Migrate an Audience

Overview

The API Comparison table highlights the main actions and API methods for creating and managing Audiences. Select an endpoint from IQM or The Trade Desk to review that platform's relevant API documentation. By comparing APIs, you can migrate your workflow from The Trade Desk to IQM.

Definitions

IQM	The Trade Desk	Description
Audience	Audience	The group of people targeted for a Campaign. Audiences comprise included/excluded demographic data which are used to optimize targeting.
Audience Segment	Data Groups	A group of specified Segments with optimization settings.
Segment Group	Data Elements	The demographic characteristics by which a group of people can be identified, organized, and combined into Audience Segments (Data Groups for TTD).
Matched Audience	First-Party Data Elements	A customized Audience that you've created and uploaded to the platform.
Pre-bid Audience	Third-Party Data Elements	An Audience composed of segments that have been sent to the platform by third-party data providers that you can purchase and target in your Audiences.
Geo-Farmed Audience	Geofence Targeting	An Audience created based on a customizable geographic location rather than demographic data.
Contextual Audience	Contextual Categories	An Audience generated by keywords or URLs, based on user activity.

API Comparison

Base URLs

  IQM: https://app.iqm.com
  
  TTD: https://api.thetradedesk.com

Action	IQM Endpoint	The Trade Desk Endpoint	Notes
Get Audience Details	GET/api/v2/audience/matched/{id} GET/api/v3/audience/segment/{audienceId} GET/api/v3/audience/retarget/{retargeted_audience_id} GET/api/v3/audience/campaign/{campaign_audience_id} GET/api/v3/audience/prebid/{prebidAudienceId}	GET/v3/audience/{audienceId}
Create an Audience	POST/api/v2/audience/matched/add POST/api/v3/audience/segment/add POST/api/v3/audience/retarget/tag POST/api/v3/audience/campaign/add POST/api/v3/audience/prebid/add	POST/v3/datagroup POST/v3/audience	IQM features different Audience creation endpoints to distinguish types of Audiences and the Segments they are composed of. See the Audience API Guidelines for more information. To create an Audience in TTD, first a Data Group must be created. Then an Audience can be created with the included/excluded DataGroupIds. What kinds of Data Groups, and how they are created, determine what kind of Audience is created: First-Party, Third-Party, Geofence, Contextual, etc.
Update an Audience	PATCH/api/v2/audience/matched/update/{matched_audience_id} PUT/api/v3/audience/segment/{audienceId} PUT/api/v3/audience/retarget/{retargeted_audience_id} PUT//api/v3/audience/prebid/{prebidAudienceId}	PUT/v3/audience
Create a Contextual Audience	POST/api/v3/audience/contextual/add	POST/v3/customcategory
Create a Geo-Farmed Audience	POST/api/v3/audience/geo-farmed/add	POST/v3/selfservegeofence	TTD Geofence endpoint creates a geographic-based segment that can then be added to a Data Group which can then be used to create an Audience.

More Campaign Resources

IQM:

• Audience API
• Upload a Matched Audinece (Quickstart Guide)
• Selecting your Audiences (Help Center Article)

TTD:

• Audiences and Targeting
• Audiences
• Include a TTD Contextual Custom Category in Bid Lines
• Geofence Targeting