Introduction

Datasources and destinations

Fields listing for The Trade Desk

01 - Click Conversion
Field IDTTD01ClickConversion
TypeNUMBER
Data Typemetric
01 - Click Conversion Currency
Field IDTTD01ClickConversionCurrency
TypeNUMBER
Data Typemetric
01 - Click Conversion Revenue
Field IDTTD01ClickConversionRevenue
TypeNUMBER
Data Typemetric
01 - Conversion Touch
Field IDTTD01ConversionTouch
TypeNUMBER
Data Typemetric
01 - Conversion Touch Revenue
Field IDTTD01ConversionTouchRevenue
TypeNUMBER
Data Typemetric
01 - Time Weighted Decay Conversion
Field IDTTD01TimeWeightedDecayConversion
TypeNUMBER
Data Typemetric
01 - Time Weighted Decay Conversion Revenue
Field IDTTD01TimeWeightedDecayConversionRevenue
TypeNUMBER
Data Typemetric
01 - View Through Conversion
Field IDTTD01ViewThroughConversion
TypeNUMBER
Data Typemetric
01 - View Through Conversion Currency
Field IDTTD01ViewThroughConversionCurrency
TypeNUMBER
Data Typemetric
01 - View Through Conversion Revenue
Field IDTTD01ViewThroughConversionRevenue
TypeNUMBER
Data Typemetric
02 - Click Conversion
Field IDTTD02ClickConversion
TypeNUMBER
Data Typemetric
02 - Click Conversion Currency
Field IDTTD02ClickConversionCurrency
TypeNUMBER
Data Typemetric
02 - Click Conversion Revenue
Field IDTTD02ClickConversionRevenue
TypeNUMBER
Data Typemetric
02 - Conversion Touch
Field IDTTD02ConversionTouch
TypeNUMBER
Data Typemetric
02 - Conversion Touch Revenue
Field IDTTD02ConversionTouchRevenue
TypeNUMBER
Data Typemetric
02 - Time Weighted Decay Conversion
Field IDTTD02TimeWeightedDecayConversion
TypeNUMBER
Data Typemetric
02 - Time Weighted Decay Conversion Revenue
Field IDTTD02TimeWeightedDecayConversionRevenue
TypeNUMBER
Data Typemetric
02 - View Through Conversion
Field IDTTD02ViewThroughConversion
TypeNUMBER
Data Typemetric
02 - View Through Conversion Currency
Field IDTTD02ViewThroughConversionCurrency
TypeNUMBER
Data Typemetric
02 - View Through Conversion Revenue
Field IDTTD02ViewThroughConversionRevenue
TypeNUMBER
Data Typemetric
03 - Click Conversion
Field IDTTD03ClickConversion
TypeNUMBER
Data Typemetric
03 - Click Conversion Currency
Field IDTTD03ClickConversionCurrency
TypeNUMBER
Data Typemetric
03 - Click Conversion Revenue
Field IDTTD03ClickConversionRevenue
TypeNUMBER
Data Typemetric
03 - Conversion Touch
Field IDTTD03ConversionTouch
TypeNUMBER
Data Typemetric
03 - Conversion Touch Revenue
Field IDTTD03ConversionTouchRevenue
TypeNUMBER
Data Typemetric
03 - Time Weighted Decay Conversion
Field IDTTD03TimeWeightedDecayConversion
TypeNUMBER
Data Typemetric
03 - Time Weighted Decay Conversion Revenue
Field IDTTD03TimeWeightedDecayConversionRevenue
TypeNUMBER
Data Typemetric
03 - View Through Conversion
Field IDTTD03ViewThroughConversion
TypeNUMBER
Data Typemetric
03 - View Through Conversion Currency
Field IDTTD03ViewThroughConversionCurrency
TypeNUMBER
Data Typemetric
03 - View Through Conversion Revenue
Field IDTTD03ViewThroughConversionRevenue
TypeNUMBER
Data Typemetric
04 - Click Conversion
Field IDTTD04ClickConversion
TypeNUMBER
Data Typemetric
04 - Click Conversion Currency
Field IDTTD04ClickConversionCurrency
TypeNUMBER
Data Typemetric
04 - Click Conversion Revenue
Field IDTTD04ClickConversionRevenue
TypeNUMBER
Data Typemetric
04 - Conversion Touch
Field IDTTD04ConversionTouch
TypeNUMBER
Data Typemetric
04 - Conversion Touch Revenue
Field IDTTD04ConversionTouchRevenue
TypeNUMBER
Data Typemetric
04 - Time Weighted Decay Conversion
Field IDTTD04TimeWeightedDecayConversion
TypeNUMBER
Data Typemetric
04 - Time Weighted Decay Conversion Revenue
Field IDTTD04TimeWeightedDecayConversionRevenue
TypeNUMBER
Data Typemetric
04 - View Through Conversion
Field IDTTD04ViewThroughConversion
TypeNUMBER
Data Typemetric
04 - View Through Conversion Currency
Field IDTTD04ViewThroughConversionCurrency
TypeNUMBER
Data Typemetric
04 - View Through Conversion Revenue
Field IDTTD04ViewThroughConversionRevenue
TypeNUMBER
Data Typemetric
05 - Click Conversion
Field IDTTD05ClickConversion
TypeNUMBER
Data Typemetric
05 - Click Conversion Currency
Field IDTTD05ClickConversionCurrency
TypeNUMBER
Data Typemetric
05 - Click Conversion Revenue
Field IDTTD05ClickConversionRevenue
TypeNUMBER
Data Typemetric
05 - Conversion Touch
Field IDTTD05ConversionTouch
TypeNUMBER
Data Typemetric
05 - Conversion Touch Revenue
Field IDTTD05ConversionTouchRevenue
TypeNUMBER
Data Typemetric
05 - Time Weighted Decay Conversion
Field IDTTD05TimeWeightedDecayConversion
TypeNUMBER
Data Typemetric
05 - Time Weighted Decay Conversion Revenue
Field IDTTD05TimeWeightedDecayConversionRevenue
TypeNUMBER
Data Typemetric
05 - View Through Conversion
Field IDTTD05ViewThroughConversion
TypeNUMBER
Data Typemetric
05 - View Through Conversion Currency
Field IDTTD05ViewThroughConversionCurrency
TypeNUMBER
Data Typemetric
05 - View Through Conversion Revenue
Field IDTTD05ViewThroughConversionRevenue
TypeNUMBER
Data Typemetric
06 - Click Conversion
Field IDTTD06ClickConversion
TypeNUMBER
Data Typemetric
06 - Click Conversion Currency
Field IDTTD06ClickConversionCurrency
TypeNUMBER
Data Typemetric
06 - Click Conversion Revenue
Field IDTTD06ClickConversionRevenue
TypeNUMBER
Data Typemetric
06 - Conversion Touch
Field IDTTD06ConversionTouch
TypeNUMBER
Data Typemetric
06 - Conversion Touch Revenue
Field IDTTD06ConversionTouchRevenue
TypeNUMBER
Data Typemetric
06 - Time Weighted Decay Conversion
Field IDTTD06TimeWeightedDecayConversion
TypeNUMBER
Data Typemetric
06 - Time Weighted Decay Conversion Revenue
Field IDTTD06TimeWeightedDecayConversionRevenue
TypeNUMBER
Data Typemetric
06 - View Through Conversion
Field IDTTD06ViewThroughConversion
TypeNUMBER
Data Typemetric
06 - View Through Conversion Currency
Field IDTTD06ViewThroughConversionCurrency
TypeNUMBER
Data Typemetric
06 - View Through Conversion Revenue
Field IDTTD06ViewThroughConversionRevenue
TypeNUMBER
Data Typemetric
TTD Cost (Adv Currency)
Field IDTTDcostAdvCurrency
TypeNUMBER
Data Typemetric
TTD Cost (Partner Currency)
Field IDTTDcostPartnerCurrency
TypeNUMBER
Data Typemetric
TTD Cost (USD)
Field IDTTDcostUSD
TypeNUMBER
Data Typemetric
Day of the year
Day of the year
Field ID_NORMALIZED_DATE_FIELD_DAY
TypeDAY
Data Typedimension
Day of the week
Day of the week
Field ID_NORMALIZED_DATE_FIELD_DAY_OF_WEEK
TypeDAY_OF_WEEK
Data Typedimension
Hour of the day
Hour of the day
Field ID_NORMALIZED_DATE_FIELD_HOUR
TypeHOUR
Data Typedimension
Month of the year
Month of the year
Field ID_NORMALIZED_DATE_FIELD_MONTH
TypeMONTH
Data Typedimension
Month and day
Month and day
Field ID_NORMALIZED_DATE_FIELD_MONTH_DAY
TypeMONTH_DAY
Data Typedimension
Quarter of the year
Quarter of the year
Field ID_NORMALIZED_DATE_FIELD_QUARTER
TypeQUARTER
Data Typedimension
Normalized Week of the year
Week of the year
Field ID_NORMALIZED_DATE_FIELD_WEEK
TypeWEEK
Data Typedimension
Week of the year (start Sunday)
Week of the year
Field ID_NORMALIZED_DATE_FIELD_WEEK_START_SUNDAY
TypeWEEK
Data Typedimension
Year
Year such as 2017.
Field ID_NORMALIZED_DATE_FIELD_YEAR
TypeYEAR
Data Typedimension
Year month
Year and month.
Field ID_NORMALIZED_DATE_FIELD_YEAR_MONTH
TypeYEAR_MONTH
Data Typedimension
Date
Year Month Day such as 20240401.
Field ID_NORMALIZED_DATE_FIELD_YEAR_MONTH_DAY
TypeYEAR_MONTH_DAY
Data Typedimension
Year month day hour
Year, month, day, and hour.
Field ID_NORMALIZED_DATE_FIELD_YEAR_MONTH_DAY_HOUR
TypeYEAR_MONTH_DAY_HOUR
Data Typedimension
Year Quarter
Year and quarter.
Field ID_NORMALIZED_DATE_FIELD_YEAR_QUARTER
TypeYEAR_QUARTER
Data Typedimension
Year week
Year and week.
Field ID_NORMALIZED_DATE_FIELD_YEAR_WEEK
TypeYEAR_WEEK
Data Typedimension
Ad Groups Audience Created At
The date and time in UTC the audience was created.
Field IDadGroups.audience.createdAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Ad Groups Audience Id
Field IDadGroups.audience.id
TypeTEXT
Data Typedimension
Ad Groups Audience Is Auto Generated
Indicates if this audience was automatically generated by The Trade Desk platform.
Field IDadGroups.audience.isAutoGenerated
TypeBOOLEAN
Data Typedimension
Ad Groups Audience Last Updated At
Indicates the time when this audience was last updated (UTC).
Field IDadGroups.audience.lastUpdatedAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Ad Groups Audience Name
The name of the audience.
Field IDadGroups.audience.name
TypeTEXT
Data Typedimension
Ad Groups Audience Target Everyone
If set to true, indicates that it is a TargetEveryone audience.
Field IDadGroups.audience.targetEveryone
TypeBOOLEAN
Data Typedimension
Ad Groups Audience Settings Recency Exclusion Window In Minutes
This is the amount of time to exclude users who are in the Excluded Data Groups of the Audience. For example, if your product is purchased at regular intervals by your customers, you may not want to immediately target somebody who just converted, but you may not want to exclude them forever either. So if your Audience excludes "Converted Users" but you know those users are likely to convert again after, say, 7 days, you may want to set your exclusion window to 6 days so you begin showing them ads leading up to their likely 7th-day conversion. This is simply a contrived example and the specific setting will depend on your use case. If you're not sure how to configure this window, 129600 (90 days) is a reasonable default you may want to start with. It's also the default value used if this is not specified on create.
Field IDadGroups.audienceSettings.recencyExclusionWindowInMinutes
TypeNUMBER
Data Typedimension
Ad Groups Audience Settings Strategy
Get the Audience Strategy configured for the ad group.
Field IDadGroups.audienceSettings.strategy
TypeTEXT
Data Typedimension
Ad Groups Auto Optimization Settings Is Use Clicks As Conversions Enabled
Controls whether clicks may be counted as primary conversions when conversion data is sparse for optimizing toward conversion-based goals.
Field IDadGroups.autoOptimizationSettings.isUseClicksAsConversionsEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Auto Optimization Settings Is Use Secondary Conversions Enabled
Controls whether secondary conversions may be counted as primary conversions when conversion data is sparse for optimizing toward conversion-based goals.
Field IDadGroups.autoOptimizationSettings.isUseSecondaryConversionsEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Base Bid CPM In Advertiser Currency
Field IDadGroups.baseBidCPMInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Bid Settings Distribution For Similar Ad Groups Is Confident
IsConfident is a way of marking that the returned data is not "perfect". If this flag is set to false see the `ConfidenceIssue` field.
Field IDadGroups.bidSettingsDistributionForSimilarAdGroups.isConfident
TypeBOOLEAN
Data Typedimension
Ad Groups Bid Settings Distribution For Similar Ad Groups Max Cpm Of Dual Histogram In Target Currency
MaxCpmOfDualHistogramInTargetCurrency describes the max value of the dual histograms so that they can be adjusted for non USD CPMs
Field IDadGroups.bidSettingsDistributionForSimilarAdGroups.maxCpmOfDualHistogramInTargetCurrency
TypeNUMBER
Data Typedimension
Ad Groups Budget Current Flight Budget
The budget of the AdGroup's current or next upcoming flight.
Field IDadGroups.budget.currentFlightBudget
TypeNUMBER
Data Typedimension
Ad Groups Budget Is Fluid
Indicates the ad group's spend in the current flight is fully system optimized, without any manual intervention.
Field IDadGroups.budget.isFluid
TypeBOOLEAN
Data Typedimension
Ad Groups Budget Spend Priority
Spend priority controls how the platform allocates value-driven (also known as fluid or unreserved) budget across ad groups within a campaign. Here's what you need to know: - This must be a value between 1 and 10, or `null`. - If set to `null`, the system automatically prioritizes spend for the ad group based on value. - Fixed budgets are always honored, regardless of priority. Priority only influences how the remaining fluid budget is distributed if there is any. - By default, in Kokai, priority acts as a value weight, not a strict order of spend. - Ad groups with a higher priority (lower number) are more likely to receive a larger share of the fluid budget, assuming similar performance and scale. However, this doesn’t mean they spend first; rather, they receive more consideration during allocation.
Field IDadGroups.budget.spendPriority
TypeNUMBER
Data Typedimension
Ad Groups Budget Total
The Ad group's total budget in Advertiser currency.
Field IDadGroups.budget.total
TypeNUMBER
Data Typedimension
Ad Groups Budget Version
The version of the budgeting experience for the campaign of the ad group.
Field IDadGroups.budget.version
TypeTEXT
Data Typedimension
Ad Groups Budget In Advertiser Currency
Field IDadGroups.budgetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Budget In Impressions
The maximum amount of impressions the adGroup should buy.
Field IDadGroups.budgetInImpressions
TypeNUMBER
Data Typedimension
Ad Groups Campaign Active Ad Group Count
The total number of AdGroups owned by the Campaign that are both visible and enabled.
Field IDadGroups.campaign.activeAdGroupCount
TypeNUMBER
Data Typedimension
Ad Groups Campaign Auto Allocator Enabled
Field IDadGroups.campaign.autoAllocatorEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Auto Campaign Cap Enabled
Field IDadGroups.campaign.autoCampaignCapEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Auto Prioritization Enabled
If set to `true`, enables the platform to automatically direct your budget to the better-performing ad groups first and then allocate the remaining budget to lower-performing ad groups. Requires the `autoAllocatorEnabled` property value to be set to true. The default value for this property is `false`. When you clone a campaign, this value is copied over.
Field IDadGroups.campaign.autoPrioritizationEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Budget In Impressions
The maximum amount of impressions the campaign should buy. For campaigns with multiple flights, this value is determined using specified flight values and may not be modified.
Field IDadGroups.campaign.budgetInImpressions
TypeNUMBER
Data Typedimension
Ad Groups Campaign Channel Type
Field IDadGroups.campaign.channelType
TypeTEXT
Data Typedimension
Ad Groups Campaign Created At
The time in UTC the campaign was created. This field is read-only.
Field IDadGroups.campaign.createdAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Ad Groups Campaign Created At Utc
The time in UTC the campaign was created. This field is read-only.
Field IDadGroups.campaign.createdAtUtc
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Ad Groups Campaign Custom CPA Click Weight
Weight to assign to click-through pixels when calculating custom CPA.
Field IDadGroups.campaign.customCPAClickWeight
TypeNUMBER
Data Typedimension
Ad Groups Campaign Custom CPA Type
The custom CPA to use to use for the CPA calculation for the campaign.
Field IDadGroups.campaign.customCPAType
TypeTEXT
Data Typedimension
Ad Groups Campaign Custom CPA Viewthrough Weight
Weight to assign to view pixels when calculating custom CPA.
Field IDadGroups.campaign.customCPAViewthroughWeight
TypeNUMBER
Data Typedimension
Ad Groups Campaign Custom ROAS Type
The custom ROAS calculation for the campaign's Return on Advertiser Spend value.
Field IDadGroups.campaign.customROASType
TypeTEXT
Data Typedimension
Ad Groups Campaign Description
An optional description of the campaign.
Field IDadGroups.campaign.description
TypeTEXT
Data Typedimension
Ad Groups Campaign End Date
The date and time (in UTC) when the campaign stops spending if it has not yet exhausted its budget. For campaigns with multiple multiple flights, this value is determined using specified flight values and may not be modified.
Field IDadGroups.campaign.endDate
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Ad Groups Campaign Funnel Location Count
The number of distinct Funnel Locations for all visible AdGroups owned by the Campaign.
Field IDadGroups.campaign.funnelLocationCount
TypeNUMBER
Data Typedimension
Ad Groups Campaign Id
The ID of the campaign.
Field IDadGroups.campaign.id
TypeTEXT
Data Typedimension
Ad Groups Campaign Impressions Only Budgeting CPM
Field IDadGroups.campaign.impressionsOnlyBudgetingCPM
TypeNUMBER
Data Typedimension
Ad Groups Campaign Io Contract Id
IO assigned to each campaign for IO clients to manage its spend.
Field IDadGroups.campaign.ioContractId
TypeNUMBER
Data Typedimension
Ad Groups Campaign Is Archived
Field IDadGroups.campaign.isArchived
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Is I Spot Enabled
If set to `true`, indicates that ISpot incremental reach KPI has been added. The default value is `false`.
Field IDadGroups.campaign.isISpotEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Is Managed By TTD
A property to indicate this campaign is managed by The Trade Desk.
Field IDadGroups.campaign.isManagedByTTD
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Is Migrated To Kokai
The campaign has been migrated from a previous version to Kokai.
Field IDadGroups.campaign.isMigratedToKokai
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Is Programmatic Guaranteed
Field IDadGroups.campaign.isProgrammaticGuaranteed
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Is Template
Field IDadGroups.campaign.isTemplate
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Is Tv Squared Enabled
If set to `true`, indicates that TvSquared incremental reach KPI has been added. The default value is `false`.
Field IDadGroups.campaign.isTvSquaredEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Last Touch Attribution Measured By The Trade Desk
The Trade Desk measure last-touch attribution (recommended for troubleshooting purposes).
Field IDadGroups.campaign.lastTouchAttributionMeasuredByTheTradeDesk
TypeBOOLEAN
Data Typedimension
Ad Groups Campaign Last Updated
The time in UTC the campaign was last updated. This field is read-only.
Field IDadGroups.campaign.lastUpdated
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Ad Groups Campaign Last Updated At Utc
The time in UTC the campaign was last updated. This field is read-only.
Field IDadGroups.campaign.lastUpdatedAtUtc
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Ad Groups Campaign Minimum Ad Group Spend In Advertiser Currency
The daily minimum spend amount that you want the platform to allocate to all ad groups in a campaign that has `autoAllocatorEnabled` and `autoPrioritizationEnabled` set to true. Requires the `autoAllocatorEnabled` and `autoPrioritizationEnabled` property values to be set to true. The default value for this property is `0`. This value must always be positive. The platform allocates the minimum amount to ad groups daily only while there is enough potential spend and budget to allocate. When you clone a campaign, this minimum spend value is carried over.
Field IDadGroups.campaign.minimumAdGroupSpendInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Campaign Name
The name of the campaign.
Field IDadGroups.campaign.name
TypeTEXT
Data Typedimension
Ad Groups Campaign Objective
The campaign objective.
Field IDadGroups.campaign.objective
TypeTEXT
Data Typedimension
Ad Groups Campaign Pacing Mode
The pacing mode for the Campaign.
Field IDadGroups.campaign.pacingMode
TypeTEXT
Data Typedimension
Ad Groups Campaign Pacing To End Of Flight Daily Rate
Field IDadGroups.campaign.pacingToEndOfFlightDailyRate
TypeNUMBER
Data Typedimension
Ad Groups Campaign Partner Cost Percentage Fee
The partner fee for the campaign as a percentage of the budget after The Trade Desk fee is calculated. For details, contact your Account Manager.
Field IDadGroups.campaign.partnerCostPercentageFee
TypeNUMBER
Data Typedimension
Ad Groups Campaign Purchase Order Number
A property that you can use for internal reference. For example, a purchase order number.
Field IDadGroups.campaign.purchaseOrderNumber
TypeTEXT
Data Typedimension
Ad Groups Campaign Share Type
A property to indicate what level of access this campaign has.
Field IDadGroups.campaign.shareType
TypeTEXT
Data Typedimension
Ad Groups Campaign Site Url
Field IDadGroups.campaign.siteUrl
TypeTEXT
Data Typedimension
Ad Groups Campaign Start Date
The date and time (in UTC) when the campaign starts spending. For campaigns with multiple flights, this value is determined using specified flight values and may not be modified. Otherwise, it must be specified at creation time.
Field IDadGroups.campaign.startDate
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Ad Groups Campaign Status
Campaign status.
Field IDadGroups.campaign.status
TypeTEXT
Data Typedimension
Ad Groups Campaign Time Zone
The Windows time zone ID of the campaign.
Field IDadGroups.campaign.timeZone
TypeTEXT
Data Typedimension
Ad Groups Campaign Time Zone IANA
The IANA/Olson time zone ID of the campaign.
Field IDadGroups.campaign.timeZoneIANA
TypeTEXT
Data Typedimension
Ad Groups Campaign Total Ad Group Count
The total number of visible AdGroups owned by the Campaign.
Field IDadGroups.campaign.totalAdGroupCount
TypeNUMBER
Data Typedimension
Ad Groups Campaign Trading Mode
The mode that the pacing and bidding system runs on to better achieve customized goals. Only applies to Kokai campaigns.
Field IDadGroups.campaign.tradingMode
TypeTEXT
Data Typedimension
Ad Groups Campaign Type
Field IDadGroups.campaign.type
TypeTEXT
Data Typedimension
Ad Groups Campaign Version
The name of The Trade Desk platform experience in which the campaign was created. If not specified, indicates that the campaign was created in a platform experience prior to Kokai.
Field IDadGroups.campaign.version
TypeTEXT
Data Typedimension
Ad Groups Campaign Stack Rank
Field IDadGroups.campaignStackRank
TypeNUMBER
Data Typedimension
Ad Groups Channel
Field IDadGroups.channel
TypeTEXT
Data Typedimension
Ad Groups Contract Floor Price As Base Bid Adjustment
Contract floor price as base-bid adjustment.
Field IDadGroups.contractFloorPriceAsBaseBidAdjustment
TypeNUMBER
Data Typedimension
Ad Groups Created At
The time in UTC the adGroup was created. This field is read-only.
Field IDadGroups.createdAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Ad Groups Cross Device Vendor Adjust Bids On Confidence
If set to true, bids for cross-device impressions are adjusted based on the confidence level of matches.
Field IDadGroups.crossDeviceVendor.adjustBidsOnConfidence
TypeBOOLEAN
Data Typedimension
Ad Groups Cross Device Vendor Id
The identifier for this cross-device vendor. Use this ID when enabling cross-device targeting on ad groups.
Field IDadGroups.crossDeviceVendor.id
TypeTEXT
Data Typedimension
Ad Groups Cross Device Vendor Name
The friendly name of the cross-device vendor.
Field IDadGroups.crossDeviceVendor.name
TypeTEXT
Data Typedimension
Ad Groups Current Flight Ad Group Id
Field IDadGroups.currentFlight.adGroupId
TypeTEXT
Data Typedimension
Ad Groups Current Flight Allocation In Advertiser Currency
The amount of the campaign flight's budget that's allocated for an ad group.
Field IDadGroups.currentFlight.allocationInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Current Flight Allocation Type
How the ad group allocation is treated. See `AdGroupBudgetAllocationType` for the different types.
Field IDadGroups.currentFlight.allocationType
TypeTEXT
Data Typedimension
Ad Groups Current Flight Budget In Advertiser Currency
Field IDadGroups.currentFlight.budgetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Current Flight Budget In Impressions
Field IDadGroups.currentFlight.budgetInImpressions
TypeNUMBER
Data Typedimension
Ad Groups Current Flight Campaign Flight Id
Field IDadGroups.currentFlight.campaignFlightId
TypeNUMBER
Data Typedimension
Ad Groups Current Flight Daily Target In Advertiser Currency
Field IDadGroups.currentFlight.dailyTargetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Current Flight Daily Target In Impressions
Field IDadGroups.currentFlight.dailyTargetInImpressions
TypeNUMBER
Data Typedimension
Ad Groups Current Flight Minimum Spend In Advertiser Currency
Field IDadGroups.currentFlight.minimumSpendInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Current Flight Target Partner Cpm
An optional control on the bidding price for impression-budgeted flight. If null, the base bid CPM is applied by default.
Field IDadGroups.currentFlight.targetPartnerCpm
TypeNUMBER
Data Typedimension
Ad Groups Current Or Next Flight Ad Group Id
Field IDadGroups.currentOrNextFlight.adGroupId
TypeTEXT
Data Typedimension
Ad Groups Current Or Next Flight Allocation In Advertiser Currency
The amount of the campaign flight's budget that's allocated for an ad group.
Field IDadGroups.currentOrNextFlight.allocationInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Current Or Next Flight Allocation Type
How the ad group allocation is treated. See `AdGroupBudgetAllocationType` for the different types.
Field IDadGroups.currentOrNextFlight.allocationType
TypeTEXT
Data Typedimension
Ad Groups Current Or Next Flight Budget In Advertiser Currency
Field IDadGroups.currentOrNextFlight.budgetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Current Or Next Flight Budget In Impressions
Field IDadGroups.currentOrNextFlight.budgetInImpressions
TypeNUMBER
Data Typedimension
Ad Groups Current Or Next Flight Campaign Flight Id
Field IDadGroups.currentOrNextFlight.campaignFlightId
TypeNUMBER
Data Typedimension
Ad Groups Current Or Next Flight Daily Target In Advertiser Currency
Field IDadGroups.currentOrNextFlight.dailyTargetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Current Or Next Flight Daily Target In Impressions
Field IDadGroups.currentOrNextFlight.dailyTargetInImpressions
TypeNUMBER
Data Typedimension
Ad Groups Current Or Next Flight Minimum Spend In Advertiser Currency
Field IDadGroups.currentOrNextFlight.minimumSpendInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Current Or Next Flight Target Partner Cpm
An optional control on the bidding price for impression-budgeted flight. If null, the base bid CPM is applied by default.
Field IDadGroups.currentOrNextFlight.targetPartnerCpm
TypeNUMBER
Data Typedimension
Ad Groups Deals Present
Returns true if the ad group is targeting deals.
Field IDadGroups.dealsPresent
TypeBOOLEAN
Data Typedimension
Ad Groups Description
An optional description of the ad group.
Field IDadGroups.description
TypeTEXT
Data Typedimension
Ad Groups Display Viewability Standard Integral
The display viewability standard of the ad group.
Field IDadGroups.displayViewabilityStandardIntegral
TypeTEXT
Data Typedimension
Ad Groups Expressiveness Bid Factors
Total number of unique bids capped at 10 per dimension.
Field IDadGroups.expressiveness.bidFactors
TypeNUMBER
Data Typedimension
Ad Groups Expressiveness Dimensions
Number of dimensions.
Field IDadGroups.expressiveness.dimensions
TypeNUMBER
Data Typedimension
Ad Groups Expressiveness Score
Expressiveness score.
Field IDadGroups.expressiveness.score
TypeNUMBER
Data Typedimension
Ad Groups Funnel Location
The funnel location of the ad group.
Field IDadGroups.funnelLocation
TypeTEXT
Data Typedimension
Ad Groups Goal Average Value
The average Goal value.
Field IDadGroups.goal.averageValue
TypeNUMBER
Data Typedimension
Ad Groups Goal Is Custom
Whether the goal is custom or not.
Field IDadGroups.goal.isCustom
TypeBOOLEAN
Data Typedimension
Ad Groups Goal Meeting Percentage
The percentage of the Goal being met, expressed as a decimal. For example, a value of 0.12 represents 12%. Rounded to 4 digits after decimal point.
Field IDadGroups.goal.meetingPercentage
TypeNUMBER
Data Typedimension
Ad Groups Goal Short Name
The short version of goal type's name.
Field IDadGroups.goal.shortName
TypeTEXT
Data Typedimension
Ad Groups Goal Target
The target Goal value.
Field IDadGroups.goal.target
TypeNUMBER
Data Typedimension
Ad Groups Goal Type
The type of Goal.
Field IDadGroups.goal.type
TypeTEXT
Data Typedimension
Ad Groups Goal Unit
The unit of measurement for the Goal data.
Field IDadGroups.goal.unit
TypeTEXT
Data Typedimension
Ad Groups Id
The ID of the ad group.
Field IDadGroups.id
TypeTEXT
Data Typedimension
Ad Groups Industry Category Id
The category's ID.
Field IDadGroups.industryCategory.id
TypeTEXT
Data Typedimension
Ad Groups Industry Category Is Default
Is this category the default, inherited from the Advertiser.
Field IDadGroups.industryCategory.isDefault
TypeBOOLEAN
Data Typedimension
Ad Groups Industry Category Is Sensitive
Is the category sensitive or not.
Field IDadGroups.industryCategory.isSensitive
TypeBOOLEAN
Data Typedimension
Ad Groups Industry Category Name
The name of the category.
Field IDadGroups.industryCategory.name
TypeTEXT
Data Typedimension
Ad Groups Industry Category Parent Category Id
The ID of the category's parent (if present).
Field IDadGroups.industryCategory.parentCategoryId
TypeTEXT
Data Typedimension
Ad Groups Industry Sub Category Id
The category's ID.
Field IDadGroups.industrySubCategory.id
TypeTEXT
Data Typedimension
Ad Groups Industry Sub Category Is Default
Is this category the default, inherited from the Advertiser.
Field IDadGroups.industrySubCategory.isDefault
TypeBOOLEAN
Data Typedimension
Ad Groups Industry Sub Category Is Sensitive
Is the category sensitive or not.
Field IDadGroups.industrySubCategory.isSensitive
TypeBOOLEAN
Data Typedimension
Ad Groups Industry Sub Category Name
The name of the category.
Field IDadGroups.industrySubCategory.name
TypeTEXT
Data Typedimension
Ad Groups Industry Sub Category Parent Category Id
The ID of the category's parent (if present).
Field IDadGroups.industrySubCategory.parentCategoryId
TypeTEXT
Data Typedimension
Ad Groups Is Archived
Field IDadGroups.isArchived
TypeBOOLEAN
Data Typedimension
Ad Groups Is Dimensional Bidding Mode
Field IDadGroups.isDimensionalBiddingMode
TypeBOOLEAN
Data Typedimension
Ad Groups Is Enabled
If set to `true`, indicates that the ad group is enabled to spend. The default value is `false`. If not set to `true`, the ad group will be disabled and will not spend.
Field IDadGroups.isEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Is High Fill Rate
Indicates whether the ad group is a high-fill rate ad group. High-fill rate ad groups may target only programmatic guaranteed high-fill rate contracts and allow for a limited set of attributes to be set in the `RTBAttributes` object. IMPORTANT: You can set this property only on create; it may not be updated thereafter.
Field IDadGroups.isHighFillRate
TypeBOOLEAN
Data Typedimension
Ad Groups Is News Navigator Enabled
Prioritize reliable and objective news as scored by our News Rating Partners.
Field IDadGroups.isNewsNavigatorEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Is Non Decisioned
Indicates whether the ad group is targeting commitment deals.
Field IDadGroups.isNonDecisioned
TypeBOOLEAN
Data Typedimension
Ad Groups Is Programmatic Guaranteed
Indicates whether the ad group is a high-fill rate ad group. High-fill rate ad groups may target only programmatic guaranteed high-fill rate contracts and allow for a limited set of attributes to be set in the `RTBAttributes` object. IMPORTANT: You can set this property only on create; it may not be updated thereafter.
Field IDadGroups.isProgrammaticGuaranteed
TypeBOOLEAN
Data Typedimension
Ad Groups Is Quality Alliance Suite Enabled
Set to true to search for ad groups that have Quality Alliance targeting enabled.
Field IDadGroups.isQualityAllianceSuiteEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Is Targeting Default On Deals
Indicates whether the ad group is targeting all default on deals.
Field IDadGroups.isTargetingDefaultOnDeals
TypeBOOLEAN
Data Typedimension
Ad Groups Is Targeting Default On Endeavors
Indicates whether the ad group is targeting all default on deals.
Field IDadGroups.isTargetingDefaultOnEndeavors
TypeBOOLEAN
Data Typedimension
Ad Groups Is Targeting Deprecated Library Deals
If set to true, indicates that the ad group is targeting deprecated library deals
Field IDadGroups.isTargetingDeprecatedLibraryDeals
TypeBOOLEAN
Data Typedimension
Ad Groups Is Template
Field IDadGroups.isTemplate
TypeBOOLEAN
Data Typedimension
Ad Groups Is Using Live Event Schedule
Indicates if an ad group is pacing using a Live Event schedule.
Field IDadGroups.isUsingLiveEventSchedule
TypeBOOLEAN
Data Typedimension
Ad Groups Koa Settings Are Future Features Enabled
Set to `true` to enable future Koa features for the AdGroup automatically.
Field IDadGroups.koaSettings.areFutureFeaturesEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Koa Settings Are Future Features Enabled For Partner
Are future features enabled for the AdGroup's Partner automatically.
Field IDadGroups.koaSettings.areFutureFeaturesEnabledForPartner
TypeBOOLEAN
Data Typedimension
Ad Groups Koa Settings Are Koa Creative Weights Enabled
Whether the ad group is using Koa optimized creative weights to maximize the ad group's primary KPI performance
Field IDadGroups.koaSettings.areKoaCreativeWeightsEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Koa Settings Minor Version
The minor version of the KOA optimizations for this AdGroup.
Field IDadGroups.koaSettings.minorVersion
TypeTEXT
Data Typedimension
Ad Groups Koa Settings Optimizations Version
The version of the KOA optimizations for this AdGroup.
Field IDadGroups.koaSettings.optimizationsVersion
TypeTEXT
Data Typedimension
Ad Groups Koa Settings Predictive Clearing Enabled
Set to `true` to enable Koa to analyze historical clearing prices to find a lower, optimal bid for each impression served in a first-price auction.
Field IDadGroups.koaSettings.predictiveClearingEnabled
TypeBOOLEAN
Data Typedimension
Ad Groups Last Updated
The time in UTC the adGroup was last updated. This field is read-only.
Field IDadGroups.lastUpdated
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Ad Groups Market Type
Returns the market the AdGroup is currently targeting.
Field IDadGroups.marketType
TypeTEXT
Data Typedimension
Ad Groups Marketplace Id
Marketplace ID
Field IDadGroups.marketplace.id
TypeTEXT
Data Typedimension
Ad Groups Marketplace Marketplace Status
Status of the given marketplace.
Field IDadGroups.marketplace.marketplaceStatus
TypeTEXT
Data Typedimension
Ad Groups Marketplace Name
Marketplace name.
Field IDadGroups.marketplace.name
TypeTEXT
Data Typedimension
Ad Groups Marketplace Owner
Marketplace owner type.
Field IDadGroups.marketplace.owner
TypeTEXT
Data Typedimension
Ad Groups Marketplace Short Name
Marketplace short name.
Field IDadGroups.marketplace.shortName
TypeTEXT
Data Typedimension
Ad Groups Max Bid CPM In Advertiser Currency
Field IDadGroups.maxBidCPMInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Name
The name of the ad group.
Field IDadGroups.name
TypeTEXT
Data Typedimension
Ad Groups Next Flight Ad Group Id
Field IDadGroups.nextFlight.adGroupId
TypeTEXT
Data Typedimension
Ad Groups Next Flight Allocation In Advertiser Currency
The amount of the campaign flight's budget that's allocated for an ad group.
Field IDadGroups.nextFlight.allocationInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Next Flight Allocation Type
How the ad group allocation is treated. See `AdGroupBudgetAllocationType` for the different types.
Field IDadGroups.nextFlight.allocationType
TypeTEXT
Data Typedimension
Ad Groups Next Flight Budget In Advertiser Currency
Field IDadGroups.nextFlight.budgetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Next Flight Budget In Impressions
Field IDadGroups.nextFlight.budgetInImpressions
TypeNUMBER
Data Typedimension
Ad Groups Next Flight Campaign Flight Id
Field IDadGroups.nextFlight.campaignFlightId
TypeNUMBER
Data Typedimension
Ad Groups Next Flight Daily Target In Advertiser Currency
Field IDadGroups.nextFlight.dailyTargetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Next Flight Daily Target In Impressions
Field IDadGroups.nextFlight.dailyTargetInImpressions
TypeNUMBER
Data Typedimension
Ad Groups Next Flight Minimum Spend In Advertiser Currency
Field IDadGroups.nextFlight.minimumSpendInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Ad Groups Next Flight Target Partner Cpm
An optional control on the bidding price for impression-budgeted flight. If null, the base bid CPM is applied by default.
Field IDadGroups.nextFlight.targetPartnerCpm
TypeNUMBER
Data Typedimension
Ad Groups Nielsen Tracking Attributes End Age
The end age being targeted for Nielsen analytics.
Field IDadGroups.nielsenTrackingAttributes.endAge
TypeTEXT
Data Typedimension
Ad Groups Nielsen Tracking Attributes Enhanced Nielsen Reporting Options
Enhanced Nielsen reporting option setting.
Field IDadGroups.nielsenTrackingAttributes.enhancedNielsenReportingOptions
TypeTEXT
Data Typedimension
Ad Groups Nielsen Tracking Attributes Gender
The gender being targeted for Nielsen analytics.
Field IDadGroups.nielsenTrackingAttributes.gender
TypeTEXT
Data Typedimension
Ad Groups Nielsen Tracking Attributes Start Age
The start age being targeted for Nielsen analytics.
Field IDadGroups.nielsenTrackingAttributes.startAge
TypeTEXT
Data Typedimension
Ad Groups Pacing Grain Id
Field IDadGroups.pacingGrainId
TypeNUMBER
Data Typedimension
Ad Groups Partner China MSA Signed
Field IDadGroups.partner.chinaMSASigned
TypeBOOLEAN
Data Typedimension
Ad Groups Partner Credit Limit In USD
Current credit limit assigned
Field IDadGroups.partner.creditLimitInUSD
TypeNUMBER
Data Typedimension
Ad Groups Partner Daily Spend Cap In USD
Daily spend cap
Field IDadGroups.partner.dailySpendCapInUSD
TypeNUMBER
Data Typedimension
Ad Groups Partner Default Recency Bucket List Id
Field IDadGroups.partner.defaultRecencyBucketListId
TypeTEXT
Data Typedimension
Ad Groups Partner Id
The ID of the partner.
Field IDadGroups.partner.id
TypeTEXT
Data Typedimension
Ad Groups Partner Id Integer
The integer ID of the partner. This ID is typically used as a buyer or seat ID in the Easy Proposal Activation API. This is a read-only property.
Field IDadGroups.partner.idInteger
TypeNUMBER
Data Typedimension
Ad Groups Partner Is Purchase Order Number Required
Indicates if partner is billed by PO#, requiring campaigns to populate this field.
Field IDadGroups.partner.isPurchaseOrderNumberRequired
TypeBOOLEAN
Data Typedimension
Ad Groups Partner Is Spend Disabled
Flag signifying whether the spend on this partner is disabled
Field IDadGroups.partner.isSpendDisabled
TypeBOOLEAN
Data Typedimension
Ad Groups Partner Must Vet Advertisers
Field IDadGroups.partner.mustVetAdvertisers
TypeBOOLEAN
Data Typedimension
Ad Groups Partner Name
The name of the partner.
Field IDadGroups.partner.name
TypeTEXT
Data Typedimension
Ad Groups Private Contract Default Adjustment
Field IDadGroups.privateContractDefaultAdjustment
TypeNUMBER
Data Typedimension
Ad Groups Quality Alliance Viewability Profile
Viewability profile used for Quality Alliance viewability targeting.
Field IDadGroups.qualityAllianceViewabilityProfile
TypeTEXT
Data Typedimension
Ad Groups Roi Goal Average Value
The average Goal value.
Field IDadGroups.roiGoal.averageValue
TypeNUMBER
Data Typedimension
Ad Groups Roi Goal Is Custom
Whether the goal is custom or not.
Field IDadGroups.roiGoal.isCustom
TypeBOOLEAN
Data Typedimension
Ad Groups Roi Goal Meeting Percentage
The percentage of the Goal being met, expressed as a decimal. For example, a value of 0.12 represents 12%. Rounded to 4 digits after decimal point.
Field IDadGroups.roiGoal.meetingPercentage
TypeNUMBER
Data Typedimension
Ad Groups Roi Goal Short Name
The short version of goal type's name.
Field IDadGroups.roiGoal.shortName
TypeTEXT
Data Typedimension
Ad Groups Roi Goal Target
The target Goal value.
Field IDadGroups.roiGoal.target
TypeNUMBER
Data Typedimension
Ad Groups Roi Goal Type
The type of Goal.
Field IDadGroups.roiGoal.type
TypeTEXT
Data Typedimension
Ad Groups Roi Goal Unit
The unit of measurement for the Goal data.
Field IDadGroups.roiGoal.unit
TypeTEXT
Data Typedimension
Ad Groups Spend Risk Level
The AdGroup's spend risk level.
Field IDadGroups.spend.riskLevel
TypeTEXT
Data Typedimension
Ad Groups Spend Spend
The AdGroup's current spend in Advertiser currency.
Field IDadGroups.spend.spend
TypeNUMBER
Data Typedimension
Ad Groups Status
Ad group status.
Field IDadGroups.status
TypeTEXT
Data Typedimension
Ad Groups Use Multiple Cross Device Vendors
If set to true, indicates that multiple cross-device vendors are used.
Field IDadGroups.useMultipleCrossDeviceVendors
TypeBOOLEAN
Data Typedimension
Ad Groups Video Viewability Standard Integral
The display viewability standard of the ad group.
Field IDadGroups.videoViewabilityStandardIntegral
TypeTEXT
Data Typedimension
Ad Groups Viewability Profile
Coalesces the viewability profile from Campaign, Advertiser, or Partner, in that order of precedence.
Field IDadGroups.viewabilityProfile
TypeTEXT
Data Typedimension
Ad Plays
The total number of auctions won. An ad play is counted when an ad is placed on a page and has the potential to be viewed, regardless of whether it is clicked.
Field IDadPlays
TypeNUMBER
Data Typemetric
Ad Server Creative Placement ID
Field IDadServerCreativePlacementID
TypeNUMBER
Data Typemetric
Ad Server Name
Field IDadServerName
TypeNUMBER
Data Typemetric
Advertiser Attribution Click Interval
The unit of time to apply to click interval attributions.
Field IDadvertiser.attribution.clickInterval
TypeTEXT
Data Typedimension
Advertiser Attribution Click Lookback Window
When The Trade Desk performs click attribution for the Advertiser’s conversions, this is the amount of time that will be considered for attribution. Unit of time is in ClickInterval.
Field IDadvertiser.attribution.clickLookbackWindow
TypeNUMBER
Data Typedimension
Advertiser Attribution Impression Interval
The unit of time to apply to impression interval attributions.
Field IDadvertiser.attribution.impressionInterval
TypeTEXT
Data Typedimension
Advertiser Attribution Impression Lookback Window
When The Trade Desk performs impression attribution for the Advertiser’s conversions, this is the amount of time that will be considered for attribution. Unit of time is in ImpressionInterval.
Field IDadvertiser.attribution.impressionLookbackWindow
TypeNUMBER
Data Typedimension
Advertiser Audience Settings Is Audience Booster Enabled
To enable the platform to add highly relevant segments to your audience when there is confidence they will improve your targeting and boost performance, continue using the `RTBAttributes.AudienceTargeting.AudienceBoosterEnabled` property in the [ad group](/v3/portal/api/area/Ad%20Group) workflows.
Field IDadvertiser.audienceSettings.isAudienceBoosterEnabled
TypeBOOLEAN
Data Typedimension
Advertiser Audience Settings Is Audience Excluder Enabled
Now renamed Prism, it’s been enhanced to focus on the most valuable impressions by excluding irrelevant user-based and non-user-based signals that are unlikely to benefit a campaign.
Field IDadvertiser.audienceSettings.isAudienceExcluderEnabled
TypeBOOLEAN
Data Typedimension
Advertiser Brand Owner
The owner of the brands assigned to the Advertiser.
Field IDadvertiser.brandOwner
TypeTEXT
Data Typedimension
Advertiser Channel Count
The number of unique primary channels belonging to live Campaigns under the Advertiser.
Field IDadvertiser.channelCount
TypeNUMBER
Data Typedimension
Advertiser Click Dedupe Window In Seconds
When The Trade Desk performs click attribution for your conversions, similar clicks will be considered duplicates if they are within this window. Set to zero to disable click de-duplication.
Field IDadvertiser.clickDedupeWindowInSeconds
TypeNUMBER
Data Typedimension
Advertiser Conversion De Dupe Window In Seconds
When The Trade Desk performs impression attribution for your conversions, similar conversions will be considered duplicates if they are within this window. Set to zero to disable conversion de-duplication.
Field IDadvertiser.conversionDeDupeWindowInSeconds
TypeNUMBER
Data Typedimension
Advertiser Country Id
Field IDadvertiser.country.id
TypeTEXT
Data Typedimension
Advertiser Country Long Name
Field IDadvertiser.country.longName
TypeTEXT
Data Typedimension
Advertiser Country Short Name
Field IDadvertiser.country.shortName
TypeTEXT
Data Typedimension
Advertiser Currency Decimal Places
Field IDadvertiser.currency.decimalPlaces
TypeTEXT
Data Typedimension
Advertiser Currency Id
Field IDadvertiser.currency.id
TypeTEXT
Data Typedimension
Advertiser Currency Is Visible
Field IDadvertiser.currency.isVisible
TypeBOOLEAN
Data Typedimension
Advertiser Currency Name
Field IDadvertiser.currency.name
TypeTEXT
Data Typedimension
Advertiser Currency Name Plural
Field IDadvertiser.currency.namePlural
TypeTEXT
Data Typedimension
Advertiser Currency Should Prefix Currency Symbol
Field IDadvertiser.currency.shouldPrefixCurrencySymbol
TypeBOOLEAN
Data Typedimension
Advertiser Currency Symbol
Field IDadvertiser.currency.symbol
TypeTEXT
Data Typedimension
Advertiser Default Partner Viewability Settings Display Sampling Rate
The display sampling rate of the provider.
Field IDadvertiser.defaultPartnerViewabilitySettings.displaySamplingRate
TypeNUMBER
Data Typedimension
Advertiser Default Partner Viewability Settings Profile Display Name
The display name of the provider.
Field IDadvertiser.defaultPartnerViewabilitySettings.profileDisplayName
TypeTEXT
Data Typedimension
Advertiser Default Partner Viewability Settings Provider Id
The provider ID.
Field IDadvertiser.defaultPartnerViewabilitySettings.providerId
TypeTEXT
Data Typedimension
Advertiser Default Partner Viewability Settings Video Sampling Rate
The video sampling rate of the provider.
Field IDadvertiser.defaultPartnerViewabilitySettings.videoSamplingRate
TypeNUMBER
Data Typedimension
Advertiser Default Right Media Offer Id
The offer type's ID.
Field IDadvertiser.defaultRightMediaOffer.id
TypeTEXT
Data Typedimension
Advertiser Default Right Media Offer Name
The name of the offer type.
Field IDadvertiser.defaultRightMediaOffer.name
TypeTEXT
Data Typedimension
Advertiser Default Seed Active Ids
Active id count in the seed.
Field IDadvertiser.defaultSeed.activeIds
TypeNUMBER
Data Typedimension
Advertiser Default Seed Created At
Date and time of the seed creation.
Field IDadvertiser.defaultSeed.createdAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Advertiser Default Seed Id
ID of the seed.
Field IDadvertiser.defaultSeed.id
TypeTEXT
Data Typedimension
Advertiser Default Seed Is Default
Indicates whether the seed is set as the default for the advertiser.
Field IDadvertiser.defaultSeed.isDefault
TypeBOOLEAN
Data Typedimension
Advertiser Default Seed Last Updated At
Date and time of last seed update.
Field IDadvertiser.defaultSeed.lastUpdatedAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Advertiser Default Seed Name
Name of the seed
Field IDadvertiser.defaultSeed.name
TypeTEXT
Data Typedimension
Advertiser Default Seed Quality
Represents the quality of the seed. Currently, this field is available only via `advertiser.seeds`.
Field IDadvertiser.defaultSeed.quality
TypeTEXT
Data Typedimension
Advertiser Default Seed Quality Reason
Represents the reason for seed definition quality.
Field IDadvertiser.defaultSeed.qualityReason
TypeTEXT
Data Typedimension
Advertiser Default Seed Status
Seed materialization status.
Field IDadvertiser.defaultSeed.status
TypeTEXT
Data Typedimension
Advertiser Default Seed Unique Households
Unique house hold ids associated with the seed.
Field IDadvertiser.defaultSeed.uniqueHouseholds
TypeNUMBER
Data Typedimension
Advertiser Description
An optional description of the advertiser.
Field IDadvertiser.description
TypeTEXT
Data Typedimension
Advertiser Domain Address
The primary domain of the advertiser.
Field IDadvertiser.domainAddress
TypeTEXT
Data Typedimension
Advertiser Funnel Location Count
The number of unique Funnel Locations belonging to visible AdGroups for live Campaigns under the Advertiser.
Field IDadvertiser.funnelLocationCount
TypeNUMBER
Data Typedimension
Advertiser Has Available Seed Pixels
Whether or not there any Seed Pixels available to the Advertiser.
Field IDadvertiser.hasAvailableSeedPixels
TypeBOOLEAN
Data Typedimension
Advertiser Id
The ID of the advertiser.
Field IDadvertiser.id
TypeTEXT
Data Typedimension
Advertiser Ignore Referral Url In Conversion
When The Trade Desk performs impression attribution for your conversions, if enabled, conversions with deduplication key different only in referral url are considered duplicates.
Field IDadvertiser.ignoreReferralUrlInConversion
TypeBOOLEAN
Data Typedimension
Advertiser Industry Category Id
The category's ID.
Field IDadvertiser.industryCategory.id
TypeTEXT
Data Typedimension
Advertiser Industry Category Is Default
Is this category the default, inherited from the Advertiser.
Field IDadvertiser.industryCategory.isDefault
TypeBOOLEAN
Data Typedimension
Advertiser Industry Category Is Sensitive
Is the category sensitive or not.
Field IDadvertiser.industryCategory.isSensitive
TypeBOOLEAN
Data Typedimension
Advertiser Industry Category Name
The name of the category.
Field IDadvertiser.industryCategory.name
TypeTEXT
Data Typedimension
Advertiser Industry Category Parent Category Id
The ID of the category's parent (if present).
Field IDadvertiser.industryCategory.parentCategoryId
TypeTEXT
Data Typedimension
Advertiser Industry Sub Category Id
The category's ID.
Field IDadvertiser.industrySubCategory.id
TypeTEXT
Data Typedimension
Advertiser Industry Sub Category Is Default
Is this category the default, inherited from the Advertiser.
Field IDadvertiser.industrySubCategory.isDefault
TypeBOOLEAN
Data Typedimension
Advertiser Industry Sub Category Is Sensitive
Is the category sensitive or not.
Field IDadvertiser.industrySubCategory.isSensitive
TypeBOOLEAN
Data Typedimension
Advertiser Industry Sub Category Name
The name of the category.
Field IDadvertiser.industrySubCategory.name
TypeTEXT
Data Typedimension
Advertiser Industry Sub Category Parent Category Id
The ID of the category's parent (if present).
Field IDadvertiser.industrySubCategory.parentCategoryId
TypeTEXT
Data Typedimension
Advertiser Is Archived
Field IDadvertiser.isArchived
TypeBOOLEAN
Data Typedimension
Advertiser Is Blocked From Hh Solution
Is the Advertiser blocked from HH Solution.
Field IDadvertiser.isBlockedFromHhSolution
TypeBOOLEAN
Data Typedimension
Advertiser Is Favorite For User
Returns `true` if advertiser was marked as favorite by current user.
Field IDadvertiser.isFavoriteForUser
TypeBOOLEAN
Data Typedimension
Advertiser Is Hcp Eligible
Indicates whether the advertiser is eligible for HCP advertising.
Field IDadvertiser.isHcpEligible
TypeBOOLEAN
Data Typedimension
Advertiser Is Hec Auto Exempt
An HEC (Housing, Employment, Credit) exemption will exclude an HEC applicable advertiser from microtargeting restrictions.
Field IDadvertiser.isHecAutoExempt
TypeBOOLEAN
Data Typedimension
Advertiser Is Marketplace Enabled By Default
Defines if marketplace will be preselected when creating a new adgroup in this advertiser
Field IDadvertiser.isMarketplaceEnabledByDefault
TypeBOOLEAN
Data Typedimension
Advertiser Is Restricted For Distributed Algos
Field IDadvertiser.isRestrictedForDistributedAlgos
TypeBOOLEAN
Data Typedimension
Advertiser Is With Campaigns At Risk
Does the Advertiser have one or more Campaigns at risk, pacing behind.
Field IDadvertiser.isWithCampaignsAtRisk
TypeBOOLEAN
Data Typedimension
Advertiser Is With Live Campaigns
Does this Advertiser have Campaigns that are active.
Field IDadvertiser.isWithLiveCampaigns
TypeBOOLEAN
Data Typedimension
Advertiser Logo
The URL for the advertiser's logo or brand image.
Field IDadvertiser.logo
TypeTEXT
Data Typedimension
Advertiser Marketplace Id
Marketplace ID
Field IDadvertiser.marketplace.id
TypeTEXT
Data Typedimension
Advertiser Marketplace Marketplace Status
Status of the given marketplace.
Field IDadvertiser.marketplace.marketplaceStatus
TypeTEXT
Data Typedimension
Advertiser Marketplace Name
Marketplace name.
Field IDadvertiser.marketplace.name
TypeTEXT
Data Typedimension
Advertiser Marketplace Owner
Marketplace owner type.
Field IDadvertiser.marketplace.owner
TypeTEXT
Data Typedimension
Advertiser Marketplace Short Name
Marketplace short name.
Field IDadvertiser.marketplace.shortName
TypeTEXT
Data Typedimension
Advertiser Most Used Seed Active Ids
Active id count in the seed.
Field IDadvertiser.mostUsedSeed.activeIds
TypeNUMBER
Data Typedimension
Advertiser Most Used Seed Created At
Date and time of the seed creation.
Field IDadvertiser.mostUsedSeed.createdAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Advertiser Most Used Seed Id
ID of the seed.
Field IDadvertiser.mostUsedSeed.id
TypeTEXT
Data Typedimension
Advertiser Most Used Seed Is Default
Indicates whether the seed is set as the default for the advertiser.
Field IDadvertiser.mostUsedSeed.isDefault
TypeBOOLEAN
Data Typedimension
Advertiser Most Used Seed Last Updated At
Date and time of last seed update.
Field IDadvertiser.mostUsedSeed.lastUpdatedAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Advertiser Most Used Seed Name
Name of the seed
Field IDadvertiser.mostUsedSeed.name
TypeTEXT
Data Typedimension
Advertiser Most Used Seed Quality
Represents the quality of the seed. Currently, this field is available only via `advertiser.seeds`.
Field IDadvertiser.mostUsedSeed.quality
TypeTEXT
Data Typedimension
Advertiser Most Used Seed Quality Reason
Represents the reason for seed definition quality.
Field IDadvertiser.mostUsedSeed.qualityReason
TypeTEXT
Data Typedimension
Advertiser Most Used Seed Status
Seed materialization status.
Field IDadvertiser.mostUsedSeed.status
TypeTEXT
Data Typedimension
Advertiser Most Used Seed Unique Households
Unique house hold ids associated with the seed.
Field IDadvertiser.mostUsedSeed.uniqueHouseholds
TypeNUMBER
Data Typedimension
Advertiser Name
The name of the advertiser.
Field IDadvertiser.name
TypeTEXT
Data Typedimension
Advertiser Name DSA
The name of the advertiser to be displayed for campaigns targeting individuals established or located in the European Union (EU).
Field IDadvertiser.nameDSA
TypeTEXT
Data Typedimension
Advertiser Onboarding Data Advertiser Id
Field IDadvertiser.onboardingData.advertiserId
TypeTEXT
Data Typedimension
Advertiser Onboarding Data Created At
Field IDadvertiser.onboardingData.createdAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Advertiser Onboarding Data Created By User Id
Field IDadvertiser.onboardingData.createdByUserId
TypeTEXT
Data Typedimension
Advertiser Onboarding Data Id
Field IDadvertiser.onboardingData.id
TypeTEXT
Data Typedimension
Advertiser Onboarding Data Last Updated At
Field IDadvertiser.onboardingData.lastUpdatedAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Advertiser Onboarding Data Last Updated By User Id
Field IDadvertiser.onboardingData.lastUpdatedByUserId
TypeTEXT
Data Typedimension
Advertiser Partner China MSA Signed
Field IDadvertiser.partner.chinaMSASigned
TypeBOOLEAN
Data Typedimension
Advertiser Partner Credit Limit In USD
Current credit limit assigned
Field IDadvertiser.partner.creditLimitInUSD
TypeNUMBER
Data Typedimension
Advertiser Partner Daily Spend Cap In USD
Daily spend cap
Field IDadvertiser.partner.dailySpendCapInUSD
TypeNUMBER
Data Typedimension
Advertiser Partner Default Recency Bucket List Id
Field IDadvertiser.partner.defaultRecencyBucketListId
TypeTEXT
Data Typedimension
Advertiser Partner Id
The ID of the partner.
Field IDadvertiser.partner.id
TypeTEXT
Data Typedimension
Advertiser Partner Id Integer
The integer ID of the partner. This ID is typically used as a buyer or seat ID in the Easy Proposal Activation API. This is a read-only property.
Field IDadvertiser.partner.idInteger
TypeNUMBER
Data Typedimension
Advertiser Partner Is Purchase Order Number Required
Indicates if partner is billed by PO#, requiring campaigns to populate this field.
Field IDadvertiser.partner.isPurchaseOrderNumberRequired
TypeBOOLEAN
Data Typedimension
Advertiser Partner Is Spend Disabled
Flag signifying whether the spend on this partner is disabled
Field IDadvertiser.partner.isSpendDisabled
TypeBOOLEAN
Data Typedimension
Advertiser Partner Must Vet Advertisers
Field IDadvertiser.partner.mustVetAdvertisers
TypeBOOLEAN
Data Typedimension
Advertiser Partner Name
The name of the partner.
Field IDadvertiser.partner.name
TypeTEXT
Data Typedimension
Advertiser Partner Basic Info Id
The ID of the partner.
Field IDadvertiser.partnerBasicInfo.id
TypeTEXT
Data Typedimension
Advertiser Partner Basic Info Name
The name of the partner.
Field IDadvertiser.partnerBasicInfo.name
TypeTEXT
Data Typedimension
Advertiser Payer Name DSA
The name of the entity paying for this advertiser's campaigns. The Digital Services Act (DSA) requires online platforms to declare the natural or legal person paying for the ad, if different from the advertiser.
Field IDadvertiser.payerNameDSA
TypeTEXT
Data Typedimension
Advertiser Political Candidate Count
The number of political candidates.
Field IDadvertiser.political.candidateCount
TypeNUMBER
Data Typedimension
Advertiser Political Is Ballot Measure
If set to `true`, indicates that this advertiser is running political advertising campaigns for a state or local ballot measure election. Here's what you need to know: - The default value for this property is false. - Required only for political advertisers for state or local ballot measure elections.
Field IDadvertiser.political.isBallotMeasure
TypeBOOLEAN
Data Typedimension
Advertiser Political Is Candidate Election
If set to `true`, indicates that this advertiser is running political advertising campaigns for a state, local, or federal election candidate and must include a candidate profile for each candidate. Here's what you need to know: - The default value for this property is `false`. - Required only for political advertisers for federal, state, or local, candidate elections.
Field IDadvertiser.political.isCandidateElection
TypeBOOLEAN
Data Typedimension
Advertiser Secret Key
The Advertiser's secret key (inherited from Partner).
Field IDadvertiser.secretKey
TypeTEXT
Data Typedimension
Advertiser Seed Permission Can Have Seed
Indicates whether the advertiser is permitted to have seed.
Field IDadvertiser.seedPermission.canHaveSeed
TypeBOOLEAN
Data Typedimension
Advertiser Special Platform Features Campaign Flight Custom Labels In Ui
Indicates whether campaign flight custom label is available in UI.
Field IDadvertiser.specialPlatformFeatures.campaignFlightCustomLabelsInUi
TypeBOOLEAN
Data Typedimension
Advertiser Special Platform Features Hide Dooh Channel Buying In Ui
Flag indicating that TTD will hide DOOH channel buying in the UI.
Field IDadvertiser.specialPlatformFeatures.hideDoohChannelBuyingInUi
TypeBOOLEAN
Data Typedimension
Advertiser Special Platform Features Impression Budget Access
Indicates whether this partner has access to impression budgets in the UI and are enabled to edit impression budgets in the API.
Field IDadvertiser.specialPlatformFeatures.impressionBudgetAccess
TypeBOOLEAN
Data Typedimension
Advertiser Special Platform Features Legacy Quality Alliance Thresholds In Ui
Indicates whether legacy Quality Alliance thresholds are available in the UI.
Field IDadvertiser.specialPlatformFeatures.legacyQualityAllianceThresholdsInUi
TypeBOOLEAN
Data Typedimension
Advertiser Special Platform Features Show TTD Pharmaceutical Standard Categores In Ui
Indicates whether TTD Pharmaceutical Standard Categories are available in the UI.
Field IDadvertiser.specialPlatformFeatures.showTTDPharmaceuticalStandardCategoresInUi
TypeBOOLEAN
Data Typedimension
Advertiser Special Platform Features Show TTD Standard Embedding Categories In Ui
Indicates whether TTD Standard Embedding Categories are available in the UI.
Field IDadvertiser.specialPlatformFeatures.showTTDStandardEmbeddingCategoriesInUi
TypeBOOLEAN
Data Typedimension
Advertiser Special Platform Features Walmart First Party Seeds In Ui
Indicates whether advertiser is allowed to add their 1PD to seeds in Walmart.
Field IDadvertiser.specialPlatformFeatures.walmartFirstPartySeedsInUi
TypeBOOLEAN
Data Typedimension
Advertiser Total Campaign Channel Count
The total number of possible Campaign Channels.
Field IDadvertiser.totalCampaignChannelCount
TypeNUMBER
Data Typedimension
Advertiser Total Funnel Location Count
The total number of possible Funnel Locations.
Field IDadvertiser.totalFunnelLocationCount
TypeNUMBER
Data Typedimension
Advertiser Use Impressions Only Budgeting
Field IDadvertiser.useImpressionsOnlyBudgeting
TypeBOOLEAN
Data Typedimension
Advertiser Use Media Cost Basis For Campaign Fees
Field IDadvertiser.useMediaCostBasisForCampaignFees
TypeBOOLEAN
Data Typedimension
Advertiser Vetting Status
Vetting status of the advertiser. This field is read-only.
Field IDadvertiser.vettingStatus
TypeTEXT
Data Typedimension
Advertiser Viewability Selected Provider Id
Field IDadvertiser.viewability.selectedProviderId
TypeTEXT
Data Typedimension
Advertiser Cost (Adv Currency)
Field IDadvertiserCostAdvCurrency
TypeNUMBER
Data Typemetric
Advertiser Cost (Partner Currency)
Field IDadvertiserCostPartnerCurrency
TypeNUMBER
Data Typemetric
Advertiser Cost (USD)
Field IDadvertiserCostUSD
TypeNUMBER
Data Typemetric
Base Bid Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDbaseBid.advertiserCurrency
TypeNUMBER
Data Typemetric
Base Bid Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDbaseBid.partnerCurrency
TypeNUMBER
Data Typemetric
Base Bid Usd
The amount specified in US dollars.
Field IDbaseBid.usd
TypeNUMBER
Data Typemetric
Bid Cpm Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDbidCpm.advertiserCurrency
TypeNUMBER
Data Typemetric
Bid Cpm Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDbidCpm.partnerCurrency
TypeNUMBER
Data Typemetric
Bid Cpm Usd
The amount specified in US dollars.
Field IDbidCpm.usd
TypeNUMBER
Data Typemetric
Bids
The total number of times an offer was made in an auction for an impression.
Field IDbids
TypeNUMBER
Data Typemetric
Browser
Field IDbrowser
TypeTEXT
Data Typedimension
Budget Spent Percent
The percent of budget spent expressed as a decimal. For example, a value of 0.12 represents 12%. Calculated by dividing the budget spent to date by the flight budget . Currently only supported for campaign flights and ad group flights.
Field IDbudgetSpentPercent
TypeNUMBER
Data Typemetric
Campaigns Active Ad Group Count
The total number of AdGroups owned by the Campaign that are both visible and enabled.
Field IDcampaigns.activeAdGroupCount
TypeNUMBER
Data Typedimension
Campaigns Audience Created At
The date and time in UTC the audience was created.
Field IDcampaigns.audience.createdAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Audience Id
Field IDcampaigns.audience.id
TypeTEXT
Data Typedimension
Campaigns Audience Is Auto Generated
Indicates if this audience was automatically generated by The Trade Desk platform.
Field IDcampaigns.audience.isAutoGenerated
TypeBOOLEAN
Data Typedimension
Campaigns Audience Last Updated At
Indicates the time when this audience was last updated (UTC).
Field IDcampaigns.audience.lastUpdatedAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Audience Name
The name of the audience.
Field IDcampaigns.audience.name
TypeTEXT
Data Typedimension
Campaigns Audience Target Everyone
If set to true, indicates that it is a TargetEveryone audience.
Field IDcampaigns.audience.targetEveryone
TypeBOOLEAN
Data Typedimension
Campaigns Auto Allocator Enabled
Field IDcampaigns.autoAllocatorEnabled
TypeBOOLEAN
Data Typedimension
Campaigns Auto Campaign Cap Enabled
Field IDcampaigns.autoCampaignCapEnabled
TypeBOOLEAN
Data Typedimension
Campaigns Auto Prioritization Enabled
If set to `true`, enables the platform to automatically direct your budget to the better-performing ad groups first and then allocate the remaining budget to lower-performing ad groups. Requires the `autoAllocatorEnabled` property value to be set to true. The default value for this property is `false`. When you clone a campaign, this value is copied over.
Field IDcampaigns.autoPrioritizationEnabled
TypeBOOLEAN
Data Typedimension
Campaigns Budget Ad Group Spend Prioritization Type
The ad group spend prioritization type. It determines how the system prioritizes budget allocation among its ad groups.
Field IDcampaigns.budget.adGroupSpendPrioritizationType
TypeTEXT
Data Typedimension
Campaigns Budget Allocation Mode
The campaign's budget allocation mode, which considers the budget distribution across all current and future flights, or the last past flight if no current or future flights exist. For details on the budget allocation modes, see the CampaignBudgetAllocationMode field.
Field IDcampaigns.budget.allocationMode
TypeTEXT
Data Typedimension
Campaigns Budget Current Or Up Coming
The budget of the campaign's current or next upcoming flight.
Field IDcampaigns.budget.currentOrUpComing
TypeNUMBER
Data Typedimension
Campaigns Budget Pacing Mode
The campaign pacing mode that determines how slowly or quickly the campaign spends the budget during its flights.
Field IDcampaigns.budget.pacingMode
TypeTEXT
Data Typedimension
Campaigns Budget Spend Mode
The spend mode that determines how the system allocates the campaign budget to its ad groups.
Field IDcampaigns.budget.spendMode
TypeTEXT
Data Typedimension
Campaigns Budget Total
The total budget of the campaign, in the advertiser's currency.
Field IDcampaigns.budget.total
TypeNUMBER
Data Typedimension
Campaigns Budget Total In Impressions
The maximum number of impressions the campaign should buy. For campaigns with multiple flights, this value is determined using specified flight values and may not be modified.
Field IDcampaigns.budget.totalInImpressions
TypeNUMBER
Data Typedimension
Campaigns Budget Uses Impression Budgets
Indicates whether any of the campaign’s current or future flights have impression budgets manually set. If no current or future flights exist, the last past flight is considered.
Field IDcampaigns.budget.usesImpressionBudgets
TypeBOOLEAN
Data Typedimension
Campaigns Budget Version
The version of the budgeting experience for the campaign.
Field IDcampaigns.budget.version
TypeTEXT
Data Typedimension
Campaigns Budget In Impressions
The maximum amount of impressions the campaign should buy. For campaigns with multiple flights, this value is determined using specified flight values and may not be modified.
Field IDcampaigns.budgetInImpressions
TypeNUMBER
Data Typedimension
Campaigns Budget Migration Reports Allocation Mode
Field IDcampaigns.budgetMigrationReports.allocationMode
TypeTEXT
Data Typedimension
Campaigns Budget Migration Reports Budgeting Version
Field IDcampaigns.budgetMigrationReports.budgetingVersion
TypeTEXT
Data Typedimension
Campaigns Budget Migration Reports Has Impressions
Indicates whether the campaign and any of its adGroups have impression budgets.
Field IDcampaigns.budgetMigrationReports.hasImpressions
TypeBOOLEAN
Data Typedimension
Campaigns Budget Migration Reports Has Live Events
Whether this campaign has unarchived live event ad groups.
Field IDcampaigns.budgetMigrationReports.hasLiveEvents
TypeBOOLEAN
Data Typedimension
Campaigns Budget Migration Reports Is Mixed Pacing
Whether the ad groups of this campaign have different pacing modes.
Field IDcampaigns.budgetMigrationReports.isMixedPacing
TypeBOOLEAN
Data Typedimension
Campaigns Budget Migration Reports Pacing Mode
The current pacing mode on the campaign, depending on whether it uses Solimar or Kokai budgeting.
Field IDcampaigns.budgetMigrationReports.pacingMode
TypeTEXT
Data Typedimension
Campaigns Budget Migration Reports Unified Pacing Mode
The pacing mode in Kokai that unifies campaign and its adGroups' pacing mode.
Field IDcampaigns.budgetMigrationReports.unifiedPacingMode
TypeTEXT
Data Typedimension
Campaigns Budget Migration Status Current Budgeting Version
The current budgeting version.
Field IDcampaigns.budgetMigrationStatus.currentBudgetingVersion
TypeTEXT
Data Typedimension
Campaigns Budget Migration Status Is Compatible
Whether the current budget settings is compatible with the settings in the target budgeting version.
Field IDcampaigns.budgetMigrationStatus.isCompatible
TypeBOOLEAN
Data Typedimension
Campaigns Campaign Group Current Flights End Date Exclusive
The latest end date of all the current campaign flights in this campaign group
Field IDcampaigns.campaignGroup.currentFlightsEndDateExclusive
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Campaign Group Current Flights Start Date Inclusive
The earliest start date of all the current campaign flights in this campaign group
Field IDcampaigns.campaignGroup.currentFlightsStartDateInclusive
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Campaign Group Flight Budget
Total budget across all current flights in the non-archived campaigns in the group.
Field IDcampaigns.campaignGroup.flightBudget
TypeNUMBER
Data Typedimension
Campaigns Campaign Group Id
The ID of the campaign group.
Field IDcampaigns.campaignGroup.id
TypeTEXT
Data Typedimension
Campaigns Campaign Group Is Archived
`true` if the campaign group is archived, `false` otherwise.
Field IDcampaigns.campaignGroup.isArchived
TypeBOOLEAN
Data Typedimension
Campaigns Campaign Group Last Updated
The time in UTC the campaign campaign was last updated.
Field IDcampaigns.campaignGroup.lastUpdated
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Campaign Group Name
Name of the campaign group.
Field IDcampaigns.campaignGroup.name
TypeTEXT
Data Typedimension
Campaigns Campaign Group Num Channels
The number of unique channels in the non-archived campaigns in the group that have current flights
Field IDcampaigns.campaignGroup.numChannels
TypeNUMBER
Data Typedimension
Campaigns Campaign Group Total Budget
Total budget across all campaigns in the non-archived campaigns in the group.
Field IDcampaigns.campaignGroup.totalBudget
TypeNUMBER
Data Typedimension
Campaigns Campaign Pacing Settings Is Value Pacing
Field IDcampaigns.campaignPacingSettings.isValuePacing
TypeBOOLEAN
Data Typedimension
Campaigns Channel Type
Field IDcampaigns.channelType
TypeTEXT
Data Typedimension
Campaigns Created At
The time in UTC the campaign was created. This field is read-only.
Field IDcampaigns.createdAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Created At Utc
The time in UTC the campaign was created. This field is read-only.
Field IDcampaigns.createdAtUtc
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Current Flight Budget Allocation Mode
Whether the budget allocation on this campaign flight is fluid, fixed, or mixed. See CampaignBudgetAllocationMode.
Field IDcampaigns.currentFlight.budgetAllocationMode
TypeTEXT
Data Typedimension
Campaigns Current Flight Budget In Advertiser Currency
The maximum amount the campaign flight may spend. This must be in the currency of the advertiser that owns the campaign.
Field IDcampaigns.currentFlight.budgetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Campaigns Current Flight Budget In Impressions
The maximum amount of impressions the campaign flight should buy.
Field IDcampaigns.currentFlight.budgetInImpressions
TypeNUMBER
Data Typedimension
Campaigns Current Flight Daily Target In Advertiser Currency
The total amount the campaign flight should spend in a single day, if possible. Value is in the currency of the advertiser that owns the campaign.
Field IDcampaigns.currentFlight.dailyTargetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Campaigns Current Flight Daily Target In Impressions
The total number of impressions the campaign flight should buy in a single day, if possible.
Field IDcampaigns.currentFlight.dailyTargetInImpressions
TypeNUMBER
Data Typedimension
Campaigns Current Flight Days Remaining
Field IDcampaigns.currentFlight.daysRemaining
TypeNUMBER
Data Typedimension
Campaigns Current Flight End Date Exclusive UTC
The date and time (in UTC) when the campaign flight is to stop spending if it has not yet exhausted its budget.
Field IDcampaigns.currentFlight.endDateExclusiveUTC
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Current Flight Flight Elapsed Percent
The percentage of the flight duration that has elapsed, expressed as a decimal. For example, a value of 0.12 represents 12%. Rounded to four decimal places
Field IDcampaigns.currentFlight.flightElapsedPercent
TypeNUMBER
Data Typedimension
Campaigns Current Flight Id
Field IDcampaigns.currentFlight.id
TypeTEXT
Data Typedimension
Campaigns Current Flight Is Active For At Least A Day
Field IDcampaigns.currentFlight.isActiveForAtLeastADay
TypeBOOLEAN
Data Typedimension
Campaigns Current Flight Is Current
Field IDcampaigns.currentFlight.isCurrent
TypeBOOLEAN
Data Typedimension
Campaigns Current Flight Is Deleted
Field IDcampaigns.currentFlight.isDeleted
TypeBOOLEAN
Data Typedimension
Campaigns Current Flight Is Fixed Impression Budget Allocation
Whether the impression budget allocation on this campaign flight is manually set as fixed.
Field IDcampaigns.currentFlight.isFixedImpressionBudgetAllocation
TypeBOOLEAN
Data Typedimension
Campaigns Current Flight Start Date Inclusive UTC
The date and time (in UTC) when the campaign flight is to start spending.
Field IDcampaigns.currentFlight.startDateInclusiveUTC
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Current Flight Uses Impression Budgets
Whether the campaign flight has impression budgets manually set.
Field IDcampaigns.currentFlight.usesImpressionBudgets
TypeBOOLEAN
Data Typedimension
Campaigns Current Or Next Flight Budget Allocation Mode
Whether the budget allocation on this campaign flight is fluid, fixed, or mixed. See CampaignBudgetAllocationMode.
Field IDcampaigns.currentOrNextFlight.budgetAllocationMode
TypeTEXT
Data Typedimension
Campaigns Current Or Next Flight Budget In Advertiser Currency
The maximum amount the campaign flight may spend. This must be in the currency of the advertiser that owns the campaign.
Field IDcampaigns.currentOrNextFlight.budgetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Campaigns Current Or Next Flight Budget In Impressions
The maximum amount of impressions the campaign flight should buy.
Field IDcampaigns.currentOrNextFlight.budgetInImpressions
TypeNUMBER
Data Typedimension
Campaigns Current Or Next Flight Daily Target In Advertiser Currency
The total amount the campaign flight should spend in a single day, if possible. Value is in the currency of the advertiser that owns the campaign.
Field IDcampaigns.currentOrNextFlight.dailyTargetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Campaigns Current Or Next Flight Daily Target In Impressions
The total number of impressions the campaign flight should buy in a single day, if possible.
Field IDcampaigns.currentOrNextFlight.dailyTargetInImpressions
TypeNUMBER
Data Typedimension
Campaigns Current Or Next Flight Days Remaining
Field IDcampaigns.currentOrNextFlight.daysRemaining
TypeNUMBER
Data Typedimension
Campaigns Current Or Next Flight End Date Exclusive UTC
The date and time (in UTC) when the campaign flight is to stop spending if it has not yet exhausted its budget.
Field IDcampaigns.currentOrNextFlight.endDateExclusiveUTC
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Current Or Next Flight Flight Elapsed Percent
The percentage of the flight duration that has elapsed, expressed as a decimal. For example, a value of 0.12 represents 12%. Rounded to four decimal places
Field IDcampaigns.currentOrNextFlight.flightElapsedPercent
TypeNUMBER
Data Typedimension
Campaigns Current Or Next Flight Id
Field IDcampaigns.currentOrNextFlight.id
TypeTEXT
Data Typedimension
Campaigns Current Or Next Flight Is Active For At Least A Day
Field IDcampaigns.currentOrNextFlight.isActiveForAtLeastADay
TypeBOOLEAN
Data Typedimension
Campaigns Current Or Next Flight Is Current
Field IDcampaigns.currentOrNextFlight.isCurrent
TypeBOOLEAN
Data Typedimension
Campaigns Current Or Next Flight Is Deleted
Field IDcampaigns.currentOrNextFlight.isDeleted
TypeBOOLEAN
Data Typedimension
Campaigns Current Or Next Flight Is Fixed Impression Budget Allocation
Whether the impression budget allocation on this campaign flight is manually set as fixed.
Field IDcampaigns.currentOrNextFlight.isFixedImpressionBudgetAllocation
TypeBOOLEAN
Data Typedimension
Campaigns Current Or Next Flight Start Date Inclusive UTC
The date and time (in UTC) when the campaign flight is to start spending.
Field IDcampaigns.currentOrNextFlight.startDateInclusiveUTC
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Current Or Next Flight Uses Impression Budgets
Whether the campaign flight has impression budgets manually set.
Field IDcampaigns.currentOrNextFlight.usesImpressionBudgets
TypeBOOLEAN
Data Typedimension
Campaigns Custom CPA Click Weight
Weight to assign to click-through pixels when calculating custom CPA.
Field IDcampaigns.customCPAClickWeight
TypeNUMBER
Data Typedimension
Campaigns Custom CPA Type
The custom CPA to use to use for the CPA calculation for the campaign.
Field IDcampaigns.customCPAType
TypeTEXT
Data Typedimension
Campaigns Custom CPA Viewthrough Weight
Weight to assign to view pixels when calculating custom CPA.
Field IDcampaigns.customCPAViewthroughWeight
TypeNUMBER
Data Typedimension
Campaigns Custom ROAS Type
The custom ROAS calculation for the campaign's Return on Advertiser Spend value.
Field IDcampaigns.customROASType
TypeTEXT
Data Typedimension
Campaigns Description
An optional description of the campaign.
Field IDcampaigns.description
TypeTEXT
Data Typedimension
Campaigns End Date
The date and time (in UTC) when the campaign stops spending if it has not yet exhausted its budget. For campaigns with multiple multiple flights, this value is determined using specified flight values and may not be modified.
Field IDcampaigns.endDate
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Frequency Settings Frequency Cap
The maximum number of impressions to serve to a specific user within the FrequencyPeriodInMinutes. Applies to the entire campaign.
Field IDcampaigns.frequencySettings.frequencyCap
TypeNUMBER
Data Typedimension
Campaigns Frequency Settings Frequency Period In Minutes
The period of time after which a specific user's Frequency Cap is reset.
Field IDcampaigns.frequencySettings.frequencyPeriodInMinutes
TypeNUMBER
Data Typedimension
Campaigns Frequency Settings Lifetime Frequency Cap
The maximum number of impressions to serve to a specific user over the lifetime of the campaign.
Field IDcampaigns.frequencySettings.lifetimeFrequencyCap
TypeNUMBER
Data Typedimension
Campaigns Funnel Location Count
The number of distinct Funnel Locations for all visible AdGroups owned by the Campaign.
Field IDcampaigns.funnelLocationCount
TypeNUMBER
Data Typedimension
Campaigns Goal Average Value
The average Goal value.
Field IDcampaigns.goal.averageValue
TypeNUMBER
Data Typedimension
Campaigns Goal Is Custom
Whether the goal is custom or not.
Field IDcampaigns.goal.isCustom
TypeBOOLEAN
Data Typedimension
Campaigns Goal Meeting Percentage
The percentage of the Goal being met, expressed as a decimal. For example, a value of 0.12 represents 12%. Rounded to 4 digits after decimal point.
Field IDcampaigns.goal.meetingPercentage
TypeNUMBER
Data Typedimension
Campaigns Goal Short Name
The short version of goal type's name.
Field IDcampaigns.goal.shortName
TypeTEXT
Data Typedimension
Campaigns Goal Target
The target Goal value.
Field IDcampaigns.goal.target
TypeNUMBER
Data Typedimension
Campaigns Goal Type
The type of Goal.
Field IDcampaigns.goal.type
TypeTEXT
Data Typedimension
Campaigns Goal Unit
The unit of measurement for the Goal data.
Field IDcampaigns.goal.unit
TypeTEXT
Data Typedimension
Campaigns Id
The ID of the campaign.
Field IDcampaigns.id
TypeTEXT
Data Typedimension
Campaigns Impressions Only Budgeting CPM
Field IDcampaigns.impressionsOnlyBudgetingCPM
TypeNUMBER
Data Typedimension
Campaigns Io Contract Id
IO assigned to each campaign for IO clients to manage its spend.
Field IDcampaigns.ioContractId
TypeNUMBER
Data Typedimension
Campaigns Is Archived
Field IDcampaigns.isArchived
TypeBOOLEAN
Data Typedimension
Campaigns Is I Spot Enabled
If set to `true`, indicates that ISpot incremental reach KPI has been added. The default value is `false`.
Field IDcampaigns.isISpotEnabled
TypeBOOLEAN
Data Typedimension
Campaigns Is Managed By TTD
A property to indicate this campaign is managed by The Trade Desk.
Field IDcampaigns.isManagedByTTD
TypeBOOLEAN
Data Typedimension
Campaigns Is Migrated To Kokai
The campaign has been migrated from a previous version to Kokai.
Field IDcampaigns.isMigratedToKokai
TypeBOOLEAN
Data Typedimension
Campaigns Is Programmatic Guaranteed
Field IDcampaigns.isProgrammaticGuaranteed
TypeBOOLEAN
Data Typedimension
Campaigns Is Template
Field IDcampaigns.isTemplate
TypeBOOLEAN
Data Typedimension
Campaigns Is Tv Squared Enabled
If set to `true`, indicates that TvSquared incremental reach KPI has been added. The default value is `false`.
Field IDcampaigns.isTvSquaredEnabled
TypeBOOLEAN
Data Typedimension
Campaigns Last Touch Attribution Measured By The Trade Desk
The Trade Desk measure last-touch attribution (recommended for troubleshooting purposes).
Field IDcampaigns.lastTouchAttributionMeasuredByTheTradeDesk
TypeBOOLEAN
Data Typedimension
Campaigns Last Updated
The time in UTC the campaign was last updated. This field is read-only.
Field IDcampaigns.lastUpdated
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Last Updated At Utc
The time in UTC the campaign was last updated. This field is read-only.
Field IDcampaigns.lastUpdatedAtUtc
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Minimum Ad Group Spend In Advertiser Currency
The daily minimum spend amount that you want the platform to allocate to all ad groups in a campaign that has `autoAllocatorEnabled` and `autoPrioritizationEnabled` set to true. Requires the `autoAllocatorEnabled` and `autoPrioritizationEnabled` property values to be set to true. The default value for this property is `0`. This value must always be positive. The platform allocates the minimum amount to ad groups daily only while there is enough potential spend and budget to allocate. When you clone a campaign, this minimum spend value is carried over.
Field IDcampaigns.minimumAdGroupSpendInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Campaigns Name
The name of the campaign.
Field IDcampaigns.name
TypeTEXT
Data Typedimension
Campaigns Next Flight Budget Allocation Mode
Whether the budget allocation on this campaign flight is fluid, fixed, or mixed. See CampaignBudgetAllocationMode.
Field IDcampaigns.nextFlight.budgetAllocationMode
TypeTEXT
Data Typedimension
Campaigns Next Flight Budget In Advertiser Currency
The maximum amount the campaign flight may spend. This must be in the currency of the advertiser that owns the campaign.
Field IDcampaigns.nextFlight.budgetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Campaigns Next Flight Budget In Impressions
The maximum amount of impressions the campaign flight should buy.
Field IDcampaigns.nextFlight.budgetInImpressions
TypeNUMBER
Data Typedimension
Campaigns Next Flight Daily Target In Advertiser Currency
The total amount the campaign flight should spend in a single day, if possible. Value is in the currency of the advertiser that owns the campaign.
Field IDcampaigns.nextFlight.dailyTargetInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Campaigns Next Flight Daily Target In Impressions
The total number of impressions the campaign flight should buy in a single day, if possible.
Field IDcampaigns.nextFlight.dailyTargetInImpressions
TypeNUMBER
Data Typedimension
Campaigns Next Flight Days Remaining
Field IDcampaigns.nextFlight.daysRemaining
TypeNUMBER
Data Typedimension
Campaigns Next Flight End Date Exclusive UTC
The date and time (in UTC) when the campaign flight is to stop spending if it has not yet exhausted its budget.
Field IDcampaigns.nextFlight.endDateExclusiveUTC
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Next Flight Flight Elapsed Percent
The percentage of the flight duration that has elapsed, expressed as a decimal. For example, a value of 0.12 represents 12%. Rounded to four decimal places
Field IDcampaigns.nextFlight.flightElapsedPercent
TypeNUMBER
Data Typedimension
Campaigns Next Flight Id
Field IDcampaigns.nextFlight.id
TypeTEXT
Data Typedimension
Campaigns Next Flight Is Active For At Least A Day
Field IDcampaigns.nextFlight.isActiveForAtLeastADay
TypeBOOLEAN
Data Typedimension
Campaigns Next Flight Is Current
Field IDcampaigns.nextFlight.isCurrent
TypeBOOLEAN
Data Typedimension
Campaigns Next Flight Is Deleted
Field IDcampaigns.nextFlight.isDeleted
TypeBOOLEAN
Data Typedimension
Campaigns Next Flight Is Fixed Impression Budget Allocation
Whether the impression budget allocation on this campaign flight is manually set as fixed.
Field IDcampaigns.nextFlight.isFixedImpressionBudgetAllocation
TypeBOOLEAN
Data Typedimension
Campaigns Next Flight Start Date Inclusive UTC
The date and time (in UTC) when the campaign flight is to start spending.
Field IDcampaigns.nextFlight.startDateInclusiveUTC
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Next Flight Uses Impression Budgets
Whether the campaign flight has impression budgets manually set.
Field IDcampaigns.nextFlight.usesImpressionBudgets
TypeBOOLEAN
Data Typedimension
Campaigns Objective
The campaign objective.
Field IDcampaigns.objective
TypeTEXT
Data Typedimension
Campaigns Pacing Mode
The pacing mode for the Campaign.
Field IDcampaigns.pacingMode
TypeTEXT
Data Typedimension
Campaigns Pacing To End Of Flight Daily Rate
Field IDcampaigns.pacingToEndOfFlightDailyRate
TypeNUMBER
Data Typedimension
Campaigns Partner China MSA Signed
Field IDcampaigns.partner.chinaMSASigned
TypeBOOLEAN
Data Typedimension
Campaigns Partner Credit Limit In USD
Current credit limit assigned
Field IDcampaigns.partner.creditLimitInUSD
TypeNUMBER
Data Typedimension
Campaigns Partner Daily Spend Cap In USD
Daily spend cap
Field IDcampaigns.partner.dailySpendCapInUSD
TypeNUMBER
Data Typedimension
Campaigns Partner Default Recency Bucket List Id
Field IDcampaigns.partner.defaultRecencyBucketListId
TypeTEXT
Data Typedimension
Campaigns Partner Id
The ID of the partner.
Field IDcampaigns.partner.id
TypeTEXT
Data Typedimension
Campaigns Partner Id Integer
The integer ID of the partner. This ID is typically used as a buyer or seat ID in the Easy Proposal Activation API. This is a read-only property.
Field IDcampaigns.partner.idInteger
TypeNUMBER
Data Typedimension
Campaigns Partner Is Purchase Order Number Required
Indicates if partner is billed by PO#, requiring campaigns to populate this field.
Field IDcampaigns.partner.isPurchaseOrderNumberRequired
TypeBOOLEAN
Data Typedimension
Campaigns Partner Is Spend Disabled
Flag signifying whether the spend on this partner is disabled
Field IDcampaigns.partner.isSpendDisabled
TypeBOOLEAN
Data Typedimension
Campaigns Partner Must Vet Advertisers
Field IDcampaigns.partner.mustVetAdvertisers
TypeBOOLEAN
Data Typedimension
Campaigns Partner Name
The name of the partner.
Field IDcampaigns.partner.name
TypeTEXT
Data Typedimension
Campaigns Partner Cost Percentage Fee
The partner fee for the campaign as a percentage of the budget after The Trade Desk fee is calculated. For details, contact your Account Manager.
Field IDcampaigns.partnerCostPercentageFee
TypeNUMBER
Data Typedimension
Campaigns Primary Goal Average Value
The average Goal value.
Field IDcampaigns.primaryGoal.averageValue
TypeNUMBER
Data Typedimension
Campaigns Primary Goal Is Custom
Whether the goal is custom or not.
Field IDcampaigns.primaryGoal.isCustom
TypeBOOLEAN
Data Typedimension
Campaigns Primary Goal Meeting Percentage
The percentage of the Goal being met, expressed as a decimal. For example, a value of 0.12 represents 12%. Rounded to 4 digits after decimal point.
Field IDcampaigns.primaryGoal.meetingPercentage
TypeNUMBER
Data Typedimension
Campaigns Primary Goal Short Name
The short version of goal type's name.
Field IDcampaigns.primaryGoal.shortName
TypeTEXT
Data Typedimension
Campaigns Primary Goal Target
The target Goal value.
Field IDcampaigns.primaryGoal.target
TypeNUMBER
Data Typedimension
Campaigns Primary Goal Type
The type of Goal.
Field IDcampaigns.primaryGoal.type
TypeTEXT
Data Typedimension
Campaigns Primary Goal Unit
The unit of measurement for the Goal data.
Field IDcampaigns.primaryGoal.unit
TypeTEXT
Data Typedimension
Campaigns Purchase Order Number
A property that you can use for internal reference. For example, a purchase order number.
Field IDcampaigns.purchaseOrderNumber
TypeTEXT
Data Typedimension
Campaigns Reporting Lifetime Impressions
The campaign's total spend in the advertiser's currency over its lifetime. NOTE: This feature is in Beta and subject to change.
Field IDcampaigns.reporting.lifetimeImpressions
TypeNUMBER
Data Typedimension
Campaigns Reporting Lifetime Spend In Advertiser Currency
The campaign's total impression count in the advertiser's currency over its lifetime. NOTE: This feature is in Beta and subject to change.
Field IDcampaigns.reporting.lifetimeSpendInAdvertiserCurrency
TypeNUMBER
Data Typedimension
Campaigns Secondary Goal Average Value
The average Goal value.
Field IDcampaigns.secondaryGoal.averageValue
TypeNUMBER
Data Typedimension
Campaigns Secondary Goal Is Custom
Whether the goal is custom or not.
Field IDcampaigns.secondaryGoal.isCustom
TypeBOOLEAN
Data Typedimension
Campaigns Secondary Goal Meeting Percentage
The percentage of the Goal being met, expressed as a decimal. For example, a value of 0.12 represents 12%. Rounded to 4 digits after decimal point.
Field IDcampaigns.secondaryGoal.meetingPercentage
TypeNUMBER
Data Typedimension
Campaigns Secondary Goal Short Name
The short version of goal type's name.
Field IDcampaigns.secondaryGoal.shortName
TypeTEXT
Data Typedimension
Campaigns Secondary Goal Target
The target Goal value.
Field IDcampaigns.secondaryGoal.target
TypeNUMBER
Data Typedimension
Campaigns Secondary Goal Type
The type of Goal.
Field IDcampaigns.secondaryGoal.type
TypeTEXT
Data Typedimension
Campaigns Secondary Goal Unit
The unit of measurement for the Goal data.
Field IDcampaigns.secondaryGoal.unit
TypeTEXT
Data Typedimension
Campaigns Seed Active Ids
Active id count in the seed.
Field IDcampaigns.seed.activeIds
TypeNUMBER
Data Typedimension
Campaigns Seed Created At
Date and time of the seed creation.
Field IDcampaigns.seed.createdAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Seed Id
ID of the seed.
Field IDcampaigns.seed.id
TypeTEXT
Data Typedimension
Campaigns Seed Is Default
Indicates whether the seed is set as the default for the advertiser.
Field IDcampaigns.seed.isDefault
TypeBOOLEAN
Data Typedimension
Campaigns Seed Last Updated At
Date and time of last seed update.
Field IDcampaigns.seed.lastUpdatedAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Seed Name
Name of the seed
Field IDcampaigns.seed.name
TypeTEXT
Data Typedimension
Campaigns Seed Quality
Represents the quality of the seed. Currently, this field is available only via `advertiser.seeds`.
Field IDcampaigns.seed.quality
TypeTEXT
Data Typedimension
Campaigns Seed Quality Reason
Represents the reason for seed definition quality.
Field IDcampaigns.seed.qualityReason
TypeTEXT
Data Typedimension
Campaigns Seed Status
Seed materialization status.
Field IDcampaigns.seed.status
TypeTEXT
Data Typedimension
Campaigns Seed Unique Households
Unique house hold ids associated with the seed.
Field IDcampaigns.seed.uniqueHouseholds
TypeNUMBER
Data Typedimension
Campaigns Share Type
A property to indicate what level of access this campaign has.
Field IDcampaigns.shareType
TypeTEXT
Data Typedimension
Campaigns Site Url
Field IDcampaigns.siteUrl
TypeTEXT
Data Typedimension
Campaigns Spend Current
Field IDcampaigns.spend.current
TypeNUMBER
Data Typedimension
Campaigns Spend Risk Level
Field IDcampaigns.spend.riskLevel
TypeTEXT
Data Typedimension
Campaigns Start Date
The date and time (in UTC) when the campaign starts spending. For campaigns with multiple flights, this value is determined using specified flight values and may not be modified. Otherwise, it must be specified at creation time.
Field IDcampaigns.startDate
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Campaigns Status
Campaign status.
Field IDcampaigns.status
TypeTEXT
Data Typedimension
Campaigns Tertiary Goal Average Value
The average Goal value.
Field IDcampaigns.tertiaryGoal.averageValue
TypeNUMBER
Data Typedimension
Campaigns Tertiary Goal Is Custom
Whether the goal is custom or not.
Field IDcampaigns.tertiaryGoal.isCustom
TypeBOOLEAN
Data Typedimension
Campaigns Tertiary Goal Meeting Percentage
The percentage of the Goal being met, expressed as a decimal. For example, a value of 0.12 represents 12%. Rounded to 4 digits after decimal point.
Field IDcampaigns.tertiaryGoal.meetingPercentage
TypeNUMBER
Data Typedimension
Campaigns Tertiary Goal Short Name
The short version of goal type's name.
Field IDcampaigns.tertiaryGoal.shortName
TypeTEXT
Data Typedimension
Campaigns Tertiary Goal Target
The target Goal value.
Field IDcampaigns.tertiaryGoal.target
TypeNUMBER
Data Typedimension
Campaigns Tertiary Goal Type
The type of Goal.
Field IDcampaigns.tertiaryGoal.type
TypeTEXT
Data Typedimension
Campaigns Tertiary Goal Unit
The unit of measurement for the Goal data.
Field IDcampaigns.tertiaryGoal.unit
TypeTEXT
Data Typedimension
Campaigns Time Zone
The Windows time zone ID of the campaign.
Field IDcampaigns.timeZone
TypeTEXT
Data Typedimension
Campaigns Time Zone IANA
The IANA/Olson time zone ID of the campaign.
Field IDcampaigns.timeZoneIANA
TypeTEXT
Data Typedimension
Campaigns Total Ad Group Count
The total number of visible AdGroups owned by the Campaign.
Field IDcampaigns.totalAdGroupCount
TypeNUMBER
Data Typedimension
Campaigns Trading Mode
The mode that the pacing and bidding system runs on to better achieve customized goals. Only applies to Kokai campaigns.
Field IDcampaigns.tradingMode
TypeTEXT
Data Typedimension
Campaigns Type
Field IDcampaigns.type
TypeTEXT
Data Typedimension
Campaigns Version
The name of The Trade Desk platform experience in which the campaign was created. If not specified, indicates that the campaign was created in a platform experience prior to Kokai.
Field IDcampaigns.version
TypeTEXT
Data Typedimension
Channel Overlap Rate Households
Percentage of households reached on more than one channel.
Field IDchannelOverlapRateHouseholds
TypeNUMBER
Data Typemetric
Channel Overlap Rate Persons
Percentage of people reached on more than one channel.
Field IDchannelOverlapRatePersons
TypeNUMBER
Data Typemetric
Clicks
The number of times a user interacted with an ad by clicking it.
Field IDclicks
TypeNUMBER
Data Typemetric
Completion Rate
The proportion of ads that are fully viewed, played, or heard out of the total number of ads served.
Field IDcompletionRate
TypeNUMBER
Data Typemetric
Conversions
The number of times a user engaged with an ad and completed an action.
Field IDconversions
TypeNUMBER
Data Typemetric
Cpa Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDcpa.advertiserCurrency
TypeNUMBER
Data Typemetric
Cpa Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDcpa.partnerCurrency
TypeNUMBER
Data Typemetric
Cpa Usd
The amount specified in US dollars.
Field IDcpa.usd
TypeNUMBER
Data Typemetric
Cpa In Advertiser Currency
Cost per acquisition (CPA) in advertiser currency.
Field IDcpaInAdvertiserCurrency
TypeNUMBER
Data Typemetric
Cpc Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDcpc.advertiserCurrency
TypeNUMBER
Data Typemetric
Cpc Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDcpc.partnerCurrency
TypeNUMBER
Data Typemetric
Cpc Usd
The amount specified in US dollars.
Field IDcpc.usd
TypeNUMBER
Data Typemetric
Cpcv Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDcpcv.advertiserCurrency
TypeNUMBER
Data Typemetric
Cpcv Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDcpcv.partnerCurrency
TypeNUMBER
Data Typemetric
Cpcv Usd
The amount specified in US dollars.
Field IDcpcv.usd
TypeNUMBER
Data Typemetric
Cpm Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDcpm.advertiserCurrency
TypeNUMBER
Data Typemetric
Cpm Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDcpm.partnerCurrency
TypeNUMBER
Data Typemetric
Cpm Usd
The amount specified in US dollars.
Field IDcpm.usd
TypeNUMBER
Data Typemetric
Cpm In Advertiser Currency
Cost per mille (CPM) in advertiser currency.
Field IDcpmInAdvertiserCurrency
TypeNUMBER
Data Typemetric
Creative Ad Server Creative Id
Field IDcreatives.adServerCreativeId
TypeTEXT
Data Typedimension
Creative Ad Server Name
Field IDcreatives.adServerName
TypeTEXT
Data Typedimension
Creative Approved By
Field IDcreatives.approvedBy
TypeTEXT
Data Typedimension
Creative Created At
The UTC time when the creative was created.
Field IDcreatives.createdAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Creative Description
An optional description of the creative. The maximum character length is 512.
Field IDcreatives.description
TypeTEXT
Data Typedimension
Creative Flight End
The flight end date and time for the creative.
Field IDcreatives.flightEnd
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Creative Flight End Date UTC
Field IDcreatives.flightEndDateUTC
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Creative Flight Start
The flight start date and time for the creative.
Field IDcreatives.flightStart
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Creative Flight Start Date UTC
Field IDcreatives.flightStartDateUTC
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Creative Flight Time Zone
Timezone for the creative flight dates. Defaults to "UTC" when not explicitly set.
Field IDcreatives.flightTimeZone
TypeTEXT
Data Typedimension
Creative Flight Time Zone IANA
The IANA/Olson time zone ID of the creative flight. The default value is "Etc/UTC".
Field IDcreatives.flightTimeZoneIANA
TypeTEXT
Data Typedimension
Creative Id
The unique identifier of the creative.
Field IDcreatives.id
TypeTEXT
Data Typedimension
Creative Id Integer
Field IDcreatives.idInteger
TypeNUMBER
Data Typedimension
Creative Interstitial Support Id
Field IDcreatives.interstitialSupportId
TypeNUMBER
Data Typedimension
Creative Is Archived
Field IDcreatives.isArchived
TypeBOOLEAN
Data Typedimension
Creative Is Click Tracking Successful
Indicates whether click tracking verification was successful. Returns true if the click tracking process has been verified successfully, otherwise false.
Field IDcreatives.isClickTrackingSuccessful
TypeBOOLEAN
Data Typedimension
Creative Last Updated At
The UTC time when the creative was last updated.
Field IDcreatives.lastUpdatedAt
TypeYEAR_MONTH_DAY_SECOND
Data Typedimension
Creative Malware Scan Is Scan Pending
Completion status of the malware scan.
Field IDcreatives.malwareScan.isScanPending
TypeBOOLEAN
Data Typedimension
Creative Name
The name of the creative. The value must not contain any of the following special characters: <>;^\r\n. The maximum character length is 256.
Field IDcreatives.name
TypeTEXT
Data Typedimension
Creative Political Ad Icon Candidate Name
Political Candidate
Field IDcreatives.politicalAdIcon.candidateName
TypeTEXT
Data Typedimension
Creative Political Ad Icon Id
Field IDcreatives.politicalAdIcon.id
TypeTEXT
Data Typedimension
Creative Political Ad Icon Political Data Id
Field IDcreatives.politicalAdIcon.politicalDataId
TypeTEXT
Data Typedimension
Creative Share Link
Link to a preview of this creative. Anybody with the link can see the creative, visiting it does not require authentication.
Field IDcreatives.shareLink
TypeTEXT
Data Typedimension
Creative Tag Type
Field IDcreatives.tagType
TypeNUMBER
Data Typedimension
Creative Tag Type Enum
Field IDcreatives.tagTypeEnum
TypeTEXT
Data Typedimension
Creative Third Party Click Tracking Url
Field IDcreatives.thirdPartyClickTrackingUrl
TypeTEXT
Data Typedimension
Creative Tmt Malware Scan Is Scan Pending
Completion status of the malware scan.
Field IDcreatives.tmtMalwareScan.isScanPending
TypeBOOLEAN
Data Typedimension
Creative Type
Enum matching the type of the creative. This value will allow for sorting and filtering.
Field IDcreatives.type
TypeTEXT
Data Typedimension
Ctr
Click-through rate (percentage of impressions that resulted in clicks).
Field IDctr
TypeNUMBER
Data Typemetric
Custom Cpa Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDcustomCpa.advertiserCurrency
TypeNUMBER
Data Typemetric
Custom Cpa Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDcustomCpa.partnerCurrency
TypeNUMBER
Data Typemetric
Custom Cpa Usd
The amount specified in US dollars.
Field IDcustomCpa.usd
TypeNUMBER
Data Typemetric
Custom Roas Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDcustomRoas.advertiserCurrency
TypeNUMBER
Data Typemetric
Custom Roas Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDcustomRoas.partnerCurrency
TypeNUMBER
Data Typemetric
Custom Roas Usd
The amount specified in US dollars.
Field IDcustomRoas.usd
TypeNUMBER
Data Typemetric
Deal ID
Field IDdealID
TypeNUMBER
Data Typemetric
Device Type
Field IDdeviceType
TypeTEXT
Data Typedimension
Impressions
The number of times an ad was served and had the potential to be viewed.
Field IDimpressions
TypeNUMBER
Data Typemetric
Impressions Served Percent
The percent of impressions served expressed as a decimal rounded to 4 decimal points. For example, a value of 0.12 represents 12%. Calculated by dividing the impressions served to date by the flight impression budget. Currently only supported for campaign flights and ad group flights.
Field IDimpressionsServedPercent
TypeNUMBER
Data Typemetric
In View Rate
The proportion of impressions where an ad was in view for a certain period of time.
Field IDinViewRate
TypeNUMBER
Data Typemetric
Matched Household Impressions
Impressions which matched with a Household Id in Graph.
Field IDmatchedHouseholdImpressions
TypeNUMBER
Data Typemetric
Matched Person Impressions
Impressions which matched with a Person Id in Graph.
Field IDmatchedPersonImpressions
TypeNUMBER
Data Typemetric
Media Cost Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDmediaCost.advertiserCurrency
TypeNUMBER
Data Typemetric
Media Cost Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDmediaCost.partnerCurrency
TypeNUMBER
Data Typemetric
Media Cost Usd
The amount specified in US dollars.
Field IDmediaCost.usd
TypeNUMBER
Data Typemetric
Media Cpm Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDmediaCpm.advertiserCurrency
TypeNUMBER
Data Typemetric
Media Cpm Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDmediaCpm.partnerCurrency
TypeNUMBER
Data Typemetric
Media Cpm Usd
The amount specified in US dollars.
Field IDmediaCpm.usd
TypeNUMBER
Data Typemetric
Nielsen Otp
The Nielsen On-Target percentage. Currently not supported for campaign flights or ad group flights.
Field IDnielsenOtp
TypeNUMBER
Data Typemetric
Operating System
Field IDoperatingSystem
TypeTEXT
Data Typedimension
Operating System Family
Field IDoperatingSystemFamily
TypeTEXT
Data Typedimension
Partner Cost (Adv Currency)
Field IDpartnerCostAdvCurrency
TypeNUMBER
Data Typemetric
Partner Cost (Partner Currency)
Field IDpartnerCostPartnerCurrency
TypeNUMBER
Data Typemetric
Partner Cost (USD)
Field IDpartnerCostUSD
TypeNUMBER
Data Typemetric
Player 25% Complete
Field IDplayer25Complete
TypeNUMBER
Data Typemetric
Player 50% Complete
Field IDplayer50Complete
TypeNUMBER
Data Typemetric
Player 75% Complete
Field IDplayer75Complete
TypeNUMBER
Data Typemetric
Player Close
Field IDplayerClose
TypeNUMBER
Data Typemetric
Player Collapse
Field IDplayerCollapse
TypeNUMBER
Data Typemetric
Player Completed Views
Field IDplayerCompletedViews
TypeNUMBER
Data Typemetric
Player Engaged Views
Field IDplayerEngagedViews
TypeNUMBER
Data Typemetric
Player Errors
Field IDplayerErrors
TypeNUMBER
Data Typemetric
Player Expansion
Field IDplayerExpansion
TypeNUMBER
Data Typemetric
Player Full Screen
Field IDplayerFullScreen
TypeNUMBER
Data Typemetric
Player Invitation Accept
Field IDplayerInvitationAccept
TypeNUMBER
Data Typemetric
Player Mute
Field IDplayerMute
TypeNUMBER
Data Typemetric
Player Pause
Field IDplayerPause
TypeNUMBER
Data Typemetric
Player Resume
Field IDplayerResume
TypeNUMBER
Data Typemetric
Player Rewind
Field IDplayerRewind
TypeNUMBER
Data Typemetric
Player Skip
Field IDplayerSkip
TypeNUMBER
Data Typemetric
Player Starts
Field IDplayerStarts
TypeNUMBER
Data Typemetric
Player Unmute
Field IDplayerUnmute
TypeNUMBER
Data Typemetric
Player Views
Field IDplayerViews
TypeNUMBER
Data Typemetric
Revenue
Total revenue generated.
Field IDrevenue
TypeNUMBER
Data Typemetric
Roas Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDroas.advertiserCurrency
TypeNUMBER
Data Typemetric
Roas Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDroas.partnerCurrency
TypeNUMBER
Data Typemetric
Roas Usd
The amount specified in US dollars.
Field IDroas.usd
TypeNUMBER
Data Typemetric
Sampled Tracked Impressions
Field IDsampledTrackedImpressions
TypeNUMBER
Data Typemetric
Sampled Viewed Impressions
Field IDsampledViewedImpressions
TypeNUMBER
Data Typemetric
Spend Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDspend.advertiserCurrency
TypeNUMBER
Data Typemetric
Spend Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDspend.partnerCurrency
TypeNUMBER
Data Typemetric
Spend Usd
The amount specified in US dollars.
Field IDspend.usd
TypeNUMBER
Data Typemetric
Spend In Advertiser Currency
Spend in advertiser currency.
Field IDspendInAdvertiserCurrency
TypeNUMBER
Data Typemetric
Total Bid Amount (Adv Currency)
Field IDtotalBidAmountAdvCurrency
TypeNUMBER
Data Typemetric
Total Bid Amount (Partner Currency)
Field IDtotalBidAmountPartnerCurrency
TypeNUMBER
Data Typemetric
Total Bid Amount (USD)
Field IDtotalBidAmountUSD
TypeNUMBER
Data Typemetric
Tv Quality Cpm Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDtvQualityCpm.advertiserCurrency
TypeNUMBER
Data Typemetric
Tv Quality Cpm Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDtvQualityCpm.partnerCurrency
TypeNUMBER
Data Typemetric
Tv Quality Cpm Usd
The amount specified in US dollars.
Field IDtvQualityCpm.usd
TypeNUMBER
Data Typemetric
Tv Quality Index
The quality of inventory run, on a scale of 1 - 100. TVQI is an aggregate of the weighted scores for eight criteria (content, addressability, playback type, device type, content duration, production quality, content signal transparency, and market type) across three pillars of quality (content, ad experience, and signals).
Field IDtvQualityIndex
TypeNUMBER
Data Typemetric
Unique Households
Unique houseHold count.
Field IDuniqueHouseholds
TypeNUMBER
Data Typemetric
Unique Persons
Unique person count.
Field IDuniquePersons
TypeNUMBER
Data Typemetric
V Cpm Advertiser Currency
The amount specified in the advertiser's currency, which is selected during the advertiser setup process.
Field IDvCpm.advertiserCurrency
TypeNUMBER
Data Typemetric
V Cpm Partner Currency
The amount specified in the partner's currency, which is selected during the partner setup process.
Field IDvCpm.partnerCurrency
TypeNUMBER
Data Typemetric
V Cpm Usd
The amount specified in US dollars.
Field IDvCpm.usd
TypeNUMBER
Data Typemetric
Video Completion Rate
The proportion of ads that are fully viewed, played, or heard out of the total number of ads served, expressed as a decimal. For example, a value of `0.65` represents 65% (65 full views per 100 ads served).
Field IDvideoCompletionRate
TypeNUMBER
Data Typemetric
Viewability
The percentage of ads that were viewable.
Field IDviewability
TypeNUMBER
Data Typemetric
Week of the year
Week of the year
Field IDweek
TypeWEEK
Data Typedimension
Win Rate
The percentage of auctions that were won.
Field IDwinRate
TypeNUMBER
Data Typemetric