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 Xandr to review that platform's relevant API documentation. By comparing APIs, you can migrate your workflow from Xandr to IQM.

Definitions

IQM	Xandr	Description
Audience	Profile	The group of people targeted for a Campaign. Audiences comprise included/excluded demographic data which is used to optimize targeting.
Audience Segment	Segment Groups	A group of specified Segments with optimization settings.
Segment Group	Segments	The demographic characteristics by which a group of people can be identified, organized, and combined into Audience Segments (Segment Groups for Xandr).
Matched Audience	Targeting Keys/Values	A customized Audience that you've created and uploaded to the platform. Xandr uses keys/values to create a customized Audience.
Retargeted Audience	Segment Pixel	An Audience created by tracking tag conversions that retargets users who visit the tracked site.

API Comparison

Base URLs

  IQM: https://app.iqm.com
  
  Xandr: https://api.appnexus.com

Action	IQM Endpoint	Xandr 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/profile
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/profile	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. A Xandr profile specifies its targeting with various parameters which can be seen on its API reference page.
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/profile
Create a Contextual Audience	POST/api/v3/audience/contextual/add
Create a Geo-Farmed Audience	POST/api/v3/audience/geo-farmed/add	POST/profile	Geography-based Audiences are created in Xandr with the following location parameters: location_target_latitude, location_target_longitude, and location_target_radius

More Campaign Resources

IQM:

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

Xandr:

• Profile Service Overview
• Segment Service