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.
3-Second Video Views Metric
Total video views that lasted for at least 3 seconds.
ADVERTISER_ID Dimension
Unique identifier for the advertiser account.
AD_ACCOUNT_ID Dimension
The unique identifier for the ad account.
AD_GROUP_ID Dimension
The unique identifier for the ad group.
AD_ID Dimension
The unique identifier for the ad.
Ad group ID Dimension
A unique identifier for an ad group within an advertising campaign. Ad groups contain one or more ads and share common targeting and bidding settings.
Ad group name Dimension
The user-defined name given to an ad group, making it easily identifiable within an advertising campaign.
Advertiser Metric
The unique identifier for the advertiser account.
Advertiser ID Dimension
Unique identifier for the advertiser account.
Advertiser Name Dimension
The name of the advertiser account.
Advertiser name Dimension
The name of the advertiser account.
App Type Dimension
The type of application or device (e.g., ALL, MOBILE, TABLET, WEB) from which Pin analytics or targeting data is gathered.
CAMPAIGN_ID Dimension
Unique identifier for the campaign.
CAMPAIGN_NAME Dimension
The name of the campaign.
CAMPAIGN_OBJECTIVE_TYPE Metric
The objective type of the campaign (e.g., BRAND_AWARENESS, TRAFFIC, CONVERSION).
CLICKTHROUGH_1 Metric
The total number of times users clicked on a Pin or an ad.
CLICKTHROUGH_2 Metric
The number of times users clicked through an ad or Pin, attributed to a 2-day click attribution window.
CPC Metric
The Cost Per Click, representing the average cost incurred for each click on an ad or promoted content.
CPC_IN_MICRO_DOLLAR Metric
The cost per click (CPC) in microdollars (1/1,000,000 of a US dollar).
CPM_IN_MICRO_DOLLAR Metric
The cost per mille (thousand impressions) (CPM) in microdollars (1/1,000,000 of a US dollar).
CTR Metric
The clickthrough rate, calculated as clicks divided by impressions.
Campaign ID Metric
The unique identifier for an advertising campaign.
Campaign name Dimension
The name of the advertising campaign.
Conversions (Checkout) Metric
The total number of checkout conversion events.
Conversions (Custom) Dimension
The total number of custom conversion events.
Conversions (Lead) Dimension
The total number of lead conversion events.
Country Dimension
The geographical country associated with the data, such as the advertiser's country or the target audience's country.
Creative Type Dimension
The format or category of the creative used for an ad or Pin, such as image, video, carousel, or collection.
DATE Dimension
The date for which the metrics are reported.
Date Dimension
The date on which the data was recorded.
ECPC_IN_MICRO_DOLLAR Metric
The effective cost per click (eCPC) in microdollars (1/1,000,000 of a US dollar).
ECPM Metric
The Effective Cost Per Mille (thousand impressions), representing the average cost for one thousand impressions, regardless of whether clicks or other engagements occurred.
ECPM_IN_MICRO_DOLLAR Metric
The effective cost per mille (thousand impressions) (eCPM) in microdollars (1/1,000,000 of a US dollar).
Earned 3-Second Video Views Dimension
The number of organic video views where the video played for at least 3 seconds. This metric is related to organic video performance.
Earned CTR Dimension
The click-through rate for organic content.
Earned Pin clicks Metric
Total number of Pin clicks from ads saved to another person's board. These are downstream, earned events for which advertisers are not billed.
Earned impressions Metric
The total number of organic (unpaid) impressions for Pins or content, indicating how many times content was displayed on screen without paid promotion.
Engagement rate Dimension
The rate at which users interact with content (e.g., clicks, saves, closeups) relative to the number of impressions. It reflects how engaging the content is to its audience.
Engagements Metric
The total number of engagements on content, such as closeups, link clicks, or saves.
Gender Dimension
The gender demographic of the audience interacting with Pins or ads, used for targeting and audience insights.
Id Dimension
A unique identifier for an entity, such as an ad, campaign, ad group, or Pin.
Impressions Metric
The number of times content or ads were displayed on screen.
LEADS Dimension
The total number of lead generation events.
Location Dimension
The geographical area or region selected for targeting ads, defining where ads will be shown to users.
Location Code Dimension
A unique numerical or alphanumeric identifier representing a specific geographical location used for ad targeting, often paired with a descriptive location name.
Order quantity (Checkout) Metric
The total quantity of items purchased in checkout conversions.
Order value (Checkout) Metric
The monetary value of checkout conversions.
PAID_IMPRESSION Metric
The number of impressions attributed to paid ads.
PIN_ID Dimension
The unique identifier for the Pin.
PIN_PROMOTION_ID Dimension
Unique identifier for a promoted Pin.
PIN_PROMOTION_NAME Dimension
The name of the promotion associated with a Pin.
Paid CTR Dimension
The click-through rate for paid advertisements.
Paid Pin clicks Metric
The number of clicks on Pins that were part of a paid advertising campaign.
Paid impressions Metric
The number of impressions for Pins that were part of a paid advertising campaign.
Pin clicks Metric
The total number of clicks on a Pin, including when it opens in closeup.
REPIN_1 Metric
The number of times a Pin was saved (repinned) by other users.
REPIN_2 Metric
The number of times a Pin was saved by users, attributed to a 2-day click attribution window.
SPEND_IN_DOLLAR Metric
The total amount of money spent on ads, expressed in US dollars.
SPEND_IN_MICRO_DOLLAR Metric
The total advertising spend, expressed in micro-dollars (1,000,000 microdollars = 1 dollar).
Spend Metric
The total amount of money spent on an ad campaign.
Spend Order Line Id Metric
A unique identifier for the order line item associated with an ad campaign, typically used for billing and invoicing purposes.
Spend Order Line Paid Type Dimension
The payment model or type associated with a specific advertising order line item, indicating how the spend is accounted for (e.g., CPC, CPM, CPA).
Spend in account currency Metric
The total amount spent on advertising in the account's local currency, converted from micro-dollars.
TOTAL_CHECKOUT Dimension
The total number of checkout conversion events.
TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR Metric
The total value of checkout conversions, expressed in micro-dollars.
TOTAL_CLICKTHROUGH Metric
The total number of clicks on a Pin or ad that led to a destination.
TOTAL_CLICK_ADD_TO_CART Metric
The total number of add-to-cart events attributed to clicks on ads.
TOTAL_CLICK_CHECKOUT Dimension
The total number of checkout events attributed to clicks on ads.
TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR Metric
The total value of checkout conversions attributed to clicks on ads, expressed in micro-dollars.
TOTAL_CLICK_LEAD Metric
The total number of lead generation events attributed to clicks on ads.
TOTAL_CLICK_SIGNUP Metric
The total number of signup events attributed to clicks on ads.
TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR Metric
The total value of signup conversions attributed to clicks on ads, expressed in micro-dollars.
TOTAL_CONVERSIONS Metric
The total number of all conversions, including various conversion actions such as checkouts, signups, and leads.
TOTAL_CUSTOM Dimension
The total number of custom conversion events defined by the advertiser.
TOTAL_CUSTOM_VALUE_IN_MICRO_DOLLAR Metric
The total value of custom conversion events, expressed in micro-dollars.
TOTAL_ENGAGEMENT Metric
The total number of engagements with an ad or Pin (e.g., saves, closeups, link clicks).
TOTAL_ENGAGEMENT_CHECKOUT Dimension
The total number of checkout conversions attributed to user engagements with ads.
TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR Metric
The total value of checkout conversions attributed to engagements with ads, expressed in micro-dollars.
TOTAL_ENGAGEMENT_LEAD Dimension
The total number of lead generation events attributed to user engagements with ads.
TOTAL_ENGAGEMENT_SIGNUP Dimension
The total number of signup events attributed to user engagements with ads.
TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR Metric
The total value of signup conversions attributed to engagements with ads, expressed in micro-dollars.
TOTAL_IMPRESSION Metric
The total number of impressions, including both paid and organic.
TOTAL_LEAD Metric
The total number of lead generation conversions.
TOTAL_OFFLINE_CHECKOUT Dimension
The total count of offline checkout conversions, which are conversions that occur outside of online tracking.
TOTAL_PAGE_VISIT Metric
The total number of page visit conversions.
TOTAL_SIGNUP Metric
The total count of all signup conversions, both online and offline.
TOTAL_SIGNUP_VALUE_IN_MICRO_DOLLAR Metric
The total monetary value, in micro-dollars, attributed to signup events across all platforms.
TOTAL_VIDEO_3SEC_VIEWS Metric
The total number of video views that lasted at least 3 seconds.
TOTAL_VIDEO_P0_COMBINED Metric
The total number of video views combined at 0% completion (video starts), across both paid and organic content.
TOTAL_VIDEO_P100_COMPLETE Metric
Total video plays at 100% completion, across both paid and earned content.
TOTAL_VIDEO_P25_COMBINED Metric
Total video plays at 25% completion combined, across both paid and earned content.
TOTAL_VIDEO_P50_COMBINED Metric
Total video plays at 50% completion combined, across both paid and earned content.
TOTAL_VIDEO_P75_COMBINED Metric
Total video plays at 75% completion combined, across both paid and earned content.
TOTAL_VIDEO_P95_COMBINED Metric
The total number of video views combined at 95% completion, across both paid and organic content.
TOTAL_VIEW_ADD_TO_CART Dimension
The total number of add-to-cart events attributed to views of ads.
TOTAL_VIEW_CHECKOUT Dimension
The total number of checkout events attributed to views of ads.
TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR Metric
The total value of checkout conversions attributed to views of ads, expressed in micro-dollars.
TOTAL_VIEW_LEAD Metric
The total number of lead events attributed to views.
TOTAL_VIEW_SIGNUP Metric
The total number of signup events attributed to views of ads.
TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR Metric
The total value of signup conversions attributed to views of ads, expressed in micro-dollars.
TOTAL_WEB_CHECKOUT Dimension
The total number of website checkout conversions.
TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR Metric
The total value of web checkout conversions, expressed in micro-dollars.
TOTAL_WEB_CLICK_CHECKOUT Dimension
The total number of website checkout conversions attributed to click actions.
TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR Metric
The total value of web checkout conversions attributed to clicks on ads, expressed in micro-dollars.
TOTAL_WEB_ENGAGEMENT_CHECKOUT Dimension
The total number of website checkout conversions attributed to user engagements with ads.
TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR Metric
The total value of website checkout conversions attributed to engagements with ads, expressed in micro-dollars.
TOTAL_WEB_SESSIONS Dimension
The total number of web sessions initiated by users.
TOTAL_WEB_VIEW_CHECKOUT Dimension
The total number of website checkout conversions attributed to view-through actions.
TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR Metric
The total value of website checkout conversions attributed to views of ads, expressed in micro-dollars.
Total 3-Second Video Views Metric
Total video views that lasted for at least 3 seconds.
WEB_CHECKOUT_ROAS Metric
The Return on Ad Spend (ROAS) for checkout actions on the website.
Web conversions (Watch video) Metric
The number of website conversions where the user watched a video.
account_type Dimension
The type of Pinterest account (e.g., BUSINESS or PERSONAL).
ad_account_country Dimension
The country associated with the ad account.
ad_account_created_time Dimension
The creation time of the ad account in Unix timestamp (seconds).
ad_account_currency Dimension
The currency used by the ad account.
ad_account_id Dimension
The unique identifier for the ad account.
ad_account_name Dimension
The name of the ad account.
ad_account_owner Dimension
Details about the user account that owns the ad account, including username and ID.
ad_account_permissions Dimension
The list of permissions granted for business access to the ad account.
ad_account_updated_time Dimension
The last update time of the ad account in Unix timestamp (seconds).
ad_ad_account_id Dimension
The unique identifier of the ad account to which the ad belongs.
ad_ad_group_id Metric
The unique identifier of the ad group to which the ad belongs.
ad_campaign_id Dimension
The unique identifier of the campaign to which the ad belongs.
ad_carousel_destination_urls Dimension
A list of destination URLs for each image or card within a carousel ad.
ad_click_tracking_url Dimension
A URL used to track clicks on an ad, enabling advertisers to monitor click-through performance.
ad_creative_type Dimension
The format or type of creative used for the ad (e.g., image, video, carousel).
ad_destination_url Dimension
The primary URL to which users are directed when they click on an ad.
ad_group_auto_targeting_enabled Dimension
Indicates if auto-targeting (also known as expanded targeting) is enabled for the ad group.
ad_group_bid_in_micro_currency Metric
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.
ad_group_bid_multiplier Dimension
A factor applied to the base bid within an ad group to adjust bids for specific targeting criteria or placements.
ad_group_bid_strategy_type Dimension
The bid strategy type for the ad group, such as AUTOMATIC_BID, MAX_BID, or TARGET_AVG.
ad_group_billable_event Dimension
The billable event type for the ad group, such as CLICKTHROUGH, IMPRESSION, or VIDEO_V_50_MRC.
ad_group_budget_in_micro_currency Dimension
The budget for the ad group in microcurrency (1/1,000,000 of the standard currency unit). This is required for non-CBO campaigns.
ad_group_budget_type Dimension
The budget type for the ad group, either DAILY or LIFETIME.
ad_group_conversion_learning_mode_type Dimension
The conversion learning mode type for the ad group, indicating how the optimization goal is learning.
ad_group_created_time Dimension
The creation time of the ad group in Unix timestamp (seconds).
ad_group_dca_assets Dimension
Dynamic Creative Assembly (DCA) assets used for the ad group, which allows for automatically generated optimized ad combinations.
ad_group_end_time Dimension
The end time of the ad group in Unix timestamp (seconds).
ad_group_entity_status Dimension
The status of the ad group entity, indicating if it is active, paused, or archived.
ad_group_feed_profile_id Dimension
The Feed Profile ID associated with the ad group.
ad_group_id Dimension
The unique identifier for the ad group.
ad_group_lifetime_frequency_cap Metric
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.
ad_group_name Dimension
The name of the ad group.
ad_group_optimization Metric
The strategy or setting used to optimize ad group performance towards specific goals, such as clicks, conversions, or impressions.
ad_group_optimization_goal_metadata Dimension
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'.
ad_group_optimization_goal_metadata.conversion_tag_v3_goal_metadata.attribution_windows.click_window_days Dimension
The number of days in the attribution window for click-through conversions, used to define how long after a click a conversion can be attributed to an ad.
ad_group_optimization_goal_metadata.conversion_tag_v3_goal_metadata.attribution_windows.view_window_days Dimension
The number of days in the attribution window for view-through conversions, used to define how long after an ad view a conversion can be attributed to that ad.
ad_group_optimization_goal_metadata.conversion_tag_v3_goal_metadata.conversion_event Dimension
The specific conversion event chosen as the optimization goal for an ad group, such as `ADD_TO_CART` or `CHECKOUT`. This event determines how Pinterest optimizes ad delivery and bidding for the ad group.
ad_group_optimization_goal_metadata.conversion_tag_v3_goal_metadata.conversion_tag_id Dimension
The unique identifier for the conversion tag used to track specific actions and optimize ad group performance.
ad_group_optimization_goal_metadata.conversion_tag_v3_goal_metadata.is_roas_optimized Dimension
Indicates whether the ad group's optimization goal is set to maximize Return on Ad Spend (ROAS).
ad_group_pacing_delivery_type Dimension
The pacing delivery type for the ad group, either STANDARD (spent smoothly) or ACCELERATED (spent as fast as possible).
ad_group_placement_group Dimension
The specific placement group where an ad group is shown, such as a product group.
ad_group_start_time Dimension
The start time of the ad group in Unix timestamp (seconds).
ad_group_status Dimension
The current status of the ad group, such as ACTIVE, PAUSED, or ARCHIVED.
ad_group_summary_status Dimension
The summary status for the ad group, such as RUNNING, PAUSED, or ARCHIVED.
ad_group_targeting_spec Dimension
Specifications for audience targeting applied to an ad group, used for breaking down ad performance reports by targeting type.
ad_group_targeting_spec.LOCALE Dimension
The specific language and regional format targeted by an ad group.
ad_group_targeting_spec.LOCATION Dimension
The geographic location targeted by an ad group.
ad_group_tracking_urls Dimension
Third-party tracking URLs for various ad events at the ad group level.
ad_group_tracking_urls.click Dimension
The click tracking URL for the ad group, used for monitoring ad group performance and attributing click actions.
ad_group_type Dimension
The type of the ad group, which is always 'adgroup'.
ad_group_updated_time Dimension
The timestamp indicating the last time the ad group was updated.
ad_id Dimension
The unique identifier for the ad.
ad_name Dimension
The name of the ad.
ad_pin_id Metric
The unique identifier of the Pin that serves as the creative for the ad.
ad_status Dimension
The current status of the ad, indicating if it is active, paused, or archived.
ad_tracking_urls Dimension
The comprehensive set of URLs used for tracking various interactions with an ad, including impressions, clicks, and engagements.
ad_type Dimension
The general classification or category of the ad.
ad_view_tracking_url Dimension
A URL used to track ad impressions or views, allowing advertisers to monitor how many times their ads are displayed.
add_to_cart_desktop_action_desktop_conversion Metric
The number of "add to cart" conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.
add_to_cart_desktop_action_mobile_conversion Metric
The number of "add to cart" conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.
add_to_cart_desktop_action_tablet_conversion Dimension
The number of "add to cart" conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.
add_to_cart_mobile_action_desktop_conversion Metric
The number of "add to cart" conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.
add_to_cart_mobile_action_mobile_conversion Metric
The number of "add to cart" conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.
add_to_cart_mobile_action_tablet_conversion Metric
The number of "add to cart" conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.
add_to_cart_tablet_action_desktop_conversion Metric
The number of "add to cart" conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.
add_to_cart_tablet_action_mobile_conversion Metric
The number of "add to cart" conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.
add_to_cart_tablet_action_tablet_conversion Dimension
The number of "add to cart" conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.
ads_CLICKTHROUGH_1 Metric
Total number of Pin clicks on an ad, representing first-order ad events.
ads_CLICKTHROUGH_2 Dimension
Total number of Pin clicks from ads saved to another person's board, representing downstream, earned events.
ads_ENGAGEMENT_1 Metric
Represents first-order engagement events on Promoted Pins, such as Pin clicks.
ads_ENGAGEMENT_2 Metric
Represents downstream or 'earned' engagement events on Pins, which are actions taken on saved Pins.
ads_OUTBOUND_CLICK_1 Metric
The number of clicks on an ad that lead to an external destination outside of Pinterest.
ads_OUTBOUND_CLICK_2 Metric
The number of clicks that led users off the Pinterest platform, attributed to a 2-day click attribution window.
ads_REPIN_1 Dimension
The total number of times a Pin was saved to a board as a first-order ad event directly resulting from an ad.
ads_REPIN_2 Metric
The total number of times a Pin was saved to a board from an ad saved by another person, representing a downstream, earned event.
ads_SPEND_IN_MICRO_DOLLAR Metric
The total advertising spend specifically for ads, expressed in micro-dollars.
ads_TOTAL_CHECKOUT Dimension
Total number of checkout events resulting from interactions with your ad.
ads_TOTAL_CLICK_ADD_TO_CART Dimension
Total number of add to cart events resulting from clicks on your ads.
ads_TOTAL_CLICK_CHECKOUT Metric
Total number of checkout events resulting from clicks on your ad.
ads_TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR Dimension
Total value, in micro-dollars, of checkout events resulting from clicks on your ad.
ads_TOTAL_CLICK_LEAD Dimension
Total number of lead generation events resulting from clicks on your ad.
ads_TOTAL_CLICK_SIGNUP Dimension
Total number of signup events resulting from clicks on your ad.
ads_TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR Dimension
Total value, in micro-dollars, of signup events resulting from clicks on your ad.
ads_TOTAL_CONVERSIONS Metric
The total number of all conversions specifically for ads.
ads_TOTAL_ENGAGEMENT Metric
Total engagements with your Pins or ads, including saves, Pin clicks, and outbound clicks.
ads_TOTAL_ENGAGEMENT_CHECKOUT Dimension
Total number of checkout events resulting from engagement with your ad.
ads_TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR Dimension
Total value, in micro-dollars, of checkout events resulting from engagement with your ad.
ads_TOTAL_ENGAGEMENT_LEAD Dimension
Total number of lead generation events resulting from engagement with your ad.
ads_TOTAL_ENGAGEMENT_SIGNUP Dimension
Total number of signup events resulting from engagement with your ad.
ads_TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR Dimension
Total value, in micro-dollars, of signup events resulting from engagement with your ad.
ads_TOTAL_LEAD Dimension
Total number of lead generation events resulting from interactions with your ad.
ads_TOTAL_VIDEO_3SEC_VIEWS Dimension
Total number of times your video ad played continuously for at least 3 seconds while 50% visible.
ads_TOTAL_VIEW_ADD_TO_CART Dimension
Total number of add to cart events resulting from views of your ad.
ads_TOTAL_VIEW_CHECKOUT Metric
Total number of checkout events resulting from views of your ad.
ads_TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR Metric
Total value, in micro-dollars, of checkout events resulting from views of your ad.
ads_TOTAL_VIEW_LEAD Dimension
Total number of lead generation events resulting from views of your ad.
ads_TOTAL_VIEW_SIGNUP Dimension
Total number of signup events resulting from views of your ad.
ads_TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR Dimension
Total value, in micro-dollars, of signup events resulting from views of your ad.
ads_TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR Dimension
Total value, in micro-dollars, of all web checkout events for your ads.
ads_TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR Dimension
Total value, in micro-dollars, of web checkout events resulting from clicks on your ad.
ads_TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR Dimension
Total value, in micro-dollars, of web checkout events resulting from engagement with your ad.
ads_TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR Metric
Total value, in micro-dollars, of web checkout events resulting from views of your ad.
ads_VIDEO_LENGTH Metric
The duration of the video creative used in the ad, in seconds.
ads_android_deep_link Dimension
The deep link URL for Android devices used in an ad, directing users to specific content within an app.
ads_carousel_android_deep_links Dimension
A list of deep link URLs for each image or card within a carousel ad on Android devices, directing users to specific in-app content.
ads_carousel_destination_urls Dimension
A list of destination URLs for each card within a carousel ad.
ads_carousel_ios_deep_links Dimension
A list of deep link URLs for each image or card within a carousel ad on iOS devices, directing users to specific in-app content.
ads_click_tracking_url Dimension
The URL used for tracking clicks on the ads.
ads_creative_type Dimension
The type of creative used for the ad (e.g., image, video, carousel).
ads_destination_url Dimension
The primary URL where users are directed after interacting with the ad.
ads_id Dimension
Unique identifier for a specific ad.
ads_ios_deep_link Dimension
The deep link URL for iOS devices used in an ad, directing users to specific content within an app.
ads_name Dimension
The name of the ad.
ads_status Dimension
The current status of the ad (e.g., active, paused, archived).
ads_tracking_urls.audience_verification Dimension
URL used for verifying that ads are served to the intended audience segments, often for third-party measurement of audience reach and demographics.
ads_tracking_urls.buyable_button Dimension
A tracking URL specifically used for monitoring clicks or interactions with a 'buyable button' within an ad. It helps advertisers measure the performance of direct shopping actions facilitated by the ad creative.
ads_tracking_urls.click Dimension
The specific URLs within the tracking_urls object that are used for tracking clicks on an ad.
ads_tracking_urls.engagement Dimension
URL used to track various engagement actions with an ad, such as saves, close-ups, link clicks, or carousel card swipes.
ads_tracking_urls.impression Dimension
URL used to track each instance when an ad is displayed to a user, measuring the visibility of the advertisement.
ads_type Dimension
The type of ad, categorizing its format or objective.
advertiser_id Dimension
The unique identifier for the advertiser.
advertiser_name Dimension
The name of the advertiser.
app_install_desktop_action_desktop_conversion Dimension
The number of "app install" conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.
app_install_desktop_action_mobile_conversion Dimension
The number of "app install" conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.
app_install_desktop_action_tablet_conversion Dimension
The number of "app install" conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.
app_install_mobile_action_desktop_conversion Dimension
The number of "app install" conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.
app_install_mobile_action_mobile_conversion Dimension
The number of "app install" conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.
app_install_mobile_action_tablet_conversion Dimension
The number of "app install" conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.
app_install_tablet_action_desktop_conversion Dimension
The number of "app install" conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.
app_install_tablet_action_mobile_conversion Dimension
The number of "app install" conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.
app_install_tablet_action_tablet_conversion Dimension
The number of "app install" conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.
board_count Metric
The total number of boards associated with a user account.
business_name Dimension
The name of the business or advertiser account on Pinterest.
campaign_created_time Dimension
The creation time of the campaign in Unix timestamp (seconds).
campaign_daily_spend_cap Metric
The daily spending cap for the campaign in microcurrency.
campaign_end_time Dimension
The scheduled end time of the campaign.
campaign_entity_status Dimension
The status of the campaign entity, indicating if it is active, paused, or archived.
campaign_id Dimension
The unique identifier for the campaign.
campaign_is_campaign_budget_optimization Dimension
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.
campaign_is_flexible_daily_budgets Dimension
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.
campaign_lifetime_spend_cap Metric
The total spending cap for the campaign's lifetime in microcurrency.
campaign_managed_status Dimension
The current management status of the campaign (e.g., active, paused, archived).
campaign_name Dimension
The name of the campaign.
campaign_objective_type Dimension
The objective type of the campaign (e.g., BRAND_AWARENESS, TRAFFIC, CONVERSION).
campaign_order_line_id Dimension
The unique identifier for the order line associated with a campaign.
campaign_start_time Dimension
The scheduled start time of the campaign.
campaign_status Dimension
The current status of the campaign, indicating if it is active, paused, or archived.
campaign_summary_status Dimension
The overall summary status of the campaign, indicating its current state (e.g., "RUNNING", "PAUSED", "ARCHIVED").
campaign_tracking_urls Dimension
A list of tracking URLs associated with the campaign for monitoring performance and attributing actions.
campaign_tracking_urls.impression Dimension
The impression tracking URL for the campaign, used for monitoring campaign performance and attributing impressions.
campaign_type Dimension
The type of the campaign, which is always 'campaign'.
campaign_updated_time Dimension
The timestamp indicating the last time a campaign was updated.
channel Dimension
The source or type of content performance, distinguishing between organic (unpaid) and paid (advertising) activities on the Pinterest platform.
checkout_desktop_action_desktop_conversion Metric
The number of "checkout" conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.
checkout_desktop_action_mobile_conversion Metric
The number of "checkout" conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.
checkout_desktop_action_tablet_conversion Dimension
The number of "checkout" conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.
checkout_mobile_action_desktop_conversion Metric
The number of "checkout" conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.
checkout_mobile_action_mobile_conversion Metric
The number of "checkout" conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.
checkout_mobile_action_tablet_conversion Metric
The number of "checkout" conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.
checkout_roas Metric
Return on ad spend (ROAS) for checkout conversions.
checkout_tablet_action_desktop_conversion Metric
The number of "checkout" conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.
checkout_tablet_action_mobile_conversion Metric
The number of "checkout" conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.
checkout_tablet_action_tablet_conversion Dimension
The number of "checkout" conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.
checkout_value_from_click_conversions_micro Metric
The value of checkout conversions in microcurrency attributed to click actions.
checkout_value_from_engagement_conversions_micro Metric
The value of checkout conversions in microcurrency attributed to engagement actions.
checkout_value_from_view_conversions_micro Metric
The value of checkout conversions in microcurrency attributed to view-through actions.
clicks Metric
The total number of clicks on your Pin or ad so it opens in closeup. This metric applies to both organic and paid content.
clickthrough Dimension
Total number of clickthroughs on a Pin or ad, which includes any clicks that lead to a destination outside of Pinterest.
clickthrough_conversions_(add_to_cart) Metric
The number of add-to-cart conversions attributed to click actions.
clickthrough_conversions_(app_install) Dimension
The number of app install conversions attributed to click actions.
clickthrough_conversions_(category_view) Dimension
The number of category view conversions attributed to click actions.
clickthrough_conversions_(checkout) Metric
The number of checkout conversions attributed to clickthroughs.
clickthrough_conversions_(custom) Dimension
The number of custom conversions attributed to click actions.
clickthrough_conversions_(lead) Dimension
The number of lead conversions attributed to clickthroughs.
clickthrough_conversions_(page_visit) Metric
The number of page visit conversions attributed to clickthroughs.
clickthrough_conversions_(signup) Metric
The number of signup conversions attributed to click actions.
clickthrough_conversions_(unknown) Metric
The total number of conversions attributed to user clicks on ads, where the specific conversion action type is not categorized.
clickthrough_conversions_(watch_video) Dimension
The number of watch video conversions attributed to click actions.
clickthrough_conversions_(website_search) Dimension
The number of website search conversions attributed to click actions.
clickthrough_order_quantity_(checkout) Metric
The quantity of items purchased in checkout conversions attributed to click actions.
clickthrough_rate Dimension
The click-through rate (CTR), representing the percentage of impressions that resulted in a click.
clickthrough_value_micro_(add_to_cart) Metric
The monetary value, in micro-units of the advertiser's currency, of "add to cart" conversions attributed to user clicks on ads.
clickthrough_value_micro_(app_install) Metric
The monetary value, in micro-units of the advertiser's currency, of "app install" conversions attributed to user clicks on ads.
clickthrough_value_micro_(category_view) Metric
The monetary value, in micro-units of the advertiser's currency, of "category view" conversions attributed to user clicks on ads.
clickthrough_value_micro_(custom) Dimension
The monetary value, in micro-units of the advertiser's currency, of "custom" conversions attributed to user clicks on ads.
clickthrough_value_micro_(lead) Metric
The value of lead conversions in microcurrency attributed to click actions.
clickthrough_value_micro_(page_visit) Dimension
The monetary value, in micro-units of the advertiser's currency, of "page visit" conversions attributed to user clicks on ads.
clickthrough_value_micro_(signup) Metric
The value of signup conversions in microcurrency attributed to click actions.
clickthrough_value_micro_(unknown) Metric
The monetary value, in micro-units of the advertiser's currency, of "unknown" conversions attributed to user clicks on ads.
clickthrough_value_micro_(watch_video) Metric
The monetary value, in micro-units of the advertiser's currency, of "watch video" conversions attributed to user clicks on ads.
clickthrough_value_micro_(website_search) Metric
The monetary value, in micro-units of the advertiser's currency, of "website search" conversions attributed to user clicks on ads.
closeup Metric
The number of times a Pin closeup was viewed.
closeup_rate Metric
The rate at which Pin closeups are viewed, calculated as closeups divided by impressions.
comment_count Metric
The total number of comments received on a Pin.
conversion_quantity_from_add_to_cart_clicks Metric
The number of "add to cart" conversions that resulted from user clicks on ads.
conversion_quantity_from_add_to_cart_engagements Dimension
The number of "add to cart" conversions that resulted from user engagements on ads.
conversion_quantity_from_add_to_cart_views Metric
The number of "add to cart" conversions that resulted from user views on ads.
conversion_quantity_from_custom_engagements Dimension
The number of "custom" conversions that resulted from user engagements on ads.
conversion_quantity_from_lead_clicks Dimension
The number of "lead" conversions that resulted from user clicks on ads.
conversion_quantity_from_lead_engagements Dimension
The number of "lead" conversions that resulted from user engagements on ads.
conversion_quantity_from_lead_views Dimension
The number of "lead" conversions that resulted from user views on ads.
conversion_quantity_from_page_visit_clicks Dimension
The number of "page visit" conversions that resulted from user clicks on ads.
conversion_quantity_from_page_visit_views Metric
The number of "page visit" conversions that resulted from user views on ads.
conversion_quantity_from_page_visits Dimension
The number of "page visit" conversions that resulted from user visits on ads.
conversion_quantity_from_search_clicks Dimension
The number of "search" conversions that resulted from user clicks on ads.
conversion_quantity_from_search_engagements Dimension
The number of "search" conversions that resulted from user engagements on ads.
conversion_quantity_from_search_views Dimension
The number of "search" conversions that resulted from user views on ads.
conversion_quantity_from_signup_clicks Dimension
The quantity of signup conversions resulting from clicks.
conversion_quantity_from_signup_engagements Dimension
The number of "signup" conversions that resulted from user engagements on ads.
conversion_quantity_from_signup_views Dimension
The number of "signup" conversions that resulted from user views on ads.
conversion_quantity_from_unknown_engagements Dimension
The number of "unknown" conversions that resulted from user engagements on ads.
conversion_quantity_from_view_category_clicks Dimension
The number of "view category" conversions that resulted from user clicks on ads.
conversion_quantity_from_view_category_engagements Dimension
The number of "view category" conversions that resulted from user engagements on ads.
conversion_quantity_from_view_category_views Dimension
The number of "view category" conversions that resulted from user views on ads.
conversion_quantity_from_watch_video_clicks Dimension
The number of "watch video" conversions that resulted from user clicks on ads.
conversion_quantity_from_watch_video_engagements Dimension
The number of "watch video" conversions that resulted from user engagements on ads.
conversion_quantity_from_watch_video_views Dimension
The number of "watch video" conversions that resulted from user views on ads.
conversions Metric
The total number of conversion events.
conversions_(app_install) Metric
The total number of app install conversions.
cost_per_2second_50%_viewability_video_view_micro Dimension
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.
cost_per_at_least_95%_completed_video_view_micro Dimension
The cost in microcurrency for a video view completed to at least 95%.
cost_per_completed_video_view_micro Dimension
The cost in microcurrency for a completed video view.
cost_per_lead Dimension
The cost associated with generating a lead.
cost_per_outbound_click Dimension
The cost associated with each outbound click.
cost_per_outbound_click_in_dollar Dimension
The average cost incurred for each outbound click from an ad to an external destination, reported in dollars.
country Dimension
The two-character ISO 3166-1 alpha-2 country code associated with an ad account or target audience, indicating the geographical region.
cpa_(app_install) Dimension
The cost incurred for each app install conversion, calculated as total ad spend divided by the number of app installs.
cpm_in_dollar Metric
The cost per thousand impressions (CPM) for ads, expressed in dollars, indicating the price paid for one thousand views or displays of an advertisement.
created_at Dimension
The timestamp indicating when the entity (e.g., Pin, ad, campaign) was created.
creative_type Dimension
The format or type of creative used (e.g., image, video, carousel).
custom_desktop_action_desktop_conversion Metric
The number of "custom" conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.
custom_desktop_action_mobile_conversion Metric
The number of "custom" conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.
custom_desktop_action_tablet_conversion Dimension
The number of "custom" conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.
custom_mobile_action_desktop_conversion Metric
The number of "custom" conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.
custom_mobile_action_mobile_conversion Metric
The number of "custom" conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.
custom_mobile_action_tablet_conversion Metric
The number of "custom" conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.
custom_roas Dimension
The Return on Ad Spend (ROAS) calculated based on custom conversion values. This metric measures the revenue generated for every dollar spent on ads, using advertiser-defined conversion values.
custom_tablet_action_desktop_conversion Metric
The number of "custom" conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.
custom_tablet_action_mobile_conversion Metric
The number of "custom" conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.
custom_tablet_action_tablet_conversion Dimension
The number of "custom" conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.
data_status Dimension
The current operational status of an entity such as an ad, campaign, or promoted Pin (e.g., active, paused, archived).
date Dimension
The date for which the metrics are reported.
date_created Dimension
The date when the entity (e.g., Pin, ad, campaign) was created.
date_range Dimension
The date range for which the metrics are reported.
date_range_end Dimension
The end date of the reporting period.
date_range_start Dimension
The start date of the reporting period.
description Dimension
The description of the Pin or Board.
earned_average_video_watch_time Metric
The average time users spent watching organic video Pins.
earned_clicks Metric
The number of organic clicks on Pins or content.
earned_ctr Dimension
The organic click-through rate, representing the percentage of times organic Pins were clicked after being seen.
earned_engagements Metric
The number of organic engagements on Pins or content.
earned_impressions Metric
The number of organic impressions on Pins or content.
earned_outbound_clicks Dimension
The number of organic outbound clicks on Pins or content.
earned_saves Dimension
The number of organic saves on Pins or content.
earned_video_starts Dimension
The number of times an organic video started playing.
earned_video_views Metric
The number of organic video views on Pins or content.
earned_video_watched_at_100% Dimension
The number of times an organic video was watched to 100% completion.
earned_video_watched_at_25% Dimension
The number of times an organic video was watched to at least 25% completion.
earned_video_watched_at_50% Dimension
The number of times an organic video was watched to at least 50% completion.
earned_video_watched_at_75% Dimension
The number of times an organic video was watched to at least 75% completion.
earned_video_watched_at_95% Dimension
The number of times an organic video was watched to at least 95% completion.
ecpc_in_dollar Metric
The effective cost per click (eCPC) in dollars.
ecpcv_in_dollar Metric
The effective cost per completed video view, measured in dollars. This is a calculated ad performance metric.
ecpcv_p95_in_dollar Metric
The 95th percentile of the effective cost per completed video view, measured in dollars. This indicates a higher bound for the cost per view.
ecpe_in_dollar Metric
The effective cost per engagement (eCPE) in dollars.
ecpv_in_dollar Metric
The effective cost per video view, measured in dollars. This is a calculated ad performance metric.
engagement Metric
The total number of engagements on content, such as saves, Pin clicks, outbound clicks, carousel card swipes, or secondary creative interactions.
engagement_conversions_(add_to_cart) Dimension
The number of add-to-cart conversions attributed to engagement actions.
engagement_conversions_(app_install) Dimension
The number of app install conversions attributed to engagement actions.
engagement_conversions_(category_view) Dimension
The number of category view conversions attributed to engagement actions.
engagement_conversions_(checkout) Metric
The number of checkout conversions attributed to engagement actions.
engagement_conversions_(custom) Dimension
The number of custom conversions attributed to engagement actions.
engagement_conversions_(lead) Dimension
The number of lead conversions attributed to engagement actions.
engagement_conversions_(page_visit) Dimension
The number of page visit conversions attributed to engagement actions.
engagement_conversions_(signup) Dimension
The number of signup conversions attributed to engagement actions.
engagement_conversions_(unknown) Dimension
The total number of conversions attributed to user engagements with ads, where the specific conversion action type is not categorized.
engagement_conversions_(watch_video) Dimension
The number of watch video conversions attributed to engagement actions.
engagement_conversions_(website_search) Dimension
The number of website search conversions attributed to engagement actions.
engagement_order_quantity_(checkout) Dimension
The quantity of items purchased in checkout conversions attributed to engagement actions.
engagement_rate Metric
The rate at which users engage with content, calculated as total engagements divided by impressions.
engagement_value_micro_(add_to_cart) Metric
The monetary value, in micro-units of the advertiser's currency, of "add to cart" conversions attributed to user engagements on ads.
engagement_value_micro_(app_install) Metric
The monetary value, in micro-units of the advertiser's currency, of "app install" conversions attributed to user engagements on ads.
engagement_value_micro_(category_view) Metric
The monetary value, in micro-units of the advertiser's currency, of "category view" conversions attributed to user engagements on ads.
engagement_value_micro_(custom) Metric
The monetary value, in micro-units of the advertiser's currency, of "custom" conversions attributed to user engagements on ads.
engagement_value_micro_(lead) Metric
The monetary value, in micro-units of the advertiser's currency, of "lead" conversions attributed to user engagements on ads.
engagement_value_micro_(page_visit) Metric
The monetary value, in micro-units of the advertiser's currency, of "page visit" conversions attributed to user engagements on ads.
engagement_value_micro_(signup) Metric
The value of signup conversions in microcurrency attributed to engagement actions.
engagement_value_micro_(unknown) Metric
The monetary value, in micro-units of the advertiser's currency, of "unknown" conversions attributed to user engagements on ads.
engagement_value_micro_(watch_video) Metric
The monetary value, in micro-units of the advertiser's currency, of "watch video" conversions attributed to user engagements on ads.
engagement_value_micro_(website_search) Metric
The monetary value, in micro-units of the advertiser's currency, of "website search" conversions attributed to user engagements on ads.
enhanced_match_status Dimension
Indicates the status of Pinterest's Enhanced Match solution, which improves conversion tracking by capturing more web actions without relying heavily on cookies. This is typically a property of a conversion tag.
follower_count Metric
The total number of followers for a user account.
following_count Metric
The total number of users that a user account is following.
full_screen_play Metric
The number of times a video pin was played in full-screen mode.
full_screen_playtime Metric
The total time (in seconds or milliseconds) that a video pin was played in full-screen mode.
id Metric
The unique identifier for the entity (e.g., Pin ID, Board ID, Ad Account ID).
impression Metric
The total number of times a Pin or ad was displayed on screen.
impressions Metric
The number of times your Pins or ads were on screen. This metric applies to both organic and paid content.
inapp_add_to_cart_cost_per_action Dimension
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.
inapp_add_to_cart_roas Dimension
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.
inapp_app_install_cost_per_action Dimension
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.
inapp_app_install_roas Dimension
The return on ad spend (ROAS) for in-app "app install" actions, indicating the revenue generated per dollar spent on advertising for these actions.
inapp_checkout_cost_per_action Metric
The cost incurred for each in-app "checkout" action, calculated as total ad spend divided by the number of in-app "checkout" events.
inapp_checkout_roas Dimension
The return on ad spend (ROAS) for in-app "checkout" actions, indicating the revenue generated per dollar spent on advertising for these actions.
inapp_search_cost_per_action Dimension
The cost incurred for each in-app "search" action, calculated as total ad spend divided by the number of in-app "search" events.
inapp_search_roas Dimension
The return on ad spend (ROAS) for in-app "search" actions, indicating the revenue generated per dollar spent on advertising for these actions.
inapp_signup_cost_per_action Dimension
The cost incurred for each in-app "signup" action, calculated as total ad spend divided by the number of in-app "signup" events.
inapp_signup_roas Dimension
The return on ad spend (ROAS) for in-app "signup" actions, indicating the revenue generated per dollar spent on advertising for these actions.
inapp_unknown_cost_per_action Dimension
The cost incurred for each in-app "unknown" action, calculated as total ad spend divided by the number of in-app "unknown" events.
inapp_unknown_roas Dimension
The return on ad spend (ROAS) for in-app "unknown" actions, indicating the revenue generated per dollar spent on advertising for these actions.
is_premiere_campaign Dimension
Indicates if a campaign is a "Premiere Spotlight" campaign, which is a premium ad placement on Pinterest offering high visibility, typically for video ads, at the top of home and search feeds to maximize brand awareness and engagement.
last_fired_time_ms Metric
The last recorded time, in milliseconds, when a conversion tag or similar event tracking mechanism was fired.
lead_desktop_action_desktop_conversion Metric
The number of "lead" conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.
lead_desktop_action_mobile_conversion Dimension
The number of "lead" conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.
lead_desktop_action_tablet_conversion Dimension
The number of "lead" conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.
lead_mobile_action_desktop_conversion Metric
The number of "lead" conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.
lead_mobile_action_mobile_conversion Metric
The number of "lead" conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.
lead_mobile_action_tablet_conversion Dimension
The number of "lead" conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.
lead_tablet_action_desktop_conversion Dimension
The number of "lead" conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.
lead_tablet_action_mobile_conversion Metric
The number of "lead" conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.
lead_tablet_action_tablet_conversion Dimension
The number of "lead" conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.
leads Metric
The total number of lead events.
lifetime_metrics.clickthrough Metric
The total number of clicks on content over its entire lifetime. This metric measures the long-term effectiveness of content in driving user interest.
lifetime_metrics.comment Metric
The total number of comments received on a Pin over its lifetime. This corresponds to the TOTAL_COMMENTS metric.
lifetime_metrics.impression Metric
The total number of times a Pin has been displayed to users over its lifetime. This corresponds to the IMPRESSION metric.
lifetime_metrics.pin_click Metric
The total number of clicks on the Pin itself over its lifetime. This corresponds to the PIN_CLICK metric.
lifetime_metrics.reaction Metric
The total number of reactions received on a Pin over its lifetime. This corresponds to the TOTAL_REACTIONS metric.
like_count Dimension
Represents the number of times a Pin or content has been 'saved' by users. On Pinterest, 'saves' are a primary form of engagement, similar to 'likes' on other social media platforms.
link Dimension
The destination URL for the Pin when clicked.
media.cover_image_url Dimension
The URL of the cover image for a video Pin.
media.images.1200x.url Dimension
The URL of the 1200x scaled version of the Pin's image media.
media.images.150x150.url Dimension
The URL of the 150x150 scaled version of the Pin's image media.
media.images.400x300.url Dimension
The URL of the 400x300 scaled version of the Pin's image media.
media.images.600x.url Dimension
The URL of the 600x scaled version of the Pin's image media.
media.images.originals.url Dimension
The URL of the original, high-resolution image associated with a Pin.
media.media_type Dimension
The type of media associated with the Pin, such as image or video.
monthly_views Metric
The total number of impressions or views an account's Pins have received in a month.
name Dimension
The name or title of an entity within Pinterest, such as a Pin, campaign, ad group, or ad account. It is used for identification and display purposes.
offline_checkout_cost_per_action Dimension
The cost incurred for each offline "checkout" action, calculated as total ad spend divided by the number of offline "checkout" events.
offline_checkout_roas Dimension
The return on ad spend (ROAS) for offline "checkout" actions, indicating the revenue generated per dollar spent on advertising for these actions.
offline_custom_cost_per_action Dimension
The cost incurred for each offline "custom" action, calculated as total ad spend divided by the number of offline "custom" events.
offline_custom_roas Dimension
The return on ad spend (ROAS) for offline "custom" actions, indicating the revenue generated per dollar spent on advertising for these actions.
offline_lead_cost_per_action Dimension
The cost incurred for each offline "lead" action, calculated as total ad spend divided by the number of offline "lead" events.
offline_lead_roas Dimension
The return on ad spend (ROAS) for offline "lead" actions, indicating the revenue generated per dollar spent on advertising for these actions.
offline_signup_cost_per_action Dimension
The cost incurred for each offline "signup" action, calculated as total ad spend divided by the number of offline "signup" events.
offline_signup_roas Dimension
The return on ad spend (ROAS) for offline "signup" actions, indicating the revenue generated per dollar spent on advertising for these actions.
offline_unknown_cost_per_action Dimension
The cost incurred for each offline "unknown" action, calculated as total ad spend divided by the number of offline "unknown" events.
offline_unknown_roas Dimension
The return on ad spend (ROAS) for offline "unknown" actions, indicating the revenue generated per dollar spent on advertising for these actions.
order_line_id Metric
The unique identifier for the order line item within an ad account.
order_line_name Dimension
The name of the order line item.
outbound_click Metric
The number of clicks that take users off Pinterest to a destination URL.
outbound_click_rate Metric
The rate at which users click to leave the Pinterest platform, calculated as outbound clicks divided by impressions.
outbound_clicks Metric
Total number of clicks that lead users off of Pinterest.
outbound_ctr Dimension
The click-through rate for clicks that lead users off the Pinterest platform.
page_visit_cost_per_action Metric
The cost incurred for each page visit action, calculated as total ad spend divided by the number of page visit events.
page_visit_desktop_action_desktop_conversion Metric
The number of "page visit" conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.
page_visit_desktop_action_mobile_conversion Metric
The number of "page visit" conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.
page_visit_desktop_action_tablet_conversion Dimension
The number of "page visit" conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.
page_visit_mobile_action_desktop_conversion Metric
The number of "page visit" conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.
page_visit_mobile_action_mobile_conversion Metric
The number of "page visit" conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.
page_visit_mobile_action_tablet_conversion Metric
The number of "page visit" conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.
page_visit_roas Metric
The return on ad spend (ROAS) for page visit actions, indicating the revenue generated per dollar spent on advertising for these actions.
page_visit_tablet_action_desktop_conversion Metric
The number of "page visit" conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.
page_visit_tablet_action_mobile_conversion Metric
The number of "page visit" conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.
page_visit_tablet_action_tablet_conversion Metric
The number of "page visit" conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.
paid_average_video_watch_time Metric
The average watch time for paid video content.
paid_clicks Metric
The number of clicks attributed to paid ads.
paid_ctr Dimension
The paid click-through rate, representing the percentage of times ads were clicked after being seen.
paid_engagements Metric
The number of engagements attributed to paid ads.
paid_impression Metric
The number of impressions attributed to paid ads.
paid_impressions Metric
The total number of impressions attributed to paid ads.
paid_saves Metric
The number of saves attributed to paid ads.
paid_video_starts Metric
The number of times a paid video started playing.
paid_video_views Metric
The number of views for paid video content.
paid_video_watched_at_100% Dimension
The number of times a paid video was watched to 100% completion.
paid_video_watched_at_25% Metric
The number of times a paid video was watched to at least 25% completion.
paid_video_watched_at_50% Metric
The number of times a paid video was watched to at least 50% completion.
paid_video_watched_at_75% Metric
The number of times a paid video was watched to at least 75% completion.
paid_video_watched_at_95% Dimension
The number of times a paid video was watched to at least 95% completion.
pin_alt_text Dimension
The descriptive alternative text provided for a Pin, used for accessibility (screen readers) and to help Pinterest's algorithm understand and categorize the content.
pin_attribution Dimension
Information regarding how a conversion or action is attributed to a specific Pin, often based on defined attribution windows for clicks, engagements, or views.
pin_board_id Dimension
The unique identifier of the board to which the Pin belongs.
pin_click Metric
The number of times a Pin was clicked.
pin_click_rate Metric
The rate at which users click on a Pin.
pin_count Metric
The total number of Pins created or owned by a user account.
pin_created_at Dimension
The timestamp indicating when the Pin was created.
pin_description Dimension
The textual description provided for the Pin.
pin_id Dimension
The unique identifier for the Pin.
pin_link Dimension
The URL or link that the Pin directs users to when clicked.
pin_media Dimension
Details about the media content of the Pin, such as image URLs and dimensions for various sizes.
pin_parent_pin_id Dimension
The unique identifier of the original Pin if this Pin was saved (re-pinned) from another Pin.
pin_promotion_carousel_android_deep_links Dimension
A list of deep links for individual cards within a carousel ad, specifically for Android devices, directing users to specific in-app content when they interact with a promoted Pin. If the app is not installed, a destination URL will be used as a fallback.
pin_promotion_carousel_destination_urls Dimension
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. These serve as click-through links for each image in the carousel.
pin_promotion_click_tracking_url Dimension
The URL used to track clicks on a promoted Pin for conversion and performance monitoring.
pin_promotion_collection_items_destination_url_template Dimension
The URL template used for destination links of items within a collection Pin promotion.
pin_promotion_creative_type Dimension
The creative type of the promoted Pin, such as standard image, video, carousel, or collection.
pin_promotion_destination_url Dimension
The landing page URL where users are directed after clicking on the promoted Pin.
pin_promotion_id Dimension
The unique identifier for a promoted Pin.
pin_promotion_name Dimension
The name of the promoted Pin.
pin_promotion_pin_id Dimension
The unique identifier of the promoted Pin.
pin_promotion_review_status Dimension
The current review status of the promoted Pin, indicating if it's approved, pending, or rejected.
pin_promotion_status Dimension
The status of a promoted Pin, such as APPROVED, PAUSED, or REJECTED.
pin_promotion_tracking_urls Dimension
A collection of URLs used for tracking various events related to the promoted Pin, beyond just clicks or views.
pin_promotion_type Dimension
The type of promotion used for the Pin.
pin_promotion_view_tracking_url Dimension
A URL used for tracking ad impressions (views) for a promoted Pin. This allows advertisers to monitor the performance of their ads.
pin_title Dimension
The title of the Pin.
pinterest_checkout_cost_per_action Dimension
The average cost incurred for each checkout action completed by users originating from Pinterest ads. This is a computed metric from ad analytics.
pinterest_checkout_roas Dimension
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.
platform Dimension
The device or operating system where the content or ad is displayed, for example, Android mobile, iOS, or web.
product_group_id Dimension
The unique identifier for a product group.
product_item_id Dimension
The unique identifier for a product item within a catalog.
profile_image Dimension
The URL to the profile image of the Pinterest account.
profile_visit Metric
The total number of visits to the user's profile.
promo_id Dimension
A unique identifier for a specific promotion or promotional offer associated with advertising content.
quartile_95_percent_view Metric
The number of times a video was viewed to at least 95% completion.
repin_count Metric
The total number of times the Pin was saved or 're-pinned' to a board.
repin_rate Dimension
The rate at which Pins are saved by other users.
report_type Dimension
The classification of the report being generated, such as Advertiser Delivery Metrics, Top 100 Pins, or User Metrics, determining the kind of data collected.
save Metric
The number of times a Pin was saved to a board.
save_rate Metric
The rate at which Pins are saved by other users, calculated as saves divided by impressions.
search_desktop_action_desktop_conversion Dimension
The number of search actions leading to a conversion on a desktop device, where the initial action also occurred on a desktop device.
search_desktop_action_mobile_conversion Dimension
The number of search actions leading to a conversion on a mobile device, where the initial action occurred on a desktop device.
search_desktop_action_tablet_conversion Dimension
The number of search actions leading to a conversion on a tablet device, where the initial action occurred on a desktop device.
search_mobile_action_desktop_conversion Dimension
The number of search actions leading to a conversion on a desktop device, where the initial action occurred on a mobile device.
search_mobile_action_mobile_conversion Dimension
The number of search actions leading to a conversion on a mobile device, where the initial action also occurred on a mobile device.
search_mobile_action_tablet_conversion Dimension
The number of search actions leading to a conversion on a tablet device, where the initial action occurred on a mobile device.
search_tablet_action_desktop_conversion Dimension
The number of search actions leading to a conversion on a desktop device, where the initial action occurred on a tablet device.
search_tablet_action_mobile_conversion Dimension
The number of search actions leading to a conversion on a mobile device, where the initial action occurred on a tablet device.
search_tablet_action_tablet_conversion Dimension
The number of search actions leading to a conversion on a tablet device, where the initial action also occurred on a tablet device.
showcase_card_thumbnail_swipe_backward Dimension
The count of backward swipes on showcase card thumbnails. This is an engagement metric for showcase ad formats.
showcase_card_thumbnail_swipe_forward Dimension
The count of forward swipes on showcase card thumbnails. This is an engagement metric for showcase ad formats.
showcase_pin_clickthrough Dimension
The number of click-throughs on a Showcase Pin.
showcase_subpage_clickthrough Dimension
The total number of clickthroughs on a showcase subpage. This is an engagement metric for showcase ad formats.
showcase_subpage_closeup Dimension
The total number of closeups (enlarged views) of content on a showcase subpage. This is an engagement metric for showcase ad formats.
showcase_subpage_impression Dimension
The total number of impressions (views) of a showcase subpage. This is a visibility metric for showcase ad formats.
showcase_subpage_repin Dimension
The total number of repins (saves) from a showcase subpage. This is an engagement metric for showcase ad formats.
showcase_subpage_swipe_left Dimension
The count of left swipes on a showcase subpage. This is an engagement metric for showcase ad formats.
showcase_subpage_swipe_right Dimension
The count of right swipes on a showcase subpage. This is an engagement metric for showcase ad formats.
showcase_subpin_clickthrough Dimension
The total number of clickthroughs on a subpin within a showcase. This is an engagement metric for showcase ad formats.
showcase_subpin_impression Dimension
The total number of impressions (views) of a subpin within a showcase. This is a visibility metric for showcase ad formats.
showcase_subpin_repin Metric
The total number of repins (saves) from a subpin within a showcase. This is an engagement metric for showcase ad formats.
showcase_subpin_swipe_left Dimension
The count of left swipes on a subpin within a showcase. This is an engagement metric for showcase ad formats.
showcase_subpin_swipe_right Dimension
The count of right swipes on a subpin within a showcase. This is an engagement metric for showcase ad formats.
signup_desktop_action_desktop_conversion Metric
The number of signup actions leading to a conversion on a desktop device, where the initial action also occurred on a desktop device.
signup_desktop_action_mobile_conversion Metric
The number of signup actions leading to a conversion on a mobile device, where the initial action occurred on a desktop device.
signup_desktop_action_tablet_conversion Dimension
The number of signup actions leading to a conversion on a tablet device, where the initial action occurred on a desktop device.
signup_mobile_action_desktop_conversion Dimension
The number of signup actions leading to a conversion on a desktop device, where the initial action occurred on a mobile device.
signup_mobile_action_mobile_conversion Metric
The number of signup actions leading to a conversion on a mobile device, where the initial action also occurred on a mobile device.
signup_mobile_action_tablet_conversion Dimension
The number of signup actions leading to a conversion on a tablet device, where the initial action occurred on a mobile device.
signup_tablet_action_desktop_conversion Dimension
The number of signup actions leading to a conversion on a desktop device, where the initial action occurred on a tablet device.
signup_tablet_action_mobile_conversion Metric
The number of signup actions leading to a conversion on a mobile device, where the initial action occurred on a tablet device.
signup_tablet_action_tablet_conversion Dimension
The number of signup actions leading to a conversion on a tablet device, where the initial action also occurred on a tablet device.
spend_in_account_currency_micro Metric
The total amount of money spent on ads, expressed in microunits of the ad account's currency.
spend_in_account_currency_micro_PLN Metric
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.
spend_in_dollar Metric
The total amount of money spent on ads, expressed in US dollars.
status Dimension
The current operational state of an entity, such as a campaign, ad group, ad, or ad account. Common statuses include `ACTIVE`, `PAUSED`, or `ARCHIVED`.
targeting_description Dimension
A description of the specific targeting criteria used for an ad or ad group.
targeting_type Dimension
The category of targeting used for an ad, such as 'AGE_BUCKET', 'GENDER', 'LOCATION', or 'KEYWORD'.
targeting_value Dimension
The specific value within a targeting type, such as '45-49' for 'AGE_BUCKET' or 'female' for 'GENDER'.
title Dimension
The title of the Pin or Board.
total_add_to_cart_conversion_rate Metric
The overall conversion rate for add-to-cart events.
total_checkout_conversion_rate Dimension
The total rate at which users complete a checkout process after interacting with an ad. This measures the effectiveness of ads in driving sales.
total_clickthrough Metric
The total number of clicks on a Pin or ad that led to a destination.
total_conversion_quantity Dimension
The total number of conversions.
total_conversion_value_micro Metric
The total value of all conversions in microcurrency.
total_custom_conversion_rate Dimension
The total rate of conversions based on custom definitions. This indicates how effectively ads drive specific, advertiser-defined actions.
total_custom_value_in_micro_dollar Metric
The total value generated from custom conversions, expressed in micro-dollars. This allows advertisers to track the monetary impact of specific actions.
total_idea_pin_product_tag_visit Dimension
The total number of visits to product tags within Idea Pins.
total_impression Metric
The total number of impressions, including both paid and organic.
total_impression_frequency Metric
The average number of times an individual user saw an impression from your ads or organic pins.
total_impression_user Metric
The total number of unique users who saw an ad or Pin.
total_inapp_add_to_cart Dimension
The total number of 'add to cart' events recorded within the Pinterest app.
total_inapp_add_to_cart_value_micro Metric
The total monetary value, in micro-dollars, of 'add to cart' events recorded within the Pinterest app.
total_inapp_app_install Dimension
The total number of app install events recorded within the Pinterest app.
total_inapp_app_install_value_micro Metric
The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app.
total_inapp_checkout Dimension
The total number of in-app checkout conversions.
total_inapp_checkout_value_micro Metric
The total value of in-app checkout conversions in microcurrency.
total_inapp_click_add_to_cart Dimension
The total number of 'add to cart' events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_click_add_to_cart_value_micro Metric
The total monetary value, in micro-dollars, of 'add to cart' events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_click_app_install Dimension
The total number of app install events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_click_app_install_value_micro Metric
The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_click_checkout Dimension
The total number of checkout events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_click_checkout_value_micro Metric
The total value of in-app checkout conversions in microcurrency attributed to click actions.
total_inapp_click_search Dimension
The total number of search events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_click_search_value_micro Metric
The total monetary value, in micro-dollars, associated with search events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_click_signup Dimension
The total number of signup events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_click_signup_value_micro Metric
The total monetary value, in micro-dollars, associated with signup events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_click_unknown Dimension
The total number of undefined conversion events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_click_unknown_value_micro Metric
The total monetary value, in micro-dollars, associated with undefined conversion events recorded within the Pinterest app that were attributed to a click interaction.
total_inapp_engagement_add_to_cart Dimension
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).
total_inapp_engagement_add_to_cart_value_micro Metric
The total monetary value, in micro-dollars, of 'add to cart' events recorded within the Pinterest app that were attributed to an engagement.
total_inapp_engagement_app_install Dimension
The total number of app install events recorded within the Pinterest app that were attributed to an engagement.
total_inapp_engagement_app_install_value_micro Metric
The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app that were attributed to an engagement.
total_inapp_engagement_checkout Dimension
The total number of in-app checkout conversions attributed to engagement actions.
total_inapp_engagement_checkout_value_micro Metric
The total value of in-app checkout conversions in microcurrency attributed to engagement actions.
total_inapp_engagement_search Dimension
The total number of search events recorded within the Pinterest app that were attributed to an engagement.
total_inapp_engagement_search_value_micro Metric
The total monetary value, in micro-dollars, associated with search events recorded within the Pinterest app that were attributed to an engagement.
total_inapp_engagement_signup Dimension
The total number of in-app signup conversions attributed to engagement actions.
total_inapp_engagement_signup_value_micro Metric
The total monetary value, in micro-dollars, associated with signup events recorded within the Pinterest app that were attributed to an engagement.
total_inapp_engagement_unknown Dimension
The total number of undefined conversion events recorded within the Pinterest app that were attributed to an engagement.
total_inapp_engagement_unknown_value_micro Metric
The total monetary value, in micro-dollars, associated with undefined conversion events recorded within the Pinterest app that were attributed to an engagement.
total_inapp_search Dimension
The total number of search events recorded within the Pinterest app.
total_inapp_search_value_micro Metric
The total monetary value, in micro-dollars, of search events recorded within the Pinterest app.
total_inapp_signup Dimension
The total number of in-app signup conversions.
total_inapp_signup_value_micro Metric
The total monetary value, in micro-dollars, of signup events recorded within the Pinterest app.
total_inapp_unknown Dimension
The total number of undefined conversion events recorded within the Pinterest app.
total_inapp_unknown_value_micro Metric
The total monetary value, in micro-dollars, of undefined conversion events recorded within the Pinterest app.
total_inapp_view_add_to_cart Dimension
The total number of 'add to cart' events recorded within the Pinterest app that were attributed to a view interaction.
total_inapp_view_add_to_cart_value_micro Metric
The total monetary value, in micro-dollars, of 'add to cart' events recorded within the Pinterest app that were attributed to a view interaction.
total_inapp_view_app_install Dimension
The total number of app install events recorded within the Pinterest app that were attributed to a view interaction.
total_inapp_view_app_install_value_micro Metric
The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app that were attributed to a view interaction.
total_inapp_view_checkout Dimension
The total number of checkout events recorded within the Pinterest app that were attributed to a view interaction.
total_inapp_view_checkout_value_micro Metric
The total value of in-app checkout conversions in microcurrency attributed to view-through actions.
total_inapp_view_search Dimension
The total number of search events recorded within the Pinterest app that were attributed to a view interaction.
total_inapp_view_search_value_micro Metric
The total monetary value, in micro-dollars, associated with search events recorded within the Pinterest app that were attributed to a view interaction.
total_inapp_view_signup Dimension
The total number of signup events recorded within the Pinterest app that were attributed to a view interaction.
total_inapp_view_signup_value_micro Metric
The total monetary value, in micro-dollars, associated with signup events recorded within the Pinterest app that were attributed to a view interaction.
total_inapp_view_unknown Dimension
The total number of undefined conversion events recorded within the Pinterest app that were attributed to a view interaction.
total_inapp_view_unknown_value_micro Metric
The total monetary value, in micro-dollars, associated with undefined conversion events recorded within the Pinterest app that were attributed to a view interaction.
total_lead_conversion_rate Dimension
The total rate at which users become leads (e.g., submit a form, sign up for a newsletter) after interacting with an ad. This measures lead generation effectiveness.
total_offline_checkout Dimension
The total count of offline checkout conversions. These are conversions that occur outside of online tracking.
total_offline_checkout_value_micro Metric
The total value of offline checkout conversions in microcurrency.
total_offline_click_checkout Dimension
The total number of offline checkout events attributed to a click interaction.
total_offline_click_checkout_value_micro Metric
The total value of offline checkout conversions in microcurrency attributed to click actions.
total_offline_click_custom Dimension
The total number of custom offline events attributed to a click interaction.
total_offline_click_custom_value_micro Metric
The total monetary value, in micro-dollars, of custom offline events attributed to a click interaction.
total_offline_click_lead Dimension
The total number of offline lead events attributed to a click interaction.
total_offline_click_lead_value_micro Metric
The total monetary value, in micro-dollars, of offline lead events attributed to a click interaction.
total_offline_click_signup Dimension
The total number of offline signup events attributed to a click interaction.
total_offline_click_signup_value_micro Metric
The total monetary value, in micro-dollars, of offline signup events attributed to a click interaction.
total_offline_click_unknown Dimension
The total number of undefined offline conversion events attributed to a click interaction.
total_offline_click_unknown_value_micro Metric
The total monetary value, in micro-dollars, of undefined offline conversion events attributed to a click interaction.
total_offline_custom Dimension
The total count of custom offline conversions, defined by the advertiser.
total_offline_custom_value_micro Metric
The total monetary value, in micro-dollars, of custom offline events.
total_offline_engagement_checkout Dimension
The total number of offline checkout events attributed to an engagement (saves, closeups, link clicks, carousel swipes).
total_offline_engagement_checkout_value_micro Metric
The total value of offline checkout conversions in microcurrency attributed to engagement actions.
total_offline_engagement_custom Dimension
The total number of custom offline events attributed to an engagement.
total_offline_engagement_custom_value_micro Metric
The total monetary value, in micro-dollars, of custom offline events attributed to an engagement.
total_offline_engagement_lead Dimension
The total number of offline lead events attributed to an engagement.
total_offline_engagement_lead_value_micro Metric
The total monetary value, in micro-dollars, of offline lead events attributed to an engagement.
total_offline_engagement_signup Dimension
The total number of offline signup events attributed to an engagement.
total_offline_engagement_signup_value_micro Metric
The total monetary value, in micro-dollars, of offline signup events attributed to an engagement.
total_offline_engagement_unknown Dimension
The total number of undefined offline conversion events attributed to an engagement.
total_offline_engagement_unknown_value_micro Metric
The total monetary value, in micro-dollars, of undefined offline conversion events attributed to an engagement.
total_offline_lead Dimension
The total count of offline lead generation conversions.
total_offline_lead_value_micro Metric
The total monetary value, in micro-dollars, of offline lead events.
total_offline_signup Dimension
The total count of offline signup conversions.
total_offline_signup_value_micro Metric
The total monetary value, in micro-dollars, of offline signup events.
total_offline_unknown Dimension
The total number of undefined offline conversion events.
total_offline_unknown_value_micro Metric
The total monetary value, in micro-dollars, of undefined offline conversion events.
total_offline_view_checkout Dimension
The total number of offline checkout events attributed to a view interaction.
total_offline_view_checkout_value_micro Metric
The total value of offline checkout conversions in microcurrency attributed to view-through actions.
total_offline_view_custom Dimension
The total number of custom offline events attributed to a view interaction.
total_offline_view_custom_value_micro Metric
The total monetary value, in micro-dollars, of custom offline events attributed to a view interaction.
total_offline_view_lead Dimension
The total number of offline lead events attributed to a view interaction.
total_offline_view_lead_value_micro Metric
The total monetary value, in micro-dollars, of offline lead events attributed to a view interaction.
total_offline_view_signup Dimension
The total number of offline signup events attributed to a view interaction.
total_offline_view_signup_value_micro Metric
The total monetary value, in micro-dollars, of offline signup events attributed to a view interaction.
total_offline_view_unknown Dimension
The total number of offline views for conversions categorized as unknown.
total_offline_view_unknown_value_micro Metric
The total value of unknown offline view conversions, represented in micro-units of the advertiser's currency.
total_onsite_checkouts Metric
The total number of checkout events that occurred directly on Pinterest's platform.
total_page_visit Metric
The total number of page visit conversions.
total_page_visit_conversion_rate Dimension
The total rate at which users visit a specific page after interacting with an ad. This measures the effectiveness of ads in driving website traffic to key pages.
total_pinterest_checkout Dimension
The total number of checkout conversions that occurred directly on Pinterest.
total_pinterest_checkout_value_in_micro_dollar Metric
The total value of Pinterest checkout conversions in microdollars.
total_repin_rate Dimension
The total rate at which Pins are saved by other users.
total_search_conversion_rate Dimension
The total rate at which users perform a search action after interacting with an ad. This measures the effectiveness of ads in driving search engagement.
total_signup Dimension
The total count of all signup conversions, both online and offline.
total_signup_conversion_rate Dimension
The total rate at which users complete a signup process after interacting with an ad. This measures the effectiveness of ads in acquiring new users or subscribers.
total_signup_value_in_micro_dollar Metric
The total monetary value, in micro-dollars, attributed to signup events across all platforms.
total_unknown_conversion_rate Dimension
The total conversion rate for actions that do not fall into predefined conversion categories. This metric helps identify conversions not yet categorized.
total_video_avg_watchtime_in_second Metric
The total average watch time in seconds for video Pins.
total_video_mrc_views Metric
Total video views where the video meets the Media Rating Council (MRC) standard for a view.
total_video_p0_combined Dimension
The total number of video views combined at 0% completion (video starts).
total_video_p100_complete Metric
Total video plays at 100% completion (both paid and earned).
total_video_p25_combined Metric
Total video plays at 25% completion combined (both paid and earned).
total_video_p50_combined Metric
Total video plays at 50% completion combined (both paid and earned).
total_video_p75_combined Metric
Total video plays at 75% completion combined (both paid and earned).
total_video_p95_combined Dimension
The total number of video views combined at 95% completion.
total_view_category_conversion_rate Dimension
The total rate at which users view a specific category page after interacting with an ad. This measures the effectiveness of ads in guiding users to relevant product or content categories.
total_watch_video_conversion_rate Dimension
The total rate at which users watch a video after interacting with an ad. This measures the effectiveness of ads in driving video consumption.
total_web_add_to_cart Metric
The total number of times an item was added to a shopping cart on the web. This is an online conversion metric.
total_web_add_to_cart_value_micro Metric
The total monetary value, in micro-dollars, of 'add to cart' events recorded on the advertiser's website.
total_web_checkout Metric
The total number of website checkout conversions.
total_web_checkout_value_micro Metric
The total value of website checkout conversions in microcurrency.
total_web_click_add_to_cart Dimension
The total number of 'add to cart' events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_add_to_cart_value_micro Metric
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.
total_web_click_checkout Metric
The total number of website checkout conversions attributed to click actions.
total_web_click_checkout_value_micro Metric
The total value of website checkout conversions in microcurrency attributed to click actions.
total_web_click_custom Metric
The total number of custom events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_custom_value_micro Metric
The total monetary value, in micro-dollars, of custom events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_lead Dimension
The total number of lead events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_lead_value_micro Metric
The total monetary value, in micro-dollars, of lead events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_page_visit Metric
The total number of page visit events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_page_visit_value_micro Metric
The total monetary value, in micro-dollars, of page visit events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_search Dimension
The total number of website searches attributed to click actions.
total_web_click_search_value_micro Metric
The total monetary value, in micro-dollars, of search events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_signup Dimension
The total number of signup events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_signup_value_micro Metric
The total monetary value, in micro-dollars, of signup events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_unknown Dimension
The total number of undefined conversion events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_unknown_value_micro Metric
The total monetary value, in micro-dollars, of undefined conversion events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_view_category Metric
The total number of category view events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_view_category_value_micro Metric
The total monetary value, in micro-dollars, of category view events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_watch_video Dimension
The total number of video watch events recorded on the advertiser's website that were attributed to a click interaction.
total_web_click_watch_video_value_micro Metric
The total monetary value, in micro-dollars, of video watch events recorded on the advertiser's website that were attributed to a click interaction.
total_web_custom Metric
The total number of custom events recorded on the advertiser's website.
total_web_custom_value_micro Metric
The total monetary value, in micro-dollars, of custom events recorded on the advertiser's website.
total_web_engagement_add_to_cart Dimension
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).
total_web_engagement_add_to_cart_value_micro Metric
The total monetary value, in micro-dollars, of 'add to cart' events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_checkout Dimension
The total number of checkout events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_checkout_value_micro Metric
The total value of website checkout conversions in microcurrency attributed to engagement actions.
total_web_engagement_custom Dimension
The total number of custom events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_custom_value_micro Metric
The total monetary value, in micro-dollars, of custom events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_lead Dimension
The total number of lead events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_lead_value_micro Metric
The total monetary value, in micro-dollars, of lead events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_page_visit Dimension
The total number of page visit events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_page_visit_value_micro Metric
The total monetary value, in micro-dollars, of page visit events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_search Dimension
The total number of search events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_search_value_micro Metric
The total monetary value, in micro-dollars, of search events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_signup Dimension
The total number of signup events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_signup_value_micro Metric
The total monetary value, in micro-dollars, of signup events recorded on the advertiser's website that were attributed to an engagement.
total_web_engagement_unknown Dimension
Total number of engagement events on the website that do not fit into other defined categories.
total_web_engagement_unknown_value_micro Metric
Total value of engagement events on the website that do not fit into other defined categories, in micro-currency.
total_web_engagement_view_category Dimension
Total number of web engagement events where a category was viewed.
total_web_engagement_view_category_value_micro Metric
Total value of web engagement events involving category views, in micro-currency.
total_web_engagement_watch_video Dimension
Total number of web engagement events where a video was watched.
total_web_engagement_watch_video_value_micro Metric
Total value of web engagement events involving video watches, in micro-currency.
total_web_lead Metric
Total number of lead conversion events recorded on the website.
total_web_lead_value_micro Metric
Total value of lead conversion events recorded on the website, in micro-currency.
total_web_page_visit Dimension
Total number of page visit conversion events on the website.
total_web_page_visit_value_micro Metric
Total value of page visit conversion events on the website, in micro-currency.
total_web_search Metric
Total number of search conversion events on the website.
total_web_search_value_micro Metric
Total value of search conversion events on the website, in micro-currency.
total_web_sessions Metric
The total number of web sessions initiated by users.
total_web_signup Metric
Total number of signup conversion events on the website.
total_web_signup_value_micro Metric
Total value of signup conversion events on the website, in micro-currency.
total_web_unknown Dimension
Total number of unknown web conversion events.
total_web_unknown_value_micro Metric
Total value of unknown web conversion events, in micro-currency.
total_web_view_add_to_cart Metric
Total number of web add-to-cart events resulting from a view.
total_web_view_add_to_cart_value_micro Metric
Total value of web add-to-cart events resulting from a view, in micro-currency.
total_web_view_category Dimension
Total number of web category view events.
total_web_view_category_value_micro Metric
The total value of website view category conversions in microcurrency.
total_web_view_checkout Metric
The total number of website checkout conversions attributed to view-through actions.
total_web_view_checkout_value_micro Metric
The total value of website checkout conversions in microcurrency attributed to view-through actions.
total_web_view_custom Metric
The total number of custom web conversions attributed to views.
total_web_view_custom_value_micro Metric
The total value of custom web conversions attributed to views, expressed in microunits.
total_web_view_lead Metric
Total number of lead events on the website resulting from a view.
total_web_view_lead_value_micro Metric
Total value of lead events on the website resulting from a view, in micro-currency.
total_web_view_page_visit Metric
Total number of page visit events on the website resulting from a view.
total_web_view_page_visit_value_micro Metric
Total value of page visit events on the website resulting from a view, in micro-currency.
total_web_view_search Dimension
The total number of website searches attributed to view-through actions.
total_web_view_search_value_micro Metric
The total value generated from viewing search results on the web, represented in micro-units of the advertiser's currency.
total_web_view_signup Metric
Total number of signup events on the website resulting from a view.
total_web_view_signup_value_micro Metric
Total value of signup events on the website resulting from a view, in micro-currency.
total_web_view_unknown Dimension
Total number of unknown web events resulting from a view.
total_web_view_unknown_value_micro Metric
The total value of unknown web conversions attributed to views, expressed in microunits.
total_web_view_view_category Metric
The total number of views of product categories on the web. This is an online engagement or conversion metric.
total_web_view_view_category_value_micro Metric
The total value generated from viewing product categories on the web, represented in micro-units of the advertiser's currency.
total_web_view_watch_video Dimension
Total number of video watch events on the website resulting from a view.
total_web_view_watch_video_value_micro Metric
Total value of video watch events on the website resulting from a view, in micro-currency.
total_web_watch_video_value_micro Metric
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.
unknown_desktop_action_desktop_conversion Dimension
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.
unknown_desktop_action_mobile_conversion Dimension
The number of conversions where the initial action was an unknown event on a desktop device, and the conversion occurred on a mobile device.
unknown_desktop_action_tablet_conversion Dimension
The number of conversions where the initial action was an unknown event on a desktop device, and the conversion occurred on a tablet device.
unknown_mobile_action_desktop_conversion Dimension
The number of conversions where the initial action was an unknown event on a mobile device, and the conversion occurred on a desktop device.
unknown_mobile_action_mobile_conversion Dimension
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.
unknown_mobile_action_tablet_conversion Dimension
The number of conversions where the initial action was an unknown event on a mobile device, and the conversion occurred on a tablet device.
unknown_tablet_action_desktop_conversion Dimension
The number of conversions where the initial action was an unknown event on a tablet device, and the conversion occurred on a desktop device.
unknown_tablet_action_mobile_conversion Dimension
The number of conversions where the initial action was an unknown event on a tablet device, and the conversion occurred on a mobile device.
unknown_tablet_action_tablet_conversion Dimension
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.
username Dimension
The username of the account owner or Pin creator.
value_micro_(app_install) Metric
The monetary value associated with an app install conversion event, in micro-currency.
video_10s_view Metric
The number of times the video was viewed for at least 10 seconds.
video_avg_watch_time Metric
The average time users spent watching video Pins, measured in seconds.
video_mrc_view Metric
The number of video views that meet the Media Rating Council (MRC) standard for viewability.
video_start Metric
The number of times a video started playing.
video_v50_watch_time Metric
The average watch time for videos watched to at least 50% completion.
view_category_desktop_action_desktop_conversion Metric
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.
view_category_desktop_action_mobile_conversion Dimension
The number of conversions where the initial action was viewing a category on a desktop device, and the conversion occurred on a mobile device.
view_category_desktop_action_tablet_conversion Dimension
The number of conversions where the initial action was viewing a category on a desktop device, and the conversion occurred on a tablet device.
view_category_mobile_action_desktop_conversion Dimension
The number of conversions where the initial action was viewing a category on a mobile device, and the conversion occurred on a desktop device.
view_category_mobile_action_mobile_conversion Metric
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.
view_category_mobile_action_tablet_conversion Dimension
The number of conversions where the initial action was viewing a category on a mobile device, and the conversion occurred on a tablet device.
view_category_tablet_action_desktop_conversion Dimension
The number of conversions where the initial action was viewing a category on a tablet device, and the conversion occurred on a desktop device.
view_category_tablet_action_mobile_conversion Dimension
The number of conversions where the initial action was viewing a category on a tablet device, and the conversion occurred on a mobile device.
view_category_tablet_action_tablet_conversion Dimension
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.
viewthrough_conversions_(add_to_cart) Metric
The number of add-to-cart conversions attributed to a view-through action.
viewthrough_conversions_(app_install) Dimension
The number of app install conversions attributed to view-through actions.
viewthrough_conversions_(category_view) Dimension
The number of category view conversions attributed to view-through actions.
viewthrough_conversions_(checkout) Metric
The number of checkout conversions attributed to a view-through action (user saw an ad but did not click, then converted).
viewthrough_conversions_(custom) Dimension
The number of custom conversions attributed to view-through actions.
viewthrough_conversions_(lead) Dimension
The number of lead conversions attributed to a view-through action.
viewthrough_conversions_(page_visit) Metric
The number of page visit conversions attributed to a view-through action.
viewthrough_conversions_(signup) Metric
The number of signup conversions attributed to a view-through action.
viewthrough_conversions_(unknown) Dimension
The number of view-through conversions of an unknown type.
viewthrough_conversions_(watch_video) Dimension
The number of watch video conversions attributed to view-through actions.
viewthrough_conversions_(website_search) Dimension
The number of website search conversions attributed to view-through actions.
viewthrough_order_quantity_(checkout) Metric
The quantity of items purchased in checkout conversions attributed to a view-through action.
viewthrough_value_micro_(add_to_cart) Metric
The monetary value of view-through add-to-cart conversions, in micro-currency.
viewthrough_value_micro_(app_install) Metric
The monetary value of view-through app install conversions, in micro-currency.
viewthrough_value_micro_(category_view) Metric
The monetary value of view-through category view conversions, in micro-currency.
viewthrough_value_micro_(custom) Dimension
The monetary value of view-through custom conversions, in micro-currency.
viewthrough_value_micro_(lead) Metric
The value of lead conversions in microcurrency attributed to a view-through action.
viewthrough_value_micro_(page_visit) Dimension
The monetary value of view-through page visit conversions, in micro-currency.
viewthrough_value_micro_(signup) Metric
The value of signup conversions in microcurrency attributed to a view-through action.
viewthrough_value_micro_(unknown) Metric
The monetary value of view-through unknown conversions, in micro-currency.
viewthrough_value_micro_(watch_video) Metric
The monetary value of view-through video watch conversions, in micro-currency.
viewthrough_value_micro_(website_search) Metric
The monetary value of view-through website search conversions, in micro-currency.
watch_video_desktop_action_desktop_conversion Dimension
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.
watch_video_desktop_action_mobile_conversion Dimension
The number of conversions where the initial action was watching a video on a desktop device, and the conversion occurred on a mobile device.
watch_video_desktop_action_tablet_conversion Dimension
The number of conversions where the initial action was watching a video on a desktop device, and the conversion occurred on a tablet device.
watch_video_mobile_action_desktop_conversion Dimension
The number of conversions where the initial action was watching a video on a mobile device, and the conversion occurred on a desktop device.
watch_video_mobile_action_mobile_conversion Dimension
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.
watch_video_mobile_action_tablet_conversion Dimension
The number of conversions where the initial action was watching a video on a mobile device, and the conversion occurred on a tablet device.
watch_video_tablet_action_desktop_conversion Dimension
The number of conversions where the initial action was watching a video on a tablet device, and the conversion occurred on a desktop device.
watch_video_tablet_action_mobile_conversion Dimension
The number of conversions where the initial action was watching a video on a tablet device, and the conversion occurred on a mobile device.
watch_video_tablet_action_tablet_conversion Dimension
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.
web_add_to_cart_cost_per_action Metric
The average cost incurred for each add-to-cart action performed on the website.
web_add_to_cart_roas Metric
The Return on Ad Spend (ROAS) for add-to-cart actions on the website.
web_checkout_cost_per_action Metric
The average cost incurred for each checkout action performed on the website.
web_checkout_roas Metric
The Return on Ad Spend (ROAS) for checkout actions on the website.
web_custom_cost_per_action Metric
The average cost incurred for each custom action performed on the website.
web_custom_roas Metric
The Return on Ad Spend (ROAS) for custom actions on the website.
web_lead_cost_per_action Metric
The average cost incurred for each lead action performed on the website.
web_lead_roas Dimension
The Return on Ad Spend (ROAS) for lead actions on the website.
web_page_visit_cost_per_action Metric
The average cost incurred for each page visit action performed on the website.
web_page_visit_roas Metric
The Return on Ad Spend (ROAS) for page visit actions on the website.
web_search_cost_per_action Dimension
The average cost incurred for each search action performed on the website.
web_search_roas Dimension
The Return on Ad Spend (ROAS) for search actions on the website.
web_signup_cost_per_action Metric
The average cost incurred for each signup action performed on the website.
web_signup_roas Dimension
The Return on Ad Spend (ROAS) for signup actions on the website.
web_unknown_cost_per_action Dimension
The average cost incurred for each unknown action performed on the website.
web_unknown_roas Dimension
The Return on Ad Spend (ROAS) for unknown actions on the website.
web_view_category_cost_per_action Metric
The average cost incurred for each category view action performed on the website.
web_view_category_roas Dimension
The Return on Ad Spend (ROAS) for category view actions on the website.
web_watch_video_cost_per_action Dimension
The average cost incurred for each video watch action performed on the website.
web_watch_video_roas Dimension
The Return on Ad Spend (ROAS) for video watch actions on the website.
website_url Dimension
The destination URL or external website link associated with a Pin or ad.