--- title: "X Ads (Twitter) metrics and dimensions" slug: "x-ads-twitter-fields" description: "Explore the X Ads (Twitter) metrics and dimensions available through Supermetrics. Find every field you need for your marketing reports." updated: 2026-09-23T11:02:47Z published: 2026-09-23T11:02:47Z canonical: "docs.supermetrics.com/x-ads-twitter-fields" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt > Use this file to discover all available pages before exploring further. # X Ads (Twitter) metrics and dimensions > Supermetrics brings all your X Ads (Twitter) data into [Google Sheets](https://workspace.google.com/marketplace/app/supermetrics/523876908005), [Looker Studio](https://supermetrics.com/products/looker-studio), [Power BI](https://supermetrics.com/products/power-bi), [Excel](https://supermetrics.com/products/excel), [BigQuery](https://supermetrics.com/products/bigquery), [Snowflake](https://supermetrics.com/products/snowflake), [Redshift](https://supermetrics.com/products/amazon-redshift), [Azure](https://supermetrics.com/products/azure-synapse) 157 metrics141 dimensionsSearch fields ### ACCOUNT | \| account \| \| --- \| \| \\| Field label \\| Account \\| \\| --- \\| --- \\| \\| Description \\| The ad account name \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Account \| \| Description \| The ad account name \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | account | | \| Field label \| Account \| \| --- \| --- \| \| Description \| The ad account name \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Account | | Description | The ad account name | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| account_id \| \| --- \| \| \\| Field label \\| Account ID \\| \\| --- \\| --- \\| \\| Description \\| The unique ID for the ad account \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Account ID \| \| Description \| The unique ID for the ad account \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | account_id | | \| Field label \| Account ID \| \| --- \| --- \| \| Description \| The unique ID for the ad account \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Account ID | | Description | The unique ID for the ad account | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| account_ui_id \| \| --- \| \| \\| Field label \\| Account UI ID \\| \\| --- \\| --- \\| \\| Description \\| Converted account ID to base-10 to match the UI value \\| \\| Field type \\| dimension \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Account UI ID \| \| Description \| Converted account ID to base-10 to match the UI value \| \| Field type \| dimension \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | account_ui_id | | \| Field label \| Account UI ID \| \| --- \| --- \| \| Description \| Converted account ID to base-10 to match the UI value \| \| Field type \| dimension \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Account UI ID | | Description | Converted account ID to base-10 to match the UI value | | Field type | dimension | | Data type | [int.number.value](/apidocs/field-data-types#number) | ### AD GROUP | \| line_item_name \| \| --- \| \| \\| Field label \\| Ad group \\| \\| --- \\| --- \\| \\| Description \\| Formerly called line item \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad group \| \| Description \| Formerly called line item \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | line_item_name | | \| Field label \| Ad group \| \| --- \| --- \| \| Description \| Formerly called line item \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Ad group | | Description | Formerly called line item | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_id \| \| --- \| \| \\| Field label \\| Ad group ID \\| \\| --- \\| --- \\| \\| Description \\| Formerly called line item id \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad group ID \| \| Description \| Formerly called line item id \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_id | | \| Field label \| Ad group ID \| \| --- \| --- \| \| Description \| Formerly called line item id \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Ad group ID | | Description | Formerly called line item id | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| ad_group_ui_id \| \| --- \| \| \\| Field label \\| Ad group UI ID \\| \\| --- \\| --- \\| \\| Description \\| Converted ad group ID to base-10 to match the UI value \\| \\| Field type \\| dimension \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Ad group UI ID \| \| Description \| Converted ad group ID to base-10 to match the UI value \| \| Field type \| dimension \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | ad_group_ui_id | | \| Field label \| Ad group UI ID \| \| --- \| --- \| \| Description \| Converted ad group ID to base-10 to match the UI value \| \| Field type \| dimension \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Ad group UI ID | | Description | Converted ad group ID to base-10 to match the UI value | | Field type | dimension | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| line_item_objective \| \| --- \| \| \\| Field label \\| Objective \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Objective \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_objective | | \| Field label \| Objective \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Objective | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_goal \| \| --- \| \| \\| Field label \\| Goal \\| \\| --- \\| --- \\| \\| Description \\| The optimization setting used for this ad group \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Goal \| \| Description \| The optimization setting used for this ad group \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_goal | | \| Field label \| Goal \| \| --- \| --- \| \| Description \| The optimization setting used for this ad group \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Goal | | Description | The optimization setting used for this ad group | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_product_type \| \| --- \| \| \\| Field label \\| Product type \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Product type \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_product_type | | \| Field label \| Product type \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Product type | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_placements \| \| --- \| \| \\| Field label \\| Placements \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Placements \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_placements | | \| Field label \| Placements \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Placements | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_charge_by \| \| --- \| \| \\| Field label \\| Charge by \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Charge by \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_charge_by | | \| Field label \| Charge by \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Charge by | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_bid_type \| \| --- \| \| \\| Field label \\| Bid type \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Bid type \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_bid_type | | \| Field label \| Bid type \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Bid type | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_bid_amount \| \| --- \| \| \\| Field label \\| Bid amount \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Bid amount \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | line_item_bid_amount | | \| Field label \| Bid amount \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Bid amount | | Field type | dimension | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| line_item_total_budget_amount \| \| --- \| \| \\| Field label \\| Ad group total budget \\| \\| --- \\| --- \\| \\| Description \\| The maximum amount you are willing to spend on the ad group, for the duration of the ad group flight length. Formerly called line item total budget \\| \\| Field type \\| dimension \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Ad group total budget \| \| Description \| The maximum amount you are willing to spend on the ad group, for the duration of the ad group flight length. Formerly called line item total budget \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | line_item_total_budget_amount | | \| Field label \| Ad group total budget \| \| --- \| --- \| \| Description \| The maximum amount you are willing to spend on the ad group, for the duration of the ad group flight length. Formerly called line item total budget \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Ad group total budget | | Description | The maximum amount you are willing to spend on the ad group, for the duration of the ad group flight length. Formerly called line item total budget | | Field type | dimension | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| line_item_advertiser_domain \| \| --- \| \| \\| Field label \\| Advertiser domain \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Advertiser domain \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_advertiser_domain | | \| Field label \| Advertiser domain \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Advertiser domain | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_primary_web_event_tag \| \| --- \| \| \\| Field label \\| Primary web event tag \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Primary web event tag \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_primary_web_event_tag | | \| Field label \| Primary web event tag \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Primary web event tag | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_created_at \| \| --- \| \| \\| Field label \\| Ad group creation date \\| \\| --- \\| --- \\| \\| Description \\| Formerly called line item creation date \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Ad group creation date \| \| Description \| Formerly called line item creation date \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | line_item_created_at | | \| Field label \| Ad group creation date \| \| --- \| --- \| \| Description \| Formerly called line item creation date \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Ad group creation date | | Description | Formerly called line item creation date | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| line_item_start_date \| \| --- \| \| \\| Field label \\| Ad group start date \\| \\| --- \\| --- \\| \\| Description \\| The date when the ad group began serving \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Ad group start date \| \| Description \| The date when the ad group began serving \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | line_item_start_date | | \| Field label \| Ad group start date \| \| --- \| --- \| \| Description \| The date when the ad group began serving \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Ad group start date | | Description | The date when the ad group began serving | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| line_item_end_date \| \| --- \| \| \\| Field label \\| Ad group end date \\| \\| --- \\| --- \\| \\| Description \\| The date when the ad group stopped serving \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Ad group end date \| \| Description \| The date when the ad group stopped serving \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | line_item_end_date | | \| Field label \| Ad group end date \| \| --- \| --- \| \| Description \| The date when the ad group stopped serving \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Ad group end date | | Description | The date when the ad group stopped serving | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| line_item_status \| \| --- \| \| \\| Field label \\| Ad group status \\| \\| --- \\| --- \\| \\| Description \\| The ad group status, with possible values ACTIVE, DRAFT, or PAUSED \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad group status \| \| Description \| The ad group status, with possible values ACTIVE, DRAFT, or PAUSED \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_status | | \| Field label \| Ad group status \| \| --- \| --- \| \| Description \| The ad group status, with possible values ACTIVE, DRAFT, or PAUSED \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Ad group status | | Description | The ad group status, with possible values ACTIVE, DRAFT, or PAUSED | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_deleted \| \| --- \| \| \\| Field label \\| Ad group deleted \\| \\| --- \\| --- \\| \\| Description \\| Formerly called line item deleted \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \| \| Field label \| Ad group deleted \| \| Description \| Formerly called line item deleted \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | line_item_deleted | | \| Field label \| Ad group deleted \| \| --- \| --- \| \| Description \| Formerly called line item deleted \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | Field label | Ad group deleted | | Description | Formerly called line item deleted | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | \| line_item_categories \| \| --- \| \| \\| Field label \\| Categories \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Categories \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_categories | | \| Field label \| Categories \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Categories | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| line_item_include_sentiment \| \| --- \| \| \\| Field label \\| Include sentiment \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Include sentiment \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_include_sentiment | | \| Field label \| Include sentiment \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Include sentiment | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | ### CAMPAIGN | \| campaign_name \| \| --- \| \| \\| Field label \\| Campaign \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Campaign \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | campaign_name | | \| Field label \| Campaign \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Campaign | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| campaign_id \| \| --- \| \| \\| Field label \\| Campaign ID \\| \\| --- \\| --- \\| \\| Description \\| The unique ID for each campaign \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Campaign ID \| \| Description \| The unique ID for each campaign \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | campaign_id | | \| Field label \| Campaign ID \| \| --- \| --- \| \| Description \| The unique ID for each campaign \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Campaign ID | | Description | The unique ID for each campaign | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| campaign_ui_id \| \| --- \| \| \\| Field label \\| Campaign UI ID \\| \\| --- \\| --- \\| \\| Description \\| Converted campaign ID to base-10 to match the UI value \\| \\| Field type \\| dimension \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Campaign UI ID \| \| Description \| Converted campaign ID to base-10 to match the UI value \| \| Field type \| dimension \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | campaign_ui_id | | \| Field label \| Campaign UI ID \| \| --- \| --- \| \| Description \| Converted campaign ID to base-10 to match the UI value \| \| Field type \| dimension \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Campaign UI ID | | Description | Converted campaign ID to base-10 to match the UI value | | Field type | dimension | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| campaign_created_at \| \| --- \| \| \\| Field label \\| Campaign creation date \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Campaign creation date \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | campaign_created_at | | \| Field label \| Campaign creation date \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Campaign creation date | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| campaign_start_time \| \| --- \| \| \\| Field label \\| Campaign start date \\| \\| --- \\| --- \\| \\| Description \\| The date your campaign is scheduled to launch. This field is deprecated by Twitter, please use Ad group start date instead \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Campaign start date \| \| Description \| The date your campaign is scheduled to launch. This field is deprecated by Twitter, please use Ad group start date instead \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | campaign_start_time | | \| Field label \| Campaign start date \| \| --- \| --- \| \| Description \| The date your campaign is scheduled to launch. This field is deprecated by Twitter, please use Ad group start date instead \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Campaign start date | | Description | The date your campaign is scheduled to launch. This field is deprecated by Twitter, please use Ad group start date instead | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| campaign_end_time \| \| --- \| \| \\| Field label \\| Campaign end date \\| \\| --- \\| --- \\| \\| Description \\| The date when the campaign ends. This field is deprecated by Twitter, please use Ad group end date instead \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Campaign end date \| \| Description \| The date when the campaign ends. This field is deprecated by Twitter, please use Ad group end date instead \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | campaign_end_time | | \| Field label \| Campaign end date \| \| --- \| --- \| \| Description \| The date when the campaign ends. This field is deprecated by Twitter, please use Ad group end date instead \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Campaign end date | | Description | The date when the campaign ends. This field is deprecated by Twitter, please use Ad group end date instead | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| campaign_servable \| \| --- \| \| \\| Field label \\| Campaign servable \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \| \| Field label \| Campaign servable \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | campaign_servable | | \| Field label \| Campaign servable \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | Field label | Campaign servable | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | \| campaign_status \| \| --- \| \| \\| Field label \\| Campaign status \\| \\| --- \\| --- \\| \\| Description \\| The campaign status, with possible values ACTIVE, DRAFT, or PAUSED \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Campaign status \| \| Description \| The campaign status, with possible values ACTIVE, DRAFT, or PAUSED \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | campaign_status | | \| Field label \| Campaign status \| \| --- \| --- \| \| Description \| The campaign status, with possible values ACTIVE, DRAFT, or PAUSED \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Campaign status | | Description | The campaign status, with possible values ACTIVE, DRAFT, or PAUSED | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| campaign_deleted \| \| --- \| \| \\| Field label \\| Campaign deleted \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \| \| Field label \| Campaign deleted \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | campaign_deleted | | \| Field label \| Campaign deleted \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | Field label | Campaign deleted | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | \| campaign_currency \| \| --- \| \| \\| Field label \\| Campaign currency \\| \\| --- \\| --- \\| \\| Description \\| The currency used for all spend-related metrics and billing \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.currency.code](/apidocs/field-data-types#currency) \\| \| \| Field label \| Campaign currency \| \| Description \| The currency used for all spend-related metrics and billing \| \| Field type \| dimension \| \| Data type \| [string.currency.code](/apidocs/field-data-types#currency) \| | | campaign_currency | | \| Field label \| Campaign currency \| \| --- \| --- \| \| Description \| The currency used for all spend-related metrics and billing \| \| Field type \| dimension \| \| Data type \| [string.currency.code](/apidocs/field-data-types#currency) \| | | Field label | Campaign currency | | Description | The currency used for all spend-related metrics and billing | | Field type | dimension | | Data type | [string.currency.code](/apidocs/field-data-types#currency) | | \| campaign_standard_delivery \| \| --- \| \| \\| Field label \\| Campaign standard delivery \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \| \| Field label \| Campaign standard delivery \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | campaign_standard_delivery | | \| Field label \| Campaign standard delivery \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| | | Field label | Campaign standard delivery | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | \| campaign_total_budget_amount \| \| --- \| \| \\| Field label \\| Campaign total budget \\| \\| --- \\| --- \\| \\| Description \\| The maximum amount you're willing to spend on each campaign for the duration of the campaign \\| \\| Field type \\| dimension \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Campaign total budget \| \| Description \| The maximum amount you're willing to spend on each campaign for the duration of the campaign \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | campaign_total_budget_amount | | \| Field label \| Campaign total budget \| \| --- \| --- \| \| Description \| The maximum amount you're willing to spend on each campaign for the duration of the campaign \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Campaign total budget | | Description | The maximum amount you're willing to spend on each campaign for the duration of the campaign | | Field type | dimension | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| campaign_daily_budget_amount \| \| --- \| \| \\| Field label \\| Campaign daily budget \\| \\| --- \\| --- \\| \\| Description \\| The maximum amount you're willing to spend on each campaign on average per day \\| \\| Field type \\| dimension \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Campaign daily budget \| \| Description \| The maximum amount you're willing to spend on each campaign on average per day \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | campaign_daily_budget_amount | | \| Field label \| Campaign daily budget \| \| --- \| --- \| \| Description \| The maximum amount you're willing to spend on each campaign on average per day \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Campaign daily budget | | Description | The maximum amount you're willing to spend on each campaign on average per day | | Field type | dimension | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| campaign_budget_optimization \| \| --- \| \| \\| Field label \\| Campaign budget optimization \\| \\| --- \\| --- \\| \\| Description \\| Type of the campaign budget optimization. Possible values - CAMPAIGN and LINE_ITEM \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Campaign budget optimization \| \| Description \| Type of the campaign budget optimization. Possible values - CAMPAIGN and LINE_ITEM \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | campaign_budget_optimization | | \| Field label \| Campaign budget optimization \| \| --- \| --- \| \| Description \| Type of the campaign budget optimization. Possible values - CAMPAIGN and LINE_ITEM \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Campaign budget optimization | | Description | Type of the campaign budget optimization. Possible values - CAMPAIGN and LINE_ITEM | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| placement \| \| --- \| \| \\| Field label \\| Placement \\| \\| --- \\| --- \\| \\| Description \\| Shows whether metrics are pulled for ads that served on or off of X \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Placement \| \| Description \| Shows whether metrics are pulled for ads that served on or off of X \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | placement | | \| Field label \| Placement \| \| --- \| --- \| \| Description \| Shows whether metrics are pulled for ads that served on or off of X \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Placement | | Description | Shows whether metrics are pulled for ads that served on or off of X | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | ### DATASOURCE | \| dataSourceName \| \| --- \| \| \\| Field label \\| Data source \\| \\| --- \\| --- \\| \\| Description \\| The name of the source for this data, as listed on supermetrics.com/docs \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| Destinations \\| API, Data warehouse \\| \| \| Field label \| Data source \| \| Description \| The name of the source for this data, as listed on supermetrics.com/docs \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| Destinations \| API, Data warehouse \| | | --- | | dataSourceName | | \| Field label \| Data source \| \| --- \| --- \| \| Description \| The name of the source for this data, as listed on supermetrics.com/docs \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| Destinations \| API, Data warehouse \| | | Field label | Data source | | Description | The name of the source for this data, as listed on supermetrics.com/docs | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | Destinations | API, Data warehouse | | \| system_metadata.data_source_logins \| \| --- \| \| \\| Field label \\| Data source logins \\| \\| --- \\| --- \\| \\| Description \\| The data source login accounts that were used to authenticate against the data source \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Data source logins \| \| Description \| The data source login accounts that were used to authenticate against the data source \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | system_metadata.data_source_logins | | \| Field label \| Data source logins \| \| --- \| --- \| \| Description \| The data source login accounts that were used to authenticate against the data source \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | Field label | Data source logins | | Description | The data source login accounts that were used to authenticate against the data source | | Field type | dimension | | Data type | [string.text.json](/apidocs/field-data-types#text) | | \| system_metadata.data_source_login_owners \| \| --- \| \| \\| Field label \\| Data source login owners \\| \\| --- \\| --- \\| \\| Description \\| The Supermetrics users that created the data source login connections \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Data source login owners \| \| Description \| The Supermetrics users that created the data source login connections \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | system_metadata.data_source_login_owners | | \| Field label \| Data source login owners \| \| --- \| --- \| \| Description \| The Supermetrics users that created the data source login connections \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | Field label | Data source login owners | | Description | The Supermetrics users that created the data source login connections | | Field type | dimension | | Data type | [string.text.json](/apidocs/field-data-types#text) | ### DEPRECATED | \| promoted_tweet_card_id \| \| --- \| \| \\| Field label \\| Tweet card ID \\| \\| --- \\| --- \\| \\| Description \\| Please note this field will be removed on 2021-08-24 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet card ID \| \| Description \| Please note this field will be removed on 2021-08-24 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | promoted_tweet_card_id | | \| Field label \| Tweet card ID \| \| --- \| --- \| \| Description \| Please note this field will be removed on 2021-08-24 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet card ID | | Description | Please note this field will be removed on 2021-08-24 | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| SIMILAR_TO_FOLLOWERS_OF_USER \| \| --- \| \| \\| Field label \\| Similar to follower \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-07-01 \\| \| \| Field label \| Similar to follower \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | SIMILAR_TO_FOLLOWERS_OF_USER | | \| Field label \| Similar to follower \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | Field label | Similar to follower | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | 🚫 Deprecated | Deprecated on 2026-07-01 | | \| promoted_tweet_card_display_url \| \| --- \| \| \\| Field label \\| Tweet card display URL \\| \\| --- \\| --- \\| \\| Description \\| Please note this field will be removed on 2021-08-24 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet card display URL \| \| Description \| Please note this field will be removed on 2021-08-24 \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | promoted_tweet_card_display_url | | \| Field label \| Tweet card display URL \| \| --- \| --- \| \| Description \| Please note this field will be removed on 2021-08-24 \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Tweet card display URL | | Description | Please note this field will be removed on 2021-08-24 | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| campaign_paused \| \| --- \| \| \\| Field label \\| Campaign paused \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \\| 🚫 Deprecated \\| Deprecated on 2022-11-30 \\| \| \| Field label \| Campaign paused \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| \| 🚫 Deprecated \| Deprecated on 2022-11-30 \| | | campaign_paused | | \| Field label \| Campaign paused \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| \| 🚫 Deprecated \| Deprecated on 2022-11-30 \| | | Field label | Campaign paused | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | 🚫 Deprecated | Deprecated on 2022-11-30 | | \| CITIES \| \| --- \| \| \\| Field label \\| City \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.geo.city](/apidocs/field-data-types#geographical) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-07-01 \\| \| \| Field label \| City \| \| Field type \| dimension \| \| Data type \| [string.geo.city](/apidocs/field-data-types#geographical) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | CITIES | | \| Field label \| City \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.geo.city](/apidocs/field-data-types#geographical) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | Field label | City | | Field type | dimension | | Data type | [string.geo.city](/apidocs/field-data-types#geographical) | | 🚫 Deprecated | Deprecated on 2026-07-01 | | \| audienceSource \| \| --- \| \| \\| Field label \\| Source of audience data \\| \\| --- \\| --- \\| \\| Description \\| The providing party of audience data. Please note this field will be removed on 2020-01-30 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Source of audience data \| \| Description \| The providing party of audience data. Please note this field will be removed on 2020-01-30 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | audienceSource | | \| Field label \| Source of audience data \| \| --- \| --- \| \| Description \| The providing party of audience data. Please note this field will be removed on 2020-01-30 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Source of audience data | | Description | The providing party of audience data. Please note this field will be removed on 2020-01-30 | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| interactionType \| \| --- \| \| \\| Field label \\| Interaction type \\| \\| --- \\| --- \\| \\| Description \\| Type of interaction; applicable to some audience types. Please note this field will be removed on 2020-01-30 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Interaction type \| \| Description \| Type of interaction; applicable to some audience types. Please note this field will be removed on 2020-01-30 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | interactionType | | \| Field label \| Interaction type \| \| --- \| --- \| \| Description \| Type of interaction; applicable to some audience types. Please note this field will be removed on 2020-01-30 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Interaction type | | Description | Type of interaction; applicable to some audience types. Please note this field will be removed on 2020-01-30 | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| EVENTS \| \| --- \| \| \\| Field label \\| Event \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-07-01 \\| \| \| Field label \| Event \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | EVENTS | | \| Field label \| Event \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | Field label | Event | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | 🚫 Deprecated | Deprecated on 2026-07-01 | | \| INTERESTS \| \| --- \| \| \\| Field label \\| Interest \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-07-01 \\| \| \| Field label \| Interest \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | INTERESTS | | \| Field label \| Interest \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | Field label | Interest | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | 🚫 Deprecated | Deprecated on 2026-07-01 | | \| APP_STORE_CATEGORY \| \| --- \| \| \\| Field label \\| App store category \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-07-01 \\| \| \| Field label \| App store category \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | APP_STORE_CATEGORY | | \| Field label \| App store category \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | Field label | App store category | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | 🚫 Deprecated | Deprecated on 2026-07-01 | | \| CONVERSION_TAGS \| \| --- \| \| \\| Field label \\| Conversion tag \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-07-01 \\| \| \| Field label \| Conversion tag \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | CONVERSION_TAGS | | \| Field label \| Conversion tag \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | Field label | Conversion tag | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | 🚫 Deprecated | Deprecated on 2026-07-01 | | \| line_item_tracking_tags \| \| --- \| \| \\| Field label \\| Tracking tags \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| 🚫 Deprecated \\| Deprecated on 2022-02-15 \\| \| \| Field label \| Tracking tags \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2022-02-15 \| | | line_item_tracking_tags | | \| Field label \| Tracking tags \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2022-02-15 \| | | Field label | Tracking tags | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | 🚫 Deprecated | Deprecated on 2022-02-15 | | \| line_item_paused \| \| --- \| \| \\| Field label \\| Ad group paused \\| \\| --- \\| --- \\| \\| Description \\| Formerly called line item paused. \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \\| 🚫 Deprecated \\| Deprecated on 2022-11-30 \\| \| \| Field label \| Ad group paused \| \| Description \| Formerly called line item paused. \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| \| 🚫 Deprecated \| Deprecated on 2022-11-30 \| | | line_item_paused | | \| Field label \| Ad group paused \| \| --- \| --- \| \| Description \| Formerly called line item paused. \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| \| 🚫 Deprecated \| Deprecated on 2022-11-30 \| | | Field label | Ad group paused | | Description | Formerly called line item paused. | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | 🚫 Deprecated | Deprecated on 2022-11-30 | | \| line_item_automatically_select_bid \| \| --- \| \| \\| Field label \\| Automatically select bid \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [bool](/apidocs/field-data-types#primitive) \\| \\| 🚫 Deprecated \\| Deprecated on 2022-02-15 \\| \| \| Field label \| Automatically select bid \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| \| 🚫 Deprecated \| Deprecated on 2022-02-15 \| | | line_item_automatically_select_bid | | \| Field label \| Automatically select bid \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [bool](/apidocs/field-data-types#primitive) \| \| 🚫 Deprecated \| Deprecated on 2022-02-15 \| | | Field label | Automatically select bid | | Field type | dimension | | Data type | [bool](/apidocs/field-data-types#primitive) | | 🚫 Deprecated | Deprecated on 2022-02-15 | | \| line_item_optimization \| \| --- \| \| \\| Field label \\| Optimization \\| \\| --- \\| --- \\| \\| Description \\| Please note this field will be removed on 2021-08-24 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Optimization \| \| Description \| Please note this field will be removed on 2021-08-24 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | line_item_optimization | | \| Field label \| Optimization \| \| --- \| --- \| \| Description \| Please note this field will be removed on 2021-08-24 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Optimization | | Description | Please note this field will be removed on 2021-08-24 | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| KEYWORDS \| \| --- \| \| \\| Field label \\| Keyword \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-07-01 \\| \| \| Field label \| Keyword \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | KEYWORDS | | \| Field label \| Keyword \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | Field label | Keyword | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | 🚫 Deprecated | Deprecated on 2026-07-01 | | \| audienceCategory \| \| --- \| \| \\| Field label \\| Audience category \\| \\| --- \\| --- \\| \\| Description \\| Name of audience category, e.g. White collar worker. Please note this field will be removed on 2020-01-30 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Audience category \| \| Description \| Name of audience category, e.g. White collar worker. Please note this field will be removed on 2020-01-30 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | audienceCategory | | \| Field label \| Audience category \| \| --- \| --- \| \| Description \| Name of audience category, e.g. White collar worker. Please note this field will be removed on 2020-01-30 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Audience category | | Description | Name of audience category, e.g. White collar worker. Please note this field will be removed on 2020-01-30 | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| LANGUAGES \| \| --- \| \| \\| Field label \\| Language \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.language.value](/apidocs/field-data-types#language) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-07-01 \\| \| \| Field label \| Language \| \| Field type \| dimension \| \| Data type \| [string.language.value](/apidocs/field-data-types#language) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | LANGUAGES | | \| Field label \| Language \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.language.value](/apidocs/field-data-types#language) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | Field label | Language | | Field type | dimension | | Data type | [string.language.value](/apidocs/field-data-types#language) | | 🚫 Deprecated | Deprecated on 2026-07-01 | | \| audienceName \| \| --- \| \| \\| Field label \\| Audience name \\| \\| --- \\| --- \\| \\| Description \\| Name of audience, e.g. Occupation. Please note this field will be removed on 2020-01-30 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Audience name \| \| Description \| Name of audience, e.g. Occupation. Please note this field will be removed on 2020-01-30 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | audienceName | | \| Field label \| Audience name \| \| --- \| --- \| \| Description \| Name of audience, e.g. Occupation. Please note this field will be removed on 2020-01-30 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Audience name | | Description | Name of audience, e.g. Occupation. Please note this field will be removed on 2020-01-30 | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| REGIONS \| \| --- \| \| \\| Field label \\| Region \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.geo.region](/apidocs/field-data-types#geographical) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-07-01 \\| \| \| Field label \| Region \| \| Field type \| dimension \| \| Data type \| [string.geo.region](/apidocs/field-data-types#geographical) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | REGIONS | | \| Field label \| Region \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.geo.region](/apidocs/field-data-types#geographical) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | Field label | Region | | Field type | dimension | | Data type | [string.geo.region](/apidocs/field-data-types#geographical) | | 🚫 Deprecated | Deprecated on 2026-07-01 | | \| TV_SHOWS \| \| --- \| \| \\| Field label \\| TV show \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-07-01 \\| \| \| Field label \| TV show \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | TV_SHOWS | | \| Field label \| TV show \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| \| 🚫 Deprecated \| Deprecated on 2026-07-01 \| | | Field label | TV show | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | 🚫 Deprecated | Deprecated on 2026-07-01 | | \| audienceType \| \| --- \| \| \\| Field label \\| Audience type \\| \\| --- \\| --- \\| \\| Description \\| Type of an audience, e.g. ALL_ON_TWITTER. Please note this field will be removed on 2020-01-30 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Audience type \| \| Description \| Type of an audience, e.g. ALL_ON_TWITTER. Please note this field will be removed on 2020-01-30 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | audienceType | | \| Field label \| Audience type \| \| --- \| --- \| \| Description \| Type of an audience, e.g. ALL_ON_TWITTER. Please note this field will be removed on 2020-01-30 \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Audience type | | Description | Type of an audience, e.g. ALL_ON_TWITTER. Please note this field will be removed on 2020-01-30 | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_profile_impressions \| \| --- \| \| \\| Field label \\| Impressions (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Impressions (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_impressions | | \| Field label \| Impressions (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Impressions (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_account_impressions \| \| --- \| \| \\| Field label \\| Impressions (promoted act) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Impressions (promoted act) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_account_impressions | | \| Field label \| Impressions (promoted act) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Impressions (promoted act) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_profile_url_clicks \| \| --- \| \| \\| Field label \\| URL clicks (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| URL clicks (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_url_clicks | | \| Field label \| URL clicks (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | URL clicks (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_profile_favorites \| \| --- \| \| \\| Field label \\| Favorites (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Favorites (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_favorites | | \| Field label \| Favorites (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Favorites (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| mediaViews \| \| --- \| \| \\| Field label \\| Media views \\| \\| --- \\| --- \\| \\| Description \\| Total views (autoplay and click) of your media across videos, Vines, GIFs, and images. This includes views you are not billed for. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Media views \| \| Description \| Total views (autoplay and click) of your media across videos, Vines, GIFs, and images. This includes views you are not billed for. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | mediaViews | | \| Field label \| Media views \| \| --- \| --- \| \| Description \| Total views (autoplay and click) of your media across videos, Vines, GIFs, and images. This includes views you are not billed for. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Media views | | Description | Total views (autoplay and click) of your media across videos, Vines, GIFs, and images. This includes views you are not billed for. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_qualified_impressions \| \| --- \| \| \\| Field label \\| Qualified impressions (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Qualified impressions (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_qualified_impressions | | \| Field label \| Qualified impressions (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Qualified impressions (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| mobile_conversion_installs_post_engagement \| \| --- \| \| \\| Field label \\| Mobile conversion installs post engagement \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Mobile conversion installs post engagement \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | mobile_conversion_installs_post_engagement | | \| Field label \| Mobile conversion installs post engagement \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Mobile conversion installs post engagement | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| CPI \| \| --- \| \| \\| Field label \\| Cost per install (CPI) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Cost per install (CPI) \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | CPI | | \| Field label \| Cost per install (CPI) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Cost per install (CPI) | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| matchRate \| \| --- \| \| \\| Field label \\| Match rate \\| \\| --- \\| --- \\| \\| Description \\| 90 day active Twitter users divided by number of users provided by the source of audience data. Please note this field will be removed on 2020-01-30 \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.percentage](/apidocs/field-data-types#number) \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Match rate \| \| Description \| 90 day active Twitter users divided by number of users provided by the source of audience data. Please note this field will be removed on 2020-01-30 \| \| Field type \| metric \| \| Data type \| [float.number.percentage](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | matchRate | | \| Field label \| Match rate \| \| --- \| --- \| \| Description \| 90 day active Twitter users divided by number of users provided by the source of audience data. Please note this field will be removed on 2020-01-30 \| \| Field type \| metric \| \| Data type \| [float.number.percentage](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Match rate | | Description | 90 day active Twitter users divided by number of users provided by the source of audience data. Please note this field will be removed on 2020-01-30 | | Field type | metric | | Data type | [float.number.percentage](/apidocs/field-data-types#number) | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | | \| percentage \| \| --- \| \| \\| Field label \\| Percentage \\| \\| --- \\| --- \\| \\| Description \\| Representation of a category within an audience. Please note this field will be removed on 2020-01-30 \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.percentage](/apidocs/field-data-types#number) \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Percentage \| \| Description \| Representation of a category within an audience. Please note this field will be removed on 2020-01-30 \| \| Field type \| metric \| \| Data type \| [float.number.percentage](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | percentage | | \| Field label \| Percentage \| \| --- \| --- \| \| Description \| Representation of a category within an audience. Please note this field will be removed on 2020-01-30 \| \| Field type \| metric \| \| Data type \| [float.number.percentage](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Percentage | | Description | Representation of a category within an audience. Please note this field will be removed on 2020-01-30 | | Field type | metric | | Data type | [float.number.percentage](/apidocs/field-data-types#number) | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | | \| video_6s_views \| \| --- \| \| \\| Field label \\| 6s video views \\| \\| --- \\| --- \\| \\| Description \\| Total number of views where at least 6 seconds of the video was viewed. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| 6s video views \| \| Description \| Total number of views where at least 6 seconds of the video was viewed. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | video_6s_views | | \| Field label \| 6s video views \| \| --- \| --- \| \| Description \| Total number of views where at least 6 seconds of the video was viewed. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | 6s video views | | Description | Total number of views where at least 6 seconds of the video was viewed. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| mobile_conversion_installs_post_view \| \| --- \| \| \\| Field label \\| Mobile conversion installs post view \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Mobile conversion installs post view \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | mobile_conversion_installs_post_view | | \| Field label \| Mobile conversion installs post view \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Mobile conversion installs post view | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| leads \| \| --- \| \| \\| Field label \\| Leads (deprecated) \\| \\| --- \\| --- \\| \\| Description \\| The number of leads you acquired as a result of a user submitting their contact information on Twitter through the Lead Generation Card. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Leads (deprecated) \| \| Description \| The number of leads you acquired as a result of a user submitting their contact information on Twitter through the Lead Generation Card. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | leads | | \| Field label \| Leads (deprecated) \| \| --- \| --- \| \| Description \| The number of leads you acquired as a result of a user submitting their contact information on Twitter through the Lead Generation Card. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Leads (deprecated) | | Description | The number of leads you acquired as a result of a user submitting their contact information on Twitter through the Lead Generation Card. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_url_clicks \| \| --- \| \| \\| Field label \\| URL clicks (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| URL clicks (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_url_clicks | | \| Field label \| URL clicks (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | URL clicks (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| app_clicks \| \| --- \| \| \\| Field label \\| App clicks \\| \\| --- \\| --- \\| \\| Description \\| Total number of clicks to install or open your app. This includes earned clicks that you're not billed for. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| App clicks \| \| Description \| Total number of clicks to install or open your app. This includes earned clicks that you're not billed for. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | app_clicks | | \| Field label \| App clicks \| \| --- \| --- \| \| Description \| Total number of clicks to install or open your app. This includes earned clicks that you're not billed for. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | App clicks | | Description | Total number of clicks to install or open your app. This includes earned clicks that you're not billed for. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_retweets \| \| --- \| \| \\| Field label \\| Retweets (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Retweets (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_retweets | | \| Field label \| Retweets (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Retweets (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_engagements \| \| --- \| \| \\| Field label \\| Engagements (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Engagements (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_engagements | | \| Field label \| Engagements (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Engagements (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_replies \| \| --- \| \| \\| Field label \\| Replies (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Replies (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_replies | | \| Field label \| Replies (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Replies (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_profile_media_views \| \| --- \| \| \\| Field label \\| Media views (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Media views (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_media_views | | \| Field label \| Media views (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Media views (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_impressions \| \| --- \| \| \\| Field label \\| Impressions (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Impressions (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_impressions | | \| Field label \| Impressions (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Impressions (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_profile_replies \| \| --- \| \| \\| Field label \\| Replies (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Replies (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_replies | | \| Field label \| Replies (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Replies (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_follows \| \| --- \| \| \\| Field label \\| Follows (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Follows (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_follows | | \| Field label \| Follows (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Follows (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_profile_clicks \| \| --- \| \| \\| Field label \\| Clicks (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Clicks (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_clicks | | \| Field label \| Clicks (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Clicks (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_favorites \| \| --- \| \| \\| Field label \\| Favorites (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Favorites (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_favorites | | \| Field label \| Favorites (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Favorites (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_retweets \| \| --- \| \| \\| Field label \\| Tweet retweets \\| \\| --- \\| --- \\| \\| Description \\| The number of people that Retweeted your ad by clicking the Retweet button. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Tweet retweets \| \| Description \| The number of people that Retweeted your ad by clicking the Retweet button. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_retweets | | \| Field label \| Tweet retweets \| \| --- \| --- \| \| Description \| The number of people that Retweeted your ad by clicking the Retweet button. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Tweet retweets | | Description | The number of people that Retweeted your ad by clicking the Retweet button. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_clicks \| \| --- \| \| \\| Field label \\| Clicks (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Clicks (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_clicks | | \| Field label \| Clicks (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Clicks (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_account_follows \| \| --- \| \| \\| Field label \\| Follows (promoted act) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Follows (promoted act) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_account_follows | | \| Field label \| Follows (promoted act) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Follows (promoted act) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_engagements \| \| --- \| \| \\| Field label \\| Engagements (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Engagements (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_engagements | | \| Field label \| Engagements (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Engagements (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| CPL \| \| --- \| \| \\| Field label \\| Cost per lead \\| \\| --- \\| --- \\| \\| Description \\| Total spend divided by the number of leads, including earned. You only pay for leads generated by your ad. \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Cost per lead \| \| Description \| Total spend divided by the number of leads, including earned. You only pay for leads generated by your ad. \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | CPL | | \| Field label \| Cost per lead \| \| --- \| --- \| \| Description \| Total spend divided by the number of leads, including earned. You only pay for leads generated by your ad. \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Cost per lead | | Description | Total spend divided by the number of leads, including earned. You only pay for leads generated by your ad. | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_engagement_rate \| \| --- \| \| \\| Field label \\| Engagement rate (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Engagement rate (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | promoted_tweet_tpn_engagement_rate | | \| Field label \| Engagement rate (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Engagement rate (TPN) (deprecated) | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | | \| followersRate \| \| --- \| \| \\| Field label \\| Followers rate (%) \\| \\| --- \\| --- \\| \\| Description \\| Total followers divided by total impressions. This helps you understand how well your ad is attracting new followers. \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Followers rate (%) \| \| Description \| Total followers divided by total impressions. This helps you understand how well your ad is attracting new followers. \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | followersRate | | \| Field label \| Followers rate (%) \| \| --- \| --- \| \| Description \| Total followers divided by total impressions. This helps you understand how well your ad is attracting new followers. \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Followers rate (%) | | Description | Total followers divided by total impressions. This helps you understand how well your ad is attracting new followers. | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_card_engagements \| \| --- \| \| \\| Field label \\| Card engagements (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Card engagements (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_card_engagements | | \| Field label \| Card engagements (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Card engagements (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| app_install_rate \| \| --- \| \| \\| Field label \\| App install rate (%) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| App install rate (%) \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | app_install_rate | | \| Field label \| App install rate (%) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | App install rate (%) | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_qualified_impressions \| \| --- \| \| \\| Field label \\| Qualified impressions (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Qualified impressions (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_qualified_impressions | | \| Field label \| Qualified impressions (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Qualified impressions (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| url_clicks \| \| --- \| \| \\| Field label \\| URL clicks \\| \\| --- \\| --- \\| \\| Description \\| Total clicks on the link or Website Card in your ad, including earned. This includes clicks you're not billed for. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| URL clicks \| \| Description \| Total clicks on the link or Website Card in your ad, including earned. This includes clicks you're not billed for. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | url_clicks | | \| Field label \| URL clicks \| \| --- \| --- \| \| Description \| Total clicks on the link or Website Card in your ad, including earned. This includes clicks you're not billed for. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | URL clicks | | Description | Total clicks on the link or Website Card in your ad, including earned. This includes clicks you're not billed for. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_tpn_media_views \| \| --- \| \| \\| Field label \\| Media views (TPN) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Media views (TPN) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_tpn_media_views | | \| Field label \| Media views (TPN) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Media views (TPN) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_engagement_rate \| \| --- \| \| \\| Field label \\| Engagement rate (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Engagement rate (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | promoted_tweet_search_engagement_rate | | \| Field label \| Engagement rate (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Engagement rate (search) (deprecated) | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | | \| promoted_tweet_timeline_card_engagements \| \| --- \| \| \\| Field label \\| Card engagements (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Card engagements (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_card_engagements | | \| Field label \| Card engagements (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Card engagements (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_clicks \| \| --- \| \| \\| Field label \\| Clicks (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Clicks (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_clicks | | \| Field label \| Clicks (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Clicks (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_timeline_media_views \| \| --- \| \| \\| Field label \\| Media views (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Media views (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_media_views | | \| Field label \| Media views (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Media views (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_impressions \| \| --- \| \| \\| Field label \\| Impressions (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Impressions (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_impressions | | \| Field label \| Impressions (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Impressions (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_timeline_url_clicks \| \| --- \| \| \\| Field label \\| URL clicks (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| URL clicks (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_url_clicks | | \| Field label \| URL clicks (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | URL clicks (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_profile_card_engagements \| \| --- \| \| \\| Field label \\| Card engagements (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Card engagements (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_card_engagements | | \| Field label \| Card engagements (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Card engagements (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_timeline_retweets \| \| --- \| \| \\| Field label \\| Retweets (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Retweets (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_retweets | | \| Field label \| Retweets (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Retweets (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_profile_retweets \| \| --- \| \| \\| Field label \\| Retweets (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Retweets (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_retweets | | \| Field label \| Retweets (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Retweets (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_timeline_replies \| \| --- \| \| \\| Field label \\| Replies (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Replies (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_replies | | \| Field label \| Replies (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Replies (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_profile_follows \| \| --- \| \| \\| Field label \\| Follows (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Follows (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_follows | | \| Field label \| Follows (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Follows (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_timeline_follows \| \| --- \| \| \\| Field label \\| Follows (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Follows (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_follows | | \| Field label \| Follows (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Follows (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_profile_engagements \| \| --- \| \| \\| Field label \\| Engagements (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Engagements (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_engagements | | \| Field label \| Engagements (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Engagements (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_timeline_favorites \| \| --- \| \| \\| Field label \\| Favorites (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Favorites (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_favorites | | \| Field label \| Favorites (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Favorites (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_profile_qualified_impressions \| \| --- \| \| \\| Field label \\| Qualified impressions (profile) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Qualified impressions (profile) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_profile_qualified_impressions | | \| Field label \| Qualified impressions (profile) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Qualified impressions (profile) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_timeline_engagement_rate \| \| --- \| \| \\| Field label \\| Engagement rate (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Engagement rate (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | promoted_tweet_timeline_engagement_rate | | \| Field label \| Engagement rate (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Engagement rate (timeline) (deprecated) | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | | \| promoted_tweet_likes \| \| --- \| \| \\| Field label \\| Likes (paid+organic) \\| \\| --- \\| --- \\| \\| Description \\| The number of people who liked your ad by clicking the heart button. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Likes (paid+organic) \| \| Description \| The number of people who liked your ad by clicking the heart button. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_likes | | \| Field label \| Likes (paid+organic) \| \| --- \| --- \| \| Description \| The number of people who liked your ad by clicking the heart button. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Likes (paid+organic) | | Description | The number of people who liked your ad by clicking the heart button. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_timeline_engagements \| \| --- \| \| \\| Field label \\| Engagements (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Engagements (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_engagements | | \| Field label \| Engagements (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Engagements (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_account_profile_visits \| \| --- \| \| \\| Field label \\| Profile visits (promoted act) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Profile visits (promoted act) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_account_profile_visits | | \| Field label \| Profile visits (promoted act) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Profile visits (promoted act) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_timeline_clicks \| \| --- \| \| \\| Field label \\| Clicks (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Clicks (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_clicks | | \| Field label \| Clicks (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Clicks (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_account_follow_rate \| \| --- \| \| \\| Field label \\| Follow rate (promoted act) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Follow rate (promoted act) \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | promoted_account_follow_rate | | \| Field label \| Follow rate (promoted act) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Follow rate (promoted act) | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | | \| promoted_tweet_timeline_qualified_impressions \| \| --- \| \| \\| Field label \\| Qualified impressions (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Qualified impressions (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_qualified_impressions | | \| Field label \| Qualified impressions (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Qualified impressions (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| video_15s_views \| \| --- \| \| \\| Field label \\| 15s video views \\| \\| --- \\| --- \\| \\| Description \\| Total number of views where at least 15 seconds of the video or for 95% of the total duration was viewed. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| 15s video views \| \| Description \| Total number of views where at least 15 seconds of the video or for 95% of the total duration was viewed. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | video_15s_views | | \| Field label \| 15s video views \| \| --- \| --- \| \| Description \| Total number of views where at least 15 seconds of the video or for 95% of the total duration was viewed. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | 15s video views | | Description | Total number of views where at least 15 seconds of the video or for 95% of the total duration was viewed. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_timeline_impressions \| \| --- \| \| \\| Field label \\| Impressions (timeline) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Impressions (timeline) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_timeline_impressions | | \| Field label \| Impressions (timeline) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Impressions (timeline) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_video_cta_clicks \| \| --- \| \| \\| Field label \\| Video CTA clicks \\| \\| --- \\| --- \\| \\| Description \\| Total clicks on the call to action in the video player. This includes clicks you are not billed for. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Video CTA clicks \| \| Description \| Total clicks on the call to action in the video player. This includes clicks you are not billed for. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_video_cta_clicks | | \| Field label \| Video CTA clicks \| \| --- \| --- \| \| Description \| Total clicks on the call to action in the video player. This includes clicks you are not billed for. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Video CTA clicks | | Description | Total clicks on the call to action in the video player. This includes clicks you are not billed for. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_media_views \| \| --- \| \| \\| Field label \\| Media views (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Media views (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_media_views | | \| Field label \| Media views (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Media views (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| lead_rate \| \| --- \| \| \\| Field label \\| Lead rate (%) \\| \\| --- \\| --- \\| \\| Description \\| Total leads divided by the number of impressions, including earned. You only pay the first time a user submits a Lead Generation Card. \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Lead rate (%) \| \| Description \| Total leads divided by the number of impressions, including earned. You only pay the first time a user submits a Lead Generation Card. \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | lead_rate | | \| Field label \| Lead rate (%) \| \| --- \| --- \| \| Description \| Total leads divided by the number of impressions, including earned. You only pay the first time a user submits a Lead Generation Card. \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Lead rate (%) | | Description | Total leads divided by the number of impressions, including earned. You only pay the first time a user submits a Lead Generation Card. | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_card_engagements \| \| --- \| \| \\| Field label \\| Card engagements (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Card engagements (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_card_engagements | | \| Field label \| Card engagements (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Card engagements (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| CPF \| \| --- \| \| \\| Field label \\| Cost per follower (CPF) \\| \\| --- \\| --- \\| \\| Description \\| Total spend divided by the number of followers, including earned. You only pay when someone follows you. \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Cost per follower (CPF) \| \| Description \| Total spend divided by the number of followers, including earned. You only pay when someone follows you. \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | CPF | | \| Field label \| Cost per follower (CPF) \| \| --- \| --- \| \| Description \| Total spend divided by the number of followers, including earned. You only pay when someone follows you. \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Cost per follower (CPF) | | Description | Total spend divided by the number of followers, including earned. You only pay when someone follows you. | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_url_clicks \| \| --- \| \| \\| Field label \\| URL clicks (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| URL clicks (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_url_clicks | | \| Field label \| URL clicks (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | URL clicks (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| followers \| \| --- \| \| \\| Field label \\| Followers \\| \\| --- \\| --- \\| \\| Description \\| Total number of followers generated from your Tweet, including earned. If you're running a followers campaign, this number also reflects follows from other locations, including Who to follow. You only pay the first time someone follows you. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Followers \| \| Description \| Total number of followers generated from your Tweet, including earned. If you're running a followers campaign, this number also reflects follows from other locations, including Who to follow. You only pay the first time someone follows you. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | followers | | \| Field label \| Followers \| \| --- \| --- \| \| Description \| Total number of followers generated from your Tweet, including earned. If you're running a followers campaign, this number also reflects follows from other locations, including Who to follow. You only pay the first time someone follows you. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Followers | | Description | Total number of followers generated from your Tweet, including earned. If you're running a followers campaign, this number also reflects follows from other locations, including Who to follow. You only pay the first time someone follows you. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_retweets \| \| --- \| \| \\| Field label \\| Retweets (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Retweets (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_retweets | | \| Field label \| Retweets (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Retweets (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| CPAC \| \| --- \| \| \\| Field label \\| Cost per app click (CPAC) \\| \\| --- \\| --- \\| \\| Description \\| Total spend divided by the number of app clicks, including earned. You only pay the first time someone clicks to install or open your app. \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Cost per app click (CPAC) \| \| Description \| Total spend divided by the number of app clicks, including earned. You only pay the first time someone clicks to install or open your app. \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | CPAC | | \| Field label \| Cost per app click (CPAC) \| \| --- \| --- \| \| Description \| Total spend divided by the number of app clicks, including earned. You only pay the first time someone clicks to install or open your app. \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Cost per app click (CPAC) | | Description | Total spend divided by the number of app clicks, including earned. You only pay the first time someone clicks to install or open your app. | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_replies \| \| --- \| \| \\| Field label \\| Replies (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Replies (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_replies | | \| Field label \| Replies (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Replies (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| app_click_rate \| \| --- \| \| \\| Field label \\| App click rate (%) \\| \\| --- \\| --- \\| \\| Description \\| Total number of app clicks divided by impressions. \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| App click rate (%) \| \| Description \| Total number of app clicks divided by impressions. \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | app_click_rate | | \| Field label \| App click rate (%) \| \| --- \| --- \| \| Description \| Total number of app clicks divided by impressions. \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | App click rate (%) | | Description | Total number of app clicks divided by impressions. | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_follows \| \| --- \| \| \\| Field label \\| Follows (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Follows (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_follows | | \| Field label \| Follows (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Follows (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| card_engagements \| \| --- \| \| \\| Field label \\| Card engagements \\| \\| --- \\| --- \\| \\| Description \\| Total number of card engagements. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Card engagements \| \| Description \| Total number of card engagements. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | card_engagements | | \| Field label \| Card engagements \| \| --- \| --- \| \| Description \| Total number of card engagements. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Card engagements | | Description | Total number of card engagements. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| promoted_tweet_search_favorites \| \| --- \| \| \\| Field label \\| favorites (search) (deprecated) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| favorites (search) (deprecated) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | promoted_tweet_search_favorites | | \| Field label \| favorites (search) (deprecated) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | favorites (search) (deprecated) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| mediaViewRate \| \| --- \| \| \\| Field label \\| Media view rate \\| \\| --- \\| --- \\| \\| Description \\| Total media views divided by number of impressions. \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Media view rate \| \| Description \| Total media views divided by number of impressions. \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | mediaViewRate | | \| Field label \| Media view rate \| \| --- \| --- \| \| Description \| Total media views divided by number of impressions. \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Media view rate | | Description | Total media views divided by number of impressions. | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | | \| media_engagements \| \| --- \| \| \\| Field label \\| Media engagements \\| \\| --- \\| --- \\| \\| Description \\| Total number of clicks of media across videos, Vines, GIFs, and images. \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| 🚫 Deprecated \\| Deprecated on 2026-04-29 \\| \| \| Field label \| Media engagements \| \| Description \| Total number of clicks of media across videos, Vines, GIFs, and images. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | media_engagements | | \| Field label \| Media engagements \| \| --- \| --- \| \| Description \| Total number of clicks of media across videos, Vines, GIFs, and images. \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| 🚫 Deprecated \| Deprecated on 2026-04-29 \| | | Field label | Media engagements | | Description | Total number of clicks of media across videos, Vines, GIFs, and images. | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | 🚫 Deprecated | Deprecated on 2026-04-29 | ### ENGAGEMENTS | \| engagements \| \| --- \| \| \\| Field label \\| Engagements \\| \\| --- \\| --- \\| \\| Description \\| All clicks on your Tweet, including Retweets, replies, likes, poll votes, and hashtag clicks. This includes earned clicks that you're not billed for \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Engagements \| \| Description \| All clicks on your Tweet, including Retweets, replies, likes, poll votes, and hashtag clicks. This includes earned clicks that you're not billed for \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | --- | | engagements | | \| Field label \| Engagements \| \| --- \| --- \| \| Description \| All clicks on your Tweet, including Retweets, replies, likes, poll votes, and hashtag clicks. This includes earned clicks that you're not billed for \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Engagements | | Description | All clicks on your Tweet, including Retweets, replies, likes, poll votes, and hashtag clicks. This includes earned clicks that you're not billed for | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| billed_engagements \| \| --- \| \| \\| Field label \\| Engagements (billed) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Engagements (billed) \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | billed_engagements | | \| Field label \| Engagements (billed) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Engagements (billed) | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| CPE \| \| --- \| \| \\| Field label \\| Cost per engagement (CPE) \\| \\| --- \\| --- \\| \\| Description \\| Total spend divided by the number of Tweet engagements, including earned. You only pay the first time someone engages with your ad (e.g. Retweets, replies, likes, or other clicks) \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Cost per engagement (CPE) \| \| Description \| Total spend divided by the number of Tweet engagements, including earned. You only pay the first time someone engages with your ad (e.g. Retweets, replies, likes, or other clicks) \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | CPE | | \| Field label \| Cost per engagement (CPE) \| \| --- \| --- \| \| Description \| Total spend divided by the number of Tweet engagements, including earned. You only pay the first time someone engages with your ad (e.g. Retweets, replies, likes, or other clicks) \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Cost per engagement (CPE) | | Description | Total spend divided by the number of Tweet engagements, including earned. You only pay the first time someone engages with your ad (e.g. Retweets, replies, likes, or other clicks) | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| engagementsRate \| \| --- \| \| \\| Field label \\| Engagements rate (%) \\| \\| --- \\| --- \\| \\| Description \\| Tweet engagements divided by impressions. This helps you understand the rate of engagements with your ad \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Engagements rate (%) \| \| Description \| Tweet engagements divided by impressions. This helps you understand the rate of engagements with your ad \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | engagementsRate | | \| Field label \| Engagements rate (%) \| \| --- \| --- \| \| Description \| Tweet engagements divided by impressions. This helps you understand the rate of engagements with your ad \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Engagements rate (%) | | Description | Tweet engagements divided by impressions. This helps you understand the rate of engagements with your ad | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | \| likes \| \| --- \| \| \\| Field label \\| Likes \\| \\| --- \\| --- \\| \\| Description \\| The number of people who liked your ad by clicking the heart button \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Likes \| \| Description \| The number of people who liked your ad by clicking the heart button \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | likes | | \| Field label \| Likes \| \| --- \| --- \| \| Description \| The number of people who liked your ad by clicking the heart button \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Likes | | Description | The number of people who liked your ad by clicking the heart button | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| retweets \| \| --- \| \| \\| Field label \\| Retweets \\| \\| --- \\| --- \\| \\| Description \\| The number of people that Retweeted your ad by clicking the Retweet button \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Retweets \| \| Description \| The number of people that Retweeted your ad by clicking the Retweet button \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | retweets | | \| Field label \| Retweets \| \| --- \| --- \| \| Description \| The number of people that Retweeted your ad by clicking the Retweet button \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Retweets | | Description | The number of people that Retweeted your ad by clicking the Retweet button | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| replies \| \| --- \| \| \\| Field label \\| Replies \\| \\| --- \\| --- \\| \\| Description \\| The number of people that responded to your Tweet by clicking the reply button \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Replies \| \| Description \| The number of people that responded to your Tweet by clicking the reply button \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | replies | | \| Field label \| Replies \| \| --- \| --- \| \| Description \| The number of people that responded to your Tweet by clicking the reply button \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Replies | | Description | The number of people that responded to your Tweet by clicking the reply button | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| follows \| \| --- \| \| \\| Field label \\| Follows \\| \\| --- \\| --- \\| \\| Description \\| Total number of followers generated from your Tweet, including earned. If you're running a followers campaign, this number also reflects follows from other locations, including Who to follow. You only pay the first time someone follows you \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Follows \| \| Description \| Total number of followers generated from your Tweet, including earned. If you're running a followers campaign, this number also reflects follows from other locations, including Who to follow. You only pay the first time someone follows you \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | follows | | \| Field label \| Follows \| \| --- \| --- \| \| Description \| Total number of followers generated from your Tweet, including earned. If you're running a followers campaign, this number also reflects follows from other locations, including Who to follow. You only pay the first time someone follows you \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Follows | | Description | Total number of followers generated from your Tweet, including earned. If you're running a followers campaign, this number also reflects follows from other locations, including Who to follow. You only pay the first time someone follows you | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| qualified_impressions \| \| --- \| \| \\| Field label \\| Qualified impressions \\| \\| --- \\| --- \\| \\| Description \\| Total number of qualified impressions \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Qualified impressions \| \| Description \| Total number of qualified impressions \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | qualified_impressions | | \| Field label \| Qualified impressions \| \| --- \| --- \| \| Description \| Total number of qualified impressions \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Qualified impressions | | Description | Total number of qualified impressions | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | ### FUNDING INSTRUMENTS | \| funding_instrument_id \| \| --- \| \| \\| Field label \\| Funding instrument ID \\| \\| --- \\| --- \\| \\| Description \\| A reference to the funding instrument \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Funding instrument ID \| \| Description \| A reference to the funding instrument \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | funding_instrument_id | | \| Field label \| Funding instrument ID \| \| --- \| --- \| \| Description \| A reference to the funding instrument \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Funding instrument ID | | Description | A reference to the funding instrument | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| funding_instrument_ui_id \| \| --- \| \| \\| Field label \\| Funding instrument UI ID \\| \\| --- \\| --- \\| \\| Description \\| Converted funding instrument ID to base-10 to match the UI value \\| \\| Field type \\| dimension \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Funding instrument UI ID \| \| Description \| Converted funding instrument ID to base-10 to match the UI value \| \| Field type \| dimension \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | funding_instrument_ui_id | | \| Field label \| Funding instrument UI ID \| \| --- \| --- \| \| Description \| Converted funding instrument ID to base-10 to match the UI value \| \| Field type \| dimension \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Funding instrument UI ID | | Description | Converted funding instrument ID to base-10 to match the UI value | | Field type | dimension | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| funding_instrument_description \| \| --- \| \| \\| Field label \\| Funding instrument description \\| \\| --- \\| --- \\| \\| Description \\| Funding instrument description \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Funding instrument description \| \| Description \| Funding instrument description \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | funding_instrument_description | | \| Field label \| Funding instrument description \| \| --- \| --- \| \| Description \| Funding instrument description \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Funding instrument description | | Description | Funding instrument description | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| funding_instrument_type \| \| --- \| \| \\| Field label \\| Funding instrument type \\| \\| --- \\| --- \\| \\| Description \\| Funding instrument type \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Funding instrument type \| \| Description \| Funding instrument type \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | funding_instrument_type | | \| Field label \| Funding instrument type \| \| --- \| --- \| \| Description \| Funding instrument type \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Funding instrument type | | Description | Funding instrument type | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| funding_instrument_status \| \| --- \| \| \\| Field label \\| Funding instrument status \\| \\| --- \\| --- \\| \\| Description \\| Funding instrument status \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Funding instrument status \| \| Description \| Funding instrument status \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | funding_instrument_status | | \| Field label \| Funding instrument status \| \| --- \| --- \| \| Description \| Funding instrument status \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Funding instrument status | | Description | Funding instrument status | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| funding_instrument_currency \| \| --- \| \| \\| Field label \\| Funding instrument currency \\| \\| --- \\| --- \\| \\| Description \\| Funding instrument currency \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Funding instrument currency \| \| Description \| Funding instrument currency \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | funding_instrument_currency | | \| Field label \| Funding instrument currency \| \| --- \| --- \| \| Description \| Funding instrument currency \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Funding instrument currency | | Description | Funding instrument currency | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| funding_instrument_start_date \| \| --- \| \| \\| Field label \\| Funding instrument start date \\| \\| --- \\| --- \\| \\| Description \\| The date for the funding instrument to become active and usable \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Funding instrument start date \| \| Description \| The date for the funding instrument to become active and usable \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | funding_instrument_start_date | | \| Field label \| Funding instrument start date \| \| --- \| --- \| \| Description \| The date for the funding instrument to become active and usable \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Funding instrument start date | | Description | The date for the funding instrument to become active and usable | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| funding_instrument_end_date \| \| --- \| \| \\| Field label \\| Funding instrument end date \\| \\| --- \\| --- \\| \\| Description \\| The date for the funding instrument to become inactive \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Funding instrument end date \| \| Description \| The date for the funding instrument to become inactive \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | funding_instrument_end_date | | \| Field label \| Funding instrument end date \| \| --- \| --- \| \| Description \| The date for the funding instrument to become inactive \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Funding instrument end date | | Description | The date for the funding instrument to become inactive | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| funding_instrument_credit_limit \| \| --- \| \| \\| Field label \\| Funding instrument credit limit \\| \\| --- \\| --- \\| \\| Description \\| The total credit available against funding instrument \\| \\| Field type \\| dimension \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Funding instrument credit limit \| \| Description \| The total credit available against funding instrument \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | funding_instrument_credit_limit | | \| Field label \| Funding instrument credit limit \| \| --- \| --- \| \| Description \| The total credit available against funding instrument \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Funding instrument credit limit | | Description | The total credit available against funding instrument | | Field type | dimension | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| funding_instrument_funded_amount \| \| --- \| \| \\| Field label \\| Funding instrument funded amount \\| \\| --- \\| --- \\| \\| Description \\| The total budget amount allocated to funding instrument \\| \\| Field type \\| dimension \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Funding instrument funded amount \| \| Description \| The total budget amount allocated to funding instrument \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | funding_instrument_funded_amount | | \| Field label \| Funding instrument funded amount \| \| --- \| --- \| \| Description \| The total budget amount allocated to funding instrument \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Funding instrument funded amount | | Description | The total budget amount allocated to funding instrument | | Field type | dimension | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| funding_instrument_credit_remaining \| \| --- \| \| \\| Field label \\| Funding instrument credit remaining \\| \\| --- \\| --- \\| \\| Description \\| The total credit remaining to funding instrument \\| \\| Field type \\| dimension \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Funding instrument credit remaining \| \| Description \| The total credit remaining to funding instrument \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | funding_instrument_credit_remaining | | \| Field label \| Funding instrument credit remaining \| \| --- \| --- \| \| Description \| The total credit remaining to funding instrument \| \| Field type \| dimension \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Funding instrument credit remaining | | Description | The total credit remaining to funding instrument | | Field type | dimension | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| funding_instrument_reasons_not_able_to_fund \| \| --- \| \| \\| Field label \\| Reasons funding instrument was not able to fund \\| \\| --- \\| --- \\| \\| Description \\| Reasons funding instrument was not able to fund \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Reasons funding instrument was not able to fund \| \| Description \| Reasons funding instrument was not able to fund \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | funding_instrument_reasons_not_able_to_fund | | \| Field label \| Reasons funding instrument was not able to fund \| \| --- \| --- \| \| Description \| Reasons funding instrument was not able to fund \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Reasons funding instrument was not able to fund | | Description | Reasons funding instrument was not able to fund | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| funding_instrument_io_header \| \| --- \| \| \\| Field label \\| Insertion order header ID \\| \\| --- \\| --- \\| \\| Description \\| ID for the associated insertion order. Note that a single ID may be associated with multiple funding instruments \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Insertion order header ID \| \| Description \| ID for the associated insertion order. Note that a single ID may be associated with multiple funding instruments \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | funding_instrument_io_header | | \| Field label \| Insertion order header ID \| \| --- \| --- \| \| Description \| ID for the associated insertion order. Note that a single ID may be associated with multiple funding instruments \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Insertion order header ID | | Description | ID for the associated insertion order. Note that a single ID may be associated with multiple funding instruments | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | ### GENERAL METRICS | \| impressions \| \| --- \| \| \\| Field label \\| Impressions \\| \\| --- \\| --- \\| \\| Description \\| The number of times your ad is shown to users, including earned \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Impressions \| \| Description \| The number of times your ad is shown to users, including earned \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | --- | | impressions | | \| Field label \| Impressions \| \| --- \| --- \| \| Description \| The number of times your ad is shown to users, including earned \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Impressions | | Description | The number of times your ad is shown to users, including earned | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| cost \| \| --- \| \| \\| Field label \\| Cost \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Cost \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | cost | | \| Field label \| Cost \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Cost | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| cost_eur \| \| --- \| \| \\| Field label \\| Cost (EUR) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \\| Services \\| [Currency conversion](/apidocs/field-data-services#currency-conversion) \\| \| \| Field label \| Cost (EUR) \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| Services \| [Currency conversion](/apidocs/field-data-services#currency-conversion) \| | | cost_eur | | \| Field label \| Cost (EUR) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| Services \| [Currency conversion](/apidocs/field-data-services#currency-conversion) \| | | Field label | Cost (EUR) | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | Services | [Currency conversion](/apidocs/field-data-services#currency-conversion) | | \| cost_usd \| \| --- \| \| \\| Field label \\| Cost (USD) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \\| Services \\| [Currency conversion](/apidocs/field-data-services#currency-conversion) \\| \| \| Field label \| Cost (USD) \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| Services \| [Currency conversion](/apidocs/field-data-services#currency-conversion) \| | | cost_usd | | \| Field label \| Cost (USD) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| Services \| [Currency conversion](/apidocs/field-data-services#currency-conversion) \| | | Field label | Cost (USD) | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | Services | [Currency conversion](/apidocs/field-data-services#currency-conversion) | | \| cost_gbp \| \| --- \| \| \\| Field label \\| Cost (GBP) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \\| Services \\| [Currency conversion](/apidocs/field-data-services#currency-conversion) \\| \| \| Field label \| Cost (GBP) \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| Services \| [Currency conversion](/apidocs/field-data-services#currency-conversion) \| | | cost_gbp | | \| Field label \| Cost (GBP) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| \| Services \| [Currency conversion](/apidocs/field-data-services#currency-conversion) \| | | Field label | Cost (GBP) | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | Services | [Currency conversion](/apidocs/field-data-services#currency-conversion) | | \| CPM \| \| --- \| \| \\| Field label \\| CPM \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| CPM \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | CPM | | \| Field label \| CPM \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | CPM | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| conversions \| \| --- \| \| \\| Field label \\| Conversions \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Conversions \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | conversions | | \| Field label \| Conversions \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Conversions | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| conversionRate \| \| --- \| \| \\| Field label \\| Conversion rate (%) \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Conversion rate (%) \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | conversionRate | | \| Field label \| Conversion rate (%) \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Conversion rate (%) | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | ### MEDIA CREATIVE | \| media_creative_id \| \| --- \| \| \\| Field label \\| Media creative ID \\| \\| --- \\| --- \\| \\| Description \\| ID of the media creative \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Media creative ID \| \| Description \| ID of the media creative \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | media_creative_id | | \| Field label \| Media creative ID \| \| --- \| --- \| \| Description \| ID of the media creative \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Media creative ID | | Description | ID of the media creative | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| media_creative_created_at \| \| --- \| \| \\| Field label \\| Media creative creation date \\| \\| --- \\| --- \\| \\| Description \\| Creation date of the media creative \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Media creative creation date \| \| Description \| Creation date of the media creative \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | media_creative_created_at | | \| Field label \| Media creative creation date \| \| --- \| --- \| \| Description \| Creation date of the media creative \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Media creative creation date | | Description | Creation date of the media creative | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| media_creative_type \| \| --- \| \| \\| Field label \\| Media creative type \\| \\| --- \\| --- \\| \\| Description \\| Type of the media creative \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Media creative type \| \| Description \| Type of the media creative \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | media_creative_type | | \| Field label \| Media creative type \| \| --- \| --- \| \| Description \| Type of the media creative \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Media creative type | | Description | Type of the media creative | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| media_name \| \| --- \| \| \\| Field label \\| Media name \\| \\| --- \\| --- \\| \\| Description \\| Name of the media object \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Media name \| \| Description \| Name of the media object \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | media_name | | \| Field label \| Media name \| \| --- \| --- \| \| Description \| Name of the media object \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Media name | | Description | Name of the media object | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| media_url \| \| --- \| \| \\| Field label \\| Media url \\| \\| --- \\| --- \\| \\| Description \\| URL to the media object \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Media url \| \| Description \| URL to the media object \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | media_url | | \| Field label \| Media url \| \| --- \| --- \| \| Description \| URL to the media object \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Media url | | Description | URL to the media object | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | ### MOBILE CONVERSION METRICS | \| mobile_conversion_achievement_unlocked \| \| --- \| \| \\| Field label \\| Mobile conversion achievements unlocked \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion achievements unlocked \| \| Description \| Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | --- | | mobile_conversion_achievement_unlocked | | \| Field label \| Mobile conversion achievements unlocked \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion achievements unlocked | | Description | Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_add_to_cart \| \| --- \| \| \\| Field label \\| Mobile conversion add to cart \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type ADD_TO_CART by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion add to cart \| \| Description \| Breakdown of mobile conversions of type ADD_TO_CART by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_add_to_cart | | \| Field label \| Mobile conversion add to cart \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type ADD_TO_CART by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion add to cart | | Description | Breakdown of mobile conversions of type ADD_TO_CART by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_added_payment_infos \| \| --- \| \| \\| Field label \\| Mobile conversion added payment infos \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion added payment infos \| \| Description \| Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_added_payment_infos | | \| Field label \| Mobile conversion added payment infos \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion added payment infos | | Description | Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_add_to_wishlist \| \| --- \| \| \\| Field label \\| Mobile conversion add to wishlist \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type ADD_TO_WISHLIST by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion add to wishlist \| \| Description \| Breakdown of mobile conversions of type ADD_TO_WISHLIST by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_add_to_wishlist | | \| Field label \| Mobile conversion add to wishlist \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type ADD_TO_WISHLIST by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion add to wishlist | | Description | Breakdown of mobile conversions of type ADD_TO_WISHLIST by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_checkout_initiated \| \| --- \| \| \\| Field label \\| Mobile conversion checkout initiated \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion checkout initiated \| \| Description \| Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_checkout_initiated | | \| Field label \| Mobile conversion checkout initiated \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion checkout initiated | | Description | Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_content_views \| \| --- \| \| \\| Field label \\| Mobile conversion content views \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type CONTENT_VIEW by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion content views \| \| Description \| Breakdown of mobile conversions of type CONTENT_VIEW by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_content_views | | \| Field label \| Mobile conversion content views \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type CONTENT_VIEW by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion content views | | Description | Breakdown of mobile conversions of type CONTENT_VIEW by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_installs \| \| --- \| \| \\| Field label \\| Mobile conversion installs \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type INSTALL by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion installs \| \| Description \| Breakdown of mobile conversions of type INSTALL by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_installs | | \| Field label \| Mobile conversion installs \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type INSTALL by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion installs | | Description | Breakdown of mobile conversions of type INSTALL by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_invites \| \| --- \| \| \\| Field label \\| Mobile conversion invites \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type INVITE by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion invites \| \| Description \| Breakdown of mobile conversions of type INVITE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_invites | | \| Field label \| Mobile conversion invites \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type INVITE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion invites | | Description | Breakdown of mobile conversions of type INVITE by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_level_achieved \| \| --- \| \| \\| Field label \\| Mobile conversion level achieved \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type LEVEL_ACHIEVED \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion level achieved \| \| Description \| Breakdown of mobile conversions of type LEVEL_ACHIEVED \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_level_achieved | | \| Field label \| Mobile conversion level achieved \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type LEVEL_ACHIEVED \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion level achieved | | Description | Breakdown of mobile conversions of type LEVEL_ACHIEVED | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_logins \| \| --- \| \| \\| Field label \\| Mobile conversion logins \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type LOGIN by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion logins \| \| Description \| Breakdown of mobile conversions of type LOGIN by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_logins | | \| Field label \| Mobile conversion logins \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type LOGIN by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion logins | | Description | Breakdown of mobile conversions of type LOGIN by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_purchases \| \| --- \| \| \\| Field label \\| Mobile conversion purchases \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion purchases \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_purchases | | \| Field label \| Mobile conversion purchases \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion purchases | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_re_engages \| \| --- \| \| \\| Field label \\| Mobile conversion re-engages \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type RE_ENGAGE by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion re-engages \| \| Description \| Breakdown of mobile conversions of type RE_ENGAGE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_re_engages | | \| Field label \| Mobile conversion re-engages \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type RE_ENGAGE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion re-engages | | Description | Breakdown of mobile conversions of type RE_ENGAGE by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_sign_ups \| \| --- \| \| \\| Field label \\| Mobile conversion sign ups \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type SIGN_UP \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion sign ups \| \| Description \| Breakdown of mobile conversions of type SIGN_UP \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_sign_ups | | \| Field label \| Mobile conversion sign ups \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type SIGN_UP \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion sign ups | | Description | Breakdown of mobile conversions of type SIGN_UP | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_rated \| \| --- \| \| \\| Field label \\| Mobile conversion rated \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion rated \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_rated | | \| Field label \| Mobile conversion rated \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion rated | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_reservations \| \| --- \| \| \\| Field label \\| Mobile conversion reservations \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type RESERVATION by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion reservations \| \| Description \| Breakdown of mobile conversions of type RESERVATION by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_reservations | | \| Field label \| Mobile conversion reservations \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type RESERVATION by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion reservations | | Description | Breakdown of mobile conversions of type RESERVATION by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_searches \| \| --- \| \| \\| Field label \\| Mobile conversion searches \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type SEARCH by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion searches \| \| Description \| Breakdown of mobile conversions of type SEARCH by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_searches | | \| Field label \| Mobile conversion searches \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type SEARCH by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion searches | | Description | Breakdown of mobile conversions of type SEARCH by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_shares \| \| --- \| \| \\| Field label \\| Mobile conversion shares \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type SHARE by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion shares \| \| Description \| Breakdown of mobile conversions of type SHARE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_shares | | \| Field label \| Mobile conversion shares \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type SHARE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion shares | | Description | Breakdown of mobile conversions of type SHARE by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_spent_credits \| \| --- \| \| \\| Field label \\| Mobile conversion spent credits \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type SPENT_CREDIT \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion spent credits \| \| Description \| Breakdown of mobile conversions of type SPENT_CREDIT \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_spent_credits | | \| Field label \| Mobile conversion spent credits \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type SPENT_CREDIT \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion spent credits | | Description | Breakdown of mobile conversions of type SPENT_CREDIT | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_tutorial_completes \| \| --- \| \| \\| Field label \\| Mobile conversion tutorial completes \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion tutorial completes \| \| Description \| Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_tutorial_completes | | \| Field label \| Mobile conversion tutorial completes \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion tutorial completes | | Description | Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_updates \| \| --- \| \| \\| Field label \\| Mobile conversion updates \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type UPDATE by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion updates \| \| Description \| Breakdown of mobile conversions of type UPDATE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_updates | | \| Field label \| Mobile conversion updates \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type UPDATE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion updates | | Description | Breakdown of mobile conversions of type UPDATE by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_achievement_unlocked_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion achievement unlocked breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion achievement unlocked breakdown \| \| Description \| Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_achievement_unlocked_breakdown | | \| Field label \| Mobile conversion achievement unlocked breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion achievement unlocked breakdown | | Description | Breakdown of mobile conversions of type ACHIEVEMENT_UNLOCKED by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_add_to_cart_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion add to cart breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type ADD_TO_CART by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion add to cart breakdown \| \| Description \| Breakdown of mobile conversions of type ADD_TO_CART by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_add_to_cart_breakdown | | \| Field label \| Mobile conversion add to cart breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type ADD_TO_CART by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion add to cart breakdown | | Description | Breakdown of mobile conversions of type ADD_TO_CART by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_add_to_wishlist_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion add to wishlist breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type ADD_TO_WISHLIST \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion add to wishlist breakdown \| \| Description \| Breakdown of mobile conversions of type ADD_TO_WISHLIST \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_add_to_wishlist_breakdown | | \| Field label \| Mobile conversion add to wishlist breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type ADD_TO_WISHLIST \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion add to wishlist breakdown | | Description | Breakdown of mobile conversions of type ADD_TO_WISHLIST | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_added_payment_infos_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion added payment infos breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion added payment infos breakdown \| \| Description \| Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_added_payment_infos_breakdown | | \| Field label \| Mobile conversion added payment infos breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion added payment infos breakdown | | Description | Breakdown of mobile conversions of type PAYMENT_INFO_ADDITION by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_checkout_initiated_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion checkout initiated breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion checkout initiated breakdown \| \| Description \| Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_checkout_initiated_breakdown | | \| Field label \| Mobile conversion checkout initiated breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion checkout initiated breakdown | | Description | Breakdown of mobile conversions of type CHECKOUT_INITIATED by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_content_views_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion content views breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type CONTENT_VIEW by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion content views breakdown \| \| Description \| Breakdown of mobile conversions of type CONTENT_VIEW by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_content_views_breakdown | | \| Field label \| Mobile conversion content views breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type CONTENT_VIEW by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion content views breakdown | | Description | Breakdown of mobile conversions of type CONTENT_VIEW by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_installs_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion installs breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type INSTALL by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion installs breakdown \| \| Description \| Breakdown of mobile conversions of type INSTALL by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_installs_breakdown | | \| Field label \| Mobile conversion installs breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type INSTALL by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion installs breakdown | | Description | Breakdown of mobile conversions of type INSTALL by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_invites_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion invites breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type INVITE by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion invites breakdown \| \| Description \| Breakdown of mobile conversions of type INVITE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_invites_breakdown | | \| Field label \| Mobile conversion invites breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type INVITE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion invites breakdown | | Description | Breakdown of mobile conversions of type INVITE by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_level_achieved_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion level achieved breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type LEVEL_ACHIEVED by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion level achieved breakdown \| \| Description \| Breakdown of mobile conversions of type LEVEL_ACHIEVED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_level_achieved_breakdown | | \| Field label \| Mobile conversion level achieved breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type LEVEL_ACHIEVED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion level achieved breakdown | | Description | Breakdown of mobile conversions of type LEVEL_ACHIEVED by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_logins_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion logins breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type LOGIN by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion logins breakdown \| \| Description \| Breakdown of mobile conversions of type LOGIN by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_logins_breakdown | | \| Field label \| Mobile conversion logins breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type LOGIN by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion logins breakdown | | Description | Breakdown of mobile conversions of type LOGIN by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_order_quantity \| \| --- \| \| \\| Field label \\| Mobile conversion order quantity \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion order quantity \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_order_quantity | | \| Field label \| Mobile conversion order quantity \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion order quantity | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_purchases_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion purchases breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type PURCHASE \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion purchases breakdown \| \| Description \| Breakdown of mobile conversions of type PURCHASE \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_purchases_breakdown | | \| Field label \| Mobile conversion purchases breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type PURCHASE \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion purchases breakdown | | Description | Breakdown of mobile conversions of type PURCHASE | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_rated_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion rated breakdown \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion rated breakdown \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_rated_breakdown | | \| Field label \| Mobile conversion rated breakdown \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion rated breakdown | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_re_engages_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion re-engages breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type RE_ENGAGE by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion re-engages breakdown \| \| Description \| Breakdown of mobile conversions of type RE_ENGAGE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_re_engages_breakdown | | \| Field label \| Mobile conversion re-engages breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type RE_ENGAGE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion re-engages breakdown | | Description | Breakdown of mobile conversions of type RE_ENGAGE by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_reservations_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion reservations breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type RESERVATION \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion reservations breakdown \| \| Description \| Breakdown of mobile conversions of type RESERVATION \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_reservations_breakdown | | \| Field label \| Mobile conversion reservations breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type RESERVATION \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion reservations breakdown | | Description | Breakdown of mobile conversions of type RESERVATION | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_sale_amount_local_micro \| \| --- \| \| \\| Field label \\| Mobile conversion sale amount \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Mobile conversion sale amount \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | mobile_conversion_sale_amount_local_micro | | \| Field label \| Mobile conversion sale amount \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Mobile conversion sale amount | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| mobile_conversion_searches_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion searches breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type SEARCH by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion searches breakdown \| \| Description \| Breakdown of mobile conversions of type SEARCH by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_searches_breakdown | | \| Field label \| Mobile conversion searches breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type SEARCH by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion searches breakdown | | Description | Breakdown of mobile conversions of type SEARCH by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_shares_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion shares breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type SHARE by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion shares breakdown \| \| Description \| Breakdown of mobile conversions of type SHARE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_shares_breakdown | | \| Field label \| Mobile conversion shares breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type SHARE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion shares breakdown | | Description | Breakdown of mobile conversions of type SHARE by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_sign_ups_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion sign ups breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type SIGN_UP \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion sign ups breakdown \| \| Description \| Breakdown of mobile conversions of type SIGN_UP \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_sign_ups_breakdown | | \| Field label \| Mobile conversion sign ups breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type SIGN_UP \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion sign ups breakdown | | Description | Breakdown of mobile conversions of type SIGN_UP | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_spent_credits_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion spent credits breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type SPENT_CREDIT \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion spent credits breakdown \| \| Description \| Breakdown of mobile conversions of type SPENT_CREDIT \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_spent_credits_breakdown | | \| Field label \| Mobile conversion spent credits breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type SPENT_CREDIT \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion spent credits breakdown | | Description | Breakdown of mobile conversions of type SPENT_CREDIT | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_tutorial_completes_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion tutorial completes breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion tutorial completes breakdown \| \| Description \| Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_tutorial_completes_breakdown | | \| Field label \| Mobile conversion tutorial completes breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion tutorial completes breakdown | | Description | Breakdown of mobile conversions of type TUTORIAL_COMPLETED by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| mobile_conversion_updates_breakdown \| \| --- \| \| \\| Field label \\| Mobile conversion updates breakdown \\| \\| --- \\| --- \\| \\| Description \\| Breakdown of mobile conversions of type UPDATE by post_view, post_engagement, assisted, order_quantity, and sale_amount \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Mobile conversion updates breakdown \| \| Description \| Breakdown of mobile conversions of type UPDATE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | mobile_conversion_updates_breakdown | | \| Field label \| Mobile conversion updates breakdown \| \| --- \| --- \| \| Description \| Breakdown of mobile conversions of type UPDATE by post_view, post_engagement, assisted, order_quantity, and sale_amount \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Mobile conversion updates breakdown | | Description | Breakdown of mobile conversions of type UPDATE by post_view, post_engagement, assisted, order_quantity, and sale_amount | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | ### OBJECTIVE VIDEO VIEWS | \| promoted_video_total_views \| \| --- \| \| \\| Field label \\| Video views \\| \\| --- \\| --- \\| \\| Description \\| Video views only count when your video is watched in 50% view for 2 seconds or more, or when a user clicks to expand/unmute your video. This includes views you are not billed for \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Video views \| \| Description \| Video views only count when your video is watched in 50% view for 2 seconds or more, or when a user clicks to expand/unmute your video. This includes views you are not billed for \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | --- | | promoted_video_total_views | | \| Field label \| Video views \| \| --- \| --- \| \| Description \| Video views only count when your video is watched in 50% view for 2 seconds or more, or when a user clicks to expand/unmute your video. This includes views you are not billed for \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Video views | | Description | Video views only count when your video is watched in 50% view for 2 seconds or more, or when a user clicks to expand/unmute your video. This includes views you are not billed for | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| video_view_rate \| \| --- \| \| \\| Field label \\| Video view rate \\| \\| --- \\| --- \\| \\| Description \\| Total video views divided by impressions. Regardless of your bid type, this is always calculated using video ad views \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| Video view rate \| \| Description \| Total video views divided by impressions. Regardless of your bid type, this is always calculated using video ad views \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | video_view_rate | | \| Field label \| Video view rate \| \| --- \| --- \| \| Description \| Total video views divided by impressions. Regardless of your bid type, this is always calculated using video ad views \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | Video view rate | | Description | Total video views divided by impressions. Regardless of your bid type, this is always calculated using video ad views | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | \| CPV \| \| --- \| \| \\| Field label \\| Cost per video view \\| \\| --- \\| --- \\| \\| Description \\| Total spend divided by the number of views, including earned. You only pay the first time someone watches your video \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Cost per video view \| \| Description \| Total spend divided by the number of views, including earned. You only pay the first time someone watches your video \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | CPV | | \| Field label \| Cost per video view \| \| --- \| --- \| \| Description \| Total spend divided by the number of views, including earned. You only pay the first time someone watches your video \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Cost per video view | | Description | Total spend divided by the number of views, including earned. You only pay the first time someone watches your video | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| video_3s100pct_views \| \| --- \| \| \\| Field label \\| Video views 3s \\| \\| --- \\| --- \\| \\| Description \\| Total number of views where at least 3 seconds were played while 100% in view \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Video views 3s \| \| Description \| Total number of views where at least 3 seconds were played while 100% in view \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | video_3s100pct_views | | \| Field label \| Video views 3s \| \| --- \| --- \| \| Description \| Total number of views where at least 3 seconds were played while 100% in view \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Video views 3s | | Description | Total number of views where at least 3 seconds were played while 100% in view | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| promoted_video_starts \| \| --- \| \| \\| Field label \\| Video starts \\| \\| --- \\| --- \\| \\| Description \\| The number of people who started the video, regardless of how much of the video player is in view. You're not billed for these \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Video starts \| \| Description \| The number of people who started the video, regardless of how much of the video player is in view. You're not billed for these \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | promoted_video_starts | | \| Field label \| Video starts \| \| --- \| --- \| \| Description \| The number of people who started the video, regardless of how much of the video player is in view. You're not billed for these \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Video starts | | Description | The number of people who started the video, regardless of how much of the video player is in view. You're not billed for these | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| promoted_video_views_25 \| \| --- \| \| \\| Field label \\| Video views (25% complete) \\| \\| --- \\| --- \\| \\| Description \\| The number of people who watched 25% of the video, regardless of how much of the video player is in view. You're not billed for these \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Video views (25% complete) \| \| Description \| The number of people who watched 25% of the video, regardless of how much of the video player is in view. You're not billed for these \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | promoted_video_views_25 | | \| Field label \| Video views (25% complete) \| \| --- \| --- \| \| Description \| The number of people who watched 25% of the video, regardless of how much of the video player is in view. You're not billed for these \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Video views (25% complete) | | Description | The number of people who watched 25% of the video, regardless of how much of the video player is in view. You're not billed for these | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| promoted_video_views_50 \| \| --- \| \| \\| Field label \\| Video views (50% complete) \\| \\| --- \\| --- \\| \\| Description \\| The number of people who watched 50% of the video, regardless of how much of the video player is in view. You're not billed for these \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Video views (50% complete) \| \| Description \| The number of people who watched 50% of the video, regardless of how much of the video player is in view. You're not billed for these \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | promoted_video_views_50 | | \| Field label \| Video views (50% complete) \| \| --- \| --- \| \| Description \| The number of people who watched 50% of the video, regardless of how much of the video player is in view. You're not billed for these \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Video views (50% complete) | | Description | The number of people who watched 50% of the video, regardless of how much of the video player is in view. You're not billed for these | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| promoted_video_views_75 \| \| --- \| \| \\| Field label \\| Video views (75% complete) \\| \\| --- \\| --- \\| \\| Description \\| The number of people who watched 75% of the video, regardless of how much of the video player is in view. You're not billed for these \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Video views (75% complete) \| \| Description \| The number of people who watched 75% of the video, regardless of how much of the video player is in view. You're not billed for these \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | promoted_video_views_75 | | \| Field label \| Video views (75% complete) \| \| --- \| --- \| \| Description \| The number of people who watched 75% of the video, regardless of how much of the video player is in view. You're not billed for these \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Video views (75% complete) | | Description | The number of people who watched 75% of the video, regardless of how much of the video player is in view. You're not billed for these | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| promoted_video_views_100 \| \| --- \| \| \\| Field label \\| Video views (completed) \\| \\| --- \\| --- \\| \\| Description \\| The number of people who watched 100% of the video, regardless of how much of the video player is in view. You're not billed for these \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Video views (completed) \| \| Description \| The number of people who watched 100% of the video, regardless of how much of the video player is in view. You're not billed for these \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | promoted_video_views_100 | | \| Field label \| Video views (completed) \| \| --- \| --- \| \| Description \| The number of people who watched 100% of the video, regardless of how much of the video player is in view. You're not billed for these \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Video views (completed) | | Description | The number of people who watched 100% of the video, regardless of how much of the video player is in view. You're not billed for these | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | ### OBJECTIVE WEBSITE CLICKS OR CONVERSIONS | \| clicks \| \| --- \| \| \\| Field label \\| Clicks \\| \\| --- \\| --- \\| \\| Description \\| Total clicks on links, hashtags, a Website Card, and other Tweet details in your ad, combined with likes and profile clicks \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Clicks \| \| Description \| Total clicks on links, hashtags, a Website Card, and other Tweet details in your ad, combined with likes and profile clicks \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | --- | | clicks | | \| Field label \| Clicks \| \| --- \| --- \| \| Description \| Total clicks on links, hashtags, a Website Card, and other Tweet details in your ad, combined with likes and profile clicks \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Clicks | | Description | Total clicks on links, hashtags, a Website Card, and other Tweet details in your ad, combined with likes and profile clicks | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| CTR \| \| --- \| \| \\| Field label \\| CTR \\| \\| --- \\| --- \\| \\| Description \\| Total clicks on a link or a Website Card divided by total impressions, including earned \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.ratio](/apidocs/field-data-types#number) \\| \| \| Field label \| CTR \| \| Description \| Total clicks on a link or a Website Card divided by total impressions, including earned \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | CTR | | \| Field label \| CTR \| \| --- \| --- \| \| Description \| Total clicks on a link or a Website Card divided by total impressions, including earned \| \| Field type \| metric \| \| Data type \| [float.number.ratio](/apidocs/field-data-types#number) \| | | Field label | CTR | | Description | Total clicks on a link or a Website Card divided by total impressions, including earned | | Field type | metric | | Data type | [float.number.ratio](/apidocs/field-data-types#number) | | \| CPC \| \| --- \| \| \\| Field label \\| CPC \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| CPC \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | CPC | | \| Field label \| CPC \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | CPC | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| CPA \| \| --- \| \| \\| Field label \\| Cost per acquisition \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Cost per acquisition \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | CPA | | \| Field label \| Cost per acquisition \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Cost per acquisition | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| conversion_site_visits \| \| --- \| \| \\| Field label \\| Site visits \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Site visits \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | conversion_site_visits | | \| Field label \| Site visits \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Site visits | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| conversion_sign_ups \| \| --- \| \| \\| Field label \\| Leads \\| \\| --- \\| --- \\| \\| Description \\| Total number of conversions of the lead type. Formerly known as Sign-ups \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Leads \| \| Description \| Total number of conversions of the lead type. Formerly known as Sign-ups \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | conversion_sign_ups | | \| Field label \| Leads \| \| --- \| --- \| \| Description \| Total number of conversions of the lead type. Formerly known as Sign-ups \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Leads | | Description | Total number of conversions of the lead type. Formerly known as Sign-ups | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| conversion_downloads \| \| --- \| \| \\| Field label \\| Downloads \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Downloads \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | conversion_downloads | | \| Field label \| Downloads \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Downloads | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| conversion_purchases \| \| --- \| \| \\| Field label \\| Purchases \\| \\| --- \\| --- \\| \\| Description \\| Total number of purchases. The sum of post view, post engagement, and assisted purchases for both your website and mobile app \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Purchases \| \| Description \| Total number of purchases. The sum of post view, post engagement, and assisted purchases for both your website and mobile app \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | conversion_purchases | | \| Field label \| Purchases \| \| --- \| --- \| \| Description \| Total number of purchases. The sum of post view, post engagement, and assisted purchases for both your website and mobile app \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Purchases | | Description | Total number of purchases. The sum of post view, post engagement, and assisted purchases for both your website and mobile app | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| conversion_order_quantity \| \| --- \| \| \\| Field label \\| Order quantity \\| \\| --- \\| --- \\| \\| Description \\| The order quantity of the purchase, e.g. 1 unit \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Order quantity \| \| Description \| The order quantity of the purchase, e.g. 1 unit \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | conversion_order_quantity | | \| Field label \| Order quantity \| \| --- \| --- \| \| Description \| The order quantity of the purchase, e.g. 1 unit \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Order quantity | | Description | The order quantity of the purchase, e.g. 1 unit | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | \| conversion_sale_amount \| \| --- \| \| \\| Field label \\| Sale amount \\| \\| --- \\| --- \\| \\| Description \\| The total sale amount of the purchase \\| \\| Field type \\| metric \\| \\| Data type \\| [float.currency.value](/apidocs/field-data-types#currency) \\| \| \| Field label \| Sale amount \| \| Description \| The total sale amount of the purchase \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | conversion_sale_amount | | \| Field label \| Sale amount \| \| --- \| --- \| \| Description \| The total sale amount of the purchase \| \| Field type \| metric \| \| Data type \| [float.currency.value](/apidocs/field-data-types#currency) \| | | Field label | Sale amount | | Description | The total sale amount of the purchase | | Field type | metric | | Data type | [float.currency.value](/apidocs/field-data-types#currency) | | \| conversion_custom \| \| --- \| \| \\| Field label \\| Custom conversions \\| \\| --- \\| --- \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \| \| Field label \| Custom conversions \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | conversion_custom | | \| Field label \| Custom conversions \| \| --- \| --- \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| | | Field label | Custom conversions | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | ### PROMOTED TWEET | \| promoted_tweet_id \| \| --- \| \| \\| Field label \\| Tweet ID \\| \\| --- \\| --- \\| \\| Description \\| Unique numeric ID of the original tweet being used in the promoted tweet ad \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet ID \| \| Description \| Unique numeric ID of the original tweet being used in the promoted tweet ad \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | --- | | promoted_tweet_id | | \| Field label \| Tweet ID \| \| --- \| --- \| \| Description \| Unique numeric ID of the original tweet being used in the promoted tweet ad \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet ID | | Description | Unique numeric ID of the original tweet being used in the promoted tweet ad | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_ad_id \| \| --- \| \| \\| Field label \\| Tweet ad ID \\| \\| --- \\| --- \\| \\| Description \\| Unique alphanumeric ID for the promoted tweet ad \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet ad ID \| \| Description \| Unique alphanumeric ID for the promoted tweet ad \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_ad_id | | \| Field label \| Tweet ad ID \| \| --- \| --- \| \| Description \| Unique alphanumeric ID for the promoted tweet ad \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet ad ID | | Description | Unique alphanumeric ID for the promoted tweet ad | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_created_at \| \| --- \| \| \\| Field label \\| Tweet creation date \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Tweet creation date \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | promoted_tweet_created_at | | \| Field label \| Tweet creation date \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Tweet creation date | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| ad_name \| \| --- \| \| \\| Field label \\| Ad name \\| \\| --- \\| --- \\| \\| Description \\| Ad name as displayed in X user interface. Derived from promoted tweet name, or card name if tweet name is not set \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Ad name \| \| Description \| Ad name as displayed in X user interface. Derived from promoted tweet name, or card name if tweet name is not set \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | ad_name | | \| Field label \| Ad name \| \| --- \| --- \| \| Description \| Ad name as displayed in X user interface. Derived from promoted tweet name, or card name if tweet name is not set \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Ad name | | Description | Ad name as displayed in X user interface. Derived from promoted tweet name, or card name if tweet name is not set | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_name \| \| --- \| \| \\| Field label \\| Tweet name \\| \\| --- \\| --- \\| \\| Description \\| Name of the promoted tweet. Note that this can be empty for older Tweets or ones created without a name \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet name \| \| Description \| Name of the promoted tweet. Note that this can be empty for older Tweets or ones created without a name \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_name | | \| Field label \| Tweet name \| \| --- \| --- \| \| Description \| Name of the promoted tweet. Note that this can be empty for older Tweets or ones created without a name \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet name | | Description | Name of the promoted tweet. Note that this can be empty for older Tweets or ones created without a name | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_text \| \| --- \| \| \\| Field label \\| Tweet text \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet text \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_text | | \| Field label \| Tweet text \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet text | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_source \| \| --- \| \| \\| Field label \\| Tweet source \\| \\| --- \\| --- \\| \\| Description \\| Source client of the tweet, e.g. twitter.com or Twitter for Android \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet source \| \| Description \| Source client of the tweet, e.g. twitter.com or Twitter for Android \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_source | | \| Field label \| Tweet source \| \| --- \| --- \| \| Description \| Source client of the tweet, e.g. twitter.com or Twitter for Android \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet source | | Description | Source client of the tweet, e.g. twitter.com or Twitter for Android | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_scheduled_status \| \| --- \| \| \\| Field label \\| Tweet scheduled status \\| \\| --- \\| --- \\| \\| Description \\| Whether the tweet is scheduled for later or not \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet scheduled status \| \| Description \| Whether the tweet is scheduled for later or not \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_scheduled_status | | \| Field label \| Tweet scheduled status \| \| --- \| --- \| \| Description \| Whether the tweet is scheduled for later or not \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet scheduled status | | Description | Whether the tweet is scheduled for later or not | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_scheduled_at \| \| --- \| \| \\| Field label \\| Tweet scheduled at \\| \\| --- \\| --- \\| \\| Description \\| Tweet scheduled to publish at \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.datetime](/apidocs/field-data-types#time) \\| \| \| Field label \| Tweet scheduled at \| \| Description \| Tweet scheduled to publish at \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| | | promoted_tweet_scheduled_at | | \| Field label \| Tweet scheduled at \| \| --- \| --- \| \| Description \| Tweet scheduled to publish at \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| | | Field label | Tweet scheduled at | | Description | Tweet scheduled to publish at | | Field type | dimension | | Data type | [string.time.datetime](/apidocs/field-data-types#time) | | \| promoted_tweet_type \| \| --- \| \| \\| Field label \\| Tweet type \\| \\| --- \\| --- \\| \\| Description \\| Tweet type, e.g. PUBLISHED \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet type \| \| Description \| Tweet type, e.g. PUBLISHED \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_type | | \| Field label \| Tweet type \| \| --- \| --- \| \| Description \| Tweet type, e.g. PUBLISHED \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet type | | Description | Tweet type, e.g. PUBLISHED | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_language \| \| --- \| \| \\| Field label \\| Tweet language \\| \\| --- \\| --- \\| \\| Description \\| Language of the tweet (automatically identified) \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.language.twolettercode](/apidocs/field-data-types#language) \\| \| \| Field label \| Tweet language \| \| Description \| Language of the tweet (automatically identified) \| \| Field type \| dimension \| \| Data type \| [string.language.twolettercode](/apidocs/field-data-types#language) \| | | promoted_tweet_language | | \| Field label \| Tweet language \| \| --- \| --- \| \| Description \| Language of the tweet (automatically identified) \| \| Field type \| dimension \| \| Data type \| [string.language.twolettercode](/apidocs/field-data-types#language) \| | | Field label | Tweet language | | Description | Language of the tweet (automatically identified) | | Field type | dimension | | Data type | [string.language.twolettercode](/apidocs/field-data-types#language) | | \| promoted_tweet_hashtags \| \| --- \| \| \\| Field label \\| Tweet hashtags \\| \\| --- \\| --- \\| \\| Description \\| Hashtags included in the tweet \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet hashtags \| \| Description \| Hashtags included in the tweet \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_hashtags | | \| Field label \| Tweet hashtags \| \| --- \| --- \| \| Description \| Hashtags included in the tweet \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet hashtags | | Description | Hashtags included in the tweet | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_symbols \| \| --- \| \| \\| Field label \\| Tweet symbols \\| \\| --- \\| --- \\| \\| Description \\| Symbols included in the tweet \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet symbols \| \| Description \| Symbols included in the tweet \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_symbols | | \| Field label \| Tweet symbols \| \| --- \| --- \| \| Description \| Symbols included in the tweet \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet symbols | | Description | Symbols included in the tweet | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_user_mentions \| \| --- \| \| \\| Field label \\| Tweet mentions \\| \\| --- \\| --- \\| \\| Description \\| Users mentioned in the tweet \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet mentions \| \| Description \| Users mentioned in the tweet \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_user_mentions | | \| Field label \| Tweet mentions \| \| --- \| --- \| \| Description \| Users mentioned in the tweet \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet mentions | | Description | Users mentioned in the tweet | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| tweet_url \| \| --- \| \| \\| Field label \\| Link to tweet \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Link to tweet \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | tweet_url | | \| Field label \| Link to tweet \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Link to tweet | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| promoted_tweet_first_url \| \| --- \| \| \\| Field label \\| Tweet first URL \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet first URL \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | promoted_tweet_first_url | | \| Field label \| Tweet first URL \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Tweet first URL | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| promoted_tweet_card_title \| \| --- \| \| \\| Field label \\| Tweet card title \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet card title \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_card_title | | \| Field label \| Tweet card title \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet card title | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_card_name \| \| --- \| \| \\| Field label \\| Tweet card name \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet card name \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_card_name | | \| Field label \| Tweet card name \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet card name | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_card_type \| \| --- \| \| \\| Field label \\| Tweet card type \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet card type \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_card_type | | \| Field label \| Tweet card type \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet card type | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_card_destination_url \| \| --- \| \| \\| Field label \\| Tweet card destination URL \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet card destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | promoted_tweet_card_destination_url | | \| Field label \| Tweet card destination URL \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Tweet card destination URL | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| promoted_tweet_card_image_url \| \| --- \| \| \\| Field label \\| Tweet card image URL \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet card image URL \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | promoted_tweet_card_image_url | | \| Field label \| Tweet card image URL \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Tweet card image URL | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| promoted_tweet_card_image \| \| --- \| \| \\| Field label \\| Tweet card image \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.formula](/apidocs/field-data-types#) \\| \| \| Field label \| Tweet card image \| \| Field type \| dimension \| \| Data type \| [string.text.formula](/apidocs/field-data-types#) \| | | promoted_tweet_card_image | | \| Field label \| Tweet card image \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.formula](/apidocs/field-data-types#) \| | | Field label | Tweet card image | | Field type | dimension | | Data type | [string.text.formula](/apidocs/field-data-types#) | | \| promoted_tweet_card_uri \| \| --- \| \| \\| Field label \\| Tweet card URI \\| \\| --- \\| --- \\| \\| Description \\| The unique identifier of the card. Replaces Tweet card ID \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet card URI \| \| Description \| The unique identifier of the card. Replaces Tweet card ID \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_card_uri | | \| Field label \| Tweet card URI \| \| --- \| --- \| \| Description \| The unique identifier of the card. Replaces Tweet card ID \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet card URI | | Description | The unique identifier of the card. Replaces Tweet card ID | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| promoted_tweet_destination_url \| \| --- \| \| \\| Field label \\| Tweet destination URL \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.url](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | promoted_tweet_destination_url | | \| Field label \| Tweet destination URL \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.url](/apidocs/field-data-types#text) \| | | Field label | Tweet destination URL | | Field type | dimension | | Data type | [string.text.url](/apidocs/field-data-types#text) | | \| promoted_tweet_media_type \| \| --- \| \| \\| Field label \\| Tweet media type \\| \\| --- \\| --- \\| \\| Description \\| Type of tweet media \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Tweet media type \| \| Description \| Type of tweet media \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | promoted_tweet_media_type | | \| Field label \| Tweet media type \| \| --- \| --- \| \| Description \| Type of tweet media \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Tweet media type | | Description | Type of tweet media | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| utm_source \| \| --- \| \| \\| Field label \\| Source (utm) \\| \\| --- \\| --- \\| \\| Description \\| Value of the utm_source parameter extracted from the ad destination URL \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Source (utm) \| \| Description \| Value of the utm_source parameter extracted from the ad destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | utm_source | | \| Field label \| Source (utm) \| \| --- \| --- \| \| Description \| Value of the utm_source parameter extracted from the ad destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Source (utm) | | Description | Value of the utm_source parameter extracted from the ad destination URL | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| utm_medium \| \| --- \| \| \\| Field label \\| Medium (utm) \\| \\| --- \\| --- \\| \\| Description \\| Value of the utm_medium parameter extracted from the ad destination URL \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Medium (utm) \| \| Description \| Value of the utm_medium parameter extracted from the ad destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | utm_medium | | \| Field label \| Medium (utm) \| \| --- \| --- \| \| Description \| Value of the utm_medium parameter extracted from the ad destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Medium (utm) | | Description | Value of the utm_medium parameter extracted from the ad destination URL | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| utm_content \| \| --- \| \| \\| Field label \\| Content (utm) \\| \\| --- \\| --- \\| \\| Description \\| Value of the utm_content parameter extracted from the ad destination URL \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Content (utm) \| \| Description \| Value of the utm_content parameter extracted from the ad destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | utm_content | | \| Field label \| Content (utm) \| \| --- \| --- \| \| Description \| Value of the utm_content parameter extracted from the ad destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Content (utm) | | Description | Value of the utm_content parameter extracted from the ad destination URL | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| utm_term \| \| --- \| \| \\| Field label \\| Term (utm) \\| \\| --- \\| --- \\| \\| Description \\| Value of the utm_term parameter extracted from the ad destination URL \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Term (utm) \| \| Description \| Value of the utm_term parameter extracted from the ad destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | utm_term | | \| Field label \| Term (utm) \| \| --- \| --- \| \| Description \| Value of the utm_term parameter extracted from the ad destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Term (utm) | | Description | Value of the utm_term parameter extracted from the ad destination URL | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | | \| utm_campaign \| \| --- \| \| \\| Field label \\| Campaign (utm) \\| \\| --- \\| --- \\| \\| Description \\| Value of the utm_campaign parameter extracted from the ad destination URL \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Campaign (utm) \| \| Description \| Value of the utm_campaign parameter extracted from the ad destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | utm_campaign | | \| Field label \| Campaign (utm) \| \| --- \| --- \| \| Description \| Value of the utm_campaign parameter extracted from the ad destination URL \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Campaign (utm) | | Description | Value of the utm_campaign parameter extracted from the ad destination URL | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | ### QUERY | \| system_metadata.query_date_range_start \| \| --- \| \| \\| Field label \\| Start date \\| \\| --- \\| --- \\| \\| Description \\| The start date of the requested query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Start date \| \| Description \| The start date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | --- | | system_metadata.query_date_range_start | | \| Field label \| Start date \| \| --- \| --- \| \| Description \| The start date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Start date | | Description | The start date of the requested query | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| system_metadata.query_date_range_end \| \| --- \| \| \\| Field label \\| End date \\| \\| --- \\| --- \\| \\| Description \\| The end date of the requested query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| End date \| \| Description \| The end date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | system_metadata.query_date_range_end | | \| Field label \| End date \| \| --- \| --- \| \| Description \| The end date of the requested query \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | End date | | Description | The end date of the requested query | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | \| system_metadata.query_timezone \| \| --- \| \| \\| Field label \\| Timezone \\| \\| --- \\| --- \\| \\| Description \\| The timezone that is supplied to the query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.timezone](/apidocs/field-data-types#time) \\| \| \| Field label \| Timezone \| \| Description \| The timezone that is supplied to the query \| \| Field type \| dimension \| \| Data type \| [string.time.timezone](/apidocs/field-data-types#time) \| | | system_metadata.query_timezone | | \| Field label \| Timezone \| \| --- \| --- \| \| Description \| The timezone that is supplied to the query \| \| Field type \| dimension \| \| Data type \| [string.time.timezone](/apidocs/field-data-types#time) \| | | Field label | Timezone | | Description | The timezone that is supplied to the query | | Field type | dimension | | Data type | [string.time.timezone](/apidocs/field-data-types#time) | | \| system_metadata.query_filters \| \| --- \| \| \\| Field label \\| Filters \\| \\| --- \\| --- \\| \\| Description \\| All filters used in the query \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Filters \| \| Description \| All filters used in the query \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | system_metadata.query_filters | | \| Field label \| Filters \| \| --- \| --- \| \| Description \| All filters used in the query \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | Field label | Filters | | Description | All filters used in the query | | Field type | dimension | | Data type | [string.text.json](/apidocs/field-data-types#text) | | \| system_metadata.query_date_start \| \| --- \| \| \\| Field label \\| Start \\| \\| --- \\| --- \\| \\| Description \\| When the query was started \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.datetime](/apidocs/field-data-types#time) \\| \| \| Field label \| Start \| \| Description \| When the query was started \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| | | system_metadata.query_date_start | | \| Field label \| Start \| \| --- \| --- \| \| Description \| When the query was started \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| | | Field label | Start | | Description | When the query was started | | Field type | dimension | | Data type | [string.time.datetime](/apidocs/field-data-types#time) | | \| system_metadata.query_date_end \| \| --- \| \| \\| Field label \\| End \\| \\| --- \\| --- \\| \\| Description \\| When the query completed \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.datetime](/apidocs/field-data-types#time) \\| \| \| Field label \| End \| \| Description \| When the query completed \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| | | system_metadata.query_date_end | | \| Field label \| End \| \| --- \| --- \| \| Description \| When the query completed \| \| Field type \| dimension \| \| Data type \| [string.time.datetime](/apidocs/field-data-types#time) \| | | Field label | End | | Description | When the query completed | | Field type | dimension | | Data type | [string.time.datetime](/apidocs/field-data-types#time) | | \| system_metadata.query_duration \| \| --- \| \| \\| Field label \\| Duration \\| \\| --- \\| --- \\| \\| Description \\| The duration in seconds of the query \\| \\| Field type \\| dimension \\| \\| Data type \\| [int.duration.seconds](/apidocs/field-data-types#duration) \\| \| \| Field label \| Duration \| \| Description \| The duration in seconds of the query \| \| Field type \| dimension \| \| Data type \| [int.duration.seconds](/apidocs/field-data-types#duration) \| | | system_metadata.query_duration | | \| Field label \| Duration \| \| --- \| --- \| \| Description \| The duration in seconds of the query \| \| Field type \| dimension \| \| Data type \| [int.duration.seconds](/apidocs/field-data-types#duration) \| | | Field label | Duration | | Description | The duration in seconds of the query | | Field type | dimension | | Data type | [int.duration.seconds](/apidocs/field-data-types#duration) | | \| system_metadata.query_accounts \| \| --- \| \| \\| Field label \\| Accounts \\| \\| --- \\| --- \\| \\| Description \\| A list of accounts of which the data was pulled from \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Accounts \| \| Description \| A list of accounts of which the data was pulled from \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | system_metadata.query_accounts | | \| Field label \| Accounts \| \| --- \| --- \| \| Description \| A list of accounts of which the data was pulled from \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | Field label | Accounts | | Description | A list of accounts of which the data was pulled from | | Field type | dimension | | Data type | [string.text.json](/apidocs/field-data-types#text) | | \| system_metadata.query_excluded_accounts \| \| --- \| \| \\| Field label \\| Excluded invalid accounts \\| \\| --- \\| --- \\| \\| Description \\| A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.json](/apidocs/field-data-types#text) \\| \| \| Field label \| Excluded invalid accounts \| \| Description \| A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | system_metadata.query_excluded_accounts | | \| Field label \| Excluded invalid accounts \| \| --- \| --- \| \| Description \| A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting \| \| Field type \| dimension \| \| Data type \| [string.text.json](/apidocs/field-data-types#text) \| | | Field label | Excluded invalid accounts | | Description | A list of unavailable accounts excluded from the query due to the "Exclude invalid accounts" setting | | Field type | dimension | | Data type | [string.text.json](/apidocs/field-data-types#text) | ### REACH | \| total_audience_reach \| \| --- \| \| \\| Field label \\| Total audience reach \\| \\| --- \\| --- \\| \\| Description \\| The total number of people who have been reached by the campaign \\| \\| Field type \\| metric \\| \\| Data type \\| [int.number.value](/apidocs/field-data-types#number) \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Total audience reach \| \| Description \| The total number of people who have been reached by the campaign \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | --- | | total_audience_reach | | \| Field label \| Total audience reach \| \| --- \| --- \| \| Description \| The total number of people who have been reached by the campaign \| \| Field type \| metric \| \| Data type \| [int.number.value](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Total audience reach | | Description | The total number of people who have been reached by the campaign | | Field type | metric | | Data type | [int.number.value](/apidocs/field-data-types#number) | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | | \| average_frequency \| \| --- \| \| \\| Field label \\| Average frequency \\| \\| --- \\| --- \\| \\| Description \\| The average number of times a person saw ads related to this campaign \\| \\| Field type \\| metric \\| \\| Data type \\| [float.number.value](/apidocs/field-data-types#number) \\| \\| Aggregation \\| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \\| \| \| Field label \| Average frequency \| \| Description \| The average number of times a person saw ads related to this campaign \| \| Field type \| metric \| \| Data type \| [float.number.value](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | average_frequency | | \| Field label \| Average frequency \| \| --- \| --- \| \| Description \| The average number of times a person saw ads related to this campaign \| \| Field type \| metric \| \| Data type \| [float.number.value](/apidocs/field-data-types#number) \| \| Aggregation \| [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) \| | | Field label | Average frequency | | Description | The average number of times a person saw ads related to this campaign | | Field type | metric | | Data type | [float.number.value](/apidocs/field-data-types#number) | | Aggregation | [Non-aggregatable metric](/apidocs/non-aggregatable-metrics) | ### SEGMENTATION | \| AGE \| \| --- \| \| \\| Field label \\| Age \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.person.age](/apidocs/field-data-types#person) \\| \| \| Field label \| Age \| \| Field type \| dimension \| \| Data type \| [string.person.age](/apidocs/field-data-types#person) \| | | --- | | AGE | | \| Field label \| Age \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.person.age](/apidocs/field-data-types#person) \| | | Field label | Age | | Field type | dimension | | Data type | [string.person.age](/apidocs/field-data-types#person) | | \| GENDER \| \| --- \| \| \\| Field label \\| Gender \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.person.gender](/apidocs/field-data-types#person) \\| \| \| Field label \| Gender \| \| Field type \| dimension \| \| Data type \| [string.person.gender](/apidocs/field-data-types#person) \| | | GENDER | | \| Field label \| Gender \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.person.gender](/apidocs/field-data-types#person) \| | | Field label | Gender | | Field type | dimension | | Data type | [string.person.gender](/apidocs/field-data-types#person) | | \| LOCATIONS \| \| --- \| \| \\| Field label \\| Country \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.geo.country](/apidocs/field-data-types#geographical) \\| \| \| Field label \| Country \| \| Field type \| dimension \| \| Data type \| [string.geo.country](/apidocs/field-data-types#geographical) \| | | LOCATIONS | | \| Field label \| Country \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.geo.country](/apidocs/field-data-types#geographical) \| | | Field label | Country | | Field type | dimension | | Data type | [string.geo.country](/apidocs/field-data-types#geographical) | | \| countryCode \| \| --- \| \| \\| Field label \\| Country code \\| \\| --- \\| --- \\| \\| Description \\| Two-letter county code \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.geo.country.twolettercode](/apidocs/field-data-types#geographical) \\| \| \| Field label \| Country code \| \| Description \| Two-letter county code \| \| Field type \| dimension \| \| Data type \| [string.geo.country.twolettercode](/apidocs/field-data-types#geographical) \| | | countryCode | | \| Field label \| Country code \| \| --- \| --- \| \| Description \| Two-letter county code \| \| Field type \| dimension \| \| Data type \| [string.geo.country.twolettercode](/apidocs/field-data-types#geographical) \| | | Field label | Country code | | Description | Two-letter county code | | Field type | dimension | | Data type | [string.geo.country.twolettercode](/apidocs/field-data-types#geographical) | | \| metros \| \| --- \| \| \\| Field label \\| DMA \\| \\| --- \\| --- \\| \\| Description \\| Targeting location based on Nielsen's Designated Market Area codes \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.geo.metro](/apidocs/field-data-types#geographical) \\| \| \| Field label \| DMA \| \| Description \| Targeting location based on Nielsen's Designated Market Area codes \| \| Field type \| dimension \| \| Data type \| [string.geo.metro](/apidocs/field-data-types#geographical) \| | | metros | | \| Field label \| DMA \| \| --- \| --- \| \| Description \| Targeting location based on Nielsen's Designated Market Area codes \| \| Field type \| dimension \| \| Data type \| [string.geo.metro](/apidocs/field-data-types#geographical) \| | | Field label | DMA | | Description | Targeting location based on Nielsen's Designated Market Area codes | | Field type | dimension | | Data type | [string.geo.metro](/apidocs/field-data-types#geographical) | | \| PLATFORMS \| \| --- \| \| \\| Field label \\| Platform \\| \\| --- \\| --- \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.text.value](/apidocs/field-data-types#text) \\| \| \| Field label \| Platform \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | PLATFORMS | | \| Field label \| Platform \| \| --- \| --- \| \| Field type \| dimension \| \| Data type \| [string.text.value](/apidocs/field-data-types#text) \| | | Field label | Platform | | Field type | dimension | | Data type | [string.text.value](/apidocs/field-data-types#text) | ### TIME | \| today \| \| --- \| \| \\| Field label \\| Today \\| \\| --- \\| --- \\| \\| Description \\| Today's date, e.g. 2017-01-31 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \\| Destinations \\| API, Data warehouse \\| \| \| Field label \| Today \| \| Description \| Today's date, e.g. 2017-01-31 \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| \| Destinations \| API, Data warehouse \| | | --- | | today | | \| Field label \| Today \| \| --- \| --- \| \| Description \| Today's date, e.g. 2017-01-31 \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| \| Destinations \| API, Data warehouse \| | | Field label | Today | | Description | Today's date, e.g. 2017-01-31 | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) | | Destinations | API, Data warehouse | | \| year \| \| --- \| \| \\| Field label \\| Year \\| \\| --- \\| --- \\| \\| Description \\| Year, e.g. 2017 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.year](/apidocs/field-data-types#time) \\| \| \| Field label \| Year \| \| Description \| Year, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | year | | \| Field label \| Year \| \| --- \| --- \| \| Description \| Year, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | Field label | Year | | Description | Year, e.g. 2017 | | Field type | dimension | | Data type | [string.time.year](/apidocs/field-data-types#time) | | \| yearofweek \| \| --- \| \| \\| Field label \\| Year of week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| Year of week for US weeks, e.g. 2017 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.year](/apidocs/field-data-types#time) \\| \| \| Field label \| Year of week (Sun-Sat) \| \| Description \| Year of week for US weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | yearofweek | | \| Field label \| Year of week (Sun-Sat) \| \| --- \| --- \| \| Description \| Year of week for US weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | Field label | Year of week (Sun-Sat) | | Description | Year of week for US weeks, e.g. 2017 | | Field type | dimension | | Data type | [string.time.year](/apidocs/field-data-types#time) | | \| yearofweekiso \| \| --- \| \| \\| Field label \\| Year of week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| Year of week for ISO weeks, e.g. 2017 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.year](/apidocs/field-data-types#time) \\| \| \| Field label \| Year of week (Mon-Sun) \| \| Description \| Year of week for ISO weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | yearofweekiso | | \| Field label \| Year of week (Mon-Sun) \| \| --- \| --- \| \| Description \| Year of week for ISO weeks, e.g. 2017 \| \| Field type \| dimension \| \| Data type \| [string.time.year](/apidocs/field-data-types#time) \| | | Field label | Year of week (Mon-Sun) | | Description | Year of week for ISO weeks, e.g. 2017 | | Field type | dimension | | Data type | [string.time.year](/apidocs/field-data-types#time) | | \| yearmonth \| \| --- \| \| \\| Field label \\| Year & month \\| \\| --- \\| --- \\| \\| Description \\| Year and month, e.g. 2017\\\|06 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.yearmonth](/apidocs/field-data-types#time) \\| \| \| Field label \| Year & month \| \| Description \| Year and month, e.g. 2017\\|06 \| \| Field type \| dimension \| \| Data type \| [string.time.yearmonth](/apidocs/field-data-types#time) \| | | yearmonth | | \| Field label \| Year & month \| \| --- \| --- \| \| Description \| Year and month, e.g. 2017\\|06 \| \| Field type \| dimension \| \| Data type \| [string.time.yearmonth](/apidocs/field-data-types#time) \| | | Field label | Year & month | | Description | Year and month, e.g. 2017\|06 | | Field type | dimension | | Data type | [string.time.yearmonth](/apidocs/field-data-types#time) | | \| quarter \| \| --- \| \| \\| Field label \\| Quarter \\| \\| --- \\| --- \\| \\| Description \\| Quarter, e.g. 1 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.quarter](/apidocs/field-data-types#time) \\| \| \| Field label \| Quarter \| \| Description \| Quarter, e.g. 1 \| \| Field type \| dimension \| \| Data type \| [string.time.quarter](/apidocs/field-data-types#time) \| | | quarter | | \| Field label \| Quarter \| \| --- \| --- \| \| Description \| Quarter, e.g. 1 \| \| Field type \| dimension \| \| Data type \| [string.time.quarter](/apidocs/field-data-types#time) \| | | Field label | Quarter | | Description | Quarter, e.g. 1 | | Field type | dimension | | Data type | [string.time.quarter](/apidocs/field-data-types#time) | | \| month \| \| --- \| \| \\| Field label \\| Month \\| \\| --- \\| --- \\| \\| Description \\| Month, e.g. 6 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.month](/apidocs/field-data-types#time) \\| \| \| Field label \| Month \| \| Description \| Month, e.g. 6 \| \| Field type \| dimension \| \| Data type \| [string.time.month](/apidocs/field-data-types#time) \| | | month | | \| Field label \| Month \| \| --- \| --- \| \| Description \| Month, e.g. 6 \| \| Field type \| dimension \| \| Data type \| [string.time.month](/apidocs/field-data-types#time) \| | | Field label | Month | | Description | Month, e.g. 6 | | Field type | dimension | | Data type | [string.time.month](/apidocs/field-data-types#time) | | \| yearweek \| \| --- \| \| \\| Field label \\| Year & week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| Year and week for US weeks, e.g. 2017\\\|08 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.yearweek](/apidocs/field-data-types#time) \\| \| \| Field label \| Year & week (Sun-Sat) \| \| Description \| Year and week for US weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweek](/apidocs/field-data-types#time) \| | | yearweek | | \| Field label \| Year & week (Sun-Sat) \| \| --- \| --- \| \| Description \| Year and week for US weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweek](/apidocs/field-data-types#time) \| | | Field label | Year & week (Sun-Sat) | | Description | Year and week for US weeks, e.g. 2017\|08 | | Field type | dimension | | Data type | [string.time.yearweek](/apidocs/field-data-types#time) | | \| yearweekiso \| \| --- \| \| \\| Field label \\| Year & week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| Year and week for ISO weeks, e.g. 2017\\\|08 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.yearweekiso](/apidocs/field-data-types#time) \\| \| \| Field label \| Year & week (Mon-Sun) \| \| Description \| Year and week for ISO weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweekiso](/apidocs/field-data-types#time) \| | | yearweekiso | | \| Field label \| Year & week (Mon-Sun) \| \| --- \| --- \| \| Description \| Year and week for ISO weeks, e.g. 2017\\|08 \| \| Field type \| dimension \| \| Data type \| [string.time.yearweekiso](/apidocs/field-data-types#time) \| | | Field label | Year & week (Mon-Sun) | | Description | Year and week for ISO weeks, e.g. 2017\|08 | | Field type | dimension | | Data type | [string.time.yearweekiso](/apidocs/field-data-types#time) | | \| week \| \| --- \| \| \\| Field label \\| Week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| US week number, e.g. 51 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.week](/apidocs/field-data-types#time) \\| \| \| Field label \| Week (Sun-Sat) \| \| Description \| US week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.week](/apidocs/field-data-types#time) \| | | week | | \| Field label \| Week (Sun-Sat) \| \| --- \| --- \| \| Description \| US week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.week](/apidocs/field-data-types#time) \| | | Field label | Week (Sun-Sat) | | Description | US week number, e.g. 51 | | Field type | dimension | | Data type | [string.time.week](/apidocs/field-data-types#time) | | \| weekiso \| \| --- \| \| \\| Field label \\| Week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| ISO week number, e.g. 51 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.weekiso](/apidocs/field-data-types#time) \\| \| \| Field label \| Week (Mon-Sun) \| \| Description \| ISO week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.weekiso](/apidocs/field-data-types#time) \| | | weekiso | | \| Field label \| Week (Mon-Sun) \| \| --- \| --- \| \| Description \| ISO week number, e.g. 51 \| \| Field type \| dimension \| \| Data type \| [string.time.weekiso](/apidocs/field-data-types#time) \| | | Field label | Week (Mon-Sun) | | Description | ISO week number, e.g. 51 | | Field type | dimension | | Data type | [string.time.weekiso](/apidocs/field-data-types#time) | | \| dayOfWeekName \| \| --- \| \| \\| Field label \\| Day of week (Sun-Sat) \\| \\| --- \\| --- \\| \\| Description \\| Day of week name for US weeks, e.g. 0 Sunday \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.dayofweekiso](/apidocs/field-data-types#time) \\| \| \| Field label \| Day of week (Sun-Sat) \| \| Description \| Day of week name for US weeks, e.g. 0 Sunday \| \| Field type \| dimension \| \| Data type \| [string.time.dayofweekiso](/apidocs/field-data-types#time) \| | | dayOfWeekName | | \| Field label \| Day of week (Sun-Sat) \| \| --- \| --- \| \| Description \| Day of week name for US weeks, e.g. 0 Sunday \| \| Field type \| dimension \| \| Data type \| [string.time.dayofweekiso](/apidocs/field-data-types#time) \| | | Field label | Day of week (Sun-Sat) | | Description | Day of week name for US weeks, e.g. 0 Sunday | | Field type | dimension | | Data type | [string.time.dayofweekiso](/apidocs/field-data-types#time) | | \| dayOfWeekNameIso \| \| --- \| \| \\| Field label \\| Day of week (Mon-Sun) \\| \\| --- \\| --- \\| \\| Description \\| Day of week name for ISO weeks, e.g. 1 Monday \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.dayofweek](/apidocs/field-data-types#time) \\| \| \| Field label \| Day of week (Mon-Sun) \| \| Description \| Day of week name for ISO weeks, e.g. 1 Monday \| \| Field type \| dimension \| \| Data type \| [string.time.dayofweek](/apidocs/field-data-types#time) \| | | dayOfWeekNameIso | | \| Field label \| Day of week (Mon-Sun) \| \| --- \| --- \| \| Description \| Day of week name for ISO weeks, e.g. 1 Monday \| \| Field type \| dimension \| \| Data type \| [string.time.dayofweek](/apidocs/field-data-types#time) \| | | Field label | Day of week (Mon-Sun) | | Description | Day of week name for ISO weeks, e.g. 1 Monday | | Field type | dimension | | Data type | [string.time.dayofweek](/apidocs/field-data-types#time) | | \| dayOfMonth \| \| --- \| \| \\| Field label \\| Day of month \\| \\| --- \\| --- \\| \\| Description \\| Day of month, e.g. 2 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.dayofmonth](/apidocs/field-data-types#time) \\| \| \| Field label \| Day of month \| \| Description \| Day of month, e.g. 2 \| \| Field type \| dimension \| \| Data type \| [string.time.dayofmonth](/apidocs/field-data-types#time) \| | | dayOfMonth | | \| Field label \| Day of month \| \| --- \| --- \| \| Description \| Day of month, e.g. 2 \| \| Field type \| dimension \| \| Data type \| [string.time.dayofmonth](/apidocs/field-data-types#time) \| | | Field label | Day of month | | Description | Day of month, e.g. 2 | | Field type | dimension | | Data type | [string.time.dayofmonth](/apidocs/field-data-types#time) | | \| date \| \| --- \| \| \\| Field label \\| Date \\| \\| --- \\| --- \\| \\| Description \\| Date, e.g. 2017-01-31 \\| \\| Field type \\| dimension \\| \\| Data type \\| [string.time.date](/apidocs/field-data-types#time) \\| \| \| Field label \| Date \| \| Description \| Date, e.g. 2017-01-31 \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | date | | \| Field label \| Date \| \| --- \| --- \| \| Description \| Date, e.g. 2017-01-31 \| \| Field type \| dimension \| \| Data type \| [string.time.date](/apidocs/field-data-types#time) \| | | Field label | Date | | Description | Date, e.g. 2017-01-31 | | Field type | dimension | | Data type | [string.time.date](/apidocs/field-data-types#time) |