Provider release notes

These release notes list all new features and updates that have been made to The Trade Desk APIs for providers. For announcements of new features and updates to the platform user interface (UI), see Knowledge Portal Release Notes. See also Upcoming API changes for providers.

Updated ID counting methodology: hit counts replace received counts

October 13, 2026
What you need to know and do
Change summary

Effective this month (October), received counts will begin to be deprecated and replaced with hit counts in the Segments Dashboard UI and targetingDataInsights field. Here's what you need to know:

  • Received counts are the methodology for counting unique, deduplicated IDs in a segment.
  • Hit counts report the number of IDs ingested in a segment during each time period (for example, one or seven days), without deduplication.
  • You can use hit counts to see how many IDs you send rather than how many are stored. This enables you to verify uploads and troubleshoot ingestion or segment issues. For details on hit counts, see ID counting methodologies.

Active counts are not affected by this change. Hit counts have been available in the Segments Dashboard since July 2026.

Action required

Depending on how you retrieve ID counts, complete the following actions:

  • If you view ID counts in the Segments Dashboard or the targetingDataInsights field in GraphQL, use hit counts instead of received counts going forward.
  • If your integrations use GraphQL queries, such as data insights, that retrieve the receivedCounts field, update them to use the hitCounts field.
  • If your integrations use the POST /v3/thirdpartydata/query endpoint, continue retrieving received counts until hit counts are available in the REST API.

Data API version 2 with improved error handling and response format

October 13, 2026
What you need to know and do
Change summary Effective October 13, 2026, version 2 of the Data API became the default, with standardized and improved error responses. Changes include:
  • JSON API error responses with ErrorCode and Message fields
  • Corrected HTTP status codes
  • Consistent error messages across endpoints
  • Per-item serialization errors surfacing in FailedLines instead of the entire request failing
  • New FailedLines error codes
Action required These changes include breaking changes to existing error response formats. Instructions for using the new version are in the documentation for each Data API endpoint; for example, Using the custom header. Be sure to review the full documentation for the Data API endpoint you're using, and update your integration to use version 2 of the API.

Legacy CRM Data REST API: new PiiTypes array in drop-status responses

What you need to know and do
Change summary Effective October 4, 2026, the PiiType property is deprecated in the DropInfo and LatestActivatedDrop response objects of the get /v3/crmdata/{segmentType}/segment/{advertiserId}/{crmDataId}/{referenceId} endpoint. It is replaced by PiiTypes, an array that lists all PII types declared on a drop. Unlike the PiiType property, which reflects only the first declared type, the PiiTypes array is accurate for drops that declare multiple types. For a response example, see CRM data integration (legacy REST API).
Action required If you use the legacy CRM Data REST API, find any code that reads the PiiType values from the DropInfo or LatestActivatedDrop response objects and update it to use the PiiTypes array instead.

Third-party data insights: TargetingDataStatus field deprecation

September 11, 2026
What you need to know and do
Change summary

For more consistent data modeling, we've replaced the TargetingDataStatus field (queried through the TargetingData entity) with the new TargetingDataInsights field, now queried through the TargetingDataSegment entity. Unlike TargetingDataStatus, the new field does not have a state subfield with enum values.
For details and an updated query example, see Third-party data insights.

Action required

None.

Product catalog for location data providers

September 1, 2026
What you need to know and do
Change summary

If you're a location data provider who tracks store visits and foot traffic, you can now support both daily and weekly visit tracking through a single tag while providing advertisers with more granular, location-level measurement. To help you get started, we've published a guide that explains how to structure your category and location taxonomies and configure location-based events.
For details, see Product catalog for location data providers.

Action required

None.

Documentation updates: API changes page

August 31, 2026
What you need to know and do
Change summary

We've added a new page describing how we classify and communicate API changes, covering our four change categories (additions, behavior changes, new requirements, removals and replacements) and our standard notice periods. For details, see API Changes.

Action required

None. This isn't tied to a specific product release. It's new reference content to help you plan around future API changes.

MMM feeds schema update

August 26, 2026
What you need to know and do
Change summary We've released a new version of the MMM feed schema, which adds the following new fields:
  • AudienceUnlimitedTier
  • SupplyVendorId
  • SupplyVendorPublisherId
  • SampledViewedImpressions
  • SampledTrackedImpressions
  • PlayerCompletedViews
  • PlayerCompletedStarts
  • AudioFeedTypeId
  • AudioFeedTypeName
  • VideoPlacementType

As part of this update, the following fields have also been updated in this new version:

  • The Clicks column is now included by default.
  • The DMA column has been renamed to Nielsen DMA. Effective August 31, 2026, the DMA column will no longer be supported.

Action required Before August 31, 2026, migrate to the new schema and update any references to the DMA column to use Nielsen DMA instead. For details, see MMM feed schema data metrics.

Get started for real-time ID tag

July 27, 2026
What you need to know and do
Change summary

The Trade Desk has published a new guide for the real-time ID tag, which initiates cookie mapping between websites and TDIDs used by the Real-Time Conversion Events API. If you use real-time conversions, this is the recommended cookie mapping option because it supports real-time targeting and measurement while requiring less infrastructure than the match tag solution.

Action required

None. To enable this feature, contact your Account Manager or Technical Account Manager. For details, see Real-Time ID Tag.

Renaming custom fields in the product catalog

July 15, 2026
What you need to know and do
Change summary To improve usability, The Trade Desk has upgraded product catalog custom fields to support numeric values and custom field renaming.
Action required None. To learn more about the feature, see Rename custom fields and Bulk upload template column headers.

Segment Report Insights Companion

June 30, 2026
What you need to know and do
Change summary In addition to the weekly Data Provider Segment Report, The Trade Desk now offers an AI-generated Segment Report Insights Companion. This guide summarizes the performance of your data marketplace segments and recommends actions to help you quickly identify performance gaps, optimize pricing and relevance, and make more informed decisions about your data provider catalog.
Action required None. For details, see Data marketplace reports.

Data API SDK

June 24, 2026
What you need to know and do
Change summary The new Data API SDK provides a comprehensive, unified interface for onboarding and managing data within the platform. Its primary features include:
  • Onboarding of the following types of data to The Trade Desk: conversions, first-party segments, and third-party segments. You can also manage optouts and deletions.
  • Built-in conversion to UID2s or EUIDs
  • Built-in secure authentication
Action required None. This is a new feature. For details, see Data API SDK.

Curated REDS updates

May 20, 2026
What you need to know and do
Change summary

As The Trade Desk introduces new features and capabilities, Curated REDS fields are updated to provide richer data and insights. An updated version of the schema will be provided alongside your existing schema. Both versions will be available concurrently until the legacy schema is deprecated.
NOTE: All changes listed below require migration. However, migration requirements depend on your current schema. Not all providers are affected.

Existing field in current schema Expected change Feed type
If using Metro Replaced by NielsenDMA Impressions
If using MediaCost Adds TradingModeName, AudienceUnlimitedTierName, and ImpressionCostInUSDollars Impressions
If using SupplyVendor Replaced by SellingPartyName, SellingPartyType, and SellingPartyId Impressions
MatchedFoldPosition, MatchedFoldPositionName Removed Impressions
Frequency Removed Impressions
If using TDID or DeviceId Replaced by CombinedIdentifier and CombinedIdentifierType Impressions, conversions, clicks
If using CreativeIsTrackable or CreativeIsViewable Removed Video events

Action required

Review the changes above to determine whether your integration requires schema updates due to added, renamed, or removed fields. Your current schema and the upgraded version will both remain available until a deprecation date is announced.
For next steps, contact your Data Partnership Manager.

Contextual categories: charge groups

May 19, 2026
What you need to know and do
Change summary The pricing logic for contextual categories no longer uses charge-max groups. Here's what you need to know:
  • Existing data elements assigned to charge-max groups now use the charge-all group logic. You do not need to manually reassign data elements to your charge-all group.
  • You must still assign new data elements to your charge-all group.
Action required None. For details, see Integrate contextual data.

Conversion lift study API operation changes

May 8, 2026
What you need to know and do
Change summary We've renamed several queries and mutations in the Conversion Lift Study API to use the Study prefix instead of Experiment. The following operations have new names:
Old name New name
conversionLiftExperiment conversionLiftStudy
conversionLiftExperimentDelta conversionLiftStudyDelta
conversionLiftExperimentUpdate conversionLiftStudyUpdate
conversionLiftExperiments conversionLiftStudies
NOTE: The conversionLiftExperimentThirdPartyResultCreate and conversionLiftExperimentThirdPartyResultDelete mutations are unchanged.
Action required Update your integration to use the new operation names. For details, see Manage conversion lift studies.

Tracking full-site events in Shopify

April 22, 2026
What you need to know and do
Change summary You can now track conversion data from five key events with a direct Shopify integration. Events include site visit, product page view, add to cart, checkout, and purchase, with SKU-level data for the last four.
Action required None. For details, see Tracking full-site events in Shopify.

Data API token authentication method

April 13, 2026
What you need to know and do
Change summary

Effective April 2, 2026, the User Management Platform (UMP) supports Data API token generation for authentication with new data providers. For details, see User Management Platform and API token authentication.

Action required None. If you are interested in using Data API tokens for your workflows, contact your Technical Account Manager.

Databricks connector solutions

April 6, 2026
What you need to know and do
Change summary The Trade Desk now provides a Databricks connector that enable you to securely onboard conversion and segment data from your Databricks account and access log‑level data within The Trade Desk.
Action required None. For details, see Databricks connector.

New brand-agency organization model for UMP

March 23, 2026
What you need to know and do
Change summary

To provide true shared access without transferring ownership or control, we've updated the User Management Platform (UMP) organization model and shared administrative access, which helps clarify the relationship between brands and agencies within the UMP. For details, see User Management Platform.

Action required None. If you are a UMP admin for a brand or agency, review the access granted to user admins and update it as needed.

Snowflake Native App tracking tags feature

March 20, 2026
What you need to know and do
Change summary In The Trade Desk connector Snowflake Native App we've added a Tracking Tags page—a handy facility for customers who are uploading offline conversion data, where you can look up offline tracking tags that are valid in the context of the current activity.
Action required None. For details, see The Trade Desk connector native app: Tracking tags.

Product catalog feed URL integration for PIMs

March 20, 2026
What you need to know and do
Change summary Merchants that use a product information management (PIM) provider can onboard and maintain their product catalog in The Trade Desk platform using a feed URL, leveraging data already managed in a third‑party catalog management tool without spreadsheets or direct API integrations. For details, see Product catalog feed URL integration for PIMs.
Action required None.

Third-Party Segments Dashboard: creating and updating segments

March 3, 2026
What you need to know and do
Change summary You can now create and update data segments directly in the Third-Party Segments Dashboard UI. Segments can be created or updated in bulk using a template, and you can also quickly edit individual segments inline. This helps you manage segments on your own schedule with less assistance from a Technical Account Manager.
NOTE: These new features are available exclusively on OpenTTD, not Partner Portal.
Action required None. For details, see Third-Party Segments Dashboard in OpenTTD.

First-Party Data Uploader

March 2, 2026
What you need to know and do
Change summary We've introduced the First-Party Data Uploader, an upgraded and expanded replacement for the legacy CRM Data API. This new GraphQL‑based tool supports all ID types without requiring UID agreements for anonymous identifiers. It’s also our most efficient and flexible method yet for ingesting first‑party data at scale.
NOTE: Directly identifiable IDs are still available only to advertisers and partners who have signed the UID agreement.
Action required None.

Snowflake Native App optout/deletion pages

February 25, 2026
What you need to know and do
Change summary In The Trade Desk connector Snowflake Native App, you can now submit requests to opt out or delete user IDs across all data segments associated with your partner account, or any account you are authorized to act on behalf of.
Three data opt‑out and deletion workflows are available: for first-party data, third-party data, and merchants managing data.
Action required None. For details, see Snowflake connector.

Data Usage and Spend GraphQL API

January 15, 2026
What you need to know and do
Change summary For on-demand access to third-party data usage and spend, use this API to obtain gross revenue figures, impression counts, and data costs. It eliminates the wait for emailed reports (such as for billing), providing you greater control through improved visibility and reduced complexity. For details, see Third-party data usage and spend.
Action required None. If you are new to GraphQL, check out our GraphQL API Resource Hub and familiarize yourself with the basics.