Pinterest Ads fields

  • Updated on Sep 11, 2025
  • Published on Aug 5, 2025
Prev Next

Supermetrics brings all your Pinterest Ads data into Google Sheets, Looker Studio, Power BI, Excel, BigQuery, Snowflake, Redshift, Azure

321 metrics139 dimensions

AD GROUP

ad_group_campaign_id
Field label Ad group campaign ID
Description The unique identifier of the campaign of the ad group
Field type dimension
Data type string.text.value
ad_group_id
Field label Ad group ID
Description The unique identifier of the ad group
Field type dimension
Data type int.number.value
ad_group_name
Field label Ad group name
Description The name of the ad group
Field type dimension
Data type string.text.value
ad_group_status
Field label Ad group status
Description The status of the ad group
Field type dimension
Data type string.text.value
ad_group_type
Field label Ad group type
Description The type of the ad group
Field type dimension
Data type string.text.value
ad_group_auto_targeting_enabled
Field label Auto targeting enabled
Description Whether auto targeting is enabled or not
Field type dimension
Data type bool
ad_group_bid_value
Field label Bid
Description The bid amount of the ad group in the currency of the advertiser account
Field type dimension
Data type float.currency.value
ad_group_billable_event
Field label Billable event
Description The billable event of the ad group
Field type dimension
Data type string.text.value
ad_group_budget_value
Field label Budget
Description The budget of the ad group in the currency of the advertiser account. Ad group budgets will be blank if they belong to a campaign that is using campaign budget optimisation
Field type dimension
Data type float.currency.value
ad_group_budget_type
Field label Budget type
Description The budget type of the ad group
Field type dimension
Data type string.text.value
ad_group_lifetime_frequency_cap
Field label Lifetime frequency cap
Description Lifetime frequency cap of the ad group
Field type dimension
Data type int.number.value
ad_group_optimization_goal_metadata_conversion_tag_id
Field label Optimization goal conversion tag ID
Description The unique identifier for the conversion tag of the ad group
Field type dimension
Data type string.text.value
ad_group_optimization_goal_metadata_conversion_event
Field label Optimization goal conversion event
Description The conversion event of the ad group
Field type dimension
Data type string.text.value
ad_group_optimization_goal_metadata_engagement_window
Field label Optimization goal engagement window
Description The engagement attribution window in days
Field type dimension
Data type int.number.value
ad_group_optimization_goal_metadata_click_window
Field label Optimization goal click window
Description The click attribution window in days
Field type dimension
Data type int.number.value
ad_group_optimization_goal_metadata_view_window
Field label Optimization goal view window
Description The view attribution window in days
Field type dimension
Data type int.number.value
ad_group_optimization_goal_metadata_learning_mode_type
Field label Optimization goal conversion learning mode type
Description The learning mode type of the ad group
Field type dimension
Data type string.text.value
ad_group_optimization_goal_metadata_cpa_goal_value
Field label Optimization goal CPA value
Description The CPA goal value of the ad group in the currency of the advertiser account
Field type dimension
Data type float.currency.value
ad_group_pacing_delivery_type
Field label Pacing delivery type
Description The pacing delivery type of the ad group
Field type dimension
Data type string.text.value
ad_group_pin_promotion_ids
Field label Pin promotion IDs
Description The unique identifiers for the pin promotions of the ad group
Field type dimension
Data type string.text.value
ad_group_placement_group
Field label Placement group
Description List of placements group for the ad group
Field type dimension
Data type string.text.value
ad_group_targeting_spec_app_type
Field label Targeting app type
Description List of app types the ad group is targeting
Field type dimension
Data type string.text.value
ad_group_targeting_spec_gender
Field label Targeting gender
Description List of genders the ad group is targeting
Field type dimension
Data type string.text.value
ad_group_targeting_spec_locale
Field label Targeting locale
Description List of locales the ad group is targeting
Field type dimension
Data type string.text.value
ad_group_targeting_spec_location
Field label Targeting location
Description List of locations the ad group is targeting
Field type dimension
Data type string.text.value
ad_group_targeting_spec_geo
Field label Targeting geo
Description List of geolocations the ad group is targeting
Field type dimension
Data type string.text.value
ad_group_tracking_urls
Field label Tracking URLs
Description The tracking URLs of the ad group
Field type dimension
Data type string.text.value
ad_group_start_time
Field label Ad group start date
Description The start date and start time of your ad group in UTC
Field type dimension
Data type string.time.datetime
ad_group_end_time
Field label Ad group end date
Description The end date and end time of your ad group in UTC
Field type dimension
Data type string.time.datetime
ad_group_created_time
Field label Ad group created date
Description The date the ad group was created
Field type dimension
Data type string.time.date
ad_group_updated_time
Field label Ad group updated date
Description The date the ad group was last updated
Field type dimension
Data type string.time.date

ADVERTISER

advertiser_id
Field label Advertiser ID
Description The unique identifier for the advertiser
Field type dimension
Data type string.text.value
advertiser_name
Field label Advertiser name
Description The name of the advertiser
Field type dimension
Data type string.text.value
advertiser_country
Field label Advertiser country
Description The country of the advertiser
Field type dimension
Data type string.geo.country.twolettercode
advertiser_currency
Field label Currency
Description The currency the advertiser uses
Field type dimension
Data type string.currency.code
advertiser_owner_user_id
Field label Owner user ID
Description The user ID of the owner of the advertiser
Field type dimension
Data type string.text.value
advertiser_roles
Field label Roles
Description The roles of the advertiser
Field type dimension
Data type string.text.value

CAMPAIGN

campaign_id
Field label Campaign ID
Description The unique identifier of the campaign
Field type dimension
Data type string.text.value
campaign_name
Field label Campaign name
Description The name of the campaign
Field type dimension
Data type string.text.value
campaign_start_time
Field label Campaign start date
Description The start date and start time of your campaign in UTC
Field type dimension
Data type string.time.datetime
campaign_end_time
Field label Campaign end date
Description The end date and end time of your campaign in UTC
Field type dimension
Data type string.time.datetime
campaign_daily_spend_cap
Field label Daily spend cap
Description The daily spend cap of the campaign
Field type dimension
Data type float.currency.value
campaign_lifetime_spend_cap
Field label Lifetime spend cap
Description The lifetime spend cap of the campaign
Field type dimension
Data type float.currency.value
campaign_status
Field label Campaign status
Description The status of the campaign
Field type dimension
Data type string.text.value
campaign_objective_type
Field label Campaign objective type
Description The objective type of the campaign
Field type dimension
Data type string.text.value
campaign_order_line_id
Field label Order line ID
Description The order line ID of the campaign
Field type dimension
Data type string.text.value
campaign_created_time
Field label Campaign created date
Description The date the campaign was created
Field type dimension
Data type string.time.date
campaign_updated_time
Field label Campaign updated date
Description The date the campaign was last updated
Field type dimension
Data type string.time.date

CONVERSIONS ADD TO CART

total_click_add_to_cart
Field label Click-through conversions (add to cart)
Description Total number of add to cart events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_click_add_to_cart_quantity
Field label Conversion quantity from add to cart - clicks
Description Total quantity of add to cart events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_click_add_to_cart_value
Field label Click-through value (add to cart)
Description Total value of add to cart events resulting from clicks on your ads
Field type metric
Data type float.currency.value
total_engagement_add_to_cart
Field label Engagement conversions (add to cart)
Description Total number of add to cart events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_engagement_add_to_cart_quantity
Field label Conversion quantity from add to cart - engagements
Description Total quantity of add to cart events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_engagement_add_to_cart_value
Field label Engagement value (add to cart)
Description Total value of add to cart events resulting from engagement with your ads
Field type metric
Data type float.currency.value
total_view_add_to_cart
Field label View-through conversions (add to cart)
Description Total number of add to cart events resulting from views of your ads
Field type metric
Data type int.number.value
total_view_add_to_cart_quantity
Field label Conversion quantity from add to cart - views
Description Total quantity of add to cart events resulting from views of your ads
Field type metric
Data type int.number.value
total_view_add_to_cart_value
Field label View-through value (add to cart)
Description Total value of add to cart events resulting from views of your ads
Field type metric
Data type float.currency.value
total_add_to_cart_desktop_action_to_desktop_conversion
Field label Add to cart desktop action to desktop conversion
Description Total number of desktop add to cart actions leading to a desktop add to cart conversion
Field type metric
Data type int.number.value
total_add_to_cart_desktop_action_to_mobile_conversion
Field label Add to cart desktop action to mobile conversion
Description Total number of desktop add to cart actions leading to a mobile add to cart conversion
Field type metric
Data type int.number.value
total_add_to_cart_desktop_action_to_tablet_conversion
Field label Add to cart desktop action to tablet conversion
Description Total number of desktop add to cart actions leading to a tablet add to cart conversion
Field type metric
Data type int.number.value
total_add_to_cart_mobile_action_to_desktop_conversion
Field label Add to cart mobile action to desktop conversion
Description Total number of mobile add to cart actions leading to a desktop add to cart conversion
Field type metric
Data type int.number.value
total_add_to_cart_mobile_action_to_mobile_conversion
Field label Add to cart mobile action to mobile conversion
Description Total number of mobile add to cart actions leading to a mobile add to cart conversion
Field type metric
Data type int.number.value
total_add_to_cart_mobile_action_to_tablet_conversion
Field label Add to cart mobile action to tablet conversion
Description Total number of desktop add to cart actions leading to a mobile add to cart conversion
Field type metric
Data type int.number.value
total_add_to_cart_tablet_action_to_desktop_conversion
Field label Add to cart tablet action to desktop conversion
Description Total number of tablet add to cart actions leading to a desktop add to cart conversion
Field type metric
Data type int.number.value
total_add_to_cart_tablet_action_to_mobile_conversion
Field label Add to cart tablet action to mobile conversion
Description Total number of tablet add to cart actions leading to a mobile add to cart conversion
Field type metric
Data type int.number.value
total_add_to_cart_tablet_action_to_tablet_conversion
Field label Add to cart tablet action to tablet conversion
Description Total number of tablet add to cart actions leading to a tablet add to cart conversion
Field type metric
Data type int.number.value
inapp_add_to_cart_cost_per_action
Field label In-app CPA (add to cart)
Description Average cost per in-app add to cart events
Field type metric
Data type float.currency.value
inapp_add_to_cart_roas
Field label In-app ROAS (add to cart)
Description Average return on spend for in-app add to cart events
Field type metric
Data type float.number.ratio
total_inapp_add_to_cart
Field label In-app conversions (add to cart)
Description Total number of in-app add to cart events resulting from interactions with your ads
Field type metric
Data type int.number.value
total_inapp_add_to_cart_value
Field label In-app order value (add to cart)
Description Total value of in-app add to cart events resulting from interactions with your ads
Field type metric
Data type float.currency.value
total_inapp_click_add_to_cart
Field label In-app click-through conversions (add to cart)
Description Total number of in-app add to cart events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_inapp_click_add_to_cart_value
Field label In-app click-through order value (add to cart)
Description Total value of in-app add to cart events resulting from clicks on your ads
Field type metric
Data type float.currency.value
total_inapp_engagement_add_to_cart
Field label In-app engagement conversions (add to cart)
Description Total number of in-app add to cart events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_inapp_engagement_add_to_cart_value
Field label In-app engagement order value (add to cart)
Description Total value of in-app add to cart events resulting from engagement with your ads
Field type metric
Data type float.currency.value
total_inapp_view_add_to_cart
Field label In-app view-through conversions (add to cart)
Description Total number of in-app add to cart events resulting from views of your ads
Field type metric
Data type int.number.value
total_inapp_view_add_to_cart_value
Field label In-app view-through order value (add to cart)
Description Total value of in-app add to cart events resulting from views of your ads
Field type metric
Data type float.currency.value
total_web_add_to_cart
Field label Web conversions (add to cart)
Description Total number of web add to cart events resulting from interactions with your ads
Field type metric
Data type int.number.value
total_web_add_to_cart_value
Field label Web order value (add to cart)
Description Total value of web add to cart events resulting from interactions with your ads
Field type metric
Data type float.currency.value
total_web_click_add_to_cart
Field label Web click-through conversions (add to cart)
Description Total number of web add to cart events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_web_click_add_to_cart_value
Field label Web click-through order value (add to cart)
Description Total value of web add to cart events resulting from interactions with your ads
Field type metric
Data type float.currency.value
total_web_engagement_add_to_cart
Field label Web engagement conversions (add to cart)
Description Total number of web add to cart events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_web_engagement_add_to_cart_value
Field label Web engagement order value (add to cart)
Description Total value of web add to cart events resulting from engagement with your ads
Field type metric
Data type float.currency.value
total_web_view_add_to_cart
Field label Web view-through conversions (add to cart)
Description Total number of web add to cart events resulting from views of your ads
Field type metric
Data type int.number.value
total_web_view_add_to_cart_value
Field label Web view-through order value (add to cart)
Description Total value of web add to cart events resulting from views of your ads
Field type metric
Data type float.currency.value
total_offline_lead_value
Field label Offline order value (Lead)
Description Total value of offline lead events resulting from interactions with your ad
Field type metric
Data type float.currency.value
add_to_cart_cost_per_action
Field label CPA (Add to cart)
Description Average cost per add to cart event
Field type metric
Data type float.currency.value
add_to_cart_roas
Field label ROAS (Add to cart)
Description Average return on ad spend for add to cart events
Field type metric
Data type float.number.ratio
total_add_to_cart
Field label Conversions (Add to Cart)
Description Total number of add to cart events resulting from interactions with your ad
Field type metric
Data type int.number.value
total_add_to_cart_value
Field label Conversions Value (Add to cart)
Description Total value of add to cart events resulting from interactions with your ad
Field type metric
Data type float.currency.value

CONVERSIONS APP INSTALL

total_click_app_install
Field label Click-through conversions (app install)
Description Total number of app install events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_click_app_install_value
Field label Click-through value (app install)
Description Total value of app install events resulting from clicks on your ads
Field type metric
Data type float.currency.value
total_engagement_app_install
Field label Engagement conversions (app install)
Description Total number of app install events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_engagement_app_install_value
Field label Engagement value (app install)
Description Total value of app install events resulting from engagement with your ads
Field type metric
Data type float.currency.value
total_view_app_install
Field label View-through conversions (app install)
Description Total number of app install events resulting from views of your ads
Field type metric
Data type int.number.value
total_view_app_install_value
Field label View-through value (app install)
Description Total value of app install events resulting from views of your ads
Field type metric
Data type float.currency.value
total_app_install_desktop_action_to_desktop_conversion
Field label App install desktop action to desktop conversion
Description Total number of desktop app install actions leading to a desktop app install conversion
Field type metric
Data type int.number.value
total_app_install_desktop_action_to_mobile_conversion
Field label App install desktop action to mobile conversion
Description Total number of desktop app install actions leading to a mobile app install conversion
Field type metric
Data type int.number.value
total_app_install_desktop_action_to_tablet_conversion
Field label App install desktop action to tablet conversion
Description Total number of desktop app install actions leading to a tablet app install conversion
Field type metric
Data type int.number.value
total_app_install_mobile_action_to_desktop_conversion
Field label app install mobile action to desktop conversion
Description Total number of mobile app install actions leading to a desktop app install conversion
Field type metric
Data type int.number.value
total_app_install_mobile_action_to_mobile_conversion
Field label App install mobile action to mobile conversion
Description Total number of mobile app install actions leading to a mobile app install conversion
Field type metric
Data type int.number.value
total_app_install_mobile_action_to_tablet_conversion
Field label App install mobile action to tablet conversion
Description Total number of mobile app install actions leading to a tablet app install conversion
Field type metric
Data type int.number.value
total_app_install_tablet_action_to_desktop_conversion
Field label App install tablet action to desktop conversion
Description Total number of tablet app install actions leading to a desktop app install conversion
Field type metric
Data type int.number.value
total_app_install_tablet_action_to_mobile_conversion
Field label App install tablet action to mobile conversion
Description Total number of tablet app install actions leading to a mobile app install conversion
Field type metric
Data type int.number.value
total_app_install_tablet_action_to_tablet_conversion
Field label App install tablet action to tablet conversion
Description Total number of tablet app install actions leading to a tablet app install conversion
Field type metric
Data type int.number.value
inapp_app_install_cost_per_action
Field label In-app CPA (app install)
Description Average cost per in-app app install events
Field type metric
Data type float.currency.value
inapp_app_install_roas
Field label In-app ROAS (App install)
Description Average return on ad spend for in-app app install events
Field type metric
Data type float.number.ratio
total_inapp_app_install
Field label In-app conversions (app install)
Description Total number of in-app app install events resulting from interactions with your ads
Field type metric
Data type int.number.value
total_inapp_app_install_value
Field label In-app order value (App install)
Description Total value of in-app app install events resulting from interactions with your ad
Field type metric
Data type float.currency.value
total_inapp_click_app_install
Field label In-app click-through conversions (app install)
Description Total number of in-app app install events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_inapp_click_app_install_value
Field label In-app click-through order value (app install)
Description Total value of in-app app install events resulting from clicks on your ads
Field type metric
Data type float.currency.value
total_inapp_engagement_app_install
Field label In-app engagement conversions (app install)
Description Total number of in-app app install events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_inapp_engagement_app_install_value
Field label In-app engagement order value (app install)
Description Total value of in-app app install events resulting from engagement with your ads
Field type metric
Data type float.currency.value
total_inapp_view_app_install
Field label In-app view-through conversions (app install)
Description Total number of in-app app install events resulting from views of your ads
Field type metric
Data type int.number.value
total_inapp_view_app_install_value
Field label In-app view-through order value (app install)
Description Total value of in-app app install events resulting from views of your ads
Field type metric
Data type float.currency.value
total_app_install
Field label Conversions (app install)
Description Total number of app install events resulting from interactions with your ads
Field type metric
Data type int.number.value
total_app_install_value
Field label Order value (App install)
Description Total value of app install events resulting from interactions with your ad
Field type metric
Data type float.currency.value
app_install_cost_per_action
Field label CPA (app install)
Description Average cost per app install events
Field type metric
Data type float.currency.value

CONVERSIONS CHECKOUT

total_click_checkout
Field label Click-through conversions (checkout)
Description Checkouts that can be traced back to when somebody clicked a promoted Pin and continued to your site, leaving Pinterest
Field type metric
Data type int.number.value
total_view_checkout
Field label View-through conversions (checkout)
Description Checkouts that can be traced back to times when people repinned or clicked your promoted Pin to see it close-up, staying on Pinterest
Field type metric
Data type int.number.value
total_click_checkout_quantity
Field label Click-through order quantity (checkout)
Description Clicks checkout quantity
Field type metric
Data type int.number.value
total_click_checkout_value
Field label Click-through order value (checkout)
Description Clicks checkout value
Field type metric
Data type float.currency.value
total_engagement_checkout
Field label Engagement conversions (checkout)
Description Engagements checkout
Field type metric
Data type int.number.value
total_engagement_checkout_quantity
Field label Engagement order quantity (checkout)
Description Engagements checkout quantity
Field type metric
Data type int.number.value
total_engagement_checkout_value
Field label Engagement order value (checkout)
Description Engagements checkout value
Field type metric
Data type float.currency.value
total_view_checkout_quantity
Field label View-through order quantity (checkout)
Description Views checkout quantity
Field type metric
Data type int.number.value
total_view_checkout_value
Field label View-through order value (checkout)
Description Views checkout value
Field type metric
Data type float.currency.value
total_checkout_desktop_action_to_desktop_conversion
Field label Checkouts desktop action to desktop conversion
Description Checkouts desktop action to desktop conversion
Field type metric
Data type int.number.value
total_checkout_desktop_action_to_mobile_conversion
Field label Checkouts desktop action to mobile conversion
Description Checkouts desktop action to mobile conversion
Field type metric
Data type int.number.value
total_checkout_desktop_action_to_tablet_conversion
Field label Checkouts desktop action to tablet conversion
Description Checkouts desktop action to tablet conversion
Field type metric
Data type int.number.value
total_checkout_mobile_action_to_desktop_conversion
Field label Checkouts mobile action to desktop conversion
Description Checkouts mobile action to desktop conversion
Field type metric
Data type int.number.value
total_checkout_mobile_action_to_mobile_conversion
Field label Checkouts mobile action to mobile conversion
Description Checkouts mobile action to mobile conversion
Field type metric
Data type int.number.value
total_checkout_mobile_action_to_tablet_conversion
Field label Checkouts mobile action to tablet conversion
Description Checkouts mobile action to tablet conversion
Field type metric
Data type int.number.value
total_checkout_tablet_action_to_desktop_conversion
Field label Checkouts tablet action to desktop conversion
Description Checkouts tablet action to desktop conversion
Field type metric
Data type int.number.value
total_checkout_tablet_action_to_mobile_conversion
Field label Checkouts tablet action to mobile conversion
Description Checkouts tablet action to mobile conversion
Field type metric
Data type int.number.value
total_checkout_tablet_action_to_tablet_conversion
Field label Checkouts tablet action to tablet conversion
Description Checkouts tablet action to tablet conversion
Field type metric
Data type int.number.value
total_web_signup
Field label Web conversions (Signup)
Description Total number of web signup events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_web_signup_value
Field label Web order value (Signup)
Description Total value of web signup events resulting from interactions with your ad
Field type metric
Data type float.currency.value
total_web_page_visit
Field label Web conversions (Page visit)
Description Total number of web page visit events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_web_page_visit_value
Field label Web order value (Page visit)
Description Total value of web page visit events resulting from interactions with your ad
Field type metric
Data type float.currency.value
web_page_visit_roas
Field label Web ROAS (Page visit)
Description Average return on ad spend for web page visit events
Field type metric
Data type float.number.ratio
web_page_visit_cost_per_action
Field label Web CPA (Page visit)
Description Average cost per web page visit event
Field type metric
Data type float.currency.value
total_web_custom
Field label Web conversions (Custom)
Description Total number of web custom events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_web_custom_value
Field label Web order value (Custom)
Description Total value of web custom events resulting from interactions with your ad
Field type metric
Data type float.currency.value
total_web_checkout
Field label Web conversions (Checkout)
Description Total number of web checkout events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_web_checkout_value
Field label Web order value (Checkout)
Description Total value of web checkout events resulting from interactions with your ad
Field type metric
Data type float.currency.value
web_checkout_cost_per_action
Field label Web CPA (Checkout)
Description Average cost per web checkout event
Field type metric
Data type float.currency.value
total_web_click_checkout
Field label Web click-through conversions (Checkout)
Description Total number of web checkout events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_web_click_checkout_value
Field label Web click-through order value (Checkout)
Description Total value of web checkout events resulting from clicks on your ad
Field type metric
Data type float.currency.value
total_web_engagement_checkout
Field label Web engagement conversions (Checkout)
Description Total number of web checkout events resulting from engagements with your ad (save, closeup or carousel swipe)
Field type metric
Data type int.number.value
total_web_engagement_checkout_value
Field label Web engagement order value (Checkout)
Description Total value of web checkout events resulting from engagements with your ad (save, closeup or carousel swipe)
Field type metric
Data type float.currency.value
total_web_view_checkout
Field label Web view-through conversions (Checkout)
Description Total number of web checkout events resulting from views of your ad
Field type metric
Data type int.number.value
total_web_view_checkout_value
Field label Web view-through order value (Checkout)
Description Total value of web checkout events resulting from views of your ad
Field type metric
Data type float.currency.value
web_checkout_roas
Field label Web ROAS (Checkout)
Description Average return on ad spend for web checkout events
Field type metric
Data type float.number.ratio
inapp_checkout_cost_per_action
Field label In-app CPA (Checkout)
Description Average cost per in-app checkout event
Field type metric
Data type float.currency.value
inapp_checkout_roas
Field label In-app ROAS (Checkout)
Description Average return on ad spend for in-app checkout events
Field type metric
Data type float.number.ratio
total_inapp_checkout
Field label In-app conversions (Checkout)
Description Total number of in-app checkout events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_inapp_checkout_value
Field label In-app order value (Checkout)
Description Total value of in-app checkout events resulting from interactions with your ad
Field type metric
Data type float.currency.value
total_inapp_click_checkout
Field label In-app click-through conversions (Checkout)
Description Total number of in-app checkout events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_inapp_click_checkout_value
Field label In-app click-through order value (Checkout)
Description Total value of in-app checkout events resulting from clicks on your ad
Field type metric
Data type float.currency.value
total_inapp_engagement_checkout
Field label In-app engagement conversions (Checkout)
Description Total number of in-app checkout events resulting from engagements with your ad (save, closeup or carousel swipe)
Field type metric
Data type int.number.value
total_inapp_engagement_checkout_value
Field label In-app engagement order value (Checkout)
Description Total value of in-app checkout events resulting from engagements with your ad (save, closeup or carousel swipe)
Field type metric
Data type float.currency.value
total_inapp_view_checkout
Field label In-app view-through conversions (Checkout)
Description Total number of in-app checkout events resulting from views of your ad
Field type metric
Data type int.number.value
total_inapp_view_checkout_value
Field label In-app view-through order value (Checkout)
Description Total value of in-app checkout events resulting from views of your ad
Field type metric
Data type float.currency.value
total_inapp_signup
Field label In-app conversions (Signup)
Description Total number of in-app signup events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_inapp_signup_value
Field label In-app order value (Signup)
Description Total value of in-app signup events resulting from interactions with your ad
Field type metric
Data type float.currency.value
total_offline_checkout
Field label Offline conversions (Checkout)
Description Total number of offline checkout events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_offline_checkout_value
Field label Offline order value (Checkout)
Description Total value of offline checkout events resulting from interactions with your ad
Field type metric
Data type float.currency.value
offline_checkout_cost_per_action
Field label Offline CPA (Checkout)
Description Average cost per offline checkout event
Field type metric
Data type float.currency.value
total_offline_custom
Field label Offline conversions (Custom)
Description Total number of offline custom events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_offline_custom_value
Field label Offline order value (Custom)
Description Total value of offline custom events resulting from interactions with your ad
Field type metric
Data type float.currency.value
offline_checkout_roas
Field label Offline ROAS (Checkout)
Description Average return on ad spend for offline checkout events
Field type metric
Data type float.number.ratio
total_offline_lead
Field label Offline conversions (Lead)
Description Total number of offline lead events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_offline_signup
Field label Offline conversions (Signup)
Description Total number of offline signup events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_offline_signup_value
Field label Offline order value (Signup)
Description Total value of offline signup events resulting from interactions with your ad
Field type metric
Data type float.currency.value
total_checkout
Field label Conversions (Checkout)
Description Total number of checkout events that resulted from interactions with your ad
Field type metric
Data type int.number.value
total_checkout_value
Field label Conversions Value (Checkout)
Description Total value of checkout events resulting from interactions with your ad
Field type metric
Data type float.currency.value
checkout_roas
Field label ROAS (Checkout)
Description Average return on ad spend for checkout events
Field type metric
Data type float.number.ratio
checkout_cost_per_action
Field label CPA (Checkout)
Description Average cost per checkout event
Field type metric
Data type float.currency.value
total_custom
Field label Conversions (Custom)
Description Total number of custom events resulting from interactions with your ad
Field type metric
Data type int.number.value
total_custom_value
Field label Conversion value (Custom)
Description Total value of custom events resulting from interactions with your ad
Field type metric
Data type float.currency.value
custom_cost_per_action
Field label CPA (Custom)
Description Average cost per custom event
Field type metric
Data type float.currency.value
custom_roas
Field label ROAS (Custom)
Description Average return on spend for custom events
Field type metric
Data type float.number.ratio
total_lead_value
Field label Conversion value (Lead)
Description Total value of lead events resulting from interactions with your ad
Field type metric
Data type float.currency.value
lead_cost_per_action
Field label CPA (Lead)
Description Average cost per lead event
Field type metric
Data type float.currency.value
lead_roas
Field label ROAS (Lead)
Description Average return on ad spend for lead events
Field type metric
Data type float.number.ratio
total_offline_click_checkout
Field label Offline click-through conversions (Checkout)
Description Total number of offline checkout events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_offline_click_checkout_value
Field label Offline click-through order value (Checkout)
Description Total value of offline checkout events resulting from clicks on your ad
Field type metric
Data type float.currency.value
total_offline_engagement_checkout
Field label Offline engagement conversions (Checkout)
Description Total number of offline checkout events resulting from engagements with your ad (save, closeup or carousel swipe)
Field type metric
Data type int.number.value
total_offline_engagement_checkout_value
Field label Offline engagement order value (Checkout)
Description Total value of offline checkout events resulting from engagements with your ad (save, closeup or carousel swipe)
Field type metric
Data type float.currency.value
total_offline_view_checkout
Field label Offline view-through conversions (Checkout)
Description Total number of offline checkout events resulting from views of your ad
Field type metric
Data type int.number.value
total_offline_view_checkout_value
Field label Offline view-through order value (Checkout)
Description Total value of offline checkout events resulting from views of your ad
Field type metric
Data type float.currency.value
total_signup_value
Field label Conversion value (Signup)
Description Total value of signup events resulting from interactions with your ad
Field type metric
Data type float.currency.value
signup_cost_per_action
Field label CPA (Signup)
Description SIGNUP_COST_PER_ACTION
Field type metric
Data type float.currency.value
signup_roas
Field label ROAS (Signup)
Description Average return on ad spend for signup events
Field type metric
Data type float.number.ratio

CONVERSIONS CUSTOM

total_click_custom
Field label Click-through conversions (custom)
Description Custom conversions that can be traced back to when somebody clicked a promoted Pin and continued to your site, leaving Pinterest
Field type metric
Data type int.number.value
total_engagement_custom
Field label Engagement conversions (custom)
Description Custom conversions that can be traced back to times when people repinned or clicked your promoted Pin to see it close-up, staying on Pinterest
Field type metric
Data type int.number.value
total_view_custom
Field label View-through conversions (custom)
Description Custom conversions that can be traced back to when somebody saw your promoted Pin
Field type metric
Data type int.number.value
total_click_custom_quantity
Field label Conversion quantity from custom - clicks
Description Clicks custom quantity
Field type metric
Data type int.number.value
total_view_custom_quantity
Field label Conversion quantity from custom - views
Description Views custom quantity
Field type metric
Data type int.number.value
total_custom_desktop_action_to_desktop_conversion
Field label Custom desktop actions to desktop conversion
Description Custom desktop actions to desktop conversion
Field type metric
Data type int.number.value
total_custom_desktop_action_to_mobile_conversion
Field label Custom desktop actions to mobile conversion
Description Custom desktop actions to mobile conversion
Field type metric
Data type int.number.value
total_custom_desktop_action_to_tablet_conversion
Field label Custom desktop actions to tablet conversion
Description Custom desktop actions to tablet conversion
Field type metric
Data type int.number.value
total_custom_mobile_action_to_desktop_conversion
Field label Custom mobile actions to desktop conversion
Description Custom mobile actions to desktop conversion
Field type metric
Data type int.number.value
total_custom_mobile_action_to_mobile_conversion
Field label Custom mobile actions to mobile conversion
Description Custom mobile actions to mobile conversion
Field type metric
Data type int.number.value
total_custom_mobile_action_to_tablet_conversion
Field label Custom mobile actions to tablet conversion
Description Custom mobile actions to tablet conversion
Field type metric
Data type int.number.value
total_custom_tablet_action_to_desktop_conversion
Field label Custom tablet actions to desktop conversion
Description Custom tablet actions to desktop conversion
Field type metric
Data type int.number.value
total_custom_tablet_action_to_mobile_conversion
Field label Custom tablet actions to mobile conversion
Description Custom tablet actions to mobile conversion
Field type metric
Data type int.number.value
total_custom_tablet_action_to_tablet_conversion
Field label Custom tablet actions to tablet conversion
Description Custom tablet actions to tablet conversion
Field type metric
Data type int.number.value
total_click_custom_value
Field label Click-through value (custom)
Description Clicks custom value
Field type metric
Data type float.currency.value
total_engagement_custom_quantity
Field label Conversion quantity from custom - engagements
Description Engagements custom quantity
Field type metric
Data type int.number.value
total_engagement_custom_value
Field label Engagement value (custom)
Description Engagements custom value
Field type metric
Data type float.currency.value
total_view_custom_value
Field label View-through value (custom)
Description Views custom value
Field type metric
Data type float.currency.value

CONVERSIONS LEAD

total_web_lead
Field label Web conversions (Lead)
Description Total number of web lead events resulting from clicks on your ad
Field type metric
Data type int.number.value
total_web_lead_value
Field label Web order value (Lead)
Description Total value of web lead events resulting from interactions with your ad
Field type metric
Data type float.currency.value
total_click_lead
Field label Click-through conversions (lead)
Description Total number of lead events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_click_lead_quantity
Field label Conversion quantity from lead - clicks
Description Total quantity of lead events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_click_lead_value
Field label Click-through value (lead)
Description Total value of lead events resulting from clicks on your ads
Field type metric
Data type float.currency.value
total_engagement_lead
Field label Engagement conversions (lead)
Description Total number of lead events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_lead
Field label Conversions (lead)
Description Total leads from clicks, engagements and views
Field type metric
Data type int.number.value
total_engagement_lead_quantity
Field label Conversion quantity from lead - engagements
Description Total quantity of lead events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_engagement_lead_value
Field label Engagement value (lead)
Description Total value of lead events resulting from engagement with your ads
Field type metric
Data type float.currency.value
total_view_lead
Field label View-through conversions (lead)
Description Total number of lead events resulting from views of your ads
Field type metric
Data type int.number.value
total_view_lead_quantity
Field label Conversion quantity from lead - views
Description Total quantity of lead events resulting from views of your ads
Field type metric
Data type int.number.value
total_view_lead_value
Field label View-through value (lead)
Description Total value of lead events resulting from views of your ads
Field type metric
Data type float.currency.value
total_lead_desktop_action_to_desktop_conversion
Field label Leads desktop action to desktop conversion
Description Total number of desktop lead actions leading to a desktop lead conversion
Field type metric
Data type int.number.value
total_lead_desktop_action_to_mobile_conversion
Field label Leads desktop action to mobile conversion
Description Total number of desktop lead actions leading to a mobile lead conversion
Field type metric
Data type int.number.value
total_lead_desktop_action_to_tablet_conversion
Field label Leads desktop action to tablet conversion
Description Total number of desktop lead actions leading to a tablet lead conversion
Field type metric
Data type int.number.value
total_lead_mobile_action_to_desktop_conversion
Field label Leads mobile action to desktop conversion
Description Total number of mobile lead actions leading to a desktop lead conversion
Field type metric
Data type int.number.value
total_lead_mobile_action_to_mobile_conversion
Field label Leads mobile action to mobile conversion
Description Total number of mobile lead actions leading to a mobile lead conversion
Field type metric
Data type int.number.value
total_lead_mobile_action_to_tablet_conversion
Field label Leads mobile action to tablet conversion
Description Total number of mobile lead actions leading to a tablet lead conversion
Field type metric
Data type int.number.value
total_lead_tablet_action_to_desktop_conversion
Field label Leads tablet action to desktop conversion
Description Total number of tablet lead actions leading to a desktop lead conversion
Field type metric
Data type int.number.value
total_lead_tablet_action_to_mobile_conversion
Field label Leads tablet action to mobile conversion
Description Total number of tablet lead actions leading to a mobile lead conversion
Field type metric
Data type int.number.value
total_lead_tablet_action_to_tablet_conversion
Field label Leads tablet action to tablet conversion
Description Total number of tablet lead actions leading to a tablet lead conversion
Field type metric
Data type int.number.value

CONVERSIONS PAGE VISIT

total_click_page_visit
Field label Click-through conversions (page visit)
Description Page visits that can be traced back to when somebody clicked a promoted Pin and continued to your site, leaving Pinterest
Field type metric
Data type int.number.value
total_engagement_page_visit
Field label Engagement conversions (page visit)
Description Page visits that can be traced back to times when people repinned or clicked your promoted Pin to see it close-up, staying on Pinterest
Field type metric
Data type int.number.value
total_view_page_visit
Field label View-through conversions (page visit)
Description Page visits that can be traced back to when somebody saw your promoted Pin
Field type metric
Data type int.number.value
total_click_page_visit_quantity
Field label Conversion quantity from page visit - clicks
Description Clicks page visit quantity
Field type metric
Data type int.number.value
total_click_page_visit_value
Field label Click-through value (page visit)
Description Clicks page visit value
Field type metric
Data type float.currency.value
total_engagement_page_visit_quantity
Field label Conversion quantity from page visits
Description Engagements page visit quantity
Field type metric
Data type int.number.value
total_engagement_page_visit_value
Field label Engagement value (page visit)
Description Engagements page visit value
Field type metric
Data type float.currency.value
total_view_page_visit_quantity
Field label Conversion quantity from page visit - views
Description Views page visit quantity
Field type metric
Data type int.number.value
total_view_page_visit_value
Field label View-through value (page visit)
Description Views page visit value
Field type metric
Data type float.currency.value
total_page_visit_desktop_action_to_desktop_conversion
Field label Page visits desktop action to desktop conversion
Description Page visits desktop action to desktop conversion
Field type metric
Data type int.number.value
total_page_visit_desktop_action_to_mobile_conversion
Field label Page visits desktop action to mobile conversion
Description Page visits desktop action to mobile conversion
Field type metric
Data type int.number.value
total_page_visit_desktop_action_to_tablet_conversion
Field label Page visits desktop action to tablet conversion
Description Page visits desktop action to tablet conversion
Field type metric
Data type int.number.value
total_page_visit_mobile_action_to_desktop_conversion
Field label Page visits mobile action to desktop conversion
Description Page visits mobile action to desktop conversion
Field type metric
Data type int.number.value
total_page_visit_mobile_action_to_mobile_conversion
Field label Page visits mobile action to mobile conversion
Description Page visits mobile action to mobile conversion
Field type metric
Data type int.number.value
total_page_visit_mobile_action_to_tablet_conversion
Field label Page visits mobile action to tablet conversion
Description Page visits mobile action to tablet conversion
Field type metric
Data type int.number.value
total_page_visit_tablet_action_to_desktop_conversion
Field label Page visits tablet action to desktop conversion
Description Page visits tablet action to desktop conversion
Field type metric
Data type int.number.value
total_page_visit_tablet_action_to_mobile_conversion
Field label Page visits tablet action to mobile conversion
Description Page visits tablet action to mobile conversion
Field type metric
Data type int.number.value
total_page_visit_tablet_action_to_tablet_conversion
Field label Page visits tablet action to tablet conversion
Description Page visits tablet action to tablet conversion
Field type metric
Data type int.number.value

CONVERSIONS SIGNUP

total_click_signup
Field label Click-through conversions (signup)
Description Sign ups that can be traced back to when somebody clicked a promoted Pin and continued to your site, leaving Pinterest
Field type metric
Data type int.number.value
total_engagement_signup
Field label Engagement conversions (signup)
Description Sign ups that can be traced back to times when people repinned or clicked your promoted Pin to see it close-up, staying on Pinterest
Field type metric
Data type int.number.value
total_engagement_signup_quantity
Field label Conversion quantity from signup - engagements
Description Engagements sign-up quantity
Field type metric
Data type int.number.value
total_engagement_signup_value
Field label Engagement value (signup)
Description Engagements sign-up value
Field type metric
Data type float.currency.value
total_view_signup_quantity
Field label Conversion quantity from signup - views
Description Views sign-up quantity
Field type metric
Data type int.number.value
total_view_signup_value
Field label View-through value (signup)
Description Views sign-up value
Field type metric
Data type float.currency.value
total_signup_desktop_action_to_desktop_conversion
Field label Sign-ups desktop action to desktop conversion
Description Sign-ups desktop action to desktop conversion
Field type metric
Data type int.number.value
total_signup_desktop_action_to_mobile_conversion
Field label Sign-ups desktop action to mobile conversion
Description Sign-ups desktop action to mobile conversion
Field type metric
Data type int.number.value
total_signup_desktop_action_to_tablet_conversion
Field label Sign-ups desktop action to tablet conversion
Description Sign-ups desktop action to tablet conversion
Field type metric
Data type int.number.value
total_signup_mobile_action_to_desktop_conversion
Field label Sign-ups mobile action to desktop conversion
Description Sign-ups mobile action to desktop conversion
Field type metric
Data type int.number.value
total_signup_mobile_action_to_mobile_conversion
Field label Sign-ups mobile action to mobile conversion
Description Sign-ups mobile action to mobile conversion
Field type metric
Data type int.number.value
total_signup_mobile_action_to_tablet_conversion
Field label Sign-ups mobile action to tablet conversion
Description Sign-ups mobile action to tablet conversion
Field type metric
Data type int.number.value
total_signup_tablet_action_to_desktop_conversion
Field label Sign-ups tablet action to desktop conversion
Description Sign-ups tablet action to desktop conversion
Field type metric
Data type int.number.value
total_signup_tablet_action_to_mobile_conversion
Field label Sign-ups tablet action to mobile conversion
Description Sign-ups tablet action to mobile conversion
Field type metric
Data type int.number.value
total_signup_tablet_action_to_tablet_conversion
Field label Sign-ups tablet action to tablet conversion
Description Sign-ups tablet action to tablet conversion
Field type metric
Data type int.number.value
total_signup
Field label Conversions (signup)
Description Total sign-ups from clicks, engagements and views
Field type metric
Data type int.number.value
total_view_signup
Field label View-through conversions (signup)
Description Sign ups that can be traced back to when somebody saw your promoted Pin
Field type metric
Data type int.number.value
total_click_signup_quantity
Field label Conversion quantity from signup - clicks
Description Clicks sign-up quantity
Field type metric
Data type int.number.value
total_click_signup_value
Field label Click-through value (signup)
Description Clicks sign-up value
Field type metric
Data type float.currency.value

CONVERSIONS WATCH VIDEO

total_click_watch_video
Field label Click-through conversions (watch video)
Description Total number of watch video events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_click_watch_video_quantity
Field label Conversion quantity from watch video - clicks
Description Total quantity of watch video events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_click_watch_video_value
Field label Click-through value (watch video)
Description Total value of watch video events resulting from clicks on your ads
Field type metric
Data type float.currency.value
total_engagement_watch_video
Field label Engagement conversions (watch video)
Description Total number of watch video events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_engagement_watch_video_quantity
Field label Conversion quantity from watch video - engagements
Description Total quantity of watch video events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_engagement_watch_video_value
Field label Engagement value (watch video)
Description Total value of watch video events resulting from engagement with your ads
Field type metric
Data type float.currency.value
total_view_watch_video
Field label View-through conversions (watch video)
Description Total number of watch video events resulting from views of your ads
Field type metric
Data type int.number.value
total_view_watch_video_quantity
Field label Conversion quantity from watch video - views
Description Total quantity of watch video events resulting from views of your ads
Field type metric
Data type int.number.value
total_view_watch_video_value
Field label View-through value (watch video)
Description Total value of watch video events resulting from views of your ads
Field type metric
Data type float.currency.value
total_watch_video_desktop_action_to_desktop_conversion
Field label Watch video desktop action to desktop conversion
Description Total number of desktop watch video actions leading to a desktop watch video conversion
Field type metric
Data type int.number.value
total_watch_video_desktop_action_to_mobile_conversion
Field label Watch video desktop action to mobile conversion
Description Total number of desktop watch video actions leading to a MOBILE watch video conversion
Field type metric
Data type int.number.value
total_watch_video_desktop_action_to_tablet_conversion
Field label Watch video desktop action to tablet conversion
Description Total number of desktop watch video actions leading to a tablet watch video conversion
Field type metric
Data type int.number.value
total_watch_video_mobile_action_to_desktop_conversion
Field label Watch video mobile action to desktop conversion
Description Total number of mobile watch video actions leading to a desktop watch video conversion
Field type metric
Data type int.number.value
total_watch_video_mobile_action_to_mobile_conversion
Field label Watch video mobile action to mobile conversion
Description Total number of mobile watch video actions leading to a mobile watch video conversion
Field type metric
Data type int.number.value
total_watch_video_mobile_action_to_tablet_conversion
Field label Watch video mobile action to tablet conversion
Description Total number of mobile watch video actions leading to a tablet watch video conversion
Field type metric
Data type int.number.value
total_watch_video_tablet_action_to_desktop_conversion
Field label Watch video tablet action to desktop conversion
Description Total number of tablet watch video actions leading to a desktop watch video conversion
Field type metric
Data type int.number.value
total_watch_video_tablet_action_to_mobile_conversion
Field label Watch video tablet action to mobile conversion
Description Total number of tablet watch video actions leading to a mobile watch video conversion
Field type metric
Data type int.number.value
total_watch_video_tablet_action_to_tablet_conversion
Field label Watch video tablet action to tablet conversion
Description Total number of tablet watch video actions leading to a tablet watch video conversion
Field type metric
Data type int.number.value
total_web_watch_video
Field label Web conversions (watch video)
Description Total number of web watch video events resulting from interactions with your ads
Field type metric
Data type int.number.value
total_web_watch_video_value
Field label Web order value (watch video)
Description Total value of web watch video events resulting from interactions with your ads
Field type metric
Data type float.currency.value
total_web_click_watch_video
Field label Web click-through conversions (watch video)
Description Total number of web watch video events resulting from clicks on your ads
Field type metric
Data type int.number.value
total_web_click_watch_video_value
Field label Web click-through order value (watch video)
Description Total value of web watch video events resulting from clicks on your ads
Field type metric
Data type float.currency.value
total_web_engagement_watch_video
Field label Web engagement conversions (watch video)
Description Total number of web watch video events resulting from engagement with your ads
Field type metric
Data type int.number.value
total_web_engagement_watch_video_value
Field label Web engagement order value (watch video)
Description Total value of web watch video events resulting from engagement with your ads
Field type metric
Data type float.currency.value
total_web_view_watch_video
Field label Web view-through conversions (watch video)
Description Total number of web watch video events resulting from views of your ads
Field type metric
Data type int.number.value
total_web_view_watch_video_value
Field label Web view-through order value (watch video)
Description Total value of web watch video events resulting from views of your ads
Field type metric
Data type float.currency.value
web_watch_video_cost_per_action
Field label Web CPA (watch video)
Description Average cost per web watch video events
Field type metric
Data type float.currency.value
web_watch_video_roas
Field label Web ROAS (watch video)
Description Average return on spend for web watch video events
Field type metric
Data type float.number.ratio

CORE METRICS

impressions_paid
Field label Impressions paid
Description The number of impressions from your promoted Pins. This includes both paid impressions and over-delivered impressions
Field type metric
Data type int.number.value
impressions_earned
Field label Impressions earned
Description The number of impressions from Repins of your promoted Pins
Field type metric
Data type int.number.value
frequency
Field label Frequency
Description The average number of times each user saw your ad
Field type metric
Data type float.number.value
reach
Field label Reach
Description Total number of unique users who saw your ads
Field type metric
Data type int.number.value
Aggregation Non-aggregatable metric
total_impressions
Field label Impressions
Description The number of impressions from earned and paid sources
Field type metric
Data type int.number.value
clickthrough_paid
Field label Clicks paid
Description The number of clicks from your promoted Pins. This includes both paid clicks and over-delivered clicks
Field type metric
Data type int.number.value
clickthrough_earned
Field label Clicks earned
Description The number of clicks from Repins of your promoted Pins
Field type metric
Data type int.number.value
total_clickthrough
Field label Clicks
Description The number of clicks from earned and paid sources
Field type metric
Data type int.number.value
ctr_rate
Field label CTR
Description Click-through rate
Field type metric
Data type float.number.ratio
ctr_rate_paid
Field label CTR paid
Description The click-through rate of paid sources
Field type metric
Data type float.number.ratio
ctr_rate_earned
Field label CTR earned
Description The click-through rate of earned sources
Field type metric
Data type float.number.ratio
outbound_clicks_paid
Field label Outbound clicks paid
Description The number of paid outbound clicks from your promoted Pins
Field type metric
Data type int.number.value
outbound_clicks_earned
Field label Outbound clicks earned
Description The number of earned outbound clicks from your promoted Pins
Field type metric
Data type int.number.value
outbound_clicks
Field label Outbound clicks
Description The total number of outbound clicks from your promoted Pins
Field type metric
Data type int.number.value
outbound_ctr_paid
Field label Outbound CTR paid
Description Paid outbound click-through rate. The ratio of paid outbound clicks to impressions of your promoted Pins
Field type metric
Data type float.number.ratio
outbound_ctr_earned
Field label Outbound CTR earned
Description Earned outbound click-through rate. The ratio of earned outbound clicks to impressions of your promoted Pins
Field type metric
Data type float.number.ratio
outbound_ctr
Field label Outbound CTR
Description Outbound click-through rate. The ratio of outbound clicks to impressions of your promoted Pins
Field type metric
Data type float.number.ratio
total_conversions
Field label Conversions
Description This is the sum of all website conversions. For example, if you track sign ups and checkouts on your website, it's the sum of all sign ups and checkouts attributed from clicks, engagements and views on Pinterest
Field type metric
Data type int.number.value
total_conversions_quantity
Field label Conversions quantity
Description Conversions quantity
Field type metric
Data type int.number.value
total_conversions_value
Field label Conversions value
Description Conversions value
Field type metric
Data type float.currency.value
saves_paid
Field label Saves paid
Description The number of paid Repins of your promoted Pins
Field type metric
Data type int.number.value
saves_earned
Field label Saves earned
Description The number of unpaid Repins of your promoted Pins
Field type metric
Data type int.number.value
total_saves
Field label Saves
Description The number of Repins from earned and paid sources
Field type metric
Data type int.number.value
save_rate
Field label Save rate
Description The rate of Repins
Field type metric
Data type float.number.percentage
save_rate_paid
Field label Save rate paid
Description The rate of paid Repins
Field type metric
Data type float.number.percentage
save_rate_earned
Field label Save rate earned
Description The rate of earned Repins
Field type metric
Data type float.number.percentage
carousel_swipes_paid
Field label Carousel swipes paid
Description The number of paid swipes from your promoted carousel Pins
Field type metric
Data type int.number.value
carousel_swipes_earned
Field label Carousel swipes earned
Description The number of non-paid swipes from your promoted carousel Pins
Field type metric
Data type int.number.value
carousel_swipes_total
Field label Carousel swipes
Description The number of swipes from your promoted carousel Pins. This includes both paid and non-paid activity
Field type metric
Data type int.number.value
engagements_paid
Field label Engagements paid
Description Total engagements from paid sources
Field type metric
Data type int.number.value
engagements_earned
Field label Engagements earned
Description Total engagements from earned sources
Field type metric
Data type int.number.value
total_engagements
Field label Engagements
Description Total engagements from earned and paid sources
Field type metric
Data type int.number.value
cpm
Field label CPM
Description Cost per mille
Field type metric
Data type float.currency.value
cpe
Field label CPE
Description Cost per engagement
Field type metric
Data type float.currency.value
cpe_paid
Field label CPE paid
Description Cost per paid engagement
Field type metric
Data type float.currency.value
cpe_earned
Field label CPE earned
Description Cost per earned engagement
Field type metric
Data type float.currency.value
cpc
Field label CPC
Description Cost per click
Field type metric
Data type float.currency.value
cpc_paid
Field label CPC paid
Description Cost per paid click
Field type metric
Data type float.currency.value
cpc_earned
Field label CPC earned
Description Cost per earned click
Field type metric
Data type float.currency.value
cost
Field label Cost
Description The money you spent for promoted Pins, in the currency of the advertiser
Field type metric
Data type float.currency.value
cost_eur
Field label Cost (EUR)
Description The money you spent for promoted Pins, converted to Euros
Field type metric
Data type float.currency.value
Services Currency conversion
cost_usd
Field label Cost (USD)
Description The money you spent for promoted Pins, converted to US dollars
Field type metric
Data type float.currency.value
Services Currency conversion
cost_gbp
Field label Cost (GBP)
Description The money you spent for promoted Pins, converted to British pounds
Field type metric
Data type float.currency.value
Services Currency conversion
conversion_rate
Field label Conversion rate
Description Total conversions divided by total clicks
Field type metric
Data type float.number.ratio
cost_per_conversion
Field label Cost per conversion
Description Cost divided by total conversions
Field type metric
Data type float.currency.value

DATASOURCE

dataSourceName
Field label Data source
Description The name of the source for this data, as listed on supermetrics.com/docs
Field type dimension
Data type string.text.value
Destinations API, Data warehouse
system_metadata.data_source_logins
Field label Data source logins
Description The data source login accounts that were used to authenticate against the data source
Field type dimension
Data type string.text.json
system_metadata.data_source_login_owners
Field label Data source login owners
Description The Supermetrics users that created the data source login connections
Field type dimension
Data type string.text.json

DEPRECATED

campaign_billing_group
Field label Billing group
Description The billing group of the campaign.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-01
advertiser_click_window_days
Field label Click window days
Description The tracking window for clicks in days.
Field type dimension
Data type int.number.value
🚫 Deprecated Deprecated on 2022-01-17
campaign_is_one_tap
Field label Campaign is one-tap
Description Whether the campaign is one-tap of not.
Field type dimension
Data type bool
🚫 Deprecated Deprecated on 2019-10-03
campaign_product_filter
Field label Product filter
Description The product filter of the campagin.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-01
ad_group_bid_type
Field label Ad group bid type
Description The bid type of the ad group.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2019-10-03
campaign_measurement_partner_campaign_id
Field label Measurement partner campaign id
Description The unique identifier of the measurement partner's campaign.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-01
advertiser_is_agency
Field label Is agency
Description Whether of not the advertiser is an agency.
Field type dimension
Data type bool
🚫 Deprecated Deprecated on 2023-05-24
ad_group_entity_version
Field label Ad group entity version
Description The entity version of the ad group.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-25
advertiser_created_time
Field label Advertiser created date
Description The date the advertiser was created.
Field type dimension
Data type string.time.date
🚫 Deprecated Deprecated on 2023-05-24
advertiser_updated_time
Field label Advertiser updated date
Description The date the advertiser was last updated.
Field type dimension
Data type string.time.date
🚫 Deprecated Deprecated on 2023-05-24
advertiser_vat_number
Field label VAT number
Description The VAT number of the advertiser.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2023-05-24
advertiser_vat_exempt_number
Field label VAT exempt number
Description The VAT exempt number of the advertiser.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2023-05-24
advertiser_represented_advertiser_country
Field label Represented country
Description The country the advertiser represents.
Field type dimension
Data type string.geo.country.twolettercode
🚫 Deprecated Deprecated on 2023-05-24
advertiser_business_address
Field label Business address
Description The business address of the advertiser.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2023-05-24
advertiser_is_agency_paying
Field label Is paying agency
Description Whether of not the advertiser is a paying agency.
Field type dimension
Data type bool
🚫 Deprecated Deprecated on 2023-05-24
ad_group_targeting_spec_term
Field label Ad group targeting term (deprecated)
Description List of terms the ad group is targeting.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2020-12-08
advertiser_is_one_tap
Field label Advertiser is one-tap
Description Whether of not the advertiser is a one-tap.
Field type dimension
Data type bool
🚫 Deprecated Deprecated on 2023-05-24
ad_group_conversion_learning_mode_type
Field label Conversion learning mode type
Description The type of conversion learning mode of the ad group.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-25
advertiser_merchant_id
Field label Merchant ID
Description The merchant ID of the advertiser.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2023-05-24
campaign_upgrade_status
Field label Campaign upgrade status
Description The upgrade status of the campaign.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2019-10-03
advertiser_test_account
Field label Is a test account
Description Whether or not the advertiser is a test account.
Field type dimension
Data type bool
🚫 Deprecated Deprecated on 2023-05-24
campaign_entity_version
Field label Campaign entity version
Description The entity version of the campaign.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2021-02-01
advertiser_type
Field label Advertiser type
Description The type of the advertiser.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2023-05-24
campaign_type
Field label Campaign type
Description The type of the campaign.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2019-10-03
ad_group_upgrade_status
Field label Ad group upgrade status
Description The upgrade status of the ad group.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2019-10-03
campaign_placement_exclusion
Field label Placement exclusion
Description The placement exclusion of the campaign.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2019-10-03
ad_group_targeting_type
Field label Ad group targeting type (deprecated)
Description The targeting type of the ad group.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2020-12-08
campaign_creative_type
Field label Creative type
Description The creative type of the campaign.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2019-10-03
ad_group_targeting_value
Field label Ad group targeting value (deprecated)
Description The targeting value of the ad group.
Field type dimension
Data type string.text.value
🚫 Deprecated Deprecated on 2020-12-08
advertiser_view_window_days
Field label View window days
Description The tracking window for views in days.
Field type dimension
Data type int.number.value
🚫 Deprecated Deprecated on 2022-01-17
advertiser_engagement_window_days
Field label Engagement window days
Description The tracking window for engagements in days.
Field type dimension
Data type int.number.value
🚫 Deprecated Deprecated on 2022-01-17
onsite_checkouts
Field label Total onsite checkouts
Description On-site checkouts.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2022-02-15
onsite_checkouts_cpa_billable
Field label Total onsite checkouts CPA
Description On-site checkouts cpa billable.
Field type metric
Data type float.currency.value
🚫 Deprecated Deprecated on 2022-02-15
closeups_rate_paid
Field label Close-up rate paid
Description The rate of paid close ups.
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2021-01-21
closeups_rate_earned
Field label Close-up rate earned
Description The rate of earned close ups.
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2021-01-21
closeups_rate
Field label Close-up rate
Description The rate of close ups.
Field type metric
Data type float.number.ratio
🚫 Deprecated Deprecated on 2021-01-21
total_closeups
Field label Close-ups
Description The number of close-ups from earned and paid sources.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2021-01-21
closeups_earned
Field label Close-ups earned
Description The number of close-ups from Repins of your promoted Pins.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2021-01-21
closeups_paid
Field label Close-ups paid
Description The number of close-ups from your promoted Pins.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2021-01-21
onsite_checkouts_value
Field label Total onsite checkouts value
Description On-site checkouts value.
Field type metric
Data type int.number.value
🚫 Deprecated Deprecated on 2022-02-15

PIN PROMOTIONS

pin_promotion_id
Field label Ad ID
Description The unique ID of the ad/pin promotion
Field type dimension
Data type string.text.value
pin_promotion_pin_id
Field label Pin ID
Description ID of the pin used in the promoted pin / ad
Field type dimension
Data type string.text.value
pin_promotion_name
Field label Promoted pin name
Description Name of promoted pin / ad
Field type dimension
Data type string.text.value
pin_promotion_status
Field label Promoted pin status
Description Status of promoted pin / ad
Field type dimension
Data type string.text.value
pin_promotion_created_time
Field label Promoted pin created date
Description The date the promoted pin was created
Field type dimension
Data type string.time.date
pin_promotion_updated_time
Field label Promoted pin updated date
Description The date the promoted pin was last updated
Field type dimension
Data type string.time.date
pin_promotion_click_tracking_url
Field label Android click tracking URL
Description 3rd-party click tracking URL used on promoted pin / ad
Field type dimension
Data type string.text.url
pin_promotion_creative_type
Field label Creative type
Description Creative type used in the promoted pin / ad
Field type dimension
Data type string.text.value
pin_promotion_destination_url
Field label Destination URL
Description Destination URL used in promoted pin / ad
Field type dimension
Data type string.text.url
utm_source
Field label Source (utm)
Description Value of the utm_source parameter extracted from the ad destination URL
Field type dimension
Data type string.text.value
utm_medium
Field label Medium (utm)
Description Value of the utm_medium parameter extracted from the ad destination URL
Field type dimension
Data type string.text.value
utm_campaign
Field label Campaign (utm)
Description Value of the utm_campaign parameter extracted from the ad destination URL
Field type dimension
Data type string.text.value
utm_content
Field label Content (utm)
Description Value of the utm_content parameter extracted from the ad destination URL
Field type dimension
Data type string.text.value
utm_term
Field label Term (utm)
Description Value of the utm_term parameter extracted from the ad destination URL
Field type dimension
Data type string.text.value
pin_promotion_is_pin_deleted
Field label Is pin deleted
Description TRUE if pin has been deleted, FALSE if pin still exists
Field type dimension
Data type bool
pin_promotion_review_status
Field label Review status
Description Review status of promoted pin / ad
Field type dimension
Data type string.text.value
pin_promotion_view_tracking_url
Field label View tracking URL
Description 3rd-party impression or view tracking URL used on promoted pin / ad
Field type dimension
Data type string.text.url
targeting_value
Field label Targeting value
Description The targeting value
Field type dimension
Data type string.text.value
targeting_type
Field label Targeting type
Description The targeting type
Field type dimension
Data type string.text.value

QUERY

system_metadata.query_date_range_start
Field label Start date
Description The start date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_date_range_end
Field label End date
Description The end date of the requested query
Field type dimension
Data type string.time.date
system_metadata.query_timezone
Field label Timezone
Description The timezone that is supplied to the query
Field type dimension
Data type string.time.timezone
system_metadata.query_filters
Field label Filters
Description All filters used in the query
Field type dimension
Data type string.text.json
system_metadata.query_date_start
Field label Start
Description When the query was started
Field type dimension
Data type string.time.datetime
system_metadata.query_date_end
Field label End
Description When the query completed
Field type dimension
Data type string.time.datetime
system_metadata.query_duration
Field label Duration
Description The duration in seconds of the query
Field type dimension
Data type int.duration.seconds
system_metadata.query_accounts
Field label Accounts
Description A list of accounts of which the data was pulled from
Field type dimension
Data type string.text.json

TARGETING BREAKDOWNS

targeting_keyword
Field label Keyword
Description Search term used by the user triggering the ad. Note that this field will only return data if you target by keyword
Field type dimension
Data type string.text.value
targeting_gender
Field label Gender
Description User gender. Note that this field will only return data if you target by gender
Field type dimension
Data type string.person.gender
targeting_age
Field label Age group
Description User age group. Note that this field will only return data if you target by age
Field type dimension
Data type string.person.age
targeting_country
Field label Country code
Description Two-letter code of the user country. Note that this field will only return data if you target by country
Field type dimension
Data type string.geo.country.twolettercode
targeting_country_name
Field label Country name
Description Name of the user country. Note that this field will only return data if you target by country
Field type dimension
Data type string.geo.country
targeting_region
Field label Region code
Description Code of the user region. Note that this field will only return data if you target by region
Field type dimension
Data type string.geo.region.code
targeting_region_name
Field label Region name
Description Name of the user region. Note that this field will only return data if you target by region
Field type dimension
Data type string.geo.region
targeting_location
Field label Location
Description User location: metropolitan area or region. Note that this field will only return data if you target by location
Field type dimension
Data type string.geo.metro
targeting_app_type
Field label App type
Description Type of the user's app, eg. "web" or "iphone". Note that this field will only return data if you target by app type
Field type dimension
Data type string.text.value
targeting_feed_type
Field label Feed type
Description Type of the feed, eg. "TWOCOLUMN_FEED". Note that this field will only return data if you target by feed type
Field type dimension
Data type string.text.value
targeting_placement
Field label Placement
Description Placement, eg. "HOME_FEED" or "RELATED_PINS". Note that this field will only return data if you target by placement
Field type dimension
Data type string.text.value
targeting_targeted_interest
Field label Targeted interest
Description Targeted user interest. Note that this field will only return data if you target by interest
Field type dimension
Data type string.text.value
targeting_pinner_interest
Field label Pinner interest
Description Targeted user interest. Note that this field will only return data if you target by interest
Field type dimension
Data type string.text.value
targeting_audience_include
Field label Audience include
Description Targeted user belonging to an audience. Note that this field will only return data if you target by audience
Field type dimension
Data type string.text.value

TIME

today
Field label Today
Description Today's date, e.g. 2017-01-31
Field type dimension
Data type string.time.date
Destinations API, Data warehouse
year
Field label Year
Field type dimension
Data type string.time.year
yearOfWeek
Field label Year of week (Sun-Sat)
Field type dimension
Data type string.time.year
yearOfWeekIso
Field label Year of week (Mon-Sun)
Field type dimension
Data type string.time.year
yearMonth
Field label Year & month
Field type dimension
Data type string.time.yearmonth
month
Field label Month
Field type dimension
Data type string.time.month
yearWeek
Field label Year & week (Sun-Sat)
Field type dimension
Data type string.time.yearweek
yearWeekIso
Field label Year & week (Mon-Sun)
Field type dimension
Data type string.time.yearweekiso
week
Field label Week (Sun-Sat)
Field type dimension
Data type string.time.week
weekIso
Field label Week (Mon-Sun)
Field type dimension
Data type string.time.weekiso
dayOfMonth
Field label Day of month
Field type dimension
Data type string.time.dayofmonth
dayOfWeekName
Field label Day of week (Sun-Sat)
Field type dimension
Data type string.time.dayofweek
dayOfWeekNameIso
Field label Day of week (Mon-Sun)
Field type dimension
Data type string.time.dayofweekiso
date
Field label Date
Field type dimension
Data type string.time.date

VIDEO ENGAGEMENTS

video_avg_watchtime_in_second_2
Field label Video avg. watch time (s) earned
Description Average watch time of all video ads, including seeks and loops, after being saved to another person's board
Field type metric
Data type float.number.value
video_avg_watchtime_in_second_1
Field label Video avg. watch time (s) paid
Description Average watch time of all video ads, including seeks and loops
Field type metric
Data type float.number.value
video_p0_combined_2
Field label Video starts earned
Description Number of times your video ad started playing after it was saved to another person's board
Field type metric
Data type int.number.value
video_p0_combined_1
Field label Video starts paid
Description Number of times your video ad started playing
Field type metric
Data type int.number.value
video_mrc_views_2
Field label Video views earned
Description Number of times your video ad played continuously for 2 seconds while 50% in view after being saved to another person's board
Field type metric
Data type int.number.value
video_mrc_views_1
Field label Video views paid
Description Number of times your video ad played continuously for 2 seconds while 50% in view
Field type metric
Data type int.number.value
video_3s_views
Field label Three second video views
Description Total number of times your video ad played continuously for at least 3 seconds while 50% visible (includes both paid and earned)
Field type metric
Data type int.number.value
video_p100_complete_1
Field label Video views at 100% paid
Description Number of times your video ad reached 100% of its length, including views that skipped ahead to this point
Field type metric
Data type int.number.value
video_p100_complete_2
Field label Video views at 100% earned
Description Number of times your video ad reached 100% of its length after it was saved to another person's board, including views that skipped ahead to this point
Field type metric
Data type int.number.value
video_p25_combined_1
Field label Video views at 25% paid
Description Number of times your video ad reached 25% of its length, including views that skipped ahead to this point
Field type metric
Data type int.number.value
video_p25_combined_2
Field label Video views at 25% earned
Description Number of times your video ad reached 25% of its length after it was saved to another person's board, including views that skipped ahead to this point
Field type metric
Data type int.number.value
video_p50_combined_1
Field label Video views at 50% paid
Description Number of times your video ad reached 50% of its length, including views that skipped ahead to this point
Field type metric
Data type int.number.value
video_p50_combined_2
Field label Video views at 50% earned
Description Number of times your video ad reached 50% of its length after it was saved to another person's board, including views that skipped ahead to this point
Field type metric
Data type int.number.value
video_p75_combined_1
Field label Video views at 75% paid
Description Number of times your video ad reached 75% of its length, including views that skipped ahead to this point
Field type metric
Data type int.number.value
video_p75_combined_2
Field label Video views at 75% earned
Description Number of times your video ad reached 75% of its length after it was saved to another person's board, including views that skipped ahead to this point
Field type metric
Data type int.number.value
video_p95_combined_1
Field label Video views at 95% paid
Description Number of times your video ad reached 95% of its length, including views that skipped ahead to this point
Field type metric
Data type int.number.value
video_p95_combined_2
Field label Video views at 95% earned
Description Number of times your video ad reached 95% of its length after it was saved to another person's board, including views that skipped ahead to this point
Field type metric
Data type int.number.value