Claravine + The Trade Desk Integration

Overview

Claravine integrates with The Trade Desk to solve the problem of sprawling advertising data complicated by siloed teams and tools, enabling you to deliver and measure your campaigns. Our platform, The Data Standards Cloud, supports inbound sync of advertiser, campaign, ad group, creative, and audience data from The Trade Desk, making it easy to:

• Automate the import of data
• Accelerate data entry and custom tracking URL building
• Audit and validate data against marketing data standards
• Pass data downstream for more readable classifications
• Enrich data for improved dimensionality and segmentation in analysis

Note: Claravine currently supports inbound sync only for The Trade Desk. Outbound sync, including automatically pushing naming convention updates back into The Trade Desk, is not supported at this time.

Once the connector is set up, The Data Standards Cloud automatically syncs and imports specified data from The Trade Desk and maps this into the appropriate fields in your template(s). From there, you can take a few approaches depending on what your team is looking to accomplish.

You can pass data directly to your analytics and BI tools so you can more immediately understand performance in these systems, and enrich this data with additional business-specific metadata before sending it downstream.

You can also create and validate data across various team workflows. For example, generate naming conventions in our platform. Then, set up campaigns in The Trade Desk and import this data to validate compliance and add business-specific data from the naming convention workflow. At the same time, associate data together for use across workflows, or pass it to your downstream solutions. This type of approach helps you to improve naming compliance while simultaneously putting more accurate, detailed data in the hands of your media and creative teams, and adding important dimensionality to your final analysis in other systems.

• Connect Claravine and The Trade Desk

  Note that you must have a The Trade Desk partner account set up to configure a The Trade Desk connector. To connect The Data Standards Cloud to The Trade Desk:

  1. Confirm that you are logged into The Trade Desk with the appropriate account with access to your marketing campaigns.
  2. Navigate to Settings → Integrations → Accounts. The Accounts page displays.
  3. Click the plus sign (+) in the top right to create a new account. The Create Connected Account menu displays.
  4. Enter the following information for the account:
     • Name
     • Description (optional). We recommend entering a description to make it easier to determine the use of the Account when creating targets.
  5. Select the The Trade Desk tile as the account type.

  

  1. Generate an API token in the Trade Desk Partner Portal and enter it in Claravine. This token is separate from your Trade Desk UI login credentials. Unlike some integrations, you generate this token yourself rather than requesting it from a Trade Desk account representative.
  2. Click Save and Connect Account. Claravine will validate the token and authorize access.

  Managing your API token: Create tokens in the Trade Desk Partner Portal under Manage API Tokens, and copy the value immediately, it won't be shown again. Revoke any token that's no longer needed or may have been compromised. For short-lived tokens, plan to rotate them ahead of expiration to avoid interruptions to your Claravine sync.

  To learn more about authentication, see Trade Desk's API Token Authentication documentation.

• The Trade Desk Fields Available for Integration

  The integration allows specific fields in The Trade Desk to automatically import data into a connected template. Below is a list of supported fields and attributes you can map data from in The Trade Desk, organized by data type.

  Advertisers

  API Field Name	Field Label	Description	Req'd	Inbound
  AdvertiserId	Advertiser ID	The unique identifier of the advertiser	Y	✔
  AdvertiserName	Advertiser Name	Name of the advertiser		✔
  AdvertiserAvailability	Advertiser Status	The current status of the advertiser (e.g., Available, Archived)		✔

  Integration filters you can apply to advertiser data synced from The Trade Desk are:

  • Vetting Status (Approved, Rejected, Submitted)

  Campaigns

  API Field Name	Field Label	Description	Req'd	Inbound
  CampaignId	Campaign ID	The unique identifier of the campaign	Y	✔
  AdvertiserId	Advertiser ID	Unique identifier of the advertiser associated with the campaign		✔
  CampaignType	Campaign Channel Type	The channel type of the campaign (e.g., Display, Video, Native, Audio, CTV)		✔
  CampaignName	Campaign Name	Name of the campaign		✔
  CampaignType	Campaign Objective	The objective assigned to the campaign. This enforces validation on any ads added to the campaign to ensure they match		✔
  CampaignGoal	Campaign Goal	The performance goal set for the campaign		✔
  CampaignFlightStart	Campaign Start Date	The start date of the campaign flight		✔
  CampaignFlightEnd	Campaign End Date	The end date of the campaign flight		✔
  CampaignAvailability	Campaign Archived	Indicates whether the campaign has been archived		✔

  Integration filters you can apply to campaign data synced from The Trade Desk are:

  • Advertiser ID
  • Availability
  • Start Date
  • End Date

  Ad Groups

  API Field Name	Field Label	Description	Req'd	Inbound
  AdGroupId	Ad Group ID	Unique identifier for the ad group	Y	✔
  AdGroupName	Ad Group Name	Name of the ad group		✔
  CampaignId	Campaign ID	Unique identifier of the campaign associated with the ad group		✔
  AdGroupChannelId	Ad Group Channel	The channel type of the ad group (e.g., Display, Video, Native, Audio, CTV)		✔
  AdGroupCreated	Ad Group Created At	Date and time the ad group was created		✔
  AdGroupAvailability	Ad Group Archived	Indicates whether the ad group has been archived		✔
  AdGroupIsEnabled	Ad Group Enabled	Indicates whether the ad group is currently enabled		✔
  AdGroupBaseBid	Ad Group Base Bid CPM	The base bid, in CPM, for the ad group		✔
  AdGroupRoiGoal	Ad Group ROI Goal	The ROI goal set for the ad group		✔
  AdGroupRoiGoalType	Ad Group ROI Goal Type	The type of ROI goal applied to the ad group		✔

  Integration filters you can apply to ad group data synced from The Trade Desk are:

  • Campaign ID
  • Availability
  • Channel ID
  • Created At (UTC)
  • Is Enabled

  Creatives

  API Field Name	Field Label	Description	Req'd	Inbound
  CreativeId	Creative ID	Unique identifier for the creative	Y	✔
  CreativeName	Creative Name	Name of the creative		✔
  CreativeCreated	Creative Created At	Date and time the creative was created		✔
  CreativeFlightStart	Creative Flight Start Date	The start date of the creative's flight		✔
  CreativeFlightEnd	Creative Flight End Date	The end date of the creative's flight		✔
  CreativeAvailability	Creative Archived	Indicates whether the creative has been archived		✔
  LastUpdatedAtUTC	Creative Last Updated At	Date and time the creative was last updated		✔
  ShareLink	Creative Share Link	URL used to preview the creative asset. Note: This field maps to the Creative URL and is required for Claravine's CVAI features, Content Comprehension and Content ID.		✔
  CreativeAuditStatuses	Creative Supply Vendor Audit Status	The supply vendor's audit status for the creative		✔
  CreativeAuditStatuses	Creative Supply Vendor Publisher Audit Status	The supply vendor's publisher-level audit status for the creative		✔

  Integration filters you can apply to creative data synced from The Trade Desk are:

  • Advertiser ID
  • Availability
  • Created At (UTC)
  • Flight Start Date (UTC)
  • Flight End Date (UTC)
  • Last Updated At (UTC)

  Audiences

  API Field Name	Field Label	Description	Req'd	Inbound
  AudienceID	Audience ID	The unique identifier of the audience	Y	✔
  AudienceName	Audience Name	Name of the audience		✔
  AdvertiserId	Advertiser ID	Unique identifier of the advertiser associated with the audience		✔
  AudienceCreated	Audience Created At	Date and time the audience was created		✔
  AudienceLastUpdated	Audience Last Updated At	Date and time the audience was last updated		✔
  AudienceAutoGenerated	Audience Auto Generated	Indicates whether the audience was automatically generated		✔
  AudienceHouseholdCount	Audience Household Count	The number of households included in the audience		✔
  AudiencePersonsCount	Audience Persons Count	The number of individual persons included in the audience		✔
  AudienceCount	Audience ID Count	The total number of identifiers included in the audience		✔
  AudienceCTVCount	Audience ID Connected TV Count	The number of connected TV identifiers included in the audience		✔
  AudienceInAppCount	Audience ID In-App Count	The number of in-app identifiers included in the audience		✔
  AudienceWebCount	Audience Web Count	The number of web identifiers included in the audience		✔
  AudienceThirdPartyDataOverlapCount	Audience Third Party Data Overlap Count	The number of records overlapping with third-party data sources		✔

  Integration filters you can apply to audience data synced from The Trade Desk are:

  • Advertiser ID
  • Last Updated At (UTC)

• Add the Integration to a Template

  For step-by-step instructions on adding this integration to a template, selecting your data type, and mapping fields, see Inbound Integration Configuration.

  
  An Outbound integration is not supported for Trade Desk at this time.