Third-party geo data integration

NOTE: This guide is intended for third-party geo providers who have completed their initial setup and are ready to integrate their data to the platform.

To make your third-party geo data available for purchase in The Trade Desk platform, you must first organize your data segments into a taxonomy and then upload your data to a data management platform (DMP).

IMPORTANT: Be sure to familiarize yourself with taxonomy types and terminology, data rate concepts, and how they affect your taxonomy design. These concepts also apply when onboarding audience data.

Here's what you need to know about onboarding your data:

You can make your third-party data available to all buyers in the platform or only to certain buyers that you specify. The taxonomy type that you choose (syndicated or custom) determines which buyers can use your data to build their audiences.
If you build a custom taxonomy, keep in mind that certain rate levels require that you provide a partner or advertiser ID.
You don't have to complete your taxonomy design before sending segment data, but you must have it ready before you start creating data elements for your segments.
You can onboard data for more than one brand or advertiser, but you will need to complete a separate initial setup for all of them. For details, see Getting started for geo data providers.

Geo data types

There are two types of location-based data you can onboard to the platform: areas defined by postal codes or by geographic coordinates. You can upload each type independently or combine as different segments. However, you cannot mix postal codes and coordinates within the same segment.

The following table summarizes the two types.

Geo Data	Description
Radius	Circular areas on a map, each defined by a center point (latitude and longitude) and a radius that determines its coverage. These are often called "Points of Interest" and are classified as geofences.
ZIP or postal codes	Geographic codes (such as ZIP codes in the U.S. or postcodes in the U.K.) that identify specific regions, cities, or neighborhoods for location-based targeting.

Process overview

The following table outlines the steps you need to take to set up and complete your third-party data integration.

Step	Description	Further Reference	Notes
1	Create a test segment and verify that data is being associated with segments correctly.	Test segment data	This task requires collaboration with your Technical Account Manager.
2	If you have not completed your data taxonomy design, be sure to do it now.	Third-party data taxonomies	You can complete this step beforehand. This is also the same required step for audience data providers.
3	Create data elements and assign rates using the Taxonomy and Rate APIs.	Third-party geo data segments and rates	Be sure to have your data taxonomy ready before you begin this step.

Send and test segment data

IMPORTANT: After you send your data, but before you begin creating your data elements, be sure to create a test segment and verify that data is being associated with segments correctly.

To test your segment data, complete the following steps related to the type of geo data you want to onboard.

Step	Description	Country and Postal Codes Endpoint	Radius Endpoint
1	Create a test segment and verify that data is being associated with segments correctly.	POST /v3/thirdpartydata	POST /v3/thirdpartydata
2	Add your geo data to the test segment.	PUT /v3/geoevent	POST /v3/geotargetsegment/addgeotargets/{providerId}/{providerElementId}
3	Work with your Technical Account Manager to verify the workflow.	N/A	N/A
4	Confirm you can retrieve geo data.	GET /v3/geoevent/{providerId}/{geoEventId}	GET /v3/geotargetsegment/{providerId}/{providerElementId}
5	Work with your Technical Account Manager to verify the workflow.	N/A	N/A

Next steps

If your test is successful, and you have already designed your data taxonomy, you can start creating your data elements. Otherwise, if you have not yet designed your third-party taxonomy, do it now.