Pinterest: Most-used fields#
The table below gives information about most-used fields that you can import from Pinterest. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
3-Second Video Views |
3-Second Video Views |
Total video views that lasted for at least 3 seconds. |
dimension |
ADVERTISER_ID |
ADVERTISER_ID |
Unique identifier for the advertiser account. |
dimension |
AD_ACCOUNT_ID |
AD_ACCOUNT_ID |
The unique identifier for the ad account. |
dimension |
AD_GROUP_ID |
AD_GROUP_ID |
The unique identifier for the ad group. |
dimension |
AD_ID |
AD_ID |
The unique identifier for the ad. |
dimension |
Advertiser ID |
Advertiser ID |
Unique identifier for the advertiser account. |
dimension |
Advertiser Name |
Advertiser Name |
The name of the advertiser account. |
dimension |
CAMPAIGN_ID |
CAMPAIGN_ID |
Unique identifier for the campaign. |
dimension |
CAMPAIGN_NAME |
CAMPAIGN_NAME |
The name of the campaign. |
dimension |
CPC_IN_MICRO_DOLLAR |
CPC_IN_MICRO_DOLLAR |
The cost per click (CPC) in microdollars (1/1,000,000 of a US dollar). |
metric |
CPM_IN_MICRO_DOLLAR |
CPM_IN_MICRO_DOLLAR |
The cost per mille (thousand impressions) (CPM) in microdollars (1/1,000,000 of a US dollar). |
metric |
CTR |
CTR |
The clickthrough rate, calculated as clicks divided by impressions. |
metric |
Conversions (Checkout) |
Conversions (Checkout) |
The total number of checkout conversion events. |
metric |
Conversions (Custom) |
Conversions (Custom) |
The total number of custom conversion events. |
metric |
Conversions (Lead) |
Conversions (Lead) |
The total number of lead conversion events. |
dimension |
DATE |
DATE |
The date for which the metrics are reported. |
dimension |
ECPC_IN_MICRO_DOLLAR |
ECPC_IN_MICRO_DOLLAR |
The effective cost per click (eCPC) in microdollars (1/1,000,000 of a US dollar). |
metric |
ECPM_IN_MICRO_DOLLAR |
ECPM_IN_MICRO_DOLLAR |
The effective cost per mille (thousand impressions) (eCPM) in microdollars (1/1,000,000 of a US dollar). |
metric |
Earned 3-Second Video Views |
Earned 3-Second Video Views |
The number of organic video views where the video played for at least 3 seconds. This metric is related to organic video performance. |
metric |
Earned CTR |
Earned CTR |
The click-through rate for organic content. |
metric |
Engagements |
Engagements |
The total number of engagements on content, such as closeups, link clicks, or saves. |
metric |
Id |
Id |
A unique identifier for an entity, such as an ad, campaign, ad group, or Pin. |
dimension |
Order quantity (Checkout) |
Order quantity (Checkout) |
The total quantity of items purchased in checkout conversions. |
dimension |
Order value (Checkout) |
Order value (Checkout) |
The monetary value of checkout conversions. |
metric |
PAID_IMPRESSION |
PAID_IMPRESSION |
The number of impressions attributed to paid ads. |
metric |
PIN_ID |
PIN_ID |
The unique identifier for the Pin. |
dimension |
PIN_PROMOTION_ID |
PIN_PROMOTION_ID |
Unique identifier for a promoted Pin. |
dimension |
PIN_PROMOTION_NAME |
PIN_PROMOTION_NAME |
The name of the promotion associated with a Pin. |
dimension |
Paid CTR |
Paid CTR |
The click-through rate for paid advertisements. |
metric |
SPEND_IN_DOLLAR |
SPEND_IN_DOLLAR |
The total amount of money spent on ads, expressed in US dollars. |
metric |
Spend |
Spend |
The total amount of money spent on an ad campaign. |
metric |
TOTAL_CHECKOUT |
TOTAL_CHECKOUT |
The total number of checkout conversion events. |
metric |
TOTAL_ENGAGEMENT |
TOTAL_ENGAGEMENT |
The total number of engagements with an ad or Pin (e.g., saves, closeups, link clicks). |
metric |
TOTAL_IMPRESSION |
TOTAL_IMPRESSION |
The total number of impressions, including both paid and organic. |
metric |
TOTAL_VIEW_LEAD |
TOTAL_VIEW_LEAD |
The total number of lead events attributed to views. |
dimension |
Total 3-Second Video Views |
Total 3-Second Video Views |
Total video views that lasted for at least 3 seconds. |
dimension |
Web conversions (Watch video) |
Web conversions (Watch video) |
The number of website conversions where the user watched a video. |
dimension |
ad_account_country |
ad_account_country |
The country associated with the ad account. |
dimension |
ad_account_created_time |
ad_account_created_time |
The creation time of the ad account in Unix timestamp (seconds). |
dimension |
ad_account_currency |
ad_account_currency |
The currency used by the ad account. |
dimension |
ad_account_id |
ad_account_id |
The unique identifier for the ad account. |
dimension |
ad_account_name |
ad_account_name |
The name of the ad account. |
dimension |
ad_account_owner |
ad_account_owner |
Details about the user account that owns the ad account, including username and ID. |
dimension |
ad_account_permissions |
ad_account_permissions |
The list of permissions granted for business access to the ad account. |
dimension |
ad_account_updated_time |
ad_account_updated_time |
The last update time of the ad account in Unix timestamp (seconds). |
dimension |
ad_ad_account_id |
ad_ad_account_id |
The unique identifier of the ad account to which the ad belongs. |
dimension |
ad_ad_group_id |
ad_ad_group_id |
The unique identifier of the ad group to which the ad belongs. |
dimension |
ad_android_deep_link |
ad_android_deep_link |
The deep link URL for Android devices, used to direct users to specific content within an app. |
dimension |
ad_campaign_id |
ad_campaign_id |
The unique identifier of the campaign to which the ad belongs. |
dimension |
ad_carousel_destination_urls |
ad_carousel_destination_urls |
A list of destination URLs for each card within a carousel ad. |
dimension |
ad_click_tracking_url |
ad_click_tracking_url |
The URL used for tracking clicks on the ad. |
dimension |
ad_created_time |
ad_created_time |
The timestamp indicating when the ad was created. |
metric |
ad_creative_type |
ad_creative_type |
The format or type of creative used for the ad (e.g., image, video, carousel). |
dimension |
ad_destination_url |
ad_destination_url |
The final URL where users are directed after interacting with the ad. |
dimension |
ad_group_auto_targeting_enabled |
ad_group_auto_targeting_enabled |
Indicates if auto-targeting (also known as expanded targeting) is enabled for the ad group. |
dimension |
ad_group_bid_in_micro_currency |
ad_group_bid_in_micro_currency |
The bid price for the ad group in microcurrency (1/1,000,000 of the standard currency unit). This is required for specific campaign objective/billable event combinations. |
dimension |
ad_group_bid_multiplier |
ad_group_bid_multiplier |
The multiplier applied to the base bid for an ad group, affecting its bidding strategy. |
dimension |
ad_group_bid_strategy_type |
ad_group_bid_strategy_type |
The bid strategy type for the ad group, such as AUTOMATIC_BID, MAX_BID, or TARGET_AVG. |
dimension |
ad_group_billable_event |
ad_group_billable_event |
The billable event type for the ad group, such as CLICKTHROUGH, IMPRESSION, or VIDEO_V_50_MRC. |
dimension |
ad_group_budget_in_micro_currency |
ad_group_budget_in_micro_currency |
The budget for the ad group in microcurrency (1/1,000,000 of the standard currency unit). This is required for non-CBO campaigns. |
dimension |
ad_group_budget_type |
ad_group_budget_type |
The budget type for the ad group, either DAILY or LIFETIME. |
dimension |
ad_group_conversion_learning_mode_type |
ad_group_conversion_learning_mode_type |
The conversion learning mode type for the ad group, indicating how the optimization goal is learning. |
dimension |
ad_group_created_time |
ad_group_created_time |
The creation time of the ad group in Unix timestamp (seconds). |
dimension |
ad_group_dca_assets |
ad_group_dca_assets |
Dynamic Creative Assembly (DCA) assets used for the ad group, which allows for automatically generated optimized ad combinations. |
dimension |
ad_group_end_time |
ad_group_end_time |
The end time of the ad group in Unix timestamp (seconds). |
dimension |
ad_group_entity_status |
ad_group_entity_status |
The status of the ad group entity, indicating if it is active, paused, or archived. |
dimension |
ad_group_feed_profile_id |
ad_group_feed_profile_id |
The Feed Profile ID associated with the ad group. |
dimension |
ad_group_id |
ad_group_id |
The unique identifier for the ad group. |
dimension |
ad_group_lifetime_frequency_cap |
ad_group_lifetime_frequency_cap |
A limit on the number of times a promoted Pin from this ad group can be impressed by a Pinner within a rolling 30-day period. |
metric |
ad_group_name |
ad_group_name |
The name of the ad group. |
dimension |
ad_group_optimization |
ad_group_optimization |
The optimization goal or strategy configured for the ad group, such as driving clicks or conversions. |
dimension |
ad_group_optimization_goal_metadata |
ad_group_optimization_goal_metadata |
Metadata defining the optimization goals for objective-based performance campaigns for the ad group. This is required when the campaign’s objective type is ‘WEB_CONVERSION’. |
dimension |
ad_group_pacing_delivery_type |
ad_group_pacing_delivery_type |
The pacing delivery type for the ad group, either STANDARD (spent smoothly) or ACCELERATED (spent as fast as possible). |
dimension |
ad_group_placement_group |
ad_group_placement_group |
The specific placement group where an ad group is shown, such as a product group. |
dimension |
ad_group_start_time |
ad_group_start_time |
The start time of the ad group in Unix timestamp (seconds). |
dimension |
ad_group_status |
ad_group_status |
The current status of the ad group, such as ACTIVE, PAUSED, or ARCHIVED. |
dimension |
ad_group_summary_status |
ad_group_summary_status |
The summary status for the ad group, such as RUNNING, PAUSED, or ARCHIVED. |
dimension |
ad_group_targeting_spec |
ad_group_targeting_spec |
Specifications for audience targeting applied to an ad group, used for breaking down ad performance reports by targeting type. |
dimension |
ad_group_tracking_urls |
ad_group_tracking_urls |
Third-party tracking URLs for various ad events at the ad group level. |
dimension |
ad_group_type |
ad_group_type |
The type of the ad group, which is always ‘adgroup’. |
dimension |
ad_group_updated_time |
ad_group_updated_time |
The timestamp indicating the last time the ad group was updated. |
dimension |
ad_id |
ad_id |
The unique identifier for the ad. |
dimension |
ad_ios_deep_link |
ad_ios_deep_link |
The deep link URL for iOS devices, used to direct users to specific content within an app. |
dimension |
ad_name |
ad_name |
The name of the ad. |
dimension |
ad_pin_id |
ad_pin_id |
The unique identifier of the Pin that serves as the creative for the ad. |
dimension |
ad_rejected_reasons |
ad_rejected_reasons |
A list of reasons provided if the ad was rejected during the Pinterest review process, detailing specific policy violations or issues. |
dimension |
ad_rejection_labels |
ad_rejection_labels |
Labels indicating specific policy violations or issues that led to the ad’s rejection. |
dimension |
ad_review_status |
ad_review_status |
The current review status of the ad (e.g., approved, pending, rejected). |
dimension |
ad_status |
ad_status |
The current status of the ad, indicating if it is active, paused, or archived. |
dimension |
ad_tracking_urls |
ad_tracking_urls |
A collection of URLs used for tracking various interactions and events related to the ad. |
dimension |
ad_type |
ad_type |
The general classification or category of the ad. |
dimension |
ad_updated_time |
ad_updated_time |
The timestamp indicating when the ad was last updated. |
metric |
ad_view_tracking_url |
ad_view_tracking_url |
The URL used for tracking when the ad is viewed or displayed. |
dimension |
add_to_cart_desktop_action_desktop_conversion |
add_to_cart_desktop_action_desktop_conversion |
The number of “add to cart” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device. |
metric |
add_to_cart_desktop_action_mobile_conversion |
add_to_cart_desktop_action_mobile_conversion |
The number of “add to cart” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device. |
metric |
add_to_cart_desktop_action_tablet_conversion |
add_to_cart_desktop_action_tablet_conversion |
The number of “add to cart” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device. |
metric |
add_to_cart_mobile_action_desktop_conversion |
add_to_cart_mobile_action_desktop_conversion |
The number of “add to cart” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device. |
metric |
add_to_cart_mobile_action_mobile_conversion |
add_to_cart_mobile_action_mobile_conversion |
The number of “add to cart” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device. |
metric |
add_to_cart_mobile_action_tablet_conversion |
add_to_cart_mobile_action_tablet_conversion |
The number of “add to cart” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device. |
metric |
add_to_cart_tablet_action_desktop_conversion |
add_to_cart_tablet_action_desktop_conversion |
The number of “add to cart” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device. |
metric |
add_to_cart_tablet_action_mobile_conversion |
add_to_cart_tablet_action_mobile_conversion |
The number of “add to cart” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device. |
metric |
add_to_cart_tablet_action_tablet_conversion |
add_to_cart_tablet_action_tablet_conversion |
The number of “add to cart” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device. |
metric |
ads_CLICKTHROUGH_1 |
ads_CLICKTHROUGH_1 |
The number of times users clicked through an ad. The suffix ‘1’ may refer to a specific attribution window. |
dimension |
ads_CLICKTHROUGH_2 |
ads_CLICKTHROUGH_2 |
The number of times users clicked through an ad. The suffix ‘2’ may refer to a different attribution window or methodology. |
metric |
ads_REPIN_1 |
ads_REPIN_1 |
The number of times users saved or ‘re-pinned’ an ad to one of their boards. The suffix ‘1’ may refer to a specific attribution window. |
dimension |
ads_REPIN_2 |
ads_REPIN_2 |
The number of times users saved or ‘re-pinned’ an ad to one of their boards. The suffix ‘2’ may refer to a different attribution window or methodology. |
dimension |
ads_SPEND_IN_MICRO_DOLLAR |
ads_SPEND_IN_MICRO_DOLLAR |
The total advertising spend specifically for ads, expressed in micro-dollars. |
dimension |
ads_TOTAL_CHECKOUT |
ads_TOTAL_CHECKOUT |
The total number of checkout conversions for ads. |
dimension |
ads_TOTAL_CLICK_ADD_TO_CART |
ads_TOTAL_CLICK_ADD_TO_CART |
The total number of add-to-cart events attributed to clicks on ads. |
dimension |
ads_TOTAL_CLICK_CHECKOUT |
ads_TOTAL_CLICK_CHECKOUT |
The total number of checkout events attributed to clicks on ads. |
dimension |
ads_TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
ads_TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
The total value of checkout conversions attributed to clicks on ads, expressed in micro-dollars. |
dimension |
ads_TOTAL_CLICK_LEAD |
ads_TOTAL_CLICK_LEAD |
The total number of lead generation events attributed to clicks on ads. |
dimension |
ads_TOTAL_CLICK_SIGNUP |
ads_TOTAL_CLICK_SIGNUP |
The total number of signup events attributed to clicks on ads. |
dimension |
ads_TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR |
ads_TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR |
The total value of signup conversions attributed to clicks on ads, expressed in micro-dollars. |
dimension |
ads_TOTAL_CONVERSIONS |
ads_TOTAL_CONVERSIONS |
The total number of all conversions specifically for ads. |
dimension |
ads_TOTAL_ENGAGEMENT |
ads_TOTAL_ENGAGEMENT |
The total number of engagements with ads, encompassing various user interactions. |
metric |
ads_TOTAL_ENGAGEMENT_CHECKOUT |
ads_TOTAL_ENGAGEMENT_CHECKOUT |
The total number of checkout conversions attributed to user engagements with ads. |
dimension |
ads_TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
ads_TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
The total value of checkout conversions attributed to engagements with ads, expressed in micro-dollars. |
dimension |
ads_TOTAL_ENGAGEMENT_LEAD |
ads_TOTAL_ENGAGEMENT_LEAD |
The total number of lead generation events attributed to user engagements with ads. |
dimension |
ads_TOTAL_ENGAGEMENT_SIGNUP |
ads_TOTAL_ENGAGEMENT_SIGNUP |
The total number of signup events attributed to user engagements with ads. |
dimension |
ads_TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR |
ads_TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR |
The total value of signup conversions attributed to engagements with ads, expressed in micro-dollars. |
dimension |
ads_TOTAL_LEAD |
ads_TOTAL_LEAD |
The total number of lead generation conversions for ads. |
dimension |
ads_TOTAL_VIDEO_3SEC_VIEWS |
ads_TOTAL_VIDEO_3SEC_VIEWS |
The total number of video views for ads that lasted at least 3 seconds. |
metric |
ads_TOTAL_VIEW_ADD_TO_CART |
ads_TOTAL_VIEW_ADD_TO_CART |
The total number of add-to-cart events attributed to views of ads. |
dimension |
ads_TOTAL_VIEW_CHECKOUT |
ads_TOTAL_VIEW_CHECKOUT |
The total number of checkout events attributed to views of ads. |
dimension |
ads_TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
ads_TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
The total value of checkout conversions attributed to views of ads, expressed in micro-dollars. |
dimension |
ads_TOTAL_VIEW_LEAD |
ads_TOTAL_VIEW_LEAD |
The total number of lead generation events attributed to views of ads. |
dimension |
ads_TOTAL_VIEW_SIGNUP |
ads_TOTAL_VIEW_SIGNUP |
The total number of signup events attributed to views of ads. |
dimension |
ads_TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR |
ads_TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR |
The total value of signup conversions attributed to views of ads, expressed in micro-dollars. |
dimension |
ads_TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
ads_TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
The total value of web checkout conversions for ads, expressed in micro-dollars. |
dimension |
ads_TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
ads_TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
The total value of web checkout conversions attributed to clicks on ads, expressed in micro-dollars. |
dimension |
ads_TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
ads_TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
The total value of web checkout conversions attributed to engagements with ads, expressed in micro-dollars. |
dimension |
ads_TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
ads_TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR |
The total value of web checkout conversions attributed to views of ads, expressed in micro-dollars. |
dimension |
ads_VIDEO_LENGTH |
ads_VIDEO_LENGTH |
The duration of the video creative used in the ad, in seconds. |
metric |
ads_creative_type |
ads_creative_type |
The type of creative used for the ad (e.g., image, video, carousel). |
dimension |
ads_destination_url |
ads_destination_url |
The primary URL where users are directed after interacting with the ad. |
dimension |
ads_id |
ads_id |
Unique identifier for a specific ad. |
dimension |
ads_name |
ads_name |
The name of the ad. |
dimension |
ads_review_status |
ads_review_status |
The current review status of an ad (e.g., approved, pending, rejected). |
dimension |
ads_status |
ads_status |
The current status of the ad (e.g., active, paused, archived). |
dimension |
ads_type |
ads_type |
The type of ad, categorizing its format or objective. |
dimension |
advertiser |
advertiser |
The name or identifier of the advertiser associated with the campaign or ad. |
dimension |
advertiser_country |
advertiser_country |
The country associated with the advertiser’s account. |
dimension |
advertiser_currency |
advertiser_currency |
The currency used for the advertiser’s account for billing and reporting. |
dimension |
advertiser_id |
advertiser_id |
The unique identifier for the advertiser. |
dimension |
advertiser_name |
advertiser_name |
The name of the advertiser. |
dimension |
agency |
agency |
The name or identifier of the advertising agency managing the campaigns. |
dimension |
app_install_desktop_action_desktop_conversion |
app_install_desktop_action_desktop_conversion |
The number of “app install” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device. |
metric |
app_install_desktop_action_mobile_conversion |
app_install_desktop_action_mobile_conversion |
The number of “app install” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device. |
metric |
app_install_desktop_action_tablet_conversion |
app_install_desktop_action_tablet_conversion |
The number of “app install” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device. |
dimension |
app_install_mobile_action_desktop_conversion |
app_install_mobile_action_desktop_conversion |
The number of “app install” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device. |
metric |
app_install_mobile_action_mobile_conversion |
app_install_mobile_action_mobile_conversion |
The number of “app install” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device. |
metric |
app_install_mobile_action_tablet_conversion |
app_install_mobile_action_tablet_conversion |
The number of “app install” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device. |
dimension |
app_install_tablet_action_desktop_conversion |
app_install_tablet_action_desktop_conversion |
The number of “app install” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device. |
metric |
app_install_tablet_action_mobile_conversion |
app_install_tablet_action_mobile_conversion |
The number of “app install” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device. |
metric |
app_install_tablet_action_tablet_conversion |
app_install_tablet_action_tablet_conversion |
The number of “app install” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device. |
dimension |
brand |
brand |
The brand associated with the advertisement or product. |
dimension |
buying_type |
buying_type |
The purchasing model for ad space (e.g., auction, fixed price). |
dimension |
campaign_created_time |
campaign_created_time |
The creation time of the campaign in Unix timestamp (seconds). |
dimension |
campaign_daily_spend_cap |
campaign_daily_spend_cap |
The daily spending cap for the campaign in microcurrency. |
metric |
campaign_end_time |
campaign_end_time |
The scheduled end time of the campaign. |
dimension |
campaign_entity_status |
campaign_entity_status |
The status of the campaign entity, indicating if it is active, paused, or archived. |
dimension |
campaign_id |
campaign_id |
The unique identifier for the campaign. |
dimension |
campaign_is_campaign_budget_optimization |
campaign_is_campaign_budget_optimization |
A boolean value indicating whether the campaign is using Campaign Budget Optimization (CBO), a feature where Pinterest automatically distributes the campaign budget across ad groups to optimize performance. |
dimension |
campaign_is_flexible_daily_budgets |
campaign_is_flexible_daily_budgets |
A boolean value indicating whether the campaign is utilizing Flexible Daily Budgets (FDB), which allows for automatic adjustment of daily ad spend, including rolling over unspent budget and overspending on high-opportunity days, to optimize performance over a weekly period. |
dimension |
campaign_lifetime_spend_cap |
campaign_lifetime_spend_cap |
The total spending cap for the campaign’s lifetime in microcurrency. |
metric |
campaign_managed_status |
campaign_managed_status |
The current management status of the campaign (e.g., active, paused, archived). |
dimension |
campaign_name |
campaign_name |
The name of the campaign. |
dimension |
campaign_objective |
campaign_objective |
The primary goal of an advertising campaign (e.g., brand awareness, traffic, conversions). |
dimension |
campaign_objective_type |
campaign_objective_type |
The objective type of the campaign (e.g., BRAND_AWARENESS, TRAFFIC, CONVERSION). |
dimension |
campaign_order_line_id |
campaign_order_line_id |
The unique identifier for the order line associated with a campaign. |
dimension |
campaign_start_time |
campaign_start_time |
The scheduled start time of the campaign. |
dimension |
campaign_status |
campaign_status |
The current status of the campaign, indicating if it is active, paused, or archived. |
dimension |
campaign_summary_status |
campaign_summary_status |
The overall summary status of the campaign, indicating its current state (e.g., “RUNNING”, “PAUSED”, “ARCHIVED”). |
dimension |
campaign_tracking_urls |
campaign_tracking_urls |
A list of tracking URLs associated with the campaign for monitoring performance and attributing actions. |
dimension |
campaign_type |
campaign_type |
The type of the campaign, which is always ‘campaign’. |
dimension |
campaign_updated_time |
campaign_updated_time |
The timestamp indicating the last time a campaign was updated. |
dimension |
checkout_desktop_action_desktop_conversion |
checkout_desktop_action_desktop_conversion |
The number of “checkout” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device. |
metric |
checkout_desktop_action_mobile_conversion |
checkout_desktop_action_mobile_conversion |
The number of “checkout” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device. |
metric |
checkout_desktop_action_tablet_conversion |
checkout_desktop_action_tablet_conversion |
The number of “checkout” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device. |
dimension |
checkout_mobile_action_desktop_conversion |
checkout_mobile_action_desktop_conversion |
The number of “checkout” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device. |
metric |
checkout_mobile_action_mobile_conversion |
checkout_mobile_action_mobile_conversion |
The number of “checkout” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device. |
metric |
checkout_mobile_action_tablet_conversion |
checkout_mobile_action_tablet_conversion |
The number of “checkout” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device. |
metric |
checkout_roas |
checkout_roas |
Return on ad spend (ROAS) for checkout conversions. |
metric |
checkout_tablet_action_desktop_conversion |
checkout_tablet_action_desktop_conversion |
The number of “checkout” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device. |
metric |
checkout_tablet_action_mobile_conversion |
checkout_tablet_action_mobile_conversion |
The number of “checkout” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device. |
metric |
checkout_tablet_action_tablet_conversion |
checkout_tablet_action_tablet_conversion |
The number of “checkout” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device. |
metric |
checkout_value_from_click_conversions_micro |
checkout_value_from_click_conversions_micro |
The value of checkout conversions in microcurrency attributed to click actions. |
metric |
checkout_value_from_engagement_conversions_micro |
checkout_value_from_engagement_conversions_micro |
The value of checkout conversions in microcurrency attributed to engagement actions. |
metric |
checkout_value_from_view_conversions_micro |
checkout_value_from_view_conversions_micro |
The value of checkout conversions in microcurrency attributed to view-through actions. |
metric |
clicks |
clicks |
The total number of clicks on a Pin or ad. |
metric |
clickthrough |
clickthrough |
Total number of clickthroughs on a Pin or ad, which includes any clicks that lead to a destination outside of Pinterest. |
dimension |
clickthrough_1 |
clickthrough_1 |
The number of times users clicked through the ad. The suffix ‘1’ may refer to a specific attribution window (e.g., 1-day clickthrough). |
metric |
clickthrough_2 |
clickthrough_2 |
The number of times users clicked through the ad. The suffix ‘2’ may refer to a different attribution window or methodology (e.g., 7-day clickthrough). |
dimension |
clickthrough_conversions_(add_to_cart) |
clickthrough_conversions_(add_to_cart) |
The number of add-to-cart conversions attributed to click actions. |
metric |
clickthrough_conversions_(app_install) |
clickthrough_conversions_(app_install) |
The number of app install conversions attributed to click actions. |
metric |
clickthrough_conversions_(category_view) |
clickthrough_conversions_(category_view) |
The number of category view conversions attributed to click actions. |
dimension |
clickthrough_conversions_(checkout) |
clickthrough_conversions_(checkout) |
The number of checkout conversions attributed to clickthroughs. |
metric |
clickthrough_conversions_(custom) |
clickthrough_conversions_(custom) |
The number of custom conversions attributed to click actions. |
metric |
clickthrough_conversions_(lead) |
clickthrough_conversions_(lead) |
The number of lead conversions attributed to clickthroughs. |
dimension |
clickthrough_conversions_(page_visit) |
clickthrough_conversions_(page_visit) |
The number of page visit conversions attributed to clickthroughs. |
metric |
clickthrough_conversions_(signup) |
clickthrough_conversions_(signup) |
The number of signup conversions attributed to click actions. |
dimension |
clickthrough_conversions_(unknown) |
clickthrough_conversions_(unknown) |
The total number of conversions attributed to user clicks on ads, where the specific conversion action type is not categorized. |
metric |
clickthrough_conversions_(watch_video) |
clickthrough_conversions_(watch_video) |
The number of watch video conversions attributed to click actions. |
dimension |
clickthrough_conversions_(website_search) |
clickthrough_conversions_(website_search) |
The number of website search conversions attributed to click actions. |
dimension |
clickthrough_order_quantity_(checkout) |
clickthrough_order_quantity_(checkout) |
The quantity of items purchased in checkout conversions attributed to click actions. |
dimension |
clickthrough_value_micro_(add_to_cart) |
clickthrough_value_micro_(add_to_cart) |
The monetary value, in micro-units of the advertiser’s currency, of “add to cart” conversions attributed to user clicks on ads. |
metric |
clickthrough_value_micro_(app_install) |
clickthrough_value_micro_(app_install) |
The monetary value, in micro-units of the advertiser’s currency, of “app install” conversions attributed to user clicks on ads. |
metric |
clickthrough_value_micro_(category_view) |
clickthrough_value_micro_(category_view) |
The monetary value, in micro-units of the advertiser’s currency, of “category view” conversions attributed to user clicks on ads. |
metric |
clickthrough_value_micro_(custom) |
clickthrough_value_micro_(custom) |
The monetary value, in micro-units of the advertiser’s currency, of “custom” conversions attributed to user clicks on ads. |
metric |
clickthrough_value_micro_(lead) |
clickthrough_value_micro_(lead) |
The value of lead conversions in microcurrency attributed to click actions. |
metric |
clickthrough_value_micro_(page_visit) |
clickthrough_value_micro_(page_visit) |
The monetary value, in micro-units of the advertiser’s currency, of “page visit” conversions attributed to user clicks on ads. |
metric |
clickthrough_value_micro_(signup) |
clickthrough_value_micro_(signup) |
The value of signup conversions in microcurrency attributed to click actions. |
metric |
clickthrough_value_micro_(unknown) |
clickthrough_value_micro_(unknown) |
The monetary value, in micro-units of the advertiser’s currency, of “unknown” conversions attributed to user clicks on ads. |
metric |
clickthrough_value_micro_(watch_video) |
clickthrough_value_micro_(watch_video) |
The monetary value, in micro-units of the advertiser’s currency, of “watch video” conversions attributed to user clicks on ads. |
metric |
clickthrough_value_micro_(website_search) |
clickthrough_value_micro_(website_search) |
The monetary value, in micro-units of the advertiser’s currency, of “website search” conversions attributed to user clicks on ads. |
metric |
closeup |
closeup |
The number of times a Pin closeup was viewed. |
dimension |
conversion_quantity_from_add_to_cart_clicks |
conversion_quantity_from_add_to_cart_clicks |
The number of “add to cart” conversions that resulted from user clicks on ads. |
dimension |
conversion_quantity_from_add_to_cart_engagements |
conversion_quantity_from_add_to_cart_engagements |
The number of “add to cart” conversions that resulted from user engagements on ads. |
dimension |
conversion_quantity_from_add_to_cart_views |
conversion_quantity_from_add_to_cart_views |
The number of “add to cart” conversions that resulted from user views on ads. |
dimension |
conversion_quantity_from_custom_clicks |
conversion_quantity_from_custom_clicks |
The quantity of custom conversions attributed to clicks on ads. |
dimension |
conversion_quantity_from_custom_engagements |
conversion_quantity_from_custom_engagements |
The number of “custom” conversions that resulted from user engagements on ads. |
dimension |
conversion_quantity_from_custom_views |
conversion_quantity_from_custom_views |
The quantity of custom conversions attributed to views of ads. |
dimension |
conversion_quantity_from_lead_clicks |
conversion_quantity_from_lead_clicks |
The number of “lead” conversions that resulted from user clicks on ads. |
dimension |
conversion_quantity_from_lead_engagements |
conversion_quantity_from_lead_engagements |
The number of “lead” conversions that resulted from user engagements on ads. |
dimension |
conversion_quantity_from_lead_views |
conversion_quantity_from_lead_views |
The number of “lead” conversions that resulted from user views on ads. |
dimension |
conversion_quantity_from_page_visit_clicks |
conversion_quantity_from_page_visit_clicks |
The number of “page visit” conversions that resulted from user clicks on ads. |
dimension |
conversion_quantity_from_page_visit_views |
conversion_quantity_from_page_visit_views |
The number of “page visit” conversions that resulted from user views on ads. |
dimension |
conversion_quantity_from_page_visits |
conversion_quantity_from_page_visits |
The number of “page visit” conversions that resulted from user visits on ads. |
dimension |
conversion_quantity_from_search_clicks |
conversion_quantity_from_search_clicks |
The number of “search” conversions that resulted from user clicks on ads. |
dimension |
conversion_quantity_from_search_engagements |
conversion_quantity_from_search_engagements |
The number of “search” conversions that resulted from user engagements on ads. |
dimension |
conversion_quantity_from_search_views |
conversion_quantity_from_search_views |
The number of “search” conversions that resulted from user views on ads. |
dimension |
conversion_quantity_from_signup_clicks |
conversion_quantity_from_signup_clicks |
The quantity of signup conversions resulting from clicks. |
dimension |
conversion_quantity_from_signup_engagements |
conversion_quantity_from_signup_engagements |
The number of “signup” conversions that resulted from user engagements on ads. |
dimension |
conversion_quantity_from_signup_views |
conversion_quantity_from_signup_views |
The number of “signup” conversions that resulted from user views on ads. |
dimension |
conversion_quantity_from_unknown_clicks |
conversion_quantity_from_unknown_clicks |
The total number of conversions attributed to user clicks on your Pinterest content or ads. This metric represents the quantity of conversion events where the specific source of the click leading to conversion is not explicitly identified beyond a click interaction. |
dimension |
conversion_quantity_from_unknown_engagements |
conversion_quantity_from_unknown_engagements |
The number of “unknown” conversions that resulted from user engagements on ads. |
dimension |
conversion_quantity_from_unknown_views |
conversion_quantity_from_unknown_views |
The total number of conversions attributed to user views of your Pinterest content or ads. This metric represents the quantity of conversion events where the specific source of the view leading to conversion is not explicitly identified beyond a view interaction. |
dimension |
conversion_quantity_from_view_category_clicks |
conversion_quantity_from_view_category_clicks |
The number of “view category” conversions that resulted from user clicks on ads. |
dimension |
conversion_quantity_from_view_category_engagements |
conversion_quantity_from_view_category_engagements |
The number of “view category” conversions that resulted from user engagements on ads. |
dimension |
conversion_quantity_from_view_category_views |
conversion_quantity_from_view_category_views |
The number of “view category” conversions that resulted from user views on ads. |
dimension |
conversion_quantity_from_watch_video_clicks |
conversion_quantity_from_watch_video_clicks |
The number of “watch video” conversions that resulted from user clicks on ads. |
dimension |
conversion_quantity_from_watch_video_engagements |
conversion_quantity_from_watch_video_engagements |
The number of “watch video” conversions that resulted from user engagements on ads. |
dimension |
conversion_quantity_from_watch_video_views |
conversion_quantity_from_watch_video_views |
The number of “watch video” conversions that resulted from user views on ads. |
dimension |
conversions |
conversions |
The total number of conversion events. |
metric |
conversions_(app_install) |
conversions_(app_install) |
The total number of app install conversions. |
metric |
cost_per_2second_50%_viewability_video_view_micro |
cost_per_2second_50%_viewability_video_view_micro |
The cost incurred for each video view that achieved at least 50% viewability for 2 seconds, represented in micro-units of the advertiser’s currency. |
metric |
cost_per_at_least_95%_completed_video_view_micro |
cost_per_at_least_95%_completed_video_view_micro |
The cost in microcurrency for a video view completed to at least 95%. |
metric |
cost_per_completed_video_view_micro |
cost_per_completed_video_view_micro |
The cost in microcurrency for a completed video view. |
metric |
cost_per_lead |
cost_per_lead |
The cost associated with generating a lead. |
dimension |
cost_per_outbound_click |
cost_per_outbound_click |
The cost associated with each outbound click. |
dimension |
cost_per_outbound_click_in_dollar |
cost_per_outbound_click_in_dollar |
The cost per outbound click (CPC) for the ad, expressed in dollars. |
dimension |
country |
country |
The two-character ISO 3166-1 alpha-2 country code associated with an ad account or audience. |
dimension |
cpa_(app_install) |
cpa_(app_install) |
The cost incurred for each app install conversion, calculated as total ad spend divided by the number of app installs. |
metric |
cpc_in_micro_dollar |
cpc_in_micro_dollar |
The cost-per-click (CPC) for the ad, expressed in micro-dollars (1,000,000 microdollars = 1 dollar). |
metric |
cpm_in_dollar |
cpm_in_dollar |
The cost per thousand impressions (CPM) for ads, expressed in dollars, indicating the price paid for one thousand views or displays of an advertisement. |
metric |
cpm_in_micro_dollar |
cpm_in_micro_dollar |
The cost-per-mille (CPM), or cost per thousand impressions, for the ad, expressed in micro-dollars. |
metric |
creative |
creative |
The ad creative or content used in the campaign. |
dimension |
creative_duration |
creative_duration |
The length or playback time of the ad creative, primarily relevant for video ad formats. |
dimension |
ctr |
ctr |
The click-through rate (CTR), representing the percentage of impressions that resulted in a click. |
dimension |
ctr_2 |
ctr_2 |
The click-through rate (CTR), potentially calculated with a different attribution window or methodology compared to the primary CTR. |
metric |
custom_desktop_action_desktop_conversion |
custom_desktop_action_desktop_conversion |
The number of “custom” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device. |
dimension |
custom_desktop_action_mobile_conversion |
custom_desktop_action_mobile_conversion |
The number of “custom” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device. |
metric |
custom_desktop_action_tablet_conversion |
custom_desktop_action_tablet_conversion |
The number of “custom” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device. |
dimension |
custom_mobile_action_desktop_conversion |
custom_mobile_action_desktop_conversion |
The number of “custom” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device. |
metric |
custom_mobile_action_mobile_conversion |
custom_mobile_action_mobile_conversion |
The number of “custom” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device. |
metric |
custom_mobile_action_tablet_conversion |
custom_mobile_action_tablet_conversion |
The number of “custom” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device. |
dimension |
custom_tablet_action_desktop_conversion |
custom_tablet_action_desktop_conversion |
The number of “custom” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device. |
dimension |
custom_tablet_action_mobile_conversion |
custom_tablet_action_mobile_conversion |
The number of “custom” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device. |
metric |
custom_tablet_action_tablet_conversion |
custom_tablet_action_tablet_conversion |
The number of “custom” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device. |
dimension |
data_currency |
data_currency |
The currency in which data values (e.g., spend, revenue) are reported. |
dimension |
date |
date |
The date for which the metrics are reported. |
dimension |
date_range_end |
date_range_end |
The end date of the reporting period. |
dimension |
date_range_start |
date_range_start |
The start date of the reporting period. |
dimension |
description |
description |
The description of the Pin or Board. |
dimension |
earned_average_video_watch_time |
earned_average_video_watch_time |
The average time users spent watching organic video Pins. |
metric |
earned_clicks |
earned_clicks |
The number of organic clicks on Pins or content. |
metric |
earned_engagements |
earned_engagements |
The number of organic engagements on Pins or content. |
metric |
earned_impressions |
earned_impressions |
The number of organic impressions on Pins or content. |
metric |
earned_outbound_clicks |
earned_outbound_clicks |
The number of organic outbound clicks on Pins or content. |
dimension |
earned_saves |
earned_saves |
The number of organic saves on Pins or content. |
dimension |
earned_video_starts |
earned_video_starts |
The number of times an organic video started playing. |
dimension |
earned_video_views |
earned_video_views |
The number of organic video views on Pins or content. |
metric |
earned_video_watched_at_100 |
earned_video_watched_at_100 |
The number of times organic video content was watched to 100% completion. |
metric |
earned_video_watched_at_100% |
earned_video_watched_at_100% |
The number of times an organic video was watched to 100% completion. |
dimension |
earned_video_watched_at_25 |
earned_video_watched_at_25 |
The number of times organic video content was watched to 25% completion. |
metric |
earned_video_watched_at_25% |
earned_video_watched_at_25% |
The number of times an organic video was watched to at least 25% completion. |
dimension |
earned_video_watched_at_50 |
earned_video_watched_at_50 |
The number of times organic video content was watched to 50% completion. |
metric |
earned_video_watched_at_50% |
earned_video_watched_at_50% |
The number of times an organic video was watched to at least 50% completion. |
dimension |
earned_video_watched_at_75 |
earned_video_watched_at_75 |
The number of times organic video content was watched to 75% completion. |
metric |
earned_video_watched_at_75% |
earned_video_watched_at_75% |
The number of times an organic video was watched to at least 75% completion. |
dimension |
earned_video_watched_at_95% |
earned_video_watched_at_95% |
The number of times an organic video was watched to at least 95% completion. |
dimension |
ecpc_in_dollar |
ecpc_in_dollar |
The effective cost per click (eCPC) in dollars. |
metric |
ecpc_in_micro_dollar |
ecpc_in_micro_dollar |
The effective cost-per-click (eCPC) for the ad, expressed in micro-dollars. |
metric |
ecpcv_in_dollar |
ecpcv_in_dollar |
The effective cost per completed video view, measured in dollars. This is a calculated ad performance metric. |
metric |
ecpcv_p95_in_dollar |
ecpcv_p95_in_dollar |
The 95th percentile of the effective cost per completed video view, measured in dollars. This indicates a higher bound for the cost per view. |
metric |
ecpe_in_dollar |
ecpe_in_dollar |
The effective cost per engagement (eCPE) in dollars. |
metric |
ecpm_in_micro_dollar |
ecpm_in_micro_dollar |
The effective cost-per-mille (eCPM), or effective cost per thousand impressions, for the ad, expressed in micro-dollars. |
metric |
ecpv_in_dollar |
ecpv_in_dollar |
The effective cost per video view, measured in dollars. This is a calculated ad performance metric. |
metric |
ectr |
ectr |
The effective click-through rate (eCTR). |
dimension |
engagement_1 |
engagement_1 |
The total number of engagements with the ad. The suffix ‘1’ may refer to a specific attribution window. |
metric |
engagement_2 |
engagement_2 |
The total number of engagements with the ad. The suffix ‘2’ may refer to a different attribution window or methodology. |
dimension |
engagement_conversions_(add_to_cart) |
engagement_conversions_(add_to_cart) |
The number of add-to-cart conversions attributed to engagement actions. |
dimension |
engagement_conversions_(app_install) |
engagement_conversions_(app_install) |
The number of app install conversions attributed to engagement actions. |
dimension |
engagement_conversions_(category_view) |
engagement_conversions_(category_view) |
The number of category view conversions attributed to engagement actions. |
dimension |
engagement_conversions_(checkout) |
engagement_conversions_(checkout) |
The number of checkout conversions attributed to engagement actions. |
dimension |
engagement_conversions_(custom) |
engagement_conversions_(custom) |
The number of custom conversions attributed to engagement actions. |
dimension |
engagement_conversions_(lead) |
engagement_conversions_(lead) |
The number of lead conversions attributed to engagement actions. |
dimension |
engagement_conversions_(page_visit) |
engagement_conversions_(page_visit) |
The number of page visit conversions attributed to engagement actions. |
dimension |
engagement_conversions_(signup) |
engagement_conversions_(signup) |
The number of signup conversions attributed to engagement actions. |
dimension |
engagement_conversions_(unknown) |
engagement_conversions_(unknown) |
The total number of conversions attributed to user engagements with ads, where the specific conversion action type is not categorized. |
dimension |
engagement_conversions_(watch_video) |
engagement_conversions_(watch_video) |
The number of watch video conversions attributed to engagement actions. |
dimension |
engagement_conversions_(website_search) |
engagement_conversions_(website_search) |
The number of website search conversions attributed to engagement actions. |
dimension |
engagement_order_quantity_(checkout) |
engagement_order_quantity_(checkout) |
The quantity of items purchased in checkout conversions attributed to engagement actions. |
dimension |
engagement_rate |
engagement_rate |
The rate at which users engage with content, calculated as total engagements divided by impressions. |
metric |
engagement_value_micro_(add_to_cart) |
engagement_value_micro_(add_to_cart) |
The monetary value, in micro-units of the advertiser’s currency, of “add to cart” conversions attributed to user engagements on ads. |
metric |
engagement_value_micro_(app_install) |
engagement_value_micro_(app_install) |
The monetary value, in micro-units of the advertiser’s currency, of “app install” conversions attributed to user engagements on ads. |
metric |
engagement_value_micro_(category_view) |
engagement_value_micro_(category_view) |
The monetary value, in micro-units of the advertiser’s currency, of “category view” conversions attributed to user engagements on ads. |
metric |
engagement_value_micro_(custom) |
engagement_value_micro_(custom) |
The monetary value, in micro-units of the advertiser’s currency, of “custom” conversions attributed to user engagements on ads. |
metric |
engagement_value_micro_(lead) |
engagement_value_micro_(lead) |
The monetary value, in micro-units of the advertiser’s currency, of “lead” conversions attributed to user engagements on ads. |
metric |
engagement_value_micro_(page_visit) |
engagement_value_micro_(page_visit) |
The monetary value, in micro-units of the advertiser’s currency, of “page visit” conversions attributed to user engagements on ads. |
metric |
engagement_value_micro_(signup) |
engagement_value_micro_(signup) |
The value of signup conversions in microcurrency attributed to engagement actions. |
metric |
engagement_value_micro_(unknown) |
engagement_value_micro_(unknown) |
The monetary value, in micro-units of the advertiser’s currency, of “unknown” conversions attributed to user engagements on ads. |
metric |
engagement_value_micro_(watch_video) |
engagement_value_micro_(watch_video) |
The monetary value, in micro-units of the advertiser’s currency, of “watch video” conversions attributed to user engagements on ads. |
metric |
engagement_value_micro_(website_search) |
engagement_value_micro_(website_search) |
The monetary value, in micro-units of the advertiser’s currency, of “website search” conversions attributed to user engagements on ads. |
metric |
engagements |
engagements |
The total number of user interactions with a Pin or ad, such as saves, closeups, and link clicks. |
metric |
entity |
entity |
A general identifier for the specific object or item being reported on. |
dimension |
format_size |
format_size |
The size specification of the ad or Pin format. |
dimension |
format_type |
format_type |
The type of ad or Pin format. |
dimension |
id |
id |
The unique identifier for the entity (e.g., Pin ID, Board ID, Ad Account ID). |
dimension |
idea_pin_product_tag_visit_1 |
idea_pin_product_tag_visit_1 |
The number of times users visited a product tag on an Idea Pin. The suffix ‘1’ may refer to a specific attribution window. |
dimension |
idea_pin_product_tag_visit_2 |
idea_pin_product_tag_visit_2 |
The number of times users visited a product tag on an Idea Pin. The suffix ‘2’ may refer to a different attribution window or methodology. |
dimension |
impression |
impression |
The total number of times a Pin or ad was displayed on screen. |
metric |
impression_1 |
impression_1 |
The number of times the ad was displayed to users. The suffix ‘1’ may refer to a specific attribution window. |
metric |
impression_2 |
impression_2 |
The number of times the ad was displayed to users. The suffix ‘2’ may refer to a different attribution window or methodology. |
metric |
impressions |
impressions |
The total number of times a Pin or ad was displayed to users. |
metric |
inapp_add_to_cart_cost_per_action |
inapp_add_to_cart_cost_per_action |
The cost incurred for each in-app “add to cart” action, calculated as total ad spend divided by the number of in-app “add to cart” events. |
metric |
inapp_add_to_cart_roas |
inapp_add_to_cart_roas |
The return on ad spend (ROAS) for in-app “add to cart” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
metric |
inapp_app_install_cost_per_action |
inapp_app_install_cost_per_action |
The cost incurred for each in-app “app install” action, calculated as total ad spend divided by the number of in-app “app install” events. |
metric |
inapp_app_install_roas |
inapp_app_install_roas |
The return on ad spend (ROAS) for in-app “app install” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
metric |
inapp_checkout_cost_per_action |
inapp_checkout_cost_per_action |
The cost incurred for each in-app “checkout” action, calculated as total ad spend divided by the number of in-app “checkout” events. |
metric |
inapp_checkout_roas |
inapp_checkout_roas |
The return on ad spend (ROAS) for in-app “checkout” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
metric |
inapp_search_cost_per_action |
inapp_search_cost_per_action |
The cost incurred for each in-app “search” action, calculated as total ad spend divided by the number of in-app “search” events. |
metric |
inapp_search_roas |
inapp_search_roas |
The return on ad spend (ROAS) for in-app “search” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
metric |
inapp_signup_cost_per_action |
inapp_signup_cost_per_action |
The cost incurred for each in-app “signup” action, calculated as total ad spend divided by the number of in-app “signup” events. |
dimension |
inapp_signup_roas |
inapp_signup_roas |
The return on ad spend (ROAS) for in-app “signup” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
dimension |
inapp_unknown_cost_per_action |
inapp_unknown_cost_per_action |
The cost incurred for each in-app “unknown” action, calculated as total ad spend divided by the number of in-app “unknown” events. |
dimension |
inapp_unknown_roas |
inapp_unknown_roas |
The return on ad spend (ROAS) for in-app “unknown” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
dimension |
inventory_id |
inventory_id |
The unique identifier for an inventory item associated with a Pin. |
dimension |
is_premiere_campaign |
is_premiere_campaign |
Indicates whether the campaign is a Premiere Campaign, which is a specific type of advertising campaign on Pinterest. |
dimension |
language |
language |
The language targeted by the ad or content. |
dimension |
lead_desktop_action_desktop_conversion |
lead_desktop_action_desktop_conversion |
The number of “lead” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device. |
dimension |
lead_desktop_action_mobile_conversion |
lead_desktop_action_mobile_conversion |
The number of “lead” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device. |
dimension |
lead_desktop_action_tablet_conversion |
lead_desktop_action_tablet_conversion |
The number of “lead” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device. |
dimension |
lead_mobile_action_desktop_conversion |
lead_mobile_action_desktop_conversion |
The number of “lead” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device. |
dimension |
lead_mobile_action_mobile_conversion |
lead_mobile_action_mobile_conversion |
The number of “lead” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device. |
dimension |
lead_mobile_action_tablet_conversion |
lead_mobile_action_tablet_conversion |
The number of “lead” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device. |
dimension |
lead_tablet_action_desktop_conversion |
lead_tablet_action_desktop_conversion |
The number of “lead” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device. |
dimension |
lead_tablet_action_mobile_conversion |
lead_tablet_action_mobile_conversion |
The number of “lead” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device. |
dimension |
lead_tablet_action_tablet_conversion |
lead_tablet_action_tablet_conversion |
The number of “lead” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device. |
dimension |
leads |
leads |
The total number of lead events. |
dimension |
link |
link |
The destination URL for the Pin when clicked. |
dimension |
media.cover_image_url |
media.cover_image_url |
The URL of the cover image for a video Pin. |
dimension |
media.images.150x150.url |
media.images.150x150.url |
The URL of the 150x150 scaled version of the Pin’s image media. |
dimension |
media.images.400x300.url |
media.images.400x300.url |
The URL of the 400x300 scaled version of the Pin’s image media. |
dimension |
media.images.600x.url |
media.images.600x.url |
The URL of the 600x scaled version of the Pin’s image media. |
dimension |
media.images.originals.url |
media.images.originals.url |
The URL of the original, high-resolution image associated with a Pin. |
dimension |
media.media_type |
media.media_type |
The type of media associated with the Pin, such as image or video. |
dimension |
offline_checkout_cost_per_action |
offline_checkout_cost_per_action |
The cost incurred for each offline “checkout” action, calculated as total ad spend divided by the number of offline “checkout” events. |
dimension |
offline_checkout_roas |
offline_checkout_roas |
The return on ad spend (ROAS) for offline “checkout” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
dimension |
offline_custom_cost_per_action |
offline_custom_cost_per_action |
The cost incurred for each offline “custom” action, calculated as total ad spend divided by the number of offline “custom” events. |
dimension |
offline_custom_roas |
offline_custom_roas |
The return on ad spend (ROAS) for offline “custom” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
dimension |
offline_lead_cost_per_action |
offline_lead_cost_per_action |
The cost incurred for each offline “lead” action, calculated as total ad spend divided by the number of offline “lead” events. |
dimension |
offline_lead_roas |
offline_lead_roas |
The return on ad spend (ROAS) for offline “lead” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
dimension |
offline_signup_cost_per_action |
offline_signup_cost_per_action |
The cost incurred for each offline “signup” action, calculated as total ad spend divided by the number of offline “signup” events. |
dimension |
offline_signup_roas |
offline_signup_roas |
The return on ad spend (ROAS) for offline “signup” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
dimension |
offline_unknown_cost_per_action |
offline_unknown_cost_per_action |
The cost incurred for each offline “unknown” action, calculated as total ad spend divided by the number of offline “unknown” events. |
dimension |
offline_unknown_roas |
offline_unknown_roas |
The return on ad spend (ROAS) for offline “unknown” actions, indicating the revenue generated per dollar spent on advertising for these actions. |
dimension |
order_line_id |
order_line_id |
The unique identifier for the order line item within an ad account. |
dimension |
order_line_name |
order_line_name |
The name of the order line item. |
dimension |
outbound_click |
outbound_click |
The number of clicks that take users off Pinterest to a destination URL. |
metric |
outbound_click_1 |
outbound_click_1 |
The number of clicks that led users off of Pinterest to an external site. The suffix ‘1’ may refer to a specific attribution window. |
dimension |
outbound_click_2 |
outbound_click_2 |
The number of clicks that led users off of Pinterest to an external site. The suffix ‘2’ may refer to a different attribution window or methodology. |
dimension |
outbound_clicks |
outbound_clicks |
Total number of clicks that lead users off of Pinterest. |
dimension |
outbound_ctr |
outbound_ctr |
The click-through rate for clicks that lead users off the Pinterest platform. |
dimension |
page_visit_cost_per_action |
page_visit_cost_per_action |
The cost incurred for each page visit action, calculated as total ad spend divided by the number of page visit events. |
metric |
page_visit_desktop_action_desktop_conversion |
page_visit_desktop_action_desktop_conversion |
The number of “page visit” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device. |
metric |
page_visit_desktop_action_mobile_conversion |
page_visit_desktop_action_mobile_conversion |
The number of “page visit” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device. |
metric |
page_visit_desktop_action_tablet_conversion |
page_visit_desktop_action_tablet_conversion |
The number of “page visit” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device. |
metric |
page_visit_mobile_action_desktop_conversion |
page_visit_mobile_action_desktop_conversion |
The number of “page visit” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device. |
metric |
page_visit_mobile_action_mobile_conversion |
page_visit_mobile_action_mobile_conversion |
The number of “page visit” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device. |
metric |
page_visit_mobile_action_tablet_conversion |
page_visit_mobile_action_tablet_conversion |
The number of “page visit” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device. |
metric |
page_visit_roas |
page_visit_roas |
The return on ad spend (ROAS) for page visit actions, indicating the revenue generated per dollar spent on advertising for these actions. |
dimension |
page_visit_tablet_action_desktop_conversion |
page_visit_tablet_action_desktop_conversion |
The number of “page visit” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device. |
metric |
page_visit_tablet_action_mobile_conversion |
page_visit_tablet_action_mobile_conversion |
The number of “page visit” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device. |
metric |
page_visit_tablet_action_tablet_conversion |
page_visit_tablet_action_tablet_conversion |
The number of “page visit” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device. |
metric |
paid_average_video_watch_time |
paid_average_video_watch_time |
The average watch time for paid video content. |
metric |
paid_clicks |
paid_clicks |
The number of clicks attributed to paid ads. |
metric |
paid_engagements |
paid_engagements |
The number of engagements attributed to paid ads. |
metric |
paid_impression |
paid_impression |
The number of impressions attributed to paid ads. |
metric |
paid_impressions |
paid_impressions |
The total number of impressions attributed to paid ads. |
metric |
paid_saves |
paid_saves |
The number of saves attributed to paid ads. |
metric |
paid_video_starts |
paid_video_starts |
The number of times a paid video started playing. |
dimension |
paid_video_views |
paid_video_views |
The number of views for paid video content. |
metric |
paid_video_watched_at_100 |
paid_video_watched_at_100 |
The number of times paid video content was watched to 100% completion. |
metric |
paid_video_watched_at_100% |
paid_video_watched_at_100% |
The number of times a paid video was watched to 100% completion. |
dimension |
paid_video_watched_at_25 |
paid_video_watched_at_25 |
The number of times paid video content was watched to 25% completion. |
metric |
paid_video_watched_at_25% |
paid_video_watched_at_25% |
The number of times a paid video was watched to at least 25% completion. |
dimension |
paid_video_watched_at_50 |
paid_video_watched_at_50 |
The number of times paid video content was watched to 50% completion. |
metric |
paid_video_watched_at_50% |
paid_video_watched_at_50% |
The number of times a paid video was watched to at least 50% completion. |
dimension |
paid_video_watched_at_75 |
paid_video_watched_at_75 |
The number of times paid video content was watched to 75% completion. |
metric |
paid_video_watched_at_75% |
paid_video_watched_at_75% |
The number of times a paid video was watched to at least 75% completion. |
dimension |
paid_video_watched_at_95% |
paid_video_watched_at_95% |
The number of times a paid video was watched to at least 95% completion. |
dimension |
pin_alt_text |
pin_alt_text |
The descriptive alternative text provided for a Pin, used for accessibility (screen readers) and to help Pinterest’s algorithm understand and categorize the content. |
dimension |
pin_attribution |
pin_attribution |
Information regarding how a conversion or action is attributed to a specific Pin, often based on defined attribution windows for clicks, engagements, or views. |
dimension |
pin_board_id |
pin_board_id |
The unique identifier of the board to which the Pin belongs. |
dimension |
pin_board_owner |
pin_board_owner |
Information about the owner of the board to which the Pin belongs, including their username. |
dimension |
pin_board_section_id |
pin_board_section_id |
The unique identifier of the board section to which the Pin belongs. |
dimension |
pin_click |
pin_click |
The number of times a Pin was clicked. |
metric |
pin_click_rate |
pin_click_rate |
The rate at which users click on a Pin. |
metric |
pin_created_at |
pin_created_at |
The timestamp indicating when the Pin was created. |
dimension |
pin_description |
pin_description |
The textual description provided for the Pin. |
dimension |
pin_dominant_color |
pin_dominant_color |
The dominant color of the Pin, represented as a hex code. |
dimension |
pin_id |
pin_id |
The unique identifier for the Pin. |
dimension |
pin_link |
pin_link |
The URL or link that the Pin directs users to when clicked. |
dimension |
pin_media |
pin_media |
Details about the media content of the Pin, such as image URLs and dimensions for various sizes. |
dimension |
pin_parent_pin_id |
pin_parent_pin_id |
The unique identifier of the original Pin if this Pin was saved (re-pinned) from another Pin. |
dimension |
pin_promotion_ad_account_id |
pin_promotion_ad_account_id |
The unique identifier of the ad account responsible for the promotion of the Pin. |
dimension |
pin_promotion_android_deep_link |
pin_promotion_android_deep_link |
The deep link URL for Android devices that directs users to a specific location within a mobile application when they interact with a promoted Pin. |
dimension |
pin_promotion_campaign_id |
pin_promotion_campaign_id |
The unique identifier of the campaign under which the Pin is being promoted. |
dimension |
pin_promotion_carousel_android_deep_links |
pin_promotion_carousel_android_deep_links |
A list of Android deep link URLs used for individual cards within a carousel ad, directing users to specific in-app content when they interact with a promoted Pin. |
dimension |
pin_promotion_carousel_destination_urls |
pin_promotion_carousel_destination_urls |
A list of destination URLs for individual cards within a carousel ad, specifying where users are directed when they click on a particular card in a promoted Pin. |
dimension |
pin_promotion_carousel_ios_deep_links |
pin_promotion_carousel_ios_deep_links |
A list of iOS deep link URLs used for individual cards within a carousel ad, directing users to specific in-app content when they interact with a promoted Pin. |
dimension |
pin_promotion_click_tracking_url |
pin_promotion_click_tracking_url |
The URL used to track clicks on a promoted Pin for conversion and performance monitoring. |
dimension |
pin_promotion_collection_items_destination_url_template |
pin_promotion_collection_items_destination_url_template |
The URL template used for destination links of items within a collection Pin promotion. |
dimension |
pin_promotion_created_time |
pin_promotion_created_time |
The date and time when the promoted Pin was created. |
dimension |
pin_promotion_creative_type |
pin_promotion_creative_type |
The creative type of the promoted Pin, such as standard image, video, carousel, or collection. |
dimension |
pin_promotion_destination_url |
pin_promotion_destination_url |
The landing page URL where users are directed after clicking on the promoted Pin. |
dimension |
pin_promotion_id |
pin_promotion_id |
The unique identifier for a promoted Pin. |
dimension |
pin_promotion_ios_deep_link |
pin_promotion_ios_deep_link |
A deep link URL for iOS devices, used to direct users to specific content within an app after clicking a promoted Pin. |
dimension |
pin_promotion_is_pin_deleted |
pin_promotion_is_pin_deleted |
Indicates whether the Pin associated with the promotion has been deleted. |
dimension |
pin_promotion_is_removable |
pin_promotion_is_removable |
Indicates whether the promoted Pin can be removed. |
dimension |
pin_promotion_name |
pin_promotion_name |
The name of the promoted Pin. |
dimension |
pin_promotion_pin_id |
pin_promotion_pin_id |
The unique identifier of the promoted Pin. |
dimension |
pin_promotion_rejected_reasons |
pin_promotion_rejected_reasons |
A list of reasons why the promoted Pin was rejected during the ad review process. |
dimension |
pin_promotion_rejection_labels |
pin_promotion_rejection_labels |
Labels indicating reasons for the rejection of a promoted Pin. |
dimension |
pin_promotion_review_status |
pin_promotion_review_status |
The current review status of the promoted Pin, indicating if it’s approved, pending, or rejected. |
dimension |
pin_promotion_status |
pin_promotion_status |
The status of a promoted Pin, such as APPROVED, PAUSED, or REJECTED. |
dimension |
pin_promotion_summary_status |
pin_promotion_summary_status |
The overall status of a Pin promotion, summarizing its current state. |
dimension |
pin_promotion_tracking_urls |
pin_promotion_tracking_urls |
A collection of URLs used for tracking various events related to the promoted Pin, beyond just clicks or views. |
dimension |
pin_promotion_type |
pin_promotion_type |
The type of promotion used for the Pin. |
dimension |
pin_promotion_updated_time |
pin_promotion_updated_time |
The date and time when the promoted Pin was last updated. |
dimension |
pin_promotion_view_tracking_url |
pin_promotion_view_tracking_url |
The URL used to track views of the promoted Pin. |
dimension |
pin_title |
pin_title |
The title of the Pin. |
dimension |
pinterest_checkout_cost_per_action |
pinterest_checkout_cost_per_action |
The average cost incurred for each checkout action completed by users originating from Pinterest ads. This is a computed metric from ad analytics. |
dimension |
pinterest_checkout_roas |
pinterest_checkout_roas |
The Return on Ad Spend (ROAS) for checkout actions on Pinterest, indicating the revenue generated per unit of ad spend for checkouts. This is a computed metric from ad analytics. |
dimension |
product |
product |
The product being advertised or associated with a Pin. |
dimension |
product_group_id |
product_group_id |
The unique identifier for a product group. |
dimension |
product_item_id |
product_item_id |
The unique identifier for a product item within a catalog. |
dimension |
promo_id |
promo_id |
The unique identifier for a promotion applied to an ad or ad group. |
dimension |
reach |
reach |
The total number of unique users who have seen your ad content at least once. |
dimension |
repin_1 |
repin_1 |
The number of times users saved or ‘re-pinned’ the ad to one of their boards. The suffix ‘1’ may refer to a specific attribution window. |
dimension |
repin_2 |
repin_2 |
The number of times users saved or ‘re-pinned’ the ad to one of their boards. The suffix ‘2’ may refer to a different attribution window or methodology. |
dimension |
repin_rate |
repin_rate |
The rate at which Pins are saved by other users. |
dimension |
save |
save |
The number of times a Pin was saved to a board. |
metric |
search_desktop_action_desktop_conversion |
search_desktop_action_desktop_conversion |
The number of search actions leading to a conversion on a desktop device, where the initial action also occurred on a desktop device. |
metric |
search_desktop_action_mobile_conversion |
search_desktop_action_mobile_conversion |
The number of search actions leading to a conversion on a mobile device, where the initial action occurred on a desktop device. |
dimension |
search_desktop_action_tablet_conversion |
search_desktop_action_tablet_conversion |
The number of search actions leading to a conversion on a tablet device, where the initial action occurred on a desktop device. |
dimension |
search_mobile_action_desktop_conversion |
search_mobile_action_desktop_conversion |
The number of search actions leading to a conversion on a desktop device, where the initial action occurred on a mobile device. |
metric |
search_mobile_action_mobile_conversion |
search_mobile_action_mobile_conversion |
The number of search actions leading to a conversion on a mobile device, where the initial action also occurred on a mobile device. |
metric |
search_mobile_action_tablet_conversion |
search_mobile_action_tablet_conversion |
The number of search actions leading to a conversion on a tablet device, where the initial action occurred on a mobile device. |
dimension |
search_tablet_action_desktop_conversion |
search_tablet_action_desktop_conversion |
The number of search actions leading to a conversion on a desktop device, where the initial action occurred on a tablet device. |
metric |
search_tablet_action_mobile_conversion |
search_tablet_action_mobile_conversion |
The number of search actions leading to a conversion on a mobile device, where the initial action occurred on a tablet device. |
dimension |
search_tablet_action_tablet_conversion |
search_tablet_action_tablet_conversion |
The number of search actions leading to a conversion on a tablet device, where the initial action also occurred on a tablet device. |
dimension |
showcase_card_thumbnail_swipe_backward |
showcase_card_thumbnail_swipe_backward |
The count of backward swipes on showcase card thumbnails. This is an engagement metric for showcase ad formats. |
dimension |
showcase_card_thumbnail_swipe_forward |
showcase_card_thumbnail_swipe_forward |
The count of forward swipes on showcase card thumbnails. This is an engagement metric for showcase ad formats. |
dimension |
showcase_pin_clickthrough |
showcase_pin_clickthrough |
The number of click-throughs on a Showcase Pin. |
dimension |
showcase_subpage_clickthrough |
showcase_subpage_clickthrough |
The total number of clickthroughs on a showcase subpage. This is an engagement metric for showcase ad formats. |
dimension |
showcase_subpage_closeup |
showcase_subpage_closeup |
The total number of closeups (enlarged views) of content on a showcase subpage. This is an engagement metric for showcase ad formats. |
dimension |
showcase_subpage_impression |
showcase_subpage_impression |
The total number of impressions (views) of a showcase subpage. This is a visibility metric for showcase ad formats. |
dimension |
showcase_subpage_repin |
showcase_subpage_repin |
The total number of repins (saves) from a showcase subpage. This is an engagement metric for showcase ad formats. |
dimension |
showcase_subpage_swipe_left |
showcase_subpage_swipe_left |
The count of left swipes on a showcase subpage. This is an engagement metric for showcase ad formats. |
dimension |
showcase_subpage_swipe_right |
showcase_subpage_swipe_right |
The count of right swipes on a showcase subpage. This is an engagement metric for showcase ad formats. |
dimension |
showcase_subpin_clickthrough |
showcase_subpin_clickthrough |
The total number of clickthroughs on a subpin within a showcase. This is an engagement metric for showcase ad formats. |
dimension |
showcase_subpin_impression |
showcase_subpin_impression |
The total number of impressions (views) of a subpin within a showcase. This is a visibility metric for showcase ad formats. |
dimension |
showcase_subpin_repin |
showcase_subpin_repin |
The total number of repins (saves) from a subpin within a showcase. This is an engagement metric for showcase ad formats. |
dimension |
showcase_subpin_swipe_left |
showcase_subpin_swipe_left |
The count of left swipes on a subpin within a showcase. This is an engagement metric for showcase ad formats. |
dimension |
showcase_subpin_swipe_right |
showcase_subpin_swipe_right |
The count of right swipes on a subpin within a showcase. This is an engagement metric for showcase ad formats. |
dimension |
signup_desktop_action_desktop_conversion |
signup_desktop_action_desktop_conversion |
The number of signup actions leading to a conversion on a desktop device, where the initial action also occurred on a desktop device. |
dimension |
signup_desktop_action_mobile_conversion |
signup_desktop_action_mobile_conversion |
The number of signup actions leading to a conversion on a mobile device, where the initial action occurred on a desktop device. |
dimension |
signup_desktop_action_tablet_conversion |
signup_desktop_action_tablet_conversion |
The number of signup actions leading to a conversion on a tablet device, where the initial action occurred on a desktop device. |
dimension |
signup_mobile_action_desktop_conversion |
signup_mobile_action_desktop_conversion |
The number of signup actions leading to a conversion on a desktop device, where the initial action occurred on a mobile device. |
dimension |
signup_mobile_action_mobile_conversion |
signup_mobile_action_mobile_conversion |
The number of signup actions leading to a conversion on a mobile device, where the initial action also occurred on a mobile device. |
dimension |
signup_mobile_action_tablet_conversion |
signup_mobile_action_tablet_conversion |
The number of signup actions leading to a conversion on a tablet device, where the initial action occurred on a mobile device. |
dimension |
signup_tablet_action_desktop_conversion |
signup_tablet_action_desktop_conversion |
The number of signup actions leading to a conversion on a desktop device, where the initial action occurred on a tablet device. |
dimension |
signup_tablet_action_mobile_conversion |
signup_tablet_action_mobile_conversion |
The number of signup actions leading to a conversion on a mobile device, where the initial action occurred on a tablet device. |
dimension |
signup_tablet_action_tablet_conversion |
signup_tablet_action_tablet_conversion |
The number of signup actions leading to a conversion on a tablet device, where the initial action also occurred on a tablet device. |
dimension |
spend_in_account_currency |
spend_in_account_currency |
The total amount spent in the ad account’s local currency. |
metric |
spend_in_account_currency_micro |
spend_in_account_currency_micro |
The total amount of money spent on ads, expressed in microunits of the ad account’s currency. |
metric |
spend_in_account_currency_micro_PLN |
spend_in_account_currency_micro_PLN |
The total advertising spend, expressed in Polish Zloty (PLN) in micro-units (e.g., micro-PLN represents 1/1,000,000 of a PLN), using the account’s specified currency. |
metric |
spend_in_dollar |
spend_in_dollar |
The total amount of money spent on ads, expressed in US dollars. |
dimension |
spend_in_dollar_PLN |
spend_in_dollar_PLN |
The total advertising spend in Polish Zloty (PLN). |
dimension |
spend_in_micro_dollar |
spend_in_micro_dollar |
The total advertising spend, expressed in micro-dollars (1,000,000 microdollars = 1 dollar). |
dimension |
status |
status |
The current operational status of an entity, such as an ad group, campaign, or promoted Pin. |
dimension |
target |
target |
The specific audience or criteria defined for ad delivery. |
dimension |
targeting |
targeting |
Detailed criteria and parameters applied for audience targeting in an ad campaign. |
dimension |
targeting_description |
targeting_description |
A description of the specific targeting criteria used for an ad or ad group. |
dimension |
targeting_type |
targeting_type |
The category of targeting used for an ad, such as ‘AGE_BUCKET’, ‘GENDER’, ‘LOCATION’, or ‘KEYWORD’. |
dimension |
targeting_value |
targeting_value |
The specific value within a targeting type, such as ‘45-49’ for ‘AGE_BUCKET’ or ‘female’ for ‘GENDER’. |
dimension |
title |
title |
The title of the Pin or Board. |
dimension |
total_add_to_cart_conversion_rate |
total_add_to_cart_conversion_rate |
The overall conversion rate for add-to-cart events. |
dimension |
total_checkout |
total_checkout |
The total number of checkout conversions. |
dimension |
total_checkout_conversion_rate |
total_checkout_conversion_rate |
The overall conversion rate for checkout events. |
dimension |
total_checkout_value_in_micro_dollar |
total_checkout_value_in_micro_dollar |
The total value of checkout conversions, expressed in micro-dollars. |
dimension |
total_click_add_to_cart |
total_click_add_to_cart |
The total number of add-to-cart events attributed to clicks on ads. |
dimension |
total_click_checkout |
total_click_checkout |
The total number of checkout events attributed to clicks on ads. |
dimension |
total_click_checkout_value_in_micro_dollar |
total_click_checkout_value_in_micro_dollar |
The total value of checkout conversions attributed to clicks on ads, expressed in micro-dollars. |
dimension |
total_click_lead |
total_click_lead |
The total number of lead generation events attributed to clicks on ads. |
dimension |
total_click_signup |
total_click_signup |
The total number of signup events attributed to clicks on ads. |
dimension |
total_click_signup_value_in_micro_dollar |
total_click_signup_value_in_micro_dollar |
The total value of signup conversions attributed to clicks on ads, expressed in micro-dollars. |
dimension |
total_clickthrough |
total_clickthrough |
The total number of clicks on a Pin or ad that led to a destination. |
metric |
total_conversion_quantity |
total_conversion_quantity |
The total number of conversions. |
dimension |
total_conversion_value_micro |
total_conversion_value_micro |
The total value of all conversions in microcurrency. |
metric |
total_conversions |
total_conversions |
The total number of all conversions, including various conversion actions such as checkouts, signups, and leads. |
dimension |
total_custom |
total_custom |
The total number of custom conversion events defined by the advertiser. |
dimension |
total_custom_value_in_micro_dollar |
total_custom_value_in_micro_dollar |
The total value of custom conversion events, expressed in micro-dollars. |
dimension |
total_engagement |
total_engagement |
The total number of engagements with the ad, encompassing various user interactions. |
dimension |
total_engagement_checkout |
total_engagement_checkout |
The total number of checkout conversions attributed to user engagements with ads. |
dimension |
total_engagement_checkout_value_in_micro_dollar |
total_engagement_checkout_value_in_micro_dollar |
The total value of checkout conversions attributed to engagements with ads, expressed in micro-dollars. |
dimension |
total_engagement_lead |
total_engagement_lead |
The total number of lead generation events attributed to user engagements with ads. |
metric |
total_engagement_signup |
total_engagement_signup |
The total number of signup events attributed to user engagements with ads. |
dimension |
total_engagement_signup_value_in_micro_dollar |
total_engagement_signup_value_in_micro_dollar |
The total value of signup conversions attributed to engagements with ads, expressed in micro-dollars. |
dimension |
total_idea_pin_product_tag_visit |
total_idea_pin_product_tag_visit |
The total number of visits to product tags within Idea Pins. |
dimension |
total_impression |
total_impression |
The total number of impressions, including both paid and organic. |
metric |
total_impression_frequency |
total_impression_frequency |
The average number of times an individual user saw an impression from your ads or organic pins. |
metric |
total_impression_user |
total_impression_user |
The total number of unique users who saw an ad or Pin. |
metric |
total_inapp_add_to_cart |
total_inapp_add_to_cart |
The total number of ‘add to cart’ events recorded within the Pinterest app. |
metric |
total_inapp_add_to_cart_value_micro |
total_inapp_add_to_cart_value_micro |
The total monetary value, in micro-dollars, of ‘add to cart’ events recorded within the Pinterest app. |
metric |
total_inapp_app_install |
total_inapp_app_install |
The total number of app install events recorded within the Pinterest app. |
metric |
total_inapp_app_install_value_micro |
total_inapp_app_install_value_micro |
The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app. |
metric |
total_inapp_checkout |
total_inapp_checkout |
The total number of in-app checkout conversions. |
metric |
total_inapp_checkout_value_micro |
total_inapp_checkout_value_micro |
The total value of in-app checkout conversions in microcurrency. |
metric |
total_inapp_click_add_to_cart |
total_inapp_click_add_to_cart |
The total number of ‘add to cart’ events recorded within the Pinterest app that were attributed to a click interaction. |
metric |
total_inapp_click_add_to_cart_value_micro |
total_inapp_click_add_to_cart_value_micro |
The total monetary value, in micro-dollars, of ‘add to cart’ events recorded within the Pinterest app that were attributed to a click interaction. |
metric |
total_inapp_click_app_install |
total_inapp_click_app_install |
The total number of app install events recorded within the Pinterest app that were attributed to a click interaction. |
metric |
total_inapp_click_app_install_value_micro |
total_inapp_click_app_install_value_micro |
The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app that were attributed to a click interaction. |
metric |
total_inapp_click_checkout |
total_inapp_click_checkout |
The total number of checkout events recorded within the Pinterest app that were attributed to a click interaction. |
metric |
total_inapp_click_checkout_value_micro |
total_inapp_click_checkout_value_micro |
The total value of in-app checkout conversions in microcurrency attributed to click actions. |
metric |
total_inapp_click_search |
total_inapp_click_search |
The total number of search events recorded within the Pinterest app that were attributed to a click interaction. |
dimension |
total_inapp_click_search_value_micro |
total_inapp_click_search_value_micro |
The total monetary value, in micro-dollars, associated with search events recorded within the Pinterest app that were attributed to a click interaction. |
metric |
total_inapp_click_signup |
total_inapp_click_signup |
The total number of signup events recorded within the Pinterest app that were attributed to a click interaction. |
dimension |
total_inapp_click_signup_value_micro |
total_inapp_click_signup_value_micro |
The total monetary value, in micro-dollars, associated with signup events recorded within the Pinterest app that were attributed to a click interaction. |
metric |
total_inapp_click_unknown |
total_inapp_click_unknown |
The total number of undefined conversion events recorded within the Pinterest app that were attributed to a click interaction. |
dimension |
total_inapp_click_unknown_value_micro |
total_inapp_click_unknown_value_micro |
The total monetary value, in micro-dollars, associated with undefined conversion events recorded within the Pinterest app that were attributed to a click interaction. |
metric |
total_inapp_engagement_add_to_cart |
total_inapp_engagement_add_to_cart |
The total number of ‘add to cart’ events recorded within the Pinterest app that were attributed to an engagement (saves, closeups, link clicks, carousel swipes). |
dimension |
total_inapp_engagement_add_to_cart_value_micro |
total_inapp_engagement_add_to_cart_value_micro |
The total monetary value, in micro-dollars, of ‘add to cart’ events recorded within the Pinterest app that were attributed to an engagement. |
metric |
total_inapp_engagement_app_install |
total_inapp_engagement_app_install |
The total number of app install events recorded within the Pinterest app that were attributed to an engagement. |
dimension |
total_inapp_engagement_app_install_value_micro |
total_inapp_engagement_app_install_value_micro |
The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app that were attributed to an engagement. |
metric |
total_inapp_engagement_checkout |
total_inapp_engagement_checkout |
The total number of in-app checkout conversions attributed to engagement actions. |
dimension |
total_inapp_engagement_checkout_value_micro |
total_inapp_engagement_checkout_value_micro |
The total value of in-app checkout conversions in microcurrency attributed to engagement actions. |
metric |
total_inapp_engagement_search |
total_inapp_engagement_search |
The total number of search events recorded within the Pinterest app that were attributed to an engagement. |
dimension |
total_inapp_engagement_search_value_micro |
total_inapp_engagement_search_value_micro |
The total monetary value, in micro-dollars, associated with search events recorded within the Pinterest app that were attributed to an engagement. |
metric |
total_inapp_engagement_signup |
total_inapp_engagement_signup |
The total number of in-app signup conversions attributed to engagement actions. |
dimension |
total_inapp_engagement_signup_value_micro |
total_inapp_engagement_signup_value_micro |
The total monetary value, in micro-dollars, associated with signup events recorded within the Pinterest app that were attributed to an engagement. |
metric |
total_inapp_engagement_unknown |
total_inapp_engagement_unknown |
The total number of undefined conversion events recorded within the Pinterest app that were attributed to an engagement. |
dimension |
total_inapp_engagement_unknown_value_micro |
total_inapp_engagement_unknown_value_micro |
The total monetary value, in micro-dollars, associated with undefined conversion events recorded within the Pinterest app that were attributed to an engagement. |
metric |
total_inapp_search |
total_inapp_search |
The total number of search events recorded within the Pinterest app. |
metric |
total_inapp_search_value_micro |
total_inapp_search_value_micro |
The total monetary value, in micro-dollars, of search events recorded within the Pinterest app. |
metric |
total_inapp_signup |
total_inapp_signup |
The total number of in-app signup conversions. |
dimension |
total_inapp_signup_value_micro |
total_inapp_signup_value_micro |
The total monetary value, in micro-dollars, of signup events recorded within the Pinterest app. |
metric |
total_inapp_unknown |
total_inapp_unknown |
The total number of undefined conversion events recorded within the Pinterest app. |
dimension |
total_inapp_unknown_value_micro |
total_inapp_unknown_value_micro |
The total monetary value, in micro-dollars, of undefined conversion events recorded within the Pinterest app. |
metric |
total_inapp_view_add_to_cart |
total_inapp_view_add_to_cart |
The total number of ‘add to cart’ events recorded within the Pinterest app that were attributed to a view interaction. |
metric |
total_inapp_view_add_to_cart_value_micro |
total_inapp_view_add_to_cart_value_micro |
The total monetary value, in micro-dollars, of ‘add to cart’ events recorded within the Pinterest app that were attributed to a view interaction. |
metric |
total_inapp_view_app_install |
total_inapp_view_app_install |
The total number of app install events recorded within the Pinterest app that were attributed to a view interaction. |
metric |
total_inapp_view_app_install_value_micro |
total_inapp_view_app_install_value_micro |
The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app that were attributed to a view interaction. |
metric |
total_inapp_view_checkout |
total_inapp_view_checkout |
The total number of checkout events recorded within the Pinterest app that were attributed to a view interaction. |
metric |
total_inapp_view_checkout_value_micro |
total_inapp_view_checkout_value_micro |
The total value of in-app checkout conversions in microcurrency attributed to view-through actions. |
metric |
total_inapp_view_search |
total_inapp_view_search |
The total number of search events recorded within the Pinterest app that were attributed to a view interaction. |
metric |
total_inapp_view_search_value_micro |
total_inapp_view_search_value_micro |
The total monetary value, in micro-dollars, associated with search events recorded within the Pinterest app that were attributed to a view interaction. |
metric |
total_inapp_view_signup |
total_inapp_view_signup |
The total number of signup events recorded within the Pinterest app that were attributed to a view interaction. |
dimension |
total_inapp_view_signup_value_micro |
total_inapp_view_signup_value_micro |
The total monetary value, in micro-dollars, associated with signup events recorded within the Pinterest app that were attributed to a view interaction. |
metric |
total_inapp_view_unknown |
total_inapp_view_unknown |
The total number of undefined conversion events recorded within the Pinterest app that were attributed to a view interaction. |
dimension |
total_inapp_view_unknown_value_micro |
total_inapp_view_unknown_value_micro |
The total monetary value, in micro-dollars, associated with undefined conversion events recorded within the Pinterest app that were attributed to a view interaction. |
metric |
total_lead |
total_lead |
The total number of lead generation conversions. |
dimension |
total_lead_conversion_rate |
total_lead_conversion_rate |
The overall conversion rate for lead generation events. |
dimension |
total_offline_checkout |
total_offline_checkout |
The total count of offline checkout conversions. These are conversions that occur outside of online tracking. |
dimension |
total_offline_checkout_value_micro |
total_offline_checkout_value_micro |
The total value of offline checkout conversions in microcurrency. |
metric |
total_offline_click_checkout |
total_offline_click_checkout |
The total number of offline checkout events attributed to a click interaction. |
dimension |
total_offline_click_checkout_value_micro |
total_offline_click_checkout_value_micro |
The total value of offline checkout conversions in microcurrency attributed to click actions. |
metric |
total_offline_click_custom |
total_offline_click_custom |
The total number of custom offline events attributed to a click interaction. |
dimension |
total_offline_click_custom_value_micro |
total_offline_click_custom_value_micro |
The total monetary value, in micro-dollars, of custom offline events attributed to a click interaction. |
metric |
total_offline_click_lead |
total_offline_click_lead |
The total number of offline lead events attributed to a click interaction. |
dimension |
total_offline_click_lead_value_micro |
total_offline_click_lead_value_micro |
The total monetary value, in micro-dollars, of offline lead events attributed to a click interaction. |
metric |
total_offline_click_signup |
total_offline_click_signup |
The total number of offline signup events attributed to a click interaction. |
dimension |
total_offline_click_signup_value_micro |
total_offline_click_signup_value_micro |
The total monetary value, in micro-dollars, of offline signup events attributed to a click interaction. |
metric |
total_offline_click_unknown |
total_offline_click_unknown |
The total number of undefined offline conversion events attributed to a click interaction. |
dimension |
total_offline_click_unknown_value_micro |
total_offline_click_unknown_value_micro |
The total monetary value, in micro-dollars, of undefined offline conversion events attributed to a click interaction. |
metric |
total_offline_custom |
total_offline_custom |
The total count of custom offline conversions, defined by the advertiser. |
dimension |
total_offline_custom_value_micro |
total_offline_custom_value_micro |
The total monetary value, in micro-dollars, of custom offline events. |
metric |
total_offline_engagement_checkout |
total_offline_engagement_checkout |
The total number of offline checkout events attributed to an engagement (saves, closeups, link clicks, carousel swipes). |
dimension |
total_offline_engagement_checkout_value_micro |
total_offline_engagement_checkout_value_micro |
The total value of offline checkout conversions in microcurrency attributed to engagement actions. |
metric |
total_offline_engagement_custom |
total_offline_engagement_custom |
The total number of custom offline events attributed to an engagement. |
dimension |
total_offline_engagement_custom_value_micro |
total_offline_engagement_custom_value_micro |
The total monetary value, in micro-dollars, of custom offline events attributed to an engagement. |
metric |
total_offline_engagement_lead |
total_offline_engagement_lead |
The total number of offline lead events attributed to an engagement. |
dimension |
total_offline_engagement_lead_value_micro |
total_offline_engagement_lead_value_micro |
The total monetary value, in micro-dollars, of offline lead events attributed to an engagement. |
metric |
total_offline_engagement_signup |
total_offline_engagement_signup |
The total number of offline signup events attributed to an engagement. |
dimension |
total_offline_engagement_signup_value_micro |
total_offline_engagement_signup_value_micro |
The total monetary value, in micro-dollars, of offline signup events attributed to an engagement. |
metric |
total_offline_engagement_unknown |
total_offline_engagement_unknown |
The total number of undefined offline conversion events attributed to an engagement. |
dimension |
total_offline_engagement_unknown_value_micro |
total_offline_engagement_unknown_value_micro |
The total monetary value, in micro-dollars, of undefined offline conversion events attributed to an engagement. |
metric |
total_offline_lead |
total_offline_lead |
The total count of offline lead generation conversions. |
dimension |
total_offline_lead_value_micro |
total_offline_lead_value_micro |
The total monetary value, in micro-dollars, of offline lead events. |
metric |
total_offline_signup |
total_offline_signup |
The total count of offline signup conversions. |
dimension |
total_offline_signup_value_micro |
total_offline_signup_value_micro |
The total monetary value, in micro-dollars, of offline signup events. |
metric |
total_offline_unknown |
total_offline_unknown |
The total number of undefined offline conversion events. |
dimension |
total_offline_unknown_value_micro |
total_offline_unknown_value_micro |
The total monetary value, in micro-dollars, of undefined offline conversion events. |
metric |
total_offline_view_checkout |
total_offline_view_checkout |
The total number of offline checkout events attributed to a view interaction. |
dimension |
total_offline_view_checkout_value_micro |
total_offline_view_checkout_value_micro |
The total value of offline checkout conversions in microcurrency attributed to view-through actions. |
metric |
total_offline_view_custom |
total_offline_view_custom |
The total number of custom offline events attributed to a view interaction. |
dimension |
total_offline_view_custom_value_micro |
total_offline_view_custom_value_micro |
The total monetary value, in micro-dollars, of custom offline events attributed to a view interaction. |
metric |
total_offline_view_lead |
total_offline_view_lead |
The total number of offline lead events attributed to a view interaction. |
dimension |
total_offline_view_lead_value_micro |
total_offline_view_lead_value_micro |
The total monetary value, in micro-dollars, of offline lead events attributed to a view interaction. |
metric |
total_offline_view_signup |
total_offline_view_signup |
The total number of offline signup events attributed to a view interaction. |
dimension |
total_offline_view_signup_value_micro |
total_offline_view_signup_value_micro |
The total monetary value, in micro-dollars, of offline signup events attributed to a view interaction. |
metric |
total_offline_view_unknown |
total_offline_view_unknown |
The total number of offline views for conversions categorized as unknown. |
dimension |
total_offline_view_unknown_value_micro |
total_offline_view_unknown_value_micro |
The total value of unknown offline view conversions, represented in micro-units of the advertiser’s currency. |
metric |
total_onsite_checkouts |
total_onsite_checkouts |
The total number of checkout events that occurred directly on Pinterest’s platform. |
dimension |
total_page_visit |
total_page_visit |
The total number of page visit conversions. |
metric |
total_page_visit_conversion_rate |
total_page_visit_conversion_rate |
The overall conversion rate for page visit events. |
dimension |
total_pinterest_checkout |
total_pinterest_checkout |
The total number of checkout conversions that occurred directly on Pinterest. |
dimension |
total_pinterest_checkout_value_in_micro_dollar |
total_pinterest_checkout_value_in_micro_dollar |
The total value of Pinterest checkout conversions in microdollars. |
metric |
total_repin_rate |
total_repin_rate |
The total rate at which Pins are saved by other users. |
metric |
total_search_conversion_rate |
total_search_conversion_rate |
The overall conversion rate for search events, indicating how often a search leads to a conversion. |
dimension |
total_signup |
total_signup |
The total count of all signup conversions, both online and offline. |
dimension |
total_signup_conversion_rate |
total_signup_conversion_rate |
The overall conversion rate for signup events. |
dimension |
total_signup_value_in_micro_dollar |
total_signup_value_in_micro_dollar |
The total monetary value, in micro-dollars, attributed to signup events across all platforms. |
metric |
total_video_3sec_views |
total_video_3sec_views |
The total number of video views that lasted at least 3 seconds. |
metric |
total_video_avg_watchtime_in_second |
total_video_avg_watchtime_in_second |
The total average watch time in seconds for video Pins. |
metric |
total_video_mrc_views |
total_video_mrc_views |
Total video views where the video meets the Media Rating Council (MRC) standard for a view. |
metric |
total_video_p0_combined |
total_video_p0_combined |
The total number of video views combined at 0% completion (video starts). |
dimension |
total_video_p100_complete |
total_video_p100_complete |
Total video plays at 100% completion (both paid and earned). |
dimension |
total_video_p25_combined |
total_video_p25_combined |
Total video plays at 25% completion combined (both paid and earned). |
dimension |
total_video_p50_combined |
total_video_p50_combined |
Total video plays at 50% completion combined (both paid and earned). |
dimension |
total_video_p75_combined |
total_video_p75_combined |
Total video plays at 75% completion combined (both paid and earned). |
dimension |
total_video_p95_combined |
total_video_p95_combined |
The total number of video views combined at 95% completion. |
dimension |
total_view_add_to_cart |
total_view_add_to_cart |
The total number of add-to-cart events attributed to views of ads. |
dimension |
total_view_checkout |
total_view_checkout |
The total number of checkout events attributed to views of ads. |
dimension |
total_view_checkout_value_in_micro_dollar |
total_view_checkout_value_in_micro_dollar |
The total value of checkout conversions attributed to views of ads, expressed in micro-dollars. |
dimension |
total_view_lead |
total_view_lead |
The total number of lead generation events attributed to views of ads. |
dimension |
total_view_signup |
total_view_signup |
The total number of signup events attributed to views of ads. |
dimension |
total_view_signup_value_in_micro_dollar |
total_view_signup_value_in_micro_dollar |
The total value of signup conversions attributed to views of ads, expressed in micro-dollars. |
dimension |
total_watch_video_conversion_rate |
total_watch_video_conversion_rate |
The overall conversion rate for video watch events. |
dimension |
total_web_add_to_cart |
total_web_add_to_cart |
The total number of times an item was added to a shopping cart on the web. This is an online conversion metric. |
metric |
total_web_add_to_cart_value_micro |
total_web_add_to_cart_value_micro |
The total monetary value, in micro-dollars, of ‘add to cart’ events recorded on the advertiser’s website. |
metric |
total_web_checkout |
total_web_checkout |
The total number of website checkout conversions. |
metric |
total_web_checkout_value_in_micro_dollar |
total_web_checkout_value_in_micro_dollar |
The total value of web checkout conversions, expressed in micro-dollars. |
dimension |
total_web_checkout_value_micro |
total_web_checkout_value_micro |
The total value of website checkout conversions in microcurrency. |
metric |
total_web_click_add_to_cart |
total_web_click_add_to_cart |
The total number of ‘add to cart’ events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_add_to_cart_value_micro |
total_web_click_add_to_cart_value_micro |
The total monetary value, in micro-dollars, of ‘add to cart’ events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_checkout |
total_web_click_checkout |
The total number of website checkout conversions attributed to click actions. |
metric |
total_web_click_checkout_value_in_micro_dollar |
total_web_click_checkout_value_in_micro_dollar |
The total value of web checkout conversions attributed to clicks on ads, expressed in micro-dollars. |
dimension |
total_web_click_checkout_value_micro |
total_web_click_checkout_value_micro |
The total value of website checkout conversions in microcurrency attributed to click actions. |
metric |
total_web_click_custom |
total_web_click_custom |
The total number of custom events recorded on the advertiser’s website that were attributed to a click interaction. |
dimension |
total_web_click_custom_value_micro |
total_web_click_custom_value_micro |
The total monetary value, in micro-dollars, of custom events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_lead |
total_web_click_lead |
The total number of lead events recorded on the advertiser’s website that were attributed to a click interaction. |
dimension |
total_web_click_lead_value_micro |
total_web_click_lead_value_micro |
The total monetary value, in micro-dollars, of lead events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_page_visit |
total_web_click_page_visit |
The total number of page visit events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_page_visit_value_micro |
total_web_click_page_visit_value_micro |
The total monetary value, in micro-dollars, of page visit events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_search |
total_web_click_search |
The total number of website searches attributed to click actions. |
dimension |
total_web_click_search_value_micro |
total_web_click_search_value_micro |
The total monetary value, in micro-dollars, of search events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_signup |
total_web_click_signup |
The total number of signup events recorded on the advertiser’s website that were attributed to a click interaction. |
dimension |
total_web_click_signup_value_micro |
total_web_click_signup_value_micro |
The total monetary value, in micro-dollars, of signup events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_unknown |
total_web_click_unknown |
The total number of undefined conversion events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_unknown_value_micro |
total_web_click_unknown_value_micro |
The total monetary value, in micro-dollars, of undefined conversion events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_view_category |
total_web_click_view_category |
The total number of category view events recorded on the advertiser’s website that were attributed to a click interaction. |
dimension |
total_web_click_view_category_value_micro |
total_web_click_view_category_value_micro |
The total monetary value, in micro-dollars, of category view events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_click_watch_video |
total_web_click_watch_video |
The total number of video watch events recorded on the advertiser’s website that were attributed to a click interaction. |
dimension |
total_web_click_watch_video_value_micro |
total_web_click_watch_video_value_micro |
The total monetary value, in micro-dollars, of video watch events recorded on the advertiser’s website that were attributed to a click interaction. |
metric |
total_web_custom |
total_web_custom |
The total number of custom events recorded on the advertiser’s website. |
dimension |
total_web_custom_value_micro |
total_web_custom_value_micro |
The total monetary value, in micro-dollars, of custom events recorded on the advertiser’s website. |
metric |
total_web_engagement_add_to_cart |
total_web_engagement_add_to_cart |
The total number of ‘add to cart’ events recorded on the advertiser’s website that were attributed to an engagement (saves, closeups, link clicks, carousel swipes). |
dimension |
total_web_engagement_add_to_cart_value_micro |
total_web_engagement_add_to_cart_value_micro |
The total monetary value, in micro-dollars, of ‘add to cart’ events recorded on the advertiser’s website that were attributed to an engagement. |
metric |
total_web_engagement_checkout |
total_web_engagement_checkout |
The total number of checkout events recorded on the advertiser’s website that were attributed to an engagement. |
dimension |
total_web_engagement_checkout_value_in_micro_dollar |
total_web_engagement_checkout_value_in_micro_dollar |
The total value of web checkout conversions attributed to engagements with ads, expressed in micro-dollars. |
dimension |
total_web_engagement_checkout_value_micro |
total_web_engagement_checkout_value_micro |
The total value of website checkout conversions in microcurrency attributed to engagement actions. |
metric |
total_web_engagement_custom |
total_web_engagement_custom |
The total number of custom events recorded on the advertiser’s website that were attributed to an engagement. |
dimension |
total_web_engagement_custom_value_micro |
total_web_engagement_custom_value_micro |
The total monetary value, in micro-dollars, of custom events recorded on the advertiser’s website that were attributed to an engagement. |
metric |
total_web_engagement_lead |
total_web_engagement_lead |
The total number of lead events recorded on the advertiser’s website that were attributed to an engagement. |
dimension |
total_web_engagement_lead_value_micro |
total_web_engagement_lead_value_micro |
The total monetary value, in micro-dollars, of lead events recorded on the advertiser’s website that were attributed to an engagement. |
metric |
total_web_engagement_page_visit |
total_web_engagement_page_visit |
The total number of page visit events recorded on the advertiser’s website that were attributed to an engagement. |
dimension |
total_web_engagement_page_visit_value_micro |
total_web_engagement_page_visit_value_micro |
The total monetary value, in micro-dollars, of page visit events recorded on the advertiser’s website that were attributed to an engagement. |
metric |
total_web_engagement_search |
total_web_engagement_search |
The total number of search events recorded on the advertiser’s website that were attributed to an engagement. |
dimension |
total_web_engagement_search_value_micro |
total_web_engagement_search_value_micro |
The total monetary value, in micro-dollars, of search events recorded on the advertiser’s website that were attributed to an engagement. |
metric |
total_web_engagement_signup |
total_web_engagement_signup |
The total number of signup events recorded on the advertiser’s website that were attributed to an engagement. |
dimension |
total_web_engagement_signup_value_micro |
total_web_engagement_signup_value_micro |
The total monetary value, in micro-dollars, of signup events recorded on the advertiser’s website that were attributed to an engagement. |
metric |
total_web_engagement_unknown |
total_web_engagement_unknown |
Total number of engagement events on the website that do not fit into other defined categories. |
dimension |
total_web_engagement_unknown_value_micro |
total_web_engagement_unknown_value_micro |
Total value of engagement events on the website that do not fit into other defined categories, in micro-currency. |
metric |
total_web_engagement_view_category |
total_web_engagement_view_category |
Total number of web engagement events where a category was viewed. |
dimension |
total_web_engagement_view_category_value_micro |
total_web_engagement_view_category_value_micro |
Total value of web engagement events involving category views, in micro-currency. |
metric |
total_web_engagement_watch_video |
total_web_engagement_watch_video |
Total number of web engagement events where a video was watched. |
dimension |
total_web_engagement_watch_video_value_micro |
total_web_engagement_watch_video_value_micro |
Total value of web engagement events involving video watches, in micro-currency. |
metric |
total_web_lead |
total_web_lead |
Total number of lead conversion events recorded on the website. |
dimension |
total_web_lead_value_micro |
total_web_lead_value_micro |
Total value of lead conversion events recorded on the website, in micro-currency. |
metric |
total_web_page_visit |
total_web_page_visit |
Total number of page visit conversion events on the website. |
dimension |
total_web_page_visit_value_micro |
total_web_page_visit_value_micro |
Total value of page visit conversion events on the website, in micro-currency. |
metric |
total_web_search |
total_web_search |
Total number of search conversion events on the website. |
metric |
total_web_search_value_micro |
total_web_search_value_micro |
Total value of search conversion events on the website, in micro-currency. |
metric |
total_web_sessions |
total_web_sessions |
The total number of web sessions initiated by users. |
dimension |
total_web_signup |
total_web_signup |
Total number of signup conversion events on the website. |
dimension |
total_web_signup_value_micro |
total_web_signup_value_micro |
Total value of signup conversion events on the website, in micro-currency. |
metric |
total_web_unknown |
total_web_unknown |
Total number of unknown web conversion events. |
metric |
total_web_unknown_value_micro |
total_web_unknown_value_micro |
Total value of unknown web conversion events, in micro-currency. |
metric |
total_web_view_add_to_cart |
total_web_view_add_to_cart |
Total number of web add-to-cart events resulting from a view. |
metric |
total_web_view_add_to_cart_value_micro |
total_web_view_add_to_cart_value_micro |
Total value of web add-to-cart events resulting from a view, in micro-currency. |
metric |
total_web_view_category |
total_web_view_category |
Total number of web category view events. |
dimension |
total_web_view_category_value_micro |
total_web_view_category_value_micro |
The total value of website view category conversions in microcurrency. |
metric |
total_web_view_checkout |
total_web_view_checkout |
The total number of website checkout conversions attributed to view-through actions. |
metric |
total_web_view_checkout_value_in_micro_dollar |
total_web_view_checkout_value_in_micro_dollar |
The total value of web checkout conversions attributed to views of ads, expressed in micro-dollars. |
dimension |
total_web_view_checkout_value_micro |
total_web_view_checkout_value_micro |
The total value of website checkout conversions in microcurrency attributed to view-through actions. |
metric |
total_web_view_custom |
total_web_view_custom |
The total number of custom web conversions attributed to views. |
dimension |
total_web_view_custom_value_micro |
total_web_view_custom_value_micro |
The total value of custom web conversions attributed to views, expressed in microunits. |
metric |
total_web_view_lead |
total_web_view_lead |
Total number of lead events on the website resulting from a view. |
dimension |
total_web_view_lead_value_micro |
total_web_view_lead_value_micro |
Total value of lead events on the website resulting from a view, in micro-currency. |
metric |
total_web_view_page_visit |
total_web_view_page_visit |
Total number of page visit events on the website resulting from a view. |
metric |
total_web_view_page_visit_value_micro |
total_web_view_page_visit_value_micro |
Total value of page visit events on the website resulting from a view, in micro-currency. |
metric |
total_web_view_search |
total_web_view_search |
The total number of website searches attributed to view-through actions. |
metric |
total_web_view_search_value_micro |
total_web_view_search_value_micro |
The total value generated from viewing search results on the web, represented in micro-units of the advertiser’s currency. |
metric |
total_web_view_signup |
total_web_view_signup |
Total number of signup events on the website resulting from a view. |
dimension |
total_web_view_signup_value_micro |
total_web_view_signup_value_micro |
Total value of signup events on the website resulting from a view, in micro-currency. |
metric |
total_web_view_unknown |
total_web_view_unknown |
Total number of unknown web events resulting from a view. |
metric |
total_web_view_unknown_value_micro |
total_web_view_unknown_value_micro |
The total value of unknown web conversions attributed to views, expressed in microunits. |
metric |
total_web_view_view_category |
total_web_view_view_category |
The total number of views of product categories on the web. This is an online engagement or conversion metric. |
dimension |
total_web_view_view_category_value_micro |
total_web_view_view_category_value_micro |
The total value generated from viewing product categories on the web, represented in micro-units of the advertiser’s currency. |
metric |
total_web_view_watch_video |
total_web_view_watch_video |
Total number of video watch events on the website resulting from a view. |
dimension |
total_web_view_watch_video_value_micro |
total_web_view_watch_video_value_micro |
Total value of video watch events on the website resulting from a view, in micro-currency. |
metric |
total_web_watch_video_value_micro |
total_web_watch_video_value_micro |
The total monetary value, in micro units of the advertiser’s currency, generated from users watching videos on the web. This value is expressed in microdollars (1/1,000,000 of a dollar) or microunits of the advertiser’s currency. |
metric |
unknown_desktop_action_desktop_conversion |
unknown_desktop_action_desktop_conversion |
The number of conversions where the initial action was an unknown event on a desktop device, and the conversion also occurred on a desktop device. |
metric |
unknown_desktop_action_mobile_conversion |
unknown_desktop_action_mobile_conversion |
The number of conversions where the initial action was an unknown event on a desktop device, and the conversion occurred on a mobile device. |
metric |
unknown_desktop_action_tablet_conversion |
unknown_desktop_action_tablet_conversion |
The number of conversions where the initial action was an unknown event on a desktop device, and the conversion occurred on a tablet device. |
metric |
unknown_mobile_action_desktop_conversion |
unknown_mobile_action_desktop_conversion |
The number of conversions where the initial action was an unknown event on a mobile device, and the conversion occurred on a desktop device. |
metric |
unknown_mobile_action_mobile_conversion |
unknown_mobile_action_mobile_conversion |
The number of conversions where the initial action was an unknown event on a mobile device, and the conversion also occurred on a mobile device. |
metric |
unknown_mobile_action_tablet_conversion |
unknown_mobile_action_tablet_conversion |
The number of conversions where the initial action was an unknown event on a mobile device, and the conversion occurred on a tablet device. |
metric |
unknown_tablet_action_desktop_conversion |
unknown_tablet_action_desktop_conversion |
The number of conversions where the initial action was an unknown event on a tablet device, and the conversion occurred on a desktop device. |
metric |
unknown_tablet_action_mobile_conversion |
unknown_tablet_action_mobile_conversion |
The number of conversions where the initial action was an unknown event on a tablet device, and the conversion occurred on a mobile device. |
metric |
unknown_tablet_action_tablet_conversion |
unknown_tablet_action_tablet_conversion |
The number of conversions where the initial action was an unknown event on a tablet device, and the conversion also occurred on a tablet device. |
metric |
value_micro_(app_install) |
value_micro_(app_install) |
The monetary value associated with an app install conversion event, in micro-currency. |
metric |
video_3sec_views_2 |
video_3sec_views_2 |
The number of video views lasting at least 3 seconds, potentially with a different attribution window or type. |
metric |
video_length |
video_length |
The duration of the video creative, in seconds. |
metric |
video_mrc_views_2 |
video_mrc_views_2 |
The number of Media Rating Council (MRC)-measured video views, indicating viewable impressions, potentially with a different attribution window or type. |
metric |
video_p0_combined_2 |
video_p0_combined_2 |
The number of times the video was viewed to 0% completion, combined across paid and organic. The suffix ‘2’ may refer to a different attribution window or type. |
metric |
video_p100_complete_2 |
video_p100_complete_2 |
The number of times the video was watched to 100% completion, combined across paid and organic. The suffix ‘2’ may refer to a different attribution window or type. |
metric |
video_p25_combined_2 |
video_p25_combined_2 |
The number of times the video was viewed to 25% completion, combined across paid and organic. The suffix ‘2’ may refer to a different attribution window or type. |
dimension |
video_p50_combined_2 |
video_p50_combined_2 |
The number of times the video was viewed to 50% completion, combined across paid and organic. The suffix ‘2’ may refer to a different attribution window or type. |
dimension |
video_p75_combined_2 |
video_p75_combined_2 |
The number of times the video was viewed to 75% completion, combined across paid and organic. The suffix ‘2’ may refer to a different attribution window or type. |
metric |
video_p95_combined_2 |
video_p95_combined_2 |
The number of times the video was viewed to 95% completion, combined across paid and organic. The suffix ‘2’ may refer to a different attribution window or type. |
metric |
view_category_desktop_action_desktop_conversion |
view_category_desktop_action_desktop_conversion |
The number of conversions where the initial action was viewing a category on a desktop device, and the conversion also occurred on a desktop device. |
dimension |
view_category_desktop_action_mobile_conversion |
view_category_desktop_action_mobile_conversion |
The number of conversions where the initial action was viewing a category on a desktop device, and the conversion occurred on a mobile device. |
dimension |
view_category_desktop_action_tablet_conversion |
view_category_desktop_action_tablet_conversion |
The number of conversions where the initial action was viewing a category on a desktop device, and the conversion occurred on a tablet device. |
dimension |
view_category_mobile_action_desktop_conversion |
view_category_mobile_action_desktop_conversion |
The number of conversions where the initial action was viewing a category on a mobile device, and the conversion occurred on a desktop device. |
dimension |
view_category_mobile_action_mobile_conversion |
view_category_mobile_action_mobile_conversion |
The number of conversions where the initial action was viewing a category on a mobile device, and the conversion also occurred on a mobile device. |
dimension |
view_category_mobile_action_tablet_conversion |
view_category_mobile_action_tablet_conversion |
The number of conversions where the initial action was viewing a category on a mobile device, and the conversion occurred on a tablet device. |
dimension |
view_category_tablet_action_desktop_conversion |
view_category_tablet_action_desktop_conversion |
The number of conversions where the initial action was viewing a category on a tablet device, and the conversion occurred on a desktop device. |
dimension |
view_category_tablet_action_mobile_conversion |
view_category_tablet_action_mobile_conversion |
The number of conversions where the initial action was viewing a category on a tablet device, and the conversion occurred on a mobile device. |
dimension |
view_category_tablet_action_tablet_conversion |
view_category_tablet_action_tablet_conversion |
The number of conversions where the initial action was viewing a category on a tablet device, and the conversion also occurred on a tablet device. |
dimension |
viewthrough_conversions_(add_to_cart) |
viewthrough_conversions_(add_to_cart) |
The number of add-to-cart conversions attributed to a view-through action. |
metric |
viewthrough_conversions_(app_install) |
viewthrough_conversions_(app_install) |
The number of app install conversions attributed to view-through actions. |
metric |
viewthrough_conversions_(category_view) |
viewthrough_conversions_(category_view) |
The number of category view conversions attributed to view-through actions. |
dimension |
viewthrough_conversions_(checkout) |
viewthrough_conversions_(checkout) |
The number of checkout conversions attributed to a view-through action (user saw an ad but did not click, then converted). |
metric |
viewthrough_conversions_(custom) |
viewthrough_conversions_(custom) |
The number of custom conversions attributed to view-through actions. |
metric |
viewthrough_conversions_(lead) |
viewthrough_conversions_(lead) |
The number of lead conversions attributed to a view-through action. |
dimension |
viewthrough_conversions_(page_visit) |
viewthrough_conversions_(page_visit) |
The number of page visit conversions attributed to a view-through action. |
metric |
viewthrough_conversions_(signup) |
viewthrough_conversions_(signup) |
The number of signup conversions attributed to a view-through action. |
dimension |
viewthrough_conversions_(unknown) |
viewthrough_conversions_(unknown) |
The number of view-through conversions of an unknown type. |
metric |
viewthrough_conversions_(watch_video) |
viewthrough_conversions_(watch_video) |
The number of watch video conversions attributed to view-through actions. |
dimension |
viewthrough_conversions_(website_search) |
viewthrough_conversions_(website_search) |
The number of website search conversions attributed to view-through actions. |
metric |
viewthrough_order_quantity_(checkout) |
viewthrough_order_quantity_(checkout) |
The quantity of items purchased in checkout conversions attributed to a view-through action. |
dimension |
viewthrough_value_micro_(add_to_cart) |
viewthrough_value_micro_(add_to_cart) |
The monetary value of view-through add-to-cart conversions, in micro-currency. |
metric |
viewthrough_value_micro_(app_install) |
viewthrough_value_micro_(app_install) |
The monetary value of view-through app install conversions, in micro-currency. |
metric |
viewthrough_value_micro_(category_view) |
viewthrough_value_micro_(category_view) |
The monetary value of view-through category view conversions, in micro-currency. |
metric |
viewthrough_value_micro_(custom) |
viewthrough_value_micro_(custom) |
The monetary value of view-through custom conversions, in micro-currency. |
metric |
viewthrough_value_micro_(lead) |
viewthrough_value_micro_(lead) |
The value of lead conversions in microcurrency attributed to a view-through action. |
metric |
viewthrough_value_micro_(page_visit) |
viewthrough_value_micro_(page_visit) |
The monetary value of view-through page visit conversions, in micro-currency. |
metric |
viewthrough_value_micro_(signup) |
viewthrough_value_micro_(signup) |
The value of signup conversions in microcurrency attributed to a view-through action. |
metric |
viewthrough_value_micro_(unknown) |
viewthrough_value_micro_(unknown) |
The monetary value of view-through unknown conversions, in micro-currency. |
metric |
viewthrough_value_micro_(watch_video) |
viewthrough_value_micro_(watch_video) |
The monetary value of view-through video watch conversions, in micro-currency. |
metric |
viewthrough_value_micro_(website_search) |
viewthrough_value_micro_(website_search) |
The monetary value of view-through website search conversions, in micro-currency. |
metric |
watch_video_desktop_action_desktop_conversion |
watch_video_desktop_action_desktop_conversion |
The number of conversions where the initial action was watching a video on a desktop device, and the conversion also occurred on a desktop device. |
dimension |
watch_video_desktop_action_mobile_conversion |
watch_video_desktop_action_mobile_conversion |
The number of conversions where the initial action was watching a video on a desktop device, and the conversion occurred on a mobile device. |
dimension |
watch_video_desktop_action_tablet_conversion |
watch_video_desktop_action_tablet_conversion |
The number of conversions where the initial action was watching a video on a desktop device, and the conversion occurred on a tablet device. |
dimension |
watch_video_mobile_action_desktop_conversion |
watch_video_mobile_action_desktop_conversion |
The number of conversions where the initial action was watching a video on a mobile device, and the conversion occurred on a desktop device. |
dimension |
watch_video_mobile_action_mobile_conversion |
watch_video_mobile_action_mobile_conversion |
The number of conversions where the initial action was watching a video on a mobile device, and the conversion also occurred on a mobile device. |
dimension |
watch_video_mobile_action_tablet_conversion |
watch_video_mobile_action_tablet_conversion |
The number of conversions where the initial action was watching a video on a mobile device, and the conversion occurred on a tablet device. |
dimension |
watch_video_tablet_action_desktop_conversion |
watch_video_tablet_action_desktop_conversion |
The number of conversions where the initial action was watching a video on a tablet device, and the conversion occurred on a desktop device. |
dimension |
watch_video_tablet_action_mobile_conversion |
watch_video_tablet_action_mobile_conversion |
The number of conversions where the initial action was watching a video on a tablet device, and the conversion occurred on a mobile device. |
dimension |
watch_video_tablet_action_tablet_conversion |
watch_video_tablet_action_tablet_conversion |
The number of conversions where the initial action was watching a video on a tablet device, and the conversion also occurred on a tablet device. |
dimension |
web_add_to_cart_cost_per_action |
web_add_to_cart_cost_per_action |
The average cost incurred for each add-to-cart action performed on the website. |
metric |
web_add_to_cart_roas |
web_add_to_cart_roas |
The Return on Ad Spend (ROAS) for add-to-cart actions on the website. |
metric |
web_checkout_cost_per_action |
web_checkout_cost_per_action |
The average cost incurred for each checkout action performed on the website. |
metric |
web_checkout_roas |
web_checkout_roas |
The Return on Ad Spend (ROAS) for checkout actions on the website. |
metric |
web_custom_cost_per_action |
web_custom_cost_per_action |
The average cost incurred for each custom action performed on the website. |
dimension |
web_custom_roas |
web_custom_roas |
The Return on Ad Spend (ROAS) for custom actions on the website. |
dimension |
web_lead_cost_per_action |
web_lead_cost_per_action |
The average cost incurred for each lead action performed on the website. |
dimension |
web_lead_roas |
web_lead_roas |
The Return on Ad Spend (ROAS) for lead actions on the website. |
dimension |
web_page_visit_cost_per_action |
web_page_visit_cost_per_action |
The average cost incurred for each page visit action performed on the website. |
metric |
web_page_visit_roas |
web_page_visit_roas |
The Return on Ad Spend (ROAS) for page visit actions on the website. |
dimension |
web_search_cost_per_action |
web_search_cost_per_action |
The average cost incurred for each search action performed on the website. |
metric |
web_search_roas |
web_search_roas |
The Return on Ad Spend (ROAS) for search actions on the website. |
metric |
web_signup_cost_per_action |
web_signup_cost_per_action |
The average cost incurred for each signup action performed on the website. |
dimension |
web_signup_roas |
web_signup_roas |
The Return on Ad Spend (ROAS) for signup actions on the website. |
dimension |
web_unknown_cost_per_action |
web_unknown_cost_per_action |
The average cost incurred for each unknown action performed on the website. |
metric |
web_unknown_roas |
web_unknown_roas |
The Return on Ad Spend (ROAS) for unknown actions on the website. |
metric |
web_view_category_cost_per_action |
web_view_category_cost_per_action |
The average cost incurred for each category view action performed on the website. |
dimension |
web_view_category_roas |
web_view_category_roas |
The Return on Ad Spend (ROAS) for category view actions on the website. |
dimension |
web_watch_video_cost_per_action |
web_watch_video_cost_per_action |
The average cost incurred for each video watch action performed on the website. |
dimension |
web_watch_video_roas |
web_watch_video_roas |
The Return on Ad Spend (ROAS) for video watch actions on the website. |
dimension |