Pinterest: Most-used fields

Pinterest: Most-used fields#

The table below gives information about most-used fields that you can import from Pinterest. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name

Adverity UI name

Description

Use in Adverity

3-Second Video Views

3-Second Video Views

Total video views that lasted for at least 3 seconds.

metric

ADVERTISER_ID

ADVERTISER_ID

Unique identifier for the advertiser account.

dimension

AD_ACCOUNT_ID

AD_ACCOUNT_ID

The unique identifier for the ad account.

dimension

AD_GROUP_ENTITY_STATUS

AD_GROUP_ENTITY_STATUS

The status of the ad group entity, indicating if it is active, paused, or archived.

metric

AD_GROUP_ID

AD_GROUP_ID

The unique identifier for the ad group.

dimension

AD_ID

AD_ID

The unique identifier for the ad.

dimension

APPTYPE

APPTYPE

The type of application (e.g., mobile app, web app) associated with an event or targeting.

dimension

Account

Account

The advertiser account associated with the data.

dimension

Ad Group

Ad Group

The name of the ad group.

dimension

Ad ID

Ad ID

The unique identifier for an individual advertisement.

metric

Ad Type

Ad Type

The category or type of advertisement.

dimension

Ad group

Ad group

The name of the ad group to which an ad belongs.

dimension

Ad group ID

Ad group ID

Unique identifier for the ad group.

dimension

Ad group name

Ad group name

The name of the ad group.

dimension

Ad name

Ad name

The name of the advertisement.

dimension

Advertiser

Advertiser

Unique identifier for the advertiser account.

dimension

Advertiser Group Name

Advertiser Group Name

The name of the advertiser group.

dimension

Advertiser ID

Advertiser ID

Unique identifier for the advertiser account.

metric

Advertiser Name

Advertiser Name

The name of the advertiser account.

dimension

Advertiser name

Advertiser name

The name of the advertiser account.

dimension

Age

Age

The age demographic used for audience segmentation or targeting.

dimension

Agency

Agency

The advertising agency managing the campaigns for the advertiser.

dimension

App Type

App Type

The type of app or device associated with the Pin activity, such as Mobile, Tablet, or Web.

dimension

CAMPAIGN_DAILY_SPEND_CAP

CAMPAIGN_DAILY_SPEND_CAP

The maximum daily spending limit set for an advertising campaign.

metric

CAMPAIGN_ENTITY_STATUS

CAMPAIGN_ENTITY_STATUS

The status of the campaign entity (e.g., active, paused, archived).

metric

CAMPAIGN_ID

CAMPAIGN_ID

Unique identifier for the campaign.

dimension

CAMPAIGN_LIFETIME_SPEND_CAP

CAMPAIGN_LIFETIME_SPEND_CAP

The maximum lifetime spending limit set for an advertising campaign.

metric

CAMPAIGN_NAME

CAMPAIGN_NAME

The name of the campaign.

dimension

CAMPAIGN_OBJECTIVE_TYPE

CAMPAIGN_OBJECTIVE_TYPE

The objective set for the campaign (e.g., brand awareness, traffic, conversions).

metric

CLICKTHROUGH_1

CLICKTHROUGH_1

The total number of Pin clicks from ads saved to another person’s board (earned clicks).

metric

CLICKTHROUGH_2

CLICKTHROUGH_2

A metric indicating the second type or attribution window of clickthroughs.

metric

COST_PER_LEAD

COST_PER_LEAD

The average cost incurred for each lead conversion.

dimension

CPC

CPC

The average cost incurred for each click on an ad or Pin (Cost Per Click).

metric

CPC_IN_MICRO_DOLLAR

CPC_IN_MICRO_DOLLAR

The cost per click (CPC) in microdollars (1/1,000,000 of a US dollar).

metric

CPM_IN_DOLLAR

CPM_IN_DOLLAR

The cost per mille (thousand impressions), in dollars.

dimension

CPM_IN_MICRO_DOLLAR

CPM_IN_MICRO_DOLLAR

The cost per mille (thousand impressions) (CPM) in microdollars (1/1,000,000 of a US dollar).

metric

CTR

CTR

The clickthrough rate, calculated as clicks divided by impressions.

metric

Campaign

Campaign

The name of the advertising campaign.

dimension

Campaign ID

Campaign ID

Unique identifier for the ad campaign.

dimension

Campaign name

Campaign name

The name of the ad campaign.

dimension

Channel

Channel

The advertising channel.

dimension

Clicks

Clicks

The total number of clicks on a Pin or ad.

metric

Client

Client

The client associated with the advertising campaigns.

dimension

Conversions (Checkout)

Conversions (Checkout)

The total number of checkout conversion events.

dimension

Conversions (Custom)

Conversions (Custom)

The total number of custom conversion events.

metric

Conversions (Lead)

Conversions (Lead)

The total number of lead conversion events.

dimension

Cost

Cost

The total cost incurred for ad delivery in the account’s primary currency.

metric

Cost_eur

Cost_eur

The total cost incurred for ad delivery, expressed in Euros.

metric

Cost_usd

Cost_usd

The total cost incurred for ad delivery, expressed in US Dollars.

metric

Country

Country

The country targeted by the ad campaign.

dimension

Creative Type

Creative Type

The type of creative used in the ad (e.g., image, video, carousel).

dimension

Currency

Currency

The currency used for reporting costs and conversion values.

dimension

DATE

DATE

The date for which the metrics are reported.

dimension

Date

Date

The date for which the data record is reported.

dimension

Day

Day

The specific day for which the data is reported.

dimension

Device

Device

The type of device used for audience segmentation or targeting.

dimension

ECPC_IN_DOLLAR

ECPC_IN_DOLLAR

The Effective Cost Per Click (ECPC), expressed in US Dollars.

metric

ECPC_IN_MICRO_DOLLAR

ECPC_IN_MICRO_DOLLAR

The effective cost per click (eCPC) in microdollars (1/1,000,000 of a US dollar).

metric

ECPE_IN_DOLLAR

ECPE_IN_DOLLAR

The Effective Cost Per Engagement (ECPE), expressed in US Dollars.

metric

ECPM

ECPM

The effective cost per mille (thousand impressions).

metric

ECPM_IN_MICRO_DOLLAR

ECPM_IN_MICRO_DOLLAR

The effective cost per mille (thousand impressions) (eCPM) in microdollars (1/1,000,000 of a US dollar).

metric

ENGAGEMENT_RATE

ENGAGEMENT_RATE

The rate of user engagement with ads or Pins, calculated as engagements divided by impressions.

metric

Earned 3-Second Video Views

Earned 3-Second Video Views

The number of organic video views where the video played for at least 3 seconds. This metric is related to organic video performance.

metric

Earned CTR

Earned CTR

The click-through rate for organic content.

metric

Earned Pin clicks

Earned Pin clicks

The number of clicks on Pins that were not promoted (organic clicks).

metric

Earned impressions

Earned impressions

The number of impressions generated through organic (non-paid) reach.

metric

Engagement rate

Engagement rate

The rate at which users engage with a Pin or ad.

metric

Engagements

Engagements

The total number of engagements on content, such as closeups, link clicks, or saves.

metric

GENDER

GENDER

The gender demographic used for audience segmentation or targeting.

dimension

Gender

Gender

The gender demographic used for audience segmentation or targeting.

dimension

ID Advertiser Group

ID Advertiser Group

The unique identifier for an advertiser group.

metric

Id

Id

A unique identifier for an entity, such as an ad, campaign, ad group, or Pin.

dimension

Impressions

Impressions

The total number of times an ad or Pin was displayed.

metric

Industry

Industry

The industry sector to which the advertiser belongs.

dimension

Keyword

Keyword

Keywords used for targeting ads to specific user searches or interests.

dimension

LEADS

LEADS

The total number of lead conversions.

dimension

LOCATION

LOCATION

The geographical location associated with an audience or targeting.

dimension

Location

Location

The geographical location targeted by the ad campaign.

dimension

Location Code

Location Code

The code representing the geographical location targeted.

dimension

Order quantity (Checkout)

Order quantity (Checkout)

The total quantity of items purchased in checkout conversions.

dimension

Order value (Checkout)

Order value (Checkout)

The monetary value of checkout conversions.

metric

PAID_IMPRESSION

PAID_IMPRESSION

The number of impressions attributed to paid ads.

metric

PIN_ID

PIN_ID

The unique identifier for the Pin.

dimension

PIN_PROMOTION_ID

PIN_PROMOTION_ID

Unique identifier for a promoted Pin.

dimension

PIN_PROMOTION_NAME

PIN_PROMOTION_NAME

The name of the promoted Pin campaign or ad.

dimension

Paid CTR

Paid CTR

The click-through rate for paid advertisements.

dimension

Paid Pin clicks

Paid Pin clicks

The number of clicks on promoted Pins.

metric

Paid impressions

Paid impressions

The number of impressions generated through paid advertising.

metric

Pin clicks

Pin clicks

The total number of clicks on Pins, including both organic and paid.

metric

Placement

Placement

The specific location or context within Pinterest where an ad is displayed.

dimension

Platform

Platform

The platform where the ad or content was displayed.

dimension

Platform Engagements

Platform Engagements

The total number of user engagements (e.g., clicks, saves) on the platform.

metric

REPIN_1

REPIN_1

A metric representing the number of times a Pin has been saved (re-pinned) by users.

metric

REPIN_2

REPIN_2

A metric indicating the second type or attribution window of repins (saves) on Pinterest.

metric

REPIN_RATE

REPIN_RATE

The rate at which Pins are re-pinned or saved by users.

dimension

SHOWCASE_PIN_CLICKTHROUGH

SHOWCASE_PIN_CLICKTHROUGH

The number of clickthroughs on a Showcase Pin.

dimension

SHOWCASE_SUBPAGE_REPIN

SHOWCASE_SUBPAGE_REPIN

The number of saves (re-pins) on a subpage within a Showcase Pin.

dimension

SHOWCASE_SUBPIN_REPIN

SHOWCASE_SUBPIN_REPIN

The number of saves (re-pins) on a sub-Pin within a Showcase Pin.

dimension

SPEND_IN_DOLLAR

SPEND_IN_DOLLAR

The total amount of money spent on ads, expressed in US dollars.

metric

SPEND_IN_MICRO_DOLLAR

SPEND_IN_MICRO_DOLLAR

The total amount of money spent on ads, expressed in microdollars.

metric

Spend

Spend

The total amount of money spent on an ad campaign.

metric

Spend Order Line Id

Spend Order Line Id

Unique identifier for the order line associated with the spend.

metric

Spend Order Line Paid Type

Spend Order Line Paid Type

The type of payment or billing associated with the order line spend.

dimension

Spend in account currency

Spend in account currency

The total amount spent, expressed in the currency of the ad account.

metric

TARGETING_STRATEGY

TARGETING_STRATEGY

The strategy employed for targeting ads or content to specific audiences.

dimension

TOTAL_CHECKOUT

TOTAL_CHECKOUT

The total number of checkout conversion events.

metric

TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR

TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total monetary value of checkout conversion events, in micro-currency.

metric

TOTAL_CLICKTHROUGH

TOTAL_CLICKTHROUGH

The total number of clicks on an ad or Pin that led to a destination.

metric

TOTAL_CLICK_ADD_TO_CART

TOTAL_CLICK_ADD_TO_CART

The total number of add-to-cart events resulting from clicks.

metric

TOTAL_CLICK_CHECKOUT

TOTAL_CLICK_CHECKOUT

The total number of checkout events attributed to clicks.

metric

TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR

TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout events resulting from clicks.

metric

TOTAL_CLICK_LEAD

TOTAL_CLICK_LEAD

The total number of lead conversions attributed to clicks.

dimension

TOTAL_CLICK_SIGNUP

TOTAL_CLICK_SIGNUP

The total number of sign-up events resulting from clicks.

metric

TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR

TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of sign-up events resulting from clicks.

metric

TOTAL_CONVERSIONS

TOTAL_CONVERSIONS

The total number of all conversion events.

metric

TOTAL_CUSTOM

TOTAL_CUSTOM

The total number of custom conversion events.

metric

TOTAL_CUSTOM_VALUE_IN_MICRO_DOLLAR

TOTAL_CUSTOM_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of custom conversion events.

metric

TOTAL_ENGAGEMENT

TOTAL_ENGAGEMENT

The total number of engagements with an ad or Pin (e.g., saves, closeups, link clicks).

metric

TOTAL_ENGAGEMENT_CHECKOUT

TOTAL_ENGAGEMENT_CHECKOUT

The total number of checkout events attributed to engagements.

dimension

TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR

TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout events resulting from user engagement.

metric

TOTAL_ENGAGEMENT_LEAD

TOTAL_ENGAGEMENT_LEAD

The total number of lead conversions attributed to engagements.

dimension

TOTAL_ENGAGEMENT_SIGNUP

TOTAL_ENGAGEMENT_SIGNUP

The total number of sign-up events resulting from user engagement.

dimension

TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR

TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of sign-up events resulting from user engagement.

metric

TOTAL_IMPRESSION

TOTAL_IMPRESSION

The total number of impressions, including both paid and organic.

metric

TOTAL_LEAD

TOTAL_LEAD

The total number of lead conversions.

dimension

TOTAL_OFFLINE_CHECKOUT

TOTAL_OFFLINE_CHECKOUT

The total number of offline checkout events.

dimension

TOTAL_PAGE_VISIT

TOTAL_PAGE_VISIT

The total number of page visit events.

dimension

TOTAL_SIGNUP

TOTAL_SIGNUP

The total number of sign-up events.

metric

TOTAL_SIGNUP_VALUE_IN_MICRO_DOLLAR

TOTAL_SIGNUP_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of sign-up events.

metric

TOTAL_VIDEO_3SEC_VIEWS

TOTAL_VIDEO_3SEC_VIEWS

Total video views that lasted for at least 3 seconds.

metric

TOTAL_VIDEO_AVG_WATCHTIME_IN_SECOND

TOTAL_VIDEO_AVG_WATCHTIME_IN_SECOND

The average watch time for video content, measured in seconds.

dimension

TOTAL_VIDEO_MRC_VIEWS

TOTAL_VIDEO_MRC_VIEWS

Total video views where the video meets the Media Rating Council (MRC) standard for a view.

metric

TOTAL_VIDEO_P0_COMBINED

TOTAL_VIDEO_P0_COMBINED

The total video plays from the first quartile (P0) across both organic and paid video Pins.

metric

TOTAL_VIDEO_P100_COMPLETE

TOTAL_VIDEO_P100_COMPLETE

Total video plays at 100% completion (both paid and earned).

metric

TOTAL_VIDEO_P25_COMBINED

TOTAL_VIDEO_P25_COMBINED

Total video plays at 25% completion combined (both paid and earned).

metric

TOTAL_VIDEO_P50_COMBINED

TOTAL_VIDEO_P50_COMBINED

Total video plays at 50% completion combined (both paid and earned).

metric

TOTAL_VIDEO_P75_COMBINED

TOTAL_VIDEO_P75_COMBINED

Total video plays at 75% completion combined (both paid and earned).

metric

TOTAL_VIDEO_P95_COMBINED

TOTAL_VIDEO_P95_COMBINED

The combined total of video views where at least 95% of the video content was watched.

metric

TOTAL_VIEW_ADD_TO_CART

TOTAL_VIEW_ADD_TO_CART

The total number of add-to-cart events attributed to views.

dimension

TOTAL_VIEW_CHECKOUT

TOTAL_VIEW_CHECKOUT

The total number of checkout events attributed to views.

metric

TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR

TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout events resulting from views.

metric

TOTAL_VIEW_LEAD

TOTAL_VIEW_LEAD

The total number of lead events attributed to views.

dimension

TOTAL_VIEW_SIGNUP

TOTAL_VIEW_SIGNUP

The total number of sign-up events resulting from views.

metric

TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR

TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of sign-up events resulting from views.

metric

TOTAL_WEB_CHECKOUT

TOTAL_WEB_CHECKOUT

The total number of web checkout events.

metric

TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR

TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of web checkout events.

metric

TOTAL_WEB_CLICK_CHECKOUT

TOTAL_WEB_CLICK_CHECKOUT

The total number of web checkout events resulting from clicks.

dimension

TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR

TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of web checkout events resulting from clicks.

metric

TOTAL_WEB_ENGAGEMENT_CHECKOUT

TOTAL_WEB_ENGAGEMENT_CHECKOUT

The total number of web checkout events resulting from engagement.

dimension

TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR

TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of web checkout events resulting from engagement.

metric

TOTAL_WEB_SESSIONS

TOTAL_WEB_SESSIONS

The total number of website sessions initiated from Pinterest.

dimension

TOTAL_WEB_VIEW_CHECKOUT

TOTAL_WEB_VIEW_CHECKOUT

The total number of web checkout events resulting from views.

metric

TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR

TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of web checkout events resulting from views.

metric

Total 3-Second Video Views

Total 3-Second Video Views

Total video views that lasted for at least 3 seconds.

metric

VIDEO_LENGTH

VIDEO_LENGTH

The total length or duration of the video content in seconds.

metric

Vertical

Vertical

The business vertical of the advertiser or associated with the content.

dimension

Video Completes

Video Completes

The number of times a video ad was watched to completion.

dimension

ViewableImpressions

ViewableImpressions

The number of impressions that were considered viewable according to industry standards.

dimension

WEB_CHECKOUT_ROAS

WEB_CHECKOUT_ROAS

The Return on Ad Spend (ROAS) specifically for web checkout conversions.

metric

Web conversions (Watch video)

Web conversions (Watch video)

The number of website conversions where the user watched a video.

dimension

_3-Second Video Views

_3-Second Video Views

Total video views that lasted for at least 3 seconds.

metric

account_id

account_id

The unique identifier for the advertiser account.

dimension

account_timezone

account_timezone

The timezone configured for the advertiser’s account.

dimension

account_type

account_type

The type of Pinterest account (e.g., personal, business).

dimension

ad_account_AD_ACCOUNT_ID

ad_account_AD_ACCOUNT_ID

Unique identifier for the ad account.

dimension

ad_account_country

ad_account_country

The country associated with the ad account.

dimension

ad_account_created_time

ad_account_created_time

The creation time of the ad account in Unix timestamp (seconds).

dimension

ad_account_currency

ad_account_currency

The currency used by the ad account.

dimension

ad_account_external_id

ad_account_external_id

A unique identifier for the ad account.

dimension

ad_account_external_name

ad_account_external_name

The external-facing name of the ad account.

dimension

ad_account_id

ad_account_id

The unique identifier for the ad account.

dimension

ad_account_name

ad_account_name

The name of the ad account.

dimension

ad_account_owner

ad_account_owner

Details about the user account that owns the ad account, including username and ID.

dimension

ad_account_owner_id

ad_account_owner_id

Unique identifier for the owner of the ad account.

dimension

ad_account_permissions

ad_account_permissions

The list of permissions granted for business access to the ad account.

dimension

ad_account_updated_time

ad_account_updated_time

The last update time of the ad account in Unix timestamp (seconds).

dimension

ad_ad_account_id

ad_ad_account_id

The unique identifier of the ad account associated with the ad.

dimension

ad_ad_group_id

ad_ad_group_id

The unique identifier of the ad group associated with the ad.

dimension

ad_android_deep_link

ad_android_deep_link

The deep link URL for Android users clicking on the ad, directing them to specific content within an app.

dimension

ad_campaign_id

ad_campaign_id

Unique identifier for the ad campaign.

dimension

ad_carousel_destination_urls

ad_carousel_destination_urls

A list of destination URLs for each card in a carousel ad.

dimension

ad_click_tracking_url

ad_click_tracking_url

The URL used for tracking clicks on the ad.

dimension

ad_destination_url

ad_destination_url

The primary URL where users are directed after clicking the ad.

dimension

ad_format

ad_format

The general format of the advertisement (e.g., standard image, video, carousel).

dimension

ad_format_type

ad_format_type

The specific type or sub-category of the ad format.

dimension

ad_group_auto_targeting_enabled

ad_group_auto_targeting_enabled

Indicates if auto-targeting (also known as expanded targeting) is enabled for the ad group.

dimension

ad_group_bid_in_micro_currency

ad_group_bid_in_micro_currency

The bid price for the ad group in microcurrency (1/1,000,000 of the standard currency unit). This is required for specific campaign objective/billable event combinations.

metric

ad_group_bid_in_micro_currency_float

ad_group_bid_in_micro_currency_float

The bid amount set for an ad group, expressed in micro-units of the account’s currency.

dimension

ad_group_bid_strategy_type

ad_group_bid_strategy_type

The bid strategy type for the ad group, such as AUTOMATIC_BID, MAX_BID, or TARGET_AVG.

dimension

ad_group_billable_event

ad_group_billable_event

The billable event type for the ad group, such as CLICKTHROUGH, IMPRESSION, or VIDEO_V_50_MRC.

dimension

ad_group_budget_in_micro_currency

ad_group_budget_in_micro_currency

The budget for the ad group in microcurrency (1/1,000,000 of the standard currency unit). This is required for non-CBO campaigns.

dimension

ad_group_budget_in_micro_currency_float

ad_group_budget_in_micro_currency_float

The budget allocated for an ad group, expressed in micro-units of the account’s currency.

dimension

ad_group_budget_type

ad_group_budget_type

The budget type for the ad group, either DAILY or LIFETIME.

dimension

ad_group_conversion_learning_mode_type

ad_group_conversion_learning_mode_type

The conversion learning mode type for the ad group, indicating how the optimization goal is learning.

dimension

ad_group_created_time

ad_group_created_time

The creation time of the ad group in Unix timestamp (seconds).

dimension

ad_group_dca_assets

ad_group_dca_assets

Dynamic Creative Assembly (DCA) assets used for the ad group, which allows for automatically generated optimized ad combinations.

dimension

ad_group_end_time

ad_group_end_time

The end time of the ad group in Unix timestamp (seconds).

dimension

ad_group_entity_status

ad_group_entity_status

The status of the ad group entity, indicating if it is active, paused, or archived.

dimension

ad_group_feed_profile_id

ad_group_feed_profile_id

The Feed Profile ID associated with the ad group.

dimension

ad_group_id

ad_group_id

The unique identifier for the ad group.

dimension

ad_group_lifetime_frequency_cap

ad_group_lifetime_frequency_cap

A limit on the number of times a promoted Pin from this ad group can be impressed by a Pinner within a rolling 30-day period.

metric

ad_group_name

ad_group_name

The name of the ad group.

dimension

ad_group_optimization_goal

ad_group_optimization_goal

The primary objective or goal set for an ad group to optimize its performance, such as conversions or impressions.

dimension

ad_group_optimization_goal_metadata

ad_group_optimization_goal_metadata

Metadata defining the optimization goals for objective-based performance campaigns for the ad group. This is required when the campaign’s objective type is ‘WEB_CONVERSION’.

dimension

ad_group_pacing_delivery_type

ad_group_pacing_delivery_type

The pacing delivery type for the ad group, either STANDARD (spent smoothly) or ACCELERATED (spent as fast as possible).

dimension

ad_group_placement_group

ad_group_placement_group

The specific placement group where an ad group is shown, such as a product group.

dimension

ad_group_start_time

ad_group_start_time

The start time of the ad group in Unix timestamp (seconds).

dimension

ad_group_status

ad_group_status

The current status of the ad group, such as ACTIVE, PAUSED, or ARCHIVED.

dimension

ad_group_summary_status

ad_group_summary_status

The summary status for the ad group, such as RUNNING, PAUSED, or ARCHIVED.

dimension

ad_group_targeting_spec

ad_group_targeting_spec

Specifications for audience targeting applied to an ad group, used for breaking down ad performance reports by targeting type.

dimension

ad_group_targeting_spec.LOCALE

ad_group_targeting_spec.LOCALE

The locale targeting specification for an ad group, defining the language or region settings used for ad delivery.

dimension

ad_group_targeting_spec.LOCATION

ad_group_targeting_spec.LOCATION

The geographic location targeting specification for an ad group, defining specific countries, regions, or cities for ad delivery.

dimension

ad_group_tracking_urls

ad_group_tracking_urls

Third-party tracking URLs for various ad events at the ad group level.

dimension

ad_group_tracking_urls.click

ad_group_tracking_urls.click

The click tracking URL configured at the ad group level.

dimension

ad_group_tracking_urls.impression

ad_group_tracking_urls.impression

The impression tracking URL configured at the ad group level.

dimension

ad_group_type

ad_group_type

The type of the ad group, which is always ‘adgroup’.

dimension

ad_group_updated_time

ad_group_updated_time

The timestamp indicating the last time the ad group was updated.

dimension

ad_id

ad_id

The unique identifier for the ad.

dimension

ad_ios_deep_link

ad_ios_deep_link

The deep link URL for iOS users clicking on the ad, directing them to specific content within an app.

dimension

ad_name

ad_name

The name of the ad.

dimension

ad_pin_id

ad_pin_id

Unique identifier for the Pin associated with an ad.

dimension

ad_status

ad_status

The current status of the ad, indicating if it is active, paused, or archived.

metric

ad_tracking_urls

ad_tracking_urls

A collection of URLs used for various types of ad tracking.

dimension

ad_type

ad_type

The type of ad being run.

dimension

ad_view_tracking_url

ad_view_tracking_url

The URL used for tracking views or impressions of the ad.

dimension

add_to_cart_desktop_action_desktop_conversion

add_to_cart_desktop_action_desktop_conversion

The number of “add to cart” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.

metric

add_to_cart_desktop_action_mobile_conversion

add_to_cart_desktop_action_mobile_conversion

The number of “add to cart” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.

metric

add_to_cart_desktop_action_tablet_conversion

add_to_cart_desktop_action_tablet_conversion

The number of “add to cart” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.

metric

add_to_cart_mobile_action_desktop_conversion

add_to_cart_mobile_action_desktop_conversion

The number of “add to cart” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.

metric

add_to_cart_mobile_action_mobile_conversion

add_to_cart_mobile_action_mobile_conversion

The number of “add to cart” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.

metric

add_to_cart_mobile_action_tablet_conversion

add_to_cart_mobile_action_tablet_conversion

The number of “add to cart” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.

metric

add_to_cart_tablet_action_desktop_conversion

add_to_cart_tablet_action_desktop_conversion

The number of “add to cart” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.

metric

add_to_cart_tablet_action_mobile_conversion

add_to_cart_tablet_action_mobile_conversion

The number of “add to cart” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.

metric

add_to_cart_tablet_action_tablet_conversion

add_to_cart_tablet_action_tablet_conversion

The number of “add to cart” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.

metric

add_to_cart_total

add_to_cart_total

The total number of add-to-cart events.

metric

ads_CLICKTHROUGH_1

ads_CLICKTHROUGH_1

The number of clicks on ads, indicating user interaction with paid content.

metric

ads_CLICKTHROUGH_2

ads_CLICKTHROUGH_2

The number of times users clicked on an ad, leading to a destination outside of Pinterest. This represents a specific type of clickthrough metric.

dimension

ads_ENGAGEMENT_1

ads_ENGAGEMENT_1

A primary engagement metric for ads, encompassing interactions like saves, closeups, and outbound clicks.

metric

ads_OUTBOUND_CLICK_1

ads_OUTBOUND_CLICK_1

A primary metric for outbound clicks from ads, indicating clicks that lead users off of Pinterest.

metric

ads_OUTBOUND_CLICK_2

ads_OUTBOUND_CLICK_2

A metric indicating the second type or attribution window of outbound clicks from ads.

metric

ads_REPIN_1

ads_REPIN_1

The number of times users saved or ‘repinned’ an ad. This is a metric indicating user engagement and content curation.

dimension

ads_REPIN_2

ads_REPIN_2

The number of times users saved or ‘repinned’ an ad. This represents a specific type or version of the repin metric.

dimension

ads_SPEND_IN_MICRO_DOLLAR

ads_SPEND_IN_MICRO_DOLLAR

The total amount spent on ads, expressed in micro-currency units of the advertiser’s currency.

dimension

ads_TOTAL_CHECKOUT

ads_TOTAL_CHECKOUT

The total number of checkout conversions attributed to ads.

metric

ads_TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout conversions attributed to ads.

metric

ads_TOTAL_CLICK_ADD_TO_CART

ads_TOTAL_CLICK_ADD_TO_CART

The total number of add-to-cart conversion events that occurred after a user clicked on an ad.

dimension

ads_TOTAL_CLICK_CHECKOUT

ads_TOTAL_CLICK_CHECKOUT

The total number of checkout conversion events that occurred after a user clicked on an ad.

dimension

ads_TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout conversion events that occurred after a user clicked on an ad. Values are based on the advertiser’s currency.

dimension

ads_TOTAL_CLICK_LEAD

ads_TOTAL_CLICK_LEAD

The total number of lead generation conversion events that occurred after a user clicked on an ad.

dimension

ads_TOTAL_CLICK_SIGNUP

ads_TOTAL_CLICK_SIGNUP

The total number of signup conversion events that occurred after a user clicked on an ad.

dimension

ads_TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of signup conversion events that occurred after a user clicked on an ad. Values are based on the advertiser’s currency.

dimension

ads_TOTAL_CONVERSIONS

ads_TOTAL_CONVERSIONS

The total number of conversion events attributed to advertisements.

metric

ads_TOTAL_CUSTOM

ads_TOTAL_CUSTOM

The total number of custom conversions tracked for ads.

dimension

ads_TOTAL_ENGAGEMENT

ads_TOTAL_ENGAGEMENT

The total number of engagement actions with an ad, which can include saves, close-ups, and link clicks.

dimension

ads_TOTAL_ENGAGEMENT_CHECKOUT

ads_TOTAL_ENGAGEMENT_CHECKOUT

The total number of checkout conversion events that occurred after a user engaged with an ad.

dimension

ads_TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout conversion events that occurred after a user engaged with an ad. Values are based on the advertiser’s currency.

dimension

ads_TOTAL_ENGAGEMENT_LEAD

ads_TOTAL_ENGAGEMENT_LEAD

The total number of lead generation conversion events that occurred after a user engaged with an ad.

dimension

ads_TOTAL_ENGAGEMENT_SIGNUP

ads_TOTAL_ENGAGEMENT_SIGNUP

The total number of signup conversion events that occurred after a user engaged with an ad.

dimension

ads_TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of signup conversion events that occurred after a user engaged with an ad. Values are based on the advertiser’s currency.

dimension

ads_TOTAL_LEAD

ads_TOTAL_LEAD

The total number of lead generation events attributed to an ad.

dimension

ads_TOTAL_VIDEO_3SEC_VIEWS

ads_TOTAL_VIDEO_3SEC_VIEWS

The total number of times an ad’s video content was viewed for at least 3 seconds.

metric

ads_TOTAL_VIEW_ADD_TO_CART

ads_TOTAL_VIEW_ADD_TO_CART

The total number of add-to-cart conversion events that occurred after a user viewed an ad.

dimension

ads_TOTAL_VIEW_CHECKOUT

ads_TOTAL_VIEW_CHECKOUT

The total number of checkout conversion events that occurred after a user viewed an ad.

dimension

ads_TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout conversion events that occurred after a user viewed an ad. Values are based on the advertiser’s currency.

dimension

ads_TOTAL_VIEW_LEAD

ads_TOTAL_VIEW_LEAD

The total number of lead generation conversion events that occurred after a user viewed an ad.

dimension

ads_TOTAL_VIEW_SIGNUP

ads_TOTAL_VIEW_SIGNUP

The total number of signup conversion events that occurred after a user viewed an ad.

dimension

ads_TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of signup conversion events that occurred after a user viewed an ad. Values are based on the advertiser’s currency.

dimension

ads_TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout conversion events from web activity, attributed to an ad. Values are based on the advertiser’s currency.

dimension

ads_TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout conversion events from web activity, specifically after a user clicked on an ad. Values are based on the advertiser’s currency.

dimension

ads_TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout conversion events from web activity, specifically after a user engaged with an ad. Values are based on the advertiser’s currency.

dimension

ads_TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR

ads_TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR

The total value, in micro-dollars, of checkout conversion events from web activity, specifically after a user viewed an ad. Values are based on the advertiser’s currency.

dimension

ads_VIDEO_LENGTH

ads_VIDEO_LENGTH

The length of the video creative used in an ad.

metric

ads_carousel_destination_urls

ads_carousel_destination_urls

A list of destination URLs for the individual cards within a carousel ad.

dimension

ads_click_tracking_url

ads_click_tracking_url

The tracking URL for ad clicks.

dimension

ads_creative_type

ads_creative_type

The type of creative used for the ad (e.g., image, video, carousel).

dimension

ads_destination_url

ads_destination_url

The primary URL where users are directed after interacting with the ad.

dimension

ads_id

ads_id

Unique identifier for a specific ad.

dimension

ads_name

ads_name

The name of the ad.

dimension

ads_review_status

ads_review_status

The current review status of an ad (e.g., approved, pending, rejected).

dimension

ads_status

ads_status

The current status of the ad (e.g., active, paused, archived).

dimension

ads_tracking_urls.click

ads_tracking_urls.click

The click tracking URL configured at the ad level.

dimension

ads_tracking_urls.impression

ads_tracking_urls.impression

The impression tracking URL configured at the ad level.

dimension

ads_type

ads_type

The type of ad, categorizing its format or objective.

dimension

ads_updated_time

ads_updated_time

The timestamp indicating when the ad-related data was last updated.

metric

adset_name

adset_name

The name of the ad set (ad group).

dimension

adset_status

adset_status

The status of the ad set (ad group), indicating if it is active, paused, or archived.

dimension

advertiser

advertiser

The name or identifier of the advertiser associated with the campaign or ad.

dimension

advertiser_campaign_ids

advertiser_campaign_ids

A list of campaign identifiers associated with a specific advertiser.

dimension

advertiser_id

advertiser_id

The unique identifier for the advertiser.

dimension

advertiser_name

advertiser_name

The name of the advertiser.

dimension

agency

agency

The name or identifier of the advertising agency managing the campaigns.

dimension

all_impressions

all_impressions

The total number of impressions across all campaigns or content.

metric

alt_text

alt_text

Alternative text description for images in Pins, used for accessibility and SEO.

dimension

app_install_desktop_action_desktop_conversion

app_install_desktop_action_desktop_conversion

The number of “app install” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.

dimension

app_install_desktop_action_mobile_conversion

app_install_desktop_action_mobile_conversion

The number of “app install” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.

dimension

app_install_desktop_action_tablet_conversion

app_install_desktop_action_tablet_conversion

The number of “app install” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.

dimension

app_install_mobile_action_desktop_conversion

app_install_mobile_action_desktop_conversion

The number of “app install” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.

dimension

app_install_mobile_action_mobile_conversion

app_install_mobile_action_mobile_conversion

The number of “app install” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.

dimension

app_install_mobile_action_tablet_conversion

app_install_mobile_action_tablet_conversion

The number of “app install” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.

dimension

app_install_tablet_action_desktop_conversion

app_install_tablet_action_desktop_conversion

The number of “app install” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.

dimension

app_install_tablet_action_mobile_conversion

app_install_tablet_action_mobile_conversion

The number of “app install” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.

dimension

app_install_tablet_action_tablet_conversion

app_install_tablet_action_tablet_conversion

The number of “app install” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.

dimension

asset_length

asset_length

The length or duration of a media asset, such as a video.

metric

board_count

board_count

The total number of boards associated with a Pinterest account.

metric

board_id

board_id

Unique identifier for a Pinterest board.

dimension

board_owner.username

board_owner.username

The username of the owner of the Pinterest board.

dimension

board_section_id

board_section_id

Unique identifier for a section within a Pinterest board.

dimension

brand

brand

The brand associated with the advertisement or product.

dimension

budget

budget

The total budget allocated for a campaign or ad group.

metric

business_name

business_name

The name of the business associated with the Pinterest account.

dimension

buying_type

buying_type

The purchasing model for ad space (e.g., auction, fixed price).

dimension

campaign_created_time

campaign_created_time

The creation time of the campaign in Unix timestamp (seconds).

dimension

campaign_daily_spend_cap

campaign_daily_spend_cap

The daily spending cap for the campaign in microcurrency.

metric

campaign_end_time

campaign_end_time

The scheduled end time of the campaign.

dimension

campaign_entity_status

campaign_entity_status

The status of the campaign entity, indicating if it is active, paused, or archived.

dimension

campaign_id

campaign_id

The unique identifier for the campaign.

dimension

campaign_ids

campaign_ids

A list of unique identifiers for associated campaigns.

dimension

campaign_is_campaign_budget_optimization

campaign_is_campaign_budget_optimization

A boolean value indicating whether the campaign is using Campaign Budget Optimization (CBO), a feature where Pinterest automatically distributes the campaign budget across ad groups to optimize performance.

dimension

campaign_is_flexible_daily_budgets

campaign_is_flexible_daily_budgets

A boolean value indicating whether the campaign is utilizing Flexible Daily Budgets (FDB), which allows for automatic adjustment of daily ad spend, including rolling over unspent budget and overspending on high-opportunity days, to optimize performance over a weekly period.

dimension

campaign_lifetime_spend_cap

campaign_lifetime_spend_cap

The total spending cap for the campaign’s lifetime in microcurrency.

metric

campaign_managed_status

campaign_managed_status

The current management status of the campaign (e.g., active, paused, archived).

dimension

campaign_name

campaign_name

The name of the campaign.

dimension

campaign_objective

campaign_objective

The primary goal of an advertising campaign (e.g., brand awareness, traffic, conversions).

dimension

campaign_objective_type

campaign_objective_type

The objective type of the campaign (e.g., BRAND_AWARENESS, TRAFFIC, CONVERSION).

dimension

campaign_order_line_id

campaign_order_line_id

The unique identifier for the order line associated with a campaign.

dimension

campaign_start_time

campaign_start_time

The scheduled start time of the campaign.

dimension

campaign_status

campaign_status

The current status of the campaign, indicating if it is active, paused, or archived.

dimension

campaign_summary_status

campaign_summary_status

The overall summary status of the campaign, indicating its current state (e.g., “RUNNING”, “PAUSED”, “ARCHIVED”).

dimension

campaign_tracking_urls

campaign_tracking_urls

A list of tracking URLs associated with the campaign for monitoring performance and attributing actions.

dimension

campaign_tracking_urls.impression

campaign_tracking_urls.impression

The impression tracking URL configured at the campaign level.

dimension

campaign_type

campaign_type

The type of the campaign, which is always ‘campaign’.

dimension

campaign_updated_time

campaign_updated_time

The timestamp indicating the last time a campaign was updated.

dimension

categories_id

categories_id

Unique identifier for an audience category.

dimension

categories_index

categories_index

Positional index for an audience category.

dimension

categories_key

categories_key

A key representing an audience category.

metric

categories_name

categories_name

The human-readable name of an audience category.

dimension

categories_ratio

categories_ratio

The proportion or percentage of the audience belonging to a specific category.

metric

channel

channel

The advertising channel used for the campaign.

dimension

checkout_desktop_action_desktop_conversion

checkout_desktop_action_desktop_conversion

The number of “checkout” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.

metric

checkout_desktop_action_mobile_conversion

checkout_desktop_action_mobile_conversion

The number of “checkout” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.

dimension

checkout_desktop_action_tablet_conversion

checkout_desktop_action_tablet_conversion

The number of “checkout” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.

dimension

checkout_mobile_action_desktop_conversion

checkout_mobile_action_desktop_conversion

The number of “checkout” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.

metric

checkout_mobile_action_mobile_conversion

checkout_mobile_action_mobile_conversion

The number of “checkout” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.

metric

checkout_mobile_action_tablet_conversion

checkout_mobile_action_tablet_conversion

The number of “checkout” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.

dimension

checkout_roas

checkout_roas

Return on ad spend (ROAS) for checkout conversions.

metric

checkout_tablet_action_desktop_conversion

checkout_tablet_action_desktop_conversion

The number of “checkout” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.

metric

checkout_tablet_action_mobile_conversion

checkout_tablet_action_mobile_conversion

The number of “checkout” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.

metric

checkout_tablet_action_tablet_conversion

checkout_tablet_action_tablet_conversion

The number of “checkout” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.

dimension

checkout_value_from_click_conversions

checkout_value_from_click_conversions

The value of checkout conversions attributed to click actions.

dimension

checkout_value_from_click_conversions_micro

checkout_value_from_click_conversions_micro

The value of checkout conversions in microcurrency attributed to click actions.

metric

checkout_value_from_engagement_conversions

checkout_value_from_engagement_conversions

The value of checkout conversions attributed to engagement actions.

metric

checkout_value_from_engagement_conversions_micro

checkout_value_from_engagement_conversions_micro

The value of checkout conversions in microcurrency attributed to engagement actions.

metric

checkout_value_from_view_conversions

checkout_value_from_view_conversions

The value of checkout conversions attributed to view-through actions.

metric

checkout_value_from_view_conversions_micro

checkout_value_from_view_conversions_micro

The value of checkout conversions in microcurrency attributed to view-through actions.

metric

clicks_total

clicks_total

The total number of clicks on ads or Pins.

metric

clickthrough

clickthrough

Total number of clickthroughs on a Pin or ad, which includes any clicks that lead to a destination outside of Pinterest.

dimension

clickthrough_conversions_(add_to_cart)

clickthrough_conversions_(add_to_cart)

The number of add-to-cart conversions attributed to click actions.

dimension

clickthrough_conversions_(app_install)

clickthrough_conversions_(app_install)

The number of app install conversions attributed to click actions.

dimension

clickthrough_conversions_(category_view)

clickthrough_conversions_(category_view)

The number of category view conversions attributed to click actions.

dimension

clickthrough_conversions_(checkout)

clickthrough_conversions_(checkout)

The number of checkout conversions attributed to clickthroughs.

dimension

clickthrough_conversions_(custom)

clickthrough_conversions_(custom)

The number of custom conversions attributed to click actions.

metric

clickthrough_conversions_(lead)

clickthrough_conversions_(lead)

The number of lead conversions attributed to clickthroughs.

dimension

clickthrough_conversions_(page_visit)

clickthrough_conversions_(page_visit)

The number of page visit conversions attributed to clickthroughs.

dimension

clickthrough_conversions_(signup)

clickthrough_conversions_(signup)

The number of signup conversions attributed to click actions.

dimension

clickthrough_conversions_(unknown)

clickthrough_conversions_(unknown)

The total number of conversions attributed to user clicks on ads, where the specific conversion action type is not categorized.

metric

clickthrough_conversions_(watch_video)

clickthrough_conversions_(watch_video)

The number of watch video conversions attributed to click actions.

dimension

clickthrough_conversions_(website_search)

clickthrough_conversions_(website_search)

The number of website search conversions attributed to click actions.

dimension

clickthrough_order_quantity_(checkout)

clickthrough_order_quantity_(checkout)

The quantity of items purchased in checkout conversions attributed to click actions.

dimension

clickthrough_rate

clickthrough_rate

The rate at which users click through after seeing an impression, calculated as clicks divided by impressions.

dimension

clickthrough_value(add_to_cart)

clickthrough_value(add_to_cart)

The total monetary value generated from ‘add to cart’ conversion events that resulted from clicks on your ads.

dimension

clickthrough_value(app_install)

clickthrough_value(app_install)

The total monetary value generated from ‘app install’ conversion events that resulted from clicks on your ads.

dimension

clickthrough_value(category_view)

clickthrough_value(category_view)

The value associated with a specific clickthrough conversion event, such as a category view.

dimension

clickthrough_value(custom)

clickthrough_value(custom)

The total monetary value generated from custom conversion events that resulted from clicks on your ads.

dimension

clickthrough_value(lead)

clickthrough_value(lead)

The total monetary value generated from ‘lead’ conversion events that resulted from clicks on your ads.

dimension

clickthrough_value(page_visit)

clickthrough_value(page_visit)

The total monetary value generated from ‘page visit’ conversion events that resulted from clicks on your ads.

dimension

clickthrough_value(signup)

clickthrough_value(signup)

The total monetary value generated from ‘signup’ conversion events that resulted from clicks on your ads.

dimension

clickthrough_value(unknown)

clickthrough_value(unknown)

The value associated with an unspecified clickthrough conversion event.

dimension

clickthrough_value(watch_video)

clickthrough_value(watch_video)

The total monetary value generated from ‘watch video’ conversion events that resulted from clicks on your ads.

dimension

clickthrough_value(website_search)

clickthrough_value(website_search)

The value associated with a clickthrough conversion event from a website search.

dimension

clickthrough_value_(add_to_cart)

clickthrough_value_(add_to_cart)

The total monetary value generated from ‘add to cart’ conversion events attributed to clicks.

dimension

clickthrough_value_(app_install)

clickthrough_value_(app_install)

The total monetary value generated from ‘app install’ conversion events attributed to clicks.

dimension

clickthrough_value_(category_view)

clickthrough_value_(category_view)

The value associated with a specific clickthrough conversion event, such as a category view.

dimension

clickthrough_value_(custom)

clickthrough_value_(custom)

The total monetary value generated from custom conversion events attributed to clicks.

dimension

clickthrough_value_(lead)

clickthrough_value_(lead)

The total monetary value generated from ‘lead’ conversion events attributed to clicks.

dimension

clickthrough_value_(page_visit)

clickthrough_value_(page_visit)

The total monetary value generated from ‘page visit’ conversion events attributed to clicks.

dimension

clickthrough_value_(signup)

clickthrough_value_(signup)

The total monetary value generated from ‘signup’ conversion events attributed to clicks.

dimension

clickthrough_value_(unknown)

clickthrough_value_(unknown)

The value associated with an unspecified clickthrough conversion event.

dimension

clickthrough_value_(watch_video)

clickthrough_value_(watch_video)

The total monetary value generated from ‘watch video’ conversion events attributed to clicks.

dimension

clickthrough_value_(website_search)

clickthrough_value_(website_search)

The value associated with a clickthrough conversion event from a website search.

dimension

clickthrough_value_micro(add_to_cart)

clickthrough_value_micro(add_to_cart)

The granular value associated with a micro-conversion event where an item is added to a shopping cart.

dimension

clickthrough_value_micro(app_install)

clickthrough_value_micro(app_install)

The granular value associated with a micro-conversion event where an application is installed.

dimension

clickthrough_value_micro(category_view)

clickthrough_value_micro(category_view)

The granular value associated with a micro-conversion event for viewing a category.

dimension

clickthrough_value_micro(custom)

clickthrough_value_micro(custom)

The granular value associated with a custom-defined micro-conversion event.

dimension

clickthrough_value_micro(lead)

clickthrough_value_micro(lead)

The granular value associated with a micro-conversion event where a lead is generated.

dimension

clickthrough_value_micro(page_visit)

clickthrough_value_micro(page_visit)

The granular value associated with a micro-conversion event for a page visit.

dimension

clickthrough_value_micro(signup)

clickthrough_value_micro(signup)

The granular value associated with a micro-conversion event for a user signup.

dimension

clickthrough_value_micro(unknown)

clickthrough_value_micro(unknown)

The granular value associated with an unspecified micro-conversion event.

dimension

clickthrough_value_micro(watch_video)

clickthrough_value_micro(watch_video)

The granular value associated with a micro-conversion event for watching a video.

dimension

clickthrough_value_micro(website_search)

clickthrough_value_micro(website_search)

The granular value associated with a micro-conversion event from a website search.

dimension

clickthrough_value_micro_(add_to_cart)

clickthrough_value_micro_(add_to_cart)

The monetary value, in micro-units of the advertiser’s currency, of “add to cart” conversions attributed to user clicks on ads.

metric

clickthrough_value_micro_(app_install)

clickthrough_value_micro_(app_install)

The monetary value, in micro-units of the advertiser’s currency, of “app install” conversions attributed to user clicks on ads.

metric

clickthrough_value_micro_(category_view)

clickthrough_value_micro_(category_view)

The monetary value, in micro-units of the advertiser’s currency, of “category view” conversions attributed to user clicks on ads.

metric

clickthrough_value_micro_(custom)

clickthrough_value_micro_(custom)

The monetary value, in micro-units of the advertiser’s currency, of “custom” conversions attributed to user clicks on ads.

metric

clickthrough_value_micro_(lead)

clickthrough_value_micro_(lead)

The value of lead conversions in microcurrency attributed to click actions.

metric

clickthrough_value_micro_(page_visit)

clickthrough_value_micro_(page_visit)

The monetary value, in micro-units of the advertiser’s currency, of “page visit” conversions attributed to user clicks on ads.

metric

clickthrough_value_micro_(signup)

clickthrough_value_micro_(signup)

The value of signup conversions in microcurrency attributed to click actions.

metric

clickthrough_value_micro_(unknown)

clickthrough_value_micro_(unknown)

The monetary value, in micro-units of the advertiser’s currency, of “unknown” conversions attributed to user clicks on ads.

metric

clickthrough_value_micro_(watch_video)

clickthrough_value_micro_(watch_video)

The monetary value, in micro-units of the advertiser’s currency, of “watch video” conversions attributed to user clicks on ads.

metric

clickthrough_value_micro_(website_search)

clickthrough_value_micro_(website_search)

The monetary value, in micro-units of the advertiser’s currency, of “website search” conversions attributed to user clicks on ads.

metric

closeup

closeup

The number of times a Pin closeup was viewed.

dimension

closeup_rate

closeup_rate

The rate at which users view a Pin in closeup mode.

dimension

comment_count

comment_count

The total number of comments on a Pin.

metric

conversion_quantity_from_add_to_cart_clicks

conversion_quantity_from_add_to_cart_clicks

The number of “add to cart” conversions that resulted from user clicks on ads.

metric

conversion_quantity_from_add_to_cart_engagements

conversion_quantity_from_add_to_cart_engagements

The number of “add to cart” conversions that resulted from user engagements on ads.

dimension

conversion_quantity_from_add_to_cart_views

conversion_quantity_from_add_to_cart_views

The number of “add to cart” conversions that resulted from user views on ads.

metric

conversion_quantity_from_custom_clicks

conversion_quantity_from_custom_clicks

The number of custom conversion events attributed to clicks on ads.

dimension

conversion_quantity_from_custom_engagements

conversion_quantity_from_custom_engagements

The number of “custom” conversions that resulted from user engagements on ads.

dimension

conversion_quantity_from_custom_views

conversion_quantity_from_custom_views

The number of custom conversion events attributed to views of ads.

dimension

conversion_quantity_from_lead_clicks

conversion_quantity_from_lead_clicks

The number of “lead” conversions that resulted from user clicks on ads.

metric

conversion_quantity_from_lead_engagements

conversion_quantity_from_lead_engagements

The number of “lead” conversions that resulted from user engagements on ads.

dimension

conversion_quantity_from_lead_views

conversion_quantity_from_lead_views

The number of “lead” conversions that resulted from user views on ads.

metric

conversion_quantity_from_page_visit_clicks

conversion_quantity_from_page_visit_clicks

The number of “page visit” conversions that resulted from user clicks on ads.

metric

conversion_quantity_from_page_visit_views

conversion_quantity_from_page_visit_views

The number of “page visit” conversions that resulted from user views on ads.

metric

conversion_quantity_from_page_visits

conversion_quantity_from_page_visits

The number of “page visit” conversions that resulted from user visits on ads.

dimension

conversion_quantity_from_search_clicks

conversion_quantity_from_search_clicks

The number of “search” conversions that resulted from user clicks on ads.

dimension

conversion_quantity_from_search_engagements

conversion_quantity_from_search_engagements

The number of “search” conversions that resulted from user engagements on ads.

dimension

conversion_quantity_from_search_views

conversion_quantity_from_search_views

The number of “search” conversions that resulted from user views on ads.

dimension

conversion_quantity_from_signup_clicks

conversion_quantity_from_signup_clicks

The quantity of signup conversions resulting from clicks.

dimension

conversion_quantity_from_signup_engagements

conversion_quantity_from_signup_engagements

The number of “signup” conversions that resulted from user engagements on ads.

dimension

conversion_quantity_from_signup_views

conversion_quantity_from_signup_views

The number of “signup” conversions that resulted from user views on ads.

dimension

conversion_quantity_from_unknown_clicks

conversion_quantity_from_unknown_clicks

The number of unknown conversion events attributed to clicks on ads.

dimension

conversion_quantity_from_unknown_engagements

conversion_quantity_from_unknown_engagements

The number of “unknown” conversions that resulted from user engagements on ads.

dimension

conversion_quantity_from_unknown_views

conversion_quantity_from_unknown_views

The number of unknown conversion events attributed to views of ads.

dimension

conversion_quantity_from_view_category_clicks

conversion_quantity_from_view_category_clicks

The number of “view category” conversions that resulted from user clicks on ads.

metric

conversion_quantity_from_view_category_engagements

conversion_quantity_from_view_category_engagements

The number of “view category” conversions that resulted from user engagements on ads.

dimension

conversion_quantity_from_view_category_views

conversion_quantity_from_view_category_views

The number of “view category” conversions that resulted from user views on ads.

metric

conversion_quantity_from_watch_video_clicks

conversion_quantity_from_watch_video_clicks

The number of “watch video” conversions that resulted from user clicks on ads.

dimension

conversion_quantity_from_watch_video_engagements

conversion_quantity_from_watch_video_engagements

The number of “watch video” conversions that resulted from user engagements on ads.

dimension

conversion_quantity_from_watch_video_views

conversion_quantity_from_watch_video_views

The number of “watch video” conversions that resulted from user views on ads.

dimension

conversions

conversions

The total number of conversion events.

dimension

conversions_(app_install)

conversions_(app_install)

The total number of app install conversions.

dimension

cost_per_2second_50%_viewability_video_view

cost_per_2second_50%_viewability_video_view

The average cost incurred for each video view that played continuously for at least 2 seconds with 50% of the video in view.

dimension

cost_per_2second_50%_viewability_video_view_micro

cost_per_2second_50%_viewability_video_view_micro

The cost incurred for each video view that achieved at least 50% viewability for 2 seconds, represented in micro-units of the advertiser’s currency.

metric

cost_per_at_least_95%_completed_video_view

cost_per_at_least_95%_completed_video_view

The average cost incurred for each video view that reached at least 95% of its total length.

dimension

cost_per_at_least_95%_completed_video_view_micro

cost_per_at_least_95%_completed_video_view_micro

The cost in microcurrency for a video view completed to at least 95%.

metric

cost_per_completed_video_view

cost_per_completed_video_view

The average cost incurred for each video view that reached 100% of its total length.

dimension

cost_per_completed_video_view_micro

cost_per_completed_video_view_micro

The cost in microcurrency for a completed video view.

metric

cost_per_lead

cost_per_lead

The cost associated with generating a lead.

dimension

cost_per_outbound_click

cost_per_outbound_click

The cost associated with each outbound click.

dimension

cost_per_outbound_click_in_dollar

cost_per_outbound_click_in_dollar

The cost incurred for each outbound click, expressed in US Dollars.

dimension

country

country

The two-character ISO 3166-1 alpha-2 country code associated with an ad account or audience.

dimension

country_code

country_code

The two-letter ISO country code representing the geographical location.

dimension

cpa_(app_install)

cpa_(app_install)

The cost incurred for each app install conversion, calculated as total ad spend divided by the number of app installs.

dimension

cpm_in_dollar

cpm_in_dollar

The cost per thousand impressions (CPM) for ads, expressed in dollars, indicating the price paid for one thousand views or displays of an advertisement.

metric

created_at

created_at

The date and time when the Pin or Board was created.

dimension

creative

creative

The ad creative or content used in the campaign.

dimension

creative_duration

creative_duration

The total duration of the creative content, typically for video ads.

dimension

creative_type

creative_type

The creative type of the ad or Pin, such as REGULAR, VIDEO, SHOPPING, CAROUSEL, MAX_VIDEO, COLLECTION, IDEA, or QUIZ.

dimension

custom_desktop_action_desktop_conversion

custom_desktop_action_desktop_conversion

The number of “custom” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.

dimension

custom_desktop_action_mobile_conversion

custom_desktop_action_mobile_conversion

The number of “custom” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.

dimension

custom_desktop_action_tablet_conversion

custom_desktop_action_tablet_conversion

The number of “custom” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.

dimension

custom_mobile_action_desktop_conversion

custom_mobile_action_desktop_conversion

The number of “custom” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.

dimension

custom_mobile_action_mobile_conversion

custom_mobile_action_mobile_conversion

The number of “custom” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.

dimension

custom_mobile_action_tablet_conversion

custom_mobile_action_tablet_conversion

The number of “custom” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.

dimension

custom_tablet_action_desktop_conversion

custom_tablet_action_desktop_conversion

The number of “custom” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.

dimension

custom_tablet_action_mobile_conversion

custom_tablet_action_mobile_conversion

The number of “custom” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.

dimension

custom_tablet_action_tablet_conversion

custom_tablet_action_tablet_conversion

The number of “custom” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.

dimension

data_currency

data_currency

The currency in which data values (e.g., spend, revenue) are reported.

dimension

data_status

data_status

The current status of the data for a given entity, indicating its processing or availability state.

dimension

date

date

The date for which the metrics are reported.

dimension

date_created

date_created

The date when a specific record or entity was created.

dimension

date_range

date_range

The specific range of dates for which the data is reported.

dimension

date_range_end

date_range_end

The end date of the reporting period.

dimension

date_range_start

date_range_start

The start date of the reporting period.

dimension

demographics_ages_key

demographics_ages_key

A key or identifier for an age group within the demographic breakdown of an audience.

dimension

demographics_ages_name

demographics_ages_name

The human-readable name of an age group within the demographic breakdown of an audience.

dimension

demographics_ages_ratio

demographics_ages_ratio

The proportional representation or percentage of an age group within the demographic breakdown of an audience.

metric

demographics_countries_key

demographics_countries_key

A key or identifier (e.g., two-letter code) for a country within the demographic breakdown of an audience.

dimension

demographics_countries_name

demographics_countries_name

The human-readable name of a country within the demographic breakdown of an audience.

dimension

demographics_countries_ratio

demographics_countries_ratio

The proportional representation or percentage of a country within the demographic breakdown of an audience.

dimension

demographics_devices_key

demographics_devices_key

A key representing a demographic device type in audience insights.

dimension

demographics_devices_name

demographics_devices_name

The human-readable name of a demographic device type in audience insights.

dimension

demographics_devices_ratio

demographics_devices_ratio

The proportion or percentage of the audience using a specific device type.

metric

demographics_genders_key

demographics_genders_key

A key or identifier for a gender within the demographic breakdown of an audience.

dimension

demographics_genders_name

demographics_genders_name

The human-readable name of a gender within the demographic breakdown of an audience.

dimension

demographics_genders_ratio

demographics_genders_ratio

The proportional representation or percentage of a gender within the demographic breakdown of an audience.

metric

demographics_metros_key

demographics_metros_key

A key or identifier for a metropolitan area within the demographic breakdown of an audience.

dimension

demographics_metros_name

demographics_metros_name

The human-readable name of a metropolitan area within the demographic breakdown of an audience.

dimension

demographics_metros_ratio

demographics_metros_ratio

The proportional representation or percentage of a metropolitan area within the demographic breakdown of an audience.

metric

description

description

The description of the Pin or Board.

dimension

device_type

device_type

The type of device (e.g., mobile, tablet, desktop) on which an ad or Pin was viewed.

dimension

dominant_color

dominant_color

The dominant color detected in the Pin’s media.

dimension

earned_average_video_watch_time

earned_average_video_watch_time

The average time users spent watching organic video Pins.

metric

earned_clicks

earned_clicks

The number of organic clicks on Pins or content.

metric

earned_closeups

earned_closeups

The number of times users voluntarily viewed a Pin in closer detail (e.g., clicked to expand) through organic reach.

metric

earned_engagements

earned_engagements

The number of organic engagements on Pins or content.

metric

earned_impressions

earned_impressions

The number of organic impressions on Pins or content.

metric

earned_outbound_clicks

earned_outbound_clicks

The number of organic outbound clicks on Pins or content.

metric

earned_saves

earned_saves

The number of organic saves on Pins or content.

metric

earned_video_starts

earned_video_starts

The number of times an organic video started playing.

metric

earned_video_views

earned_video_views

The number of organic video views on Pins or content.

metric

earned_video_watched_at_100%

earned_video_watched_at_100%

The number of times an organic video was watched to 100% completion.

metric

earned_video_watched_at_25%

earned_video_watched_at_25%

The number of times an organic video was watched to at least 25% completion.

metric

earned_video_watched_at_50%

earned_video_watched_at_50%

The number of times an organic video was watched to at least 50% completion.

metric

earned_video_watched_at_75%

earned_video_watched_at_75%

The number of times an organic video was watched to at least 75% completion.

metric

earned_video_watched_at_95%

earned_video_watched_at_95%

The number of times an organic video was watched to at least 95% completion.

metric

ecpc_in_dollar

ecpc_in_dollar

The effective cost per click (eCPC) in dollars.

metric

ecpcv_in_dollar

ecpcv_in_dollar

The effective cost per completed video view, measured in dollars. This is a calculated ad performance metric.

metric

ecpcv_p95_in_dollar

ecpcv_p95_in_dollar

The 95th percentile of the effective cost per completed video view, measured in dollars. This indicates a higher bound for the cost per view.

metric

ecpe_in_dollar

ecpe_in_dollar

The effective cost per engagement (eCPE) in dollars.

metric

ecpv_in_dollar

ecpv_in_dollar

The effective cost per video view, measured in dollars. This is a calculated ad performance metric.

metric

end_time

end_time

The end time for a data range or the conclusion of a campaign/ad group.

metric

engagement

engagement

A general count of user engagements with a Pin or ad.

metric

engagement_conversions_(add_to_cart)

engagement_conversions_(add_to_cart)

The number of add-to-cart conversions attributed to engagement actions.

dimension

engagement_conversions_(app_install)

engagement_conversions_(app_install)

The number of app install conversions attributed to engagement actions.

dimension

engagement_conversions_(category_view)

engagement_conversions_(category_view)

The number of category view conversions attributed to engagement actions.

dimension

engagement_conversions_(checkout)

engagement_conversions_(checkout)

The number of checkout conversions attributed to engagement actions.

dimension

engagement_conversions_(custom)

engagement_conversions_(custom)

The number of custom conversions attributed to engagement actions.

dimension

engagement_conversions_(lead)

engagement_conversions_(lead)

The number of lead conversions attributed to engagement actions.

dimension

engagement_conversions_(page_visit)

engagement_conversions_(page_visit)

The number of page visit conversions attributed to engagement actions.

dimension

engagement_conversions_(signup)

engagement_conversions_(signup)

The number of signup conversions attributed to engagement actions.

dimension

engagement_conversions_(unknown)

engagement_conversions_(unknown)

The total number of conversions attributed to user engagements with ads, where the specific conversion action type is not categorized.

dimension

engagement_conversions_(watch_video)

engagement_conversions_(watch_video)

The number of watch video conversions attributed to engagement actions.

dimension

engagement_conversions_(website_search)

engagement_conversions_(website_search)

The number of website search conversions attributed to engagement actions.

dimension

engagement_order_quantity_(checkout)

engagement_order_quantity_(checkout)

The quantity of items purchased in checkout conversions attributed to engagement actions.

dimension

engagement_rate

engagement_rate

The rate at which users engage with content, calculated as total engagements divided by impressions.

metric

engagement_value(add_to_cart)

engagement_value(add_to_cart)

The total monetary value generated from ‘add to cart’ conversion events that resulted from engagement with your ads (e.g., saves, closeups, carousel swipes).

dimension

engagement_value(app_install)

engagement_value(app_install)

The total monetary value generated from ‘app install’ conversion events that resulted from engagement with your ads.

dimension

engagement_value(category_view)

engagement_value(category_view)

The value generated from an engagement event, such as a category view.

dimension

engagement_value(custom)

engagement_value(custom)

The total monetary value generated from custom conversion events that resulted from engagement with your ads.

dimension

engagement_value(lead)

engagement_value(lead)

The total monetary value generated from ‘lead’ conversion events that resulted from engagement with your ads.

dimension

engagement_value(page_visit)

engagement_value(page_visit)

The total monetary value generated from ‘page visit’ conversion events that resulted from engagement with your ads.

dimension

engagement_value(signup)

engagement_value(signup)

The total monetary value generated from ‘signup’ conversion events that resulted from engagement with your ads.

dimension

engagement_value(unknown)

engagement_value(unknown)

The value generated from an unspecified engagement event.

dimension

engagement_value(watch_video)

engagement_value(watch_video)

The total monetary value generated from ‘watch video’ conversion events that resulted from engagement with your ads.

dimension

engagement_value(website_search)

engagement_value(website_search)

The value generated from an engagement event, such as a website search.

dimension

engagement_value_(app_install)

engagement_value_(app_install)

The total monetary value generated from ‘app install’ conversion events attributed to engagement.

dimension

engagement_value_(custom)

engagement_value_(custom)

The total monetary value generated from custom conversion events attributed to engagement.

dimension

engagement_value_(lead)

engagement_value_(lead)

The total monetary value generated from ‘lead’ conversion events attributed to engagement.

dimension

engagement_value_(page_visit)

engagement_value_(page_visit)

The total monetary value generated from ‘page visit’ conversion events attributed to engagement.

dimension

engagement_value_(signup)

engagement_value_(signup)

The total monetary value generated from ‘signup’ conversion events attributed to engagement.

dimension

engagement_value_(unknown)

engagement_value_(unknown)

The value generated from an unspecified engagement event.

dimension

engagement_value_(watch_video)

engagement_value_(watch_video)

The total monetary value generated from ‘watch video’ conversion events attributed to engagement.

dimension

engagement_value_micro(add_to_cart)

engagement_value_micro(add_to_cart)

The granular value generated from a micro-engagement event where an item is added to a shopping cart.

dimension

engagement_value_micro(app_install)

engagement_value_micro(app_install)

The granular value generated from a micro-engagement event where an application is installed.

dimension

engagement_value_micro(category_view)

engagement_value_micro(category_view)

The total value, in micro-units of the advertiser’s currency (e.g., $0.000001 for USD), of category view events attributed to user engagements with an ad. Engagements include actions such as saves, closeups, carousel swipes, and secondary closeups or saves on collections.

dimension

engagement_value_micro(custom)

engagement_value_micro(custom)

The value of custom engagement events, measured in micro currency. Engagement events include saves, closeups, carousel swipes, and collection secondary closeups/saves.

dimension

engagement_value_micro(lead)

engagement_value_micro(lead)

The value of lead engagement events, measured in micro currency. Engagement events include saves, closeups, carousel swipes, and collection secondary closeups/saves.

dimension

engagement_value_micro(page_visit)

engagement_value_micro(page_visit)

The value of page visit engagement events, measured in micro currency. Engagement events include saves, closeups, carousel swipes, and collection secondary closeups/saves.

dimension

engagement_value_micro(signup)

engagement_value_micro(signup)

The value of signup engagement events, measured in micro currency. Engagement events include saves, closeups, carousel swipes, and collection secondary closeups/saves.

dimension

engagement_value_micro(unknown)

engagement_value_micro(unknown)

The monetary value generated from engagements with an unknown conversion type, expressed in micro-units of the currency.

dimension

engagement_value_micro(watch_video)

engagement_value_micro(watch_video)

The monetary value generated from engagements specifically related to video watches, expressed in micro-units of the currency.

dimension

engagement_value_micro(website_search)

engagement_value_micro(website_search)

The monetary value generated from engagements related to website searches, expressed in micro-units of the currency.

dimension

engagement_value_micro_(add_to_cart)

engagement_value_micro_(add_to_cart)

The monetary value, in micro-units of the advertiser’s currency, of “add to cart” conversions attributed to user engagements on ads.

metric

engagement_value_micro_(app_install)

engagement_value_micro_(app_install)

The monetary value, in micro-units of the advertiser’s currency, of “app install” conversions attributed to user engagements on ads.

metric

engagement_value_micro_(category_view)

engagement_value_micro_(category_view)

The monetary value, in micro-units of the advertiser’s currency, of “category view” conversions attributed to user engagements on ads.

metric

engagement_value_micro_(custom)

engagement_value_micro_(custom)

The monetary value, in micro-units of the advertiser’s currency, of “custom” conversions attributed to user engagements on ads.

metric

engagement_value_micro_(lead)

engagement_value_micro_(lead)

The monetary value, in micro-units of the advertiser’s currency, of “lead” conversions attributed to user engagements on ads.

metric

engagement_value_micro_(page_visit)

engagement_value_micro_(page_visit)

The monetary value, in micro-units of the advertiser’s currency, of “page visit” conversions attributed to user engagements on ads.

metric

engagement_value_micro_(signup)

engagement_value_micro_(signup)

The value of signup conversions in microcurrency attributed to engagement actions.

metric

engagement_value_micro_(unknown)

engagement_value_micro_(unknown)

The monetary value, in micro-units of the advertiser’s currency, of “unknown” conversions attributed to user engagements on ads.

metric

engagement_value_micro_(watch_video)

engagement_value_micro_(watch_video)

The monetary value, in micro-units of the advertiser’s currency, of “watch video” conversions attributed to user engagements on ads.

metric

engagement_value_micro_(website_search)

engagement_value_micro_(website_search)

The monetary value, in micro-units of the advertiser’s currency, of “website search” conversions attributed to user engagements on ads.

metric

entity

entity

A general identifier for the specific object or item being reported on.

dimension

eur_conv_rate

eur_conv_rate

The conversion rate used to convert monetary values to Euros.

metric

follower_count

follower_count

The number of followers a Pinterest account has.

metric

following_count

following_count

The number of accounts a Pinterest user is following.

metric

format_size

format_size

The size specification of the ad or Pin format.

dimension

format_type

format_type

The type of ad or Pin format.

dimension

frequency

frequency

The average number of times a user saw an ad within a given period.

dimension

full_screen_play

full_screen_play

Indicates whether a video was played in full-screen mode.

dimension

full_screen_playtime

full_screen_playtime

The total duration a video was played in full-screen mode.

dimension

group_name

group_name

The name of an ad group.

dimension

has_been_promoted

has_been_promoted

Indicates whether the Pin has been promoted through advertising.

dimension

id

id

The unique identifier for the entity (e.g., Pin ID, Board ID, Ad Account ID).

dimension

impression

impression

The total number of times a Pin or ad was displayed on screen.

metric

impressions

impressions

The total number of times an ad or Pin was displayed to users.

metric

impressions_total

impressions_total

The total number of times ads or Pins were displayed.

metric

inapp_add_to_cart_cost_per_action

inapp_add_to_cart_cost_per_action

The cost incurred for each in-app “add to cart” action, calculated as total ad spend divided by the number of in-app “add to cart” events.

dimension

inapp_add_to_cart_roas

inapp_add_to_cart_roas

The return on ad spend (ROAS) for in-app “add to cart” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

inapp_app_install_cost_per_action

inapp_app_install_cost_per_action

The cost incurred for each in-app “app install” action, calculated as total ad spend divided by the number of in-app “app install” events.

dimension

inapp_app_install_roas

inapp_app_install_roas

The return on ad spend (ROAS) for in-app “app install” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

inapp_checkout_cost_per_action

inapp_checkout_cost_per_action

The cost incurred for each in-app “checkout” action, calculated as total ad spend divided by the number of in-app “checkout” events.

dimension

inapp_checkout_roas

inapp_checkout_roas

The return on ad spend (ROAS) for in-app “checkout” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

inapp_search_cost_per_action

inapp_search_cost_per_action

The cost incurred for each in-app “search” action, calculated as total ad spend divided by the number of in-app “search” events.

dimension

inapp_search_roas

inapp_search_roas

The return on ad spend (ROAS) for in-app “search” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

inapp_signup_cost_per_action

inapp_signup_cost_per_action

The cost incurred for each in-app “signup” action, calculated as total ad spend divided by the number of in-app “signup” events.

dimension

inapp_signup_roas

inapp_signup_roas

The return on ad spend (ROAS) for in-app “signup” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

inapp_unknown_cost_per_action

inapp_unknown_cost_per_action

The cost incurred for each in-app “unknown” action, calculated as total ad spend divided by the number of in-app “unknown” events.

dimension

inapp_unknown_roas

inapp_unknown_roas

The return on ad spend (ROAS) for in-app “unknown” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

inventory_id

inventory_id

The unique identifier for an inventory item associated with a Pin.

dimension

is_owner

is_owner

A boolean indicating if the current authenticated user is the owner of the resource.

dimension

is_standard

is_standard

Indicates whether an item or event is considered standard.

dimension

language

language

The language targeted by the ad or content.

dimension

lead

lead

The number of lead conversions.

dimension

lead_desktop_action_desktop_conversion

lead_desktop_action_desktop_conversion

The number of “lead” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.

metric

lead_desktop_action_mobile_conversion

lead_desktop_action_mobile_conversion

The number of “lead” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.

metric

lead_desktop_action_tablet_conversion

lead_desktop_action_tablet_conversion

The number of “lead” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.

dimension

lead_mobile_action_desktop_conversion

lead_mobile_action_desktop_conversion

The number of “lead” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.

dimension

lead_mobile_action_mobile_conversion

lead_mobile_action_mobile_conversion

The number of “lead” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.

metric

lead_mobile_action_tablet_conversion

lead_mobile_action_tablet_conversion

The number of “lead” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.

dimension

lead_tablet_action_desktop_conversion

lead_tablet_action_desktop_conversion

The number of “lead” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.

dimension

lead_tablet_action_mobile_conversion

lead_tablet_action_mobile_conversion

The number of “lead” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.

metric

lead_tablet_action_tablet_conversion

lead_tablet_action_tablet_conversion

The number of “lead” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.

dimension

leads

leads

The total number of lead events.

dimension

lifetime_metrics.clickthrough

lifetime_metrics.clickthrough

The total number of clickthroughs over the lifetime of a Pin or ad.

metric

lifetime_metrics.comment

lifetime_metrics.comment

The total number of comments accumulated over the lifetime of a Pin.

metric

lifetime_metrics.impression

lifetime_metrics.impression

The total number of impressions received over the lifetime of a Pin or ad.

metric

lifetime_metrics.pin_click

lifetime_metrics.pin_click

The total number of clicks on a Pin over its lifetime.

metric

lifetime_metrics.reaction

lifetime_metrics.reaction

The total number of reactions accumulated over the lifetime of a Pin.

metric

like_count

like_count

The number of likes received by a Pin.

metric

link

link

The destination URL for the Pin when clicked.

dimension

market

market

The geographical market being targeted by the ad campaign.

dimension

media.cover_image_url

media.cover_image_url

The URL of the cover image for a video Pin.

dimension

media.duration

media.duration

The duration of the video in milliseconds.

metric

media.height

media.height

The height of the primary media asset in a Pin.

metric

media.images.1200x.height

media.images.1200x.height

The height of the 1200x scaled version of the Pin’s image media.

metric

media.images.1200x.url

media.images.1200x.url

The URL of the 1200x scaled version of the Pin’s image media.

dimension

media.images.1200x.width

media.images.1200x.width

The width of the 1200x scaled version of the Pin’s image media.

metric

media.images.150x150.height

media.images.150x150.height

The height of the 150x150 scaled version of the Pin’s image media.

metric

media.images.150x150.url

media.images.150x150.url

The URL of the 150x150 scaled version of the Pin’s image media.

dimension

media.images.150x150.width

media.images.150x150.width

The width of the 150x150 scaled version of the Pin’s image media.

metric

media.images.400x300.height

media.images.400x300.height

The height of the 400x300 scaled version of the Pin’s image media.

metric

media.images.400x300.url

media.images.400x300.url

The URL of the 400x300 scaled version of the Pin’s image media.

dimension

media.images.400x300.width

media.images.400x300.width

The width of the 400x300 scaled version of the Pin’s image media.

metric

media.images.600x.height

media.images.600x.height

The height of the 600x scaled version of the Pin’s image media.

metric

media.images.600x.url

media.images.600x.url

The URL of the 600x scaled version of the Pin’s image media.

dimension

media.images.600x.width

media.images.600x.width

The width of the 600x scaled version of the Pin’s image media.

metric

media.images.originals.height

media.images.originals.height

The height of the original image media of the Pin.

dimension

media.images.originals.url

media.images.originals.url

The URL of the original, high-resolution image associated with a Pin.

dimension

media.images.originals.width

media.images.originals.width

The width of the original image media of the Pin.

dimension

media.items

media.items

A list of media items associated with a Pin, particularly for multi-image or video Pins.

dimension

media.media_type

media.media_type

The type of media associated with the Pin, such as image or video.

dimension

media.video_url

media.video_url

The URL of the video content embedded in a Pin.

dimension

media.width

media.width

The width of the primary media asset in a Pin.

metric

media_platform_id

media_platform_id

The unique identifier for the media platform.

dimension

monthly_views

monthly_views

The total number of views an account or Pin receives within a month.

metric

name

name

The name of the entity, such as a campaign, ad group, or Pin.

dimension

offline_checkout_cost_per_action

offline_checkout_cost_per_action

The cost incurred for each offline “checkout” action, calculated as total ad spend divided by the number of offline “checkout” events.

dimension

offline_checkout_roas

offline_checkout_roas

The return on ad spend (ROAS) for offline “checkout” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

offline_custom_cost_per_action

offline_custom_cost_per_action

The cost incurred for each offline “custom” action, calculated as total ad spend divided by the number of offline “custom” events.

dimension

offline_custom_roas

offline_custom_roas

The return on ad spend (ROAS) for offline “custom” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

offline_lead_cost_per_action

offline_lead_cost_per_action

The cost incurred for each offline “lead” action, calculated as total ad spend divided by the number of offline “lead” events.

dimension

offline_lead_roas

offline_lead_roas

The return on ad spend (ROAS) for offline “lead” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

offline_signup_cost_per_action

offline_signup_cost_per_action

The cost incurred for each offline “signup” action, calculated as total ad spend divided by the number of offline “signup” events.

dimension

offline_signup_roas

offline_signup_roas

The return on ad spend (ROAS) for offline “signup” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

offline_unknown_cost_per_action

offline_unknown_cost_per_action

The cost incurred for each offline “unknown” action, calculated as total ad spend divided by the number of offline “unknown” events.

dimension

offline_unknown_roas

offline_unknown_roas

The return on ad spend (ROAS) for offline “unknown” actions, indicating the revenue generated per dollar spent on advertising for these actions.

dimension

optimization_goal

optimization_goal

The goal set for optimizing campaign or ad group performance, such as awareness, consideration, or web conversion.

dimension

order_line_id

order_line_id

Unique identifier for the order line within an advertising campaign.

dimension

order_line_name

order_line_name

The name of the order line within an advertising campaign.

dimension

orderquantity

orderquantity

The total quantity of items in an order.

metric

ordervalue

ordervalue

The total value of an order.

metric

outbound_click

outbound_click

The number of clicks that take users off Pinterest to a destination URL.

metric

outbound_click_rate

outbound_click_rate

The rate of clicks that lead users off the Pinterest platform to an external destination.

metric

outbound_clicks

outbound_clicks

Total number of clicks that lead users off of Pinterest.

dimension

outbound_ctr

outbound_ctr

The click-through rate for clicks that lead users off the Pinterest platform.

dimension

owner.id

owner.id

Unique identifier of the user who owns the Pin.

metric

owner.username

owner.username

The username of the user who owns the Pin.

dimension

page_visit_cost_per_action

page_visit_cost_per_action

The cost incurred for each page visit action, calculated as total ad spend divided by the number of page visit events.

dimension

page_visit_desktop_action_desktop_conversion

page_visit_desktop_action_desktop_conversion

The number of “page visit” conversions that originated from a desktop action (e.g., a click or engagement) on a desktop device.

metric

page_visit_desktop_action_mobile_conversion

page_visit_desktop_action_mobile_conversion

The number of “page visit” conversions that originated from a desktop action (e.g., a click or engagement) on a mobile device.

metric

page_visit_desktop_action_tablet_conversion

page_visit_desktop_action_tablet_conversion

The number of “page visit” conversions that originated from a desktop action (e.g., a click or engagement) on a tablet device.

metric

page_visit_mobile_action_desktop_conversion

page_visit_mobile_action_desktop_conversion

The number of “page visit” conversions that originated from a mobile action (e.g., a click or engagement) on a desktop device.

metric

page_visit_mobile_action_mobile_conversion

page_visit_mobile_action_mobile_conversion

The number of “page visit” conversions that originated from a mobile action (e.g., a click or engagement) on a mobile device.

metric

page_visit_mobile_action_tablet_conversion

page_visit_mobile_action_tablet_conversion

The number of “page visit” conversions that originated from a mobile action (e.g., a click or engagement) on a tablet device.

metric

page_visit_roas

page_visit_roas

The return on ad spend (ROAS) for page visit actions, indicating the revenue generated per dollar spent on advertising for these actions.

metric

page_visit_tablet_action_desktop_conversion

page_visit_tablet_action_desktop_conversion

The number of “page visit” conversions that originated from a tablet action (e.g., a click or engagement) on a desktop device.

metric

page_visit_tablet_action_mobile_conversion

page_visit_tablet_action_mobile_conversion

The number of “page visit” conversions that originated from a tablet action (e.g., a click or engagement) on a mobile device.

metric

page_visit_tablet_action_tablet_conversion

page_visit_tablet_action_tablet_conversion

The number of “page visit” conversions that originated from a tablet action (e.g., a click or engagement) on a tablet device.

metric

paid_average_video_watch_time

paid_average_video_watch_time

The average watch time for paid video content.

metric

paid_budget

paid_budget

The budget specifically allocated for paid promotions.

metric

paid_clicks

paid_clicks

The number of clicks attributed to paid ads.

dimension

paid_closeups

paid_closeups

The number of times users viewed a Promoted Pin in closer detail (e.g., clicked to expand) due to paid promotion.

dimension

paid_engagements

paid_engagements

The number of engagements attributed to paid ads.

metric

paid_impression

paid_impression

The number of impressions attributed to paid ads.

metric

paid_impressions

paid_impressions

The total number of impressions attributed to paid ads.

dimension

paid_saves

paid_saves

The number of saves attributed to paid ads.

dimension

paid_type

paid_type

The type of payment used for the ad or promotion.

dimension

paid_video_starts

paid_video_starts

The number of times a paid video started playing.

metric

paid_video_views

paid_video_views

The number of views for paid video content.

metric

paid_video_watched_at_100%

paid_video_watched_at_100%

The number of times a paid video was watched to 100% completion.

metric

paid_video_watched_at_25%

paid_video_watched_at_25%

The number of times a paid video was watched to at least 25% completion.

metric

paid_video_watched_at_50%

paid_video_watched_at_50%

The number of times a paid video was watched to at least 50% completion.

metric

paid_video_watched_at_75%

paid_video_watched_at_75%

The number of times a paid video was watched to at least 75% completion.

metric

paid_video_watched_at_95%

paid_video_watched_at_95%

The number of times a paid video was watched to at least 95% completion.

metric

parent_pin_id

parent_pin_id

Unique identifier of the original Pin from which a repin or variant was created.

dimension

periodicity

periodicity

The frequency or interval at which data is reported or aggregated.

dimension

pin_ad_creative_type

pin_ad_creative_type

The creative type of the promoted Pin or ad, indicating its format or style.

dimension

pin_alt_text

pin_alt_text

The descriptive alternative text provided for a Pin, used for accessibility (screen readers) and to help Pinterest’s algorithm understand and categorize the content.

dimension

pin_attribution

pin_attribution

Information regarding how a conversion or action is attributed to a specific Pin, often based on defined attribution windows for clicks, engagements, or views.

dimension

pin_board_id

pin_board_id

The unique identifier of the board to which the Pin belongs.

dimension

pin_board_owner

pin_board_owner

Information about the owner of the board to which the Pin belongs, including their username.

dimension

pin_board_section_id

pin_board_section_id

The unique identifier of the board section to which the Pin belongs.

dimension

pin_cacheable_id

pin_cacheable_id

A unique identifier for a Pin that can be cached.

dimension

pin_click

pin_click

The number of times a Pin was clicked.

metric

pin_click_rate

pin_click_rate

The rate at which users click on a Pin.

metric

pin_clickthrough

pin_clickthrough

The total number of clicks on a Pin, including both organic and paid clicks.

metric

pin_clickthrough_rate

pin_clickthrough_rate

The ratio of total clicks on a Pin to its total impressions, expressed as a rate.

metric

pin_closeup

pin_closeup

The total number of times users clicked on a Pin to view it in closeup.

metric

pin_closeup_rate

pin_closeup_rate

The rate at which users clicked on a Pin to view it in closeup, relative to impressions.

metric

pin_comment_count

pin_comment_count

The total number of comments on a Pin.

metric

pin_count

pin_count

The total number of Pins associated with an account or board.

metric

pin_created_at

pin_created_at

The timestamp indicating when the Pin was created.

dimension

pin_description

pin_description

The textual description provided for the Pin.

dimension

pin_domain

pin_domain

The domain from which the Pin originates or is linked.

dimension

pin_dominant_color

pin_dominant_color

The dominant color of the Pin, represented as a hex code.

dimension

pin_engagement

pin_engagement

The total number of interactions with a Pin, including saves, clicks, outbound clicks, carousel swipes, and other engagements.

metric

pin_engagement_rate

pin_engagement_rate

The rate of total engagements on a Pin relative to its total impressions.

metric

pin_format_list

pin_format_list

A list of formats applicable to the Pin, such as standard, video, or product Pin.

dimension

pin_id

pin_id

The unique identifier for the Pin.

dimension

pin_image_large_size_pixels

pin_image_large_size_pixels

The pixel dimensions (width and height) of the large image variant of a Pin.

dimension

pin_image_large_size_points

pin_image_large_size_points

The size of the large image variant of the Pin, measured in points.

dimension

pin_image_large_url

pin_image_large_url

The URL for the large image variant of a Pin.

dimension

pin_image_medium_size_pixels

pin_image_medium_size_pixels

The pixel dimensions (width and height) of the medium image variant of a Pin.

dimension

pin_image_medium_size_points

pin_image_medium_size_points

The size of the medium image variant of the Pin, measured in points.

dimension

pin_image_medium_url

pin_image_medium_url

The URL for the medium image variant of a Pin.

dimension

pin_image_square_size_pixels

pin_image_square_size_pixels

The pixel dimensions (width and height) of the square image variant of a Pin.

dimension

pin_image_square_size_points

pin_image_square_size_points

The size of the square image variant of the Pin, measured in points.

dimension

pin_image_square_url

pin_image_square_url

The URL for the square image variant of a Pin.

dimension

pin_impression

pin_impression

The total number of times the Pin was displayed on screen, including both organic and paid impressions.

metric

pin_in_profile_list

pin_in_profile_list

Indicates whether the Pin is currently included in a user’s profile list.

dimension

pin_is_canonicalized

pin_is_canonicalized

Indicates if the Pin has been canonicalized, meaning it’s the primary version of similar Pins.

dimension

pin_is_downstream_promotion

pin_is_downstream_promotion

Indicates whether the Pin is part of a downstream promotion or a series of promotional content.

dimension

pin_is_in_profile

pin_is_in_profile

Indicates whether the Pin is currently displayed within a user’s profile.

dimension

pin_is_paid

pin_is_paid

A boolean value indicating whether the Pin is a paid (promoted) Pin.

dimension

pin_is_playable

pin_is_playable

Indicates if the Pin contains playable media, such as a video.

dimension

pin_is_promotable

pin_is_promotable

Indicates if the Pin is eligible to be promoted as an advertisement.

dimension

pin_is_repin

pin_is_repin

Indicates if the Pin is a re-pin (a save of another user’s Pin).

dimension

pin_is_uploaded

pin_is_uploaded

Indicates whether the Pin was directly uploaded by a user rather than sourced from a website.

dimension

pin_is_video

pin_is_video

A boolean value indicating whether the Pin contains video content.

dimension

pin_link

pin_link

The URL or link that the Pin directs users to when clicked.

dimension

pin_media

pin_media

Details about the media content of the Pin, such as image URLs and dimensions for various sizes.

dimension

pin_metrics

pin_metrics

A container for various performance metrics related to a Pin.

metric

pin_metrics.90d.impression

pin_metrics.90d.impression

The number of impressions for a Pin over a 90-day period.

metric

pin_metrics.90d.last_updated

pin_metrics.90d.last_updated

The timestamp indicating when the 90-day Pin metrics were last updated.

metric

pin_metrics.90d.outbound_click

pin_metrics.90d.outbound_click

The number of outbound clicks for a Pin over a 90-day period.

metric

pin_metrics.90d.pin_click

pin_metrics.90d.pin_click

The number of clicks on a Pin over a 90-day period.

metric

pin_metrics.90d.profile_visit

pin_metrics.90d.profile_visit

The number of profile visits generated from a Pin over a 90-day period.

metric

pin_metrics.90d.save

pin_metrics.90d.save

The number of saves (re-pins) for a Pin over a 90-day period.

metric

pin_metrics.90d.user_follow

pin_metrics.90d.user_follow

The number of user follows generated from a Pin over a 90-day period.

metric

pin_metrics.90d.video_10s_views

pin_metrics.90d.video_10s_views

The number of video views for at least 10 seconds for a Pin over a 90-day period.

metric

pin_metrics.90d.video_average_time

pin_metrics.90d.video_average_time

The average watch time for video content within a Pin over a 90-day period.

metric

pin_metrics.90d.video_p95_views

pin_metrics.90d.video_p95_views

The number of video views where at least 95% of the video content was watched for a Pin over a 90-day period.

metric

pin_metrics.90d.video_total_time

pin_metrics.90d.video_total_time

The total watch time for video content within a Pin over a 90-day period.

metric

pin_metrics.90d.video_views

pin_metrics.90d.video_views

The total number of video views for a Pin over a 90-day period.

metric

pin_metrics.all_time.comment

pin_metrics.all_time.comment

The total number of comments received on a Pin across all time.

metric

pin_metrics.all_time.impression

pin_metrics.all_time.impression

The total number of times a Pin or ad was displayed on screen, including both organic and paid impressions.

metric

pin_metrics.all_time.last_updated

pin_metrics.all_time.last_updated

The timestamp when the all-time metrics for a Pin were last updated.

metric

pin_metrics.all_time.message

pin_metrics.all_time.message

The total number of messages related to a Pin over all time.

metric

pin_metrics.all_time.outbound_click

pin_metrics.all_time.outbound_click

The total number of clicks on a Pin or ad that led users to a destination outside of Pinterest.

metric

pin_metrics.all_time.pin_click

pin_metrics.all_time.pin_click

The total number of times users clicked on a Pin to view it in closeup on Pinterest.

metric

pin_metrics.all_time.profile_visit

pin_metrics.all_time.profile_visit

The total number of profile visits attributed to a Pin over all time.

metric

pin_metrics.all_time.reaction

pin_metrics.all_time.reaction

The total number of reactions (e.g., likes, love, wow) received by a Pin over all time.

metric

pin_metrics.all_time.save

pin_metrics.all_time.save

The total number of times users saved the Pin to one of their boards.

metric

pin_metrics.all_time.user_follow

pin_metrics.all_time.user_follow

The total number of new user follows generated by a Pin over all time.

metric

pin_metrics.all_time.video_10s_views

pin_metrics.all_time.video_10s_views

The total number of times a video Pin was viewed for at least 10 seconds.

metric

pin_metrics.all_time.video_average_time

pin_metrics.all_time.video_average_time

The average duration in seconds that users spent watching the video content of the Pin.

metric

pin_metrics.all_time.video_p95_views

pin_metrics.all_time.video_p95_views

The number of times a video Pin was viewed to at least 95% of its total length.

metric

pin_metrics.all_time.video_total_time

pin_metrics.all_time.video_total_time

The total accumulated duration, in minutes, that users spent watching the video content of the Pin.

metric

pin_metrics.all_time.video_views

pin_metrics.all_time.video_views

The total number of times a video Pin was viewed for at least 2 seconds with at least 50% of the video in view.

metric

pin_native_format_type

pin_native_format_type

The native format type of the Pin (e.g., image, video, carousel).

metric

pin_not_promotable_reason

pin_not_promotable_reason

Provides the reason why a Pin is not eligible for promotion.

dimension

pin_paid_list

pin_paid_list

A list or indicator related to Pins that have been part of paid promotions.

dimension

pin_parent_pin_id

pin_parent_pin_id

The unique identifier of the original Pin if this Pin was saved (re-pinned) from another Pin.

dimension

pin_price_currency

pin_price_currency

The currency of the product’s price associated with the Pin, using ISO 4217 currency codes.

dimension

pin_price_value

pin_price_value

The numerical value of the product’s price associated with the Pin.

metric

pin_promoter

pin_promoter

The user or account promoting the Pin.

dimension

pin_promotion_ad_account_id

pin_promotion_ad_account_id

The unique identifier of the ad account responsible for the promotion of the Pin.

dimension

pin_promotion_android_deep_link

pin_promotion_android_deep_link

The deep link URL for Android devices that directs users to a specific location within a mobile application when they interact with a promoted Pin.

dimension

pin_promotion_campaign_id

pin_promotion_campaign_id

The unique identifier of the campaign under which the Pin is being promoted.

dimension

pin_promotion_campaign_objective_type

pin_promotion_campaign_objective_type

The objective type of the campaign for a promoted Pin (e.g., brand awareness, traffic, conversions).

metric

pin_promotion_carousel_android_deep_links

pin_promotion_carousel_android_deep_links

A list of Android deep link URLs used for individual cards within a carousel ad, directing users to specific in-app content when they interact with a promoted Pin.

dimension

pin_promotion_carousel_destination_urls

pin_promotion_carousel_destination_urls

A list of destination URLs for individual cards within a carousel ad, specifying where users are directed when they click on a particular card in a promoted Pin.

dimension

pin_promotion_carousel_ios_deep_links

pin_promotion_carousel_ios_deep_links

A list of iOS deep link URLs used for individual cards within a carousel ad, directing users to specific in-app content when they interact with a promoted Pin.

dimension

pin_promotion_click_tracking_url

pin_promotion_click_tracking_url

The URL used to track clicks on a promoted Pin for conversion and performance monitoring.

dimension

pin_promotion_collection_items_destination_url_template

pin_promotion_collection_items_destination_url_template

The URL template used for destination links of items within a collection Pin promotion.

dimension

pin_promotion_created_time

pin_promotion_created_time

The date and time when the promoted Pin was created.

dimension

pin_promotion_creative_type

pin_promotion_creative_type

The creative type of the promoted Pin, such as standard image, video, carousel, or collection.

dimension

pin_promotion_destination_url

pin_promotion_destination_url

The landing page URL where users are directed after clicking on the promoted Pin.

dimension

pin_promotion_id

pin_promotion_id

The unique identifier for a promoted Pin.

dimension

pin_promotion_ios_deep_link

pin_promotion_ios_deep_link

A deep link URL for iOS devices, used to direct users to specific content within an app after clicking a promoted Pin.

dimension

pin_promotion_is_pin_deleted

pin_promotion_is_pin_deleted

Indicates whether the Pin associated with the promotion has been deleted.

dimension

pin_promotion_is_removable

pin_promotion_is_removable

Indicates whether the promoted Pin can be removed.

dimension

pin_promotion_name

pin_promotion_name

The name of the promoted Pin.

dimension

pin_promotion_pin_id

pin_promotion_pin_id

The unique identifier of the promoted Pin.

dimension

pin_promotion_rejected_reasons

pin_promotion_rejected_reasons

A list of reasons why the promoted Pin was rejected during the ad review process.

dimension

pin_promotion_rejection_labels

pin_promotion_rejection_labels

Labels indicating reasons for the rejection of a promoted Pin.

dimension

pin_promotion_review_status

pin_promotion_review_status

The current review status of the promoted Pin, indicating if it’s approved, pending, or rejected.

dimension

pin_promotion_status

pin_promotion_status

The status of a promoted Pin, such as APPROVED, PAUSED, or REJECTED.

dimension

pin_promotion_summary_status

pin_promotion_summary_status

The overall status of a Pin promotion, summarizing its current state.

dimension

pin_promotion_tracking_urls

pin_promotion_tracking_urls

A collection of URLs used for tracking various events related to the promoted Pin, beyond just clicks or views.

dimension

pin_promotion_type

pin_promotion_type

The type of promotion used for the Pin.

dimension

pin_promotion_updated_time

pin_promotion_updated_time

The date and time when the promoted Pin was last updated.

dimension

pin_promotion_view_tracking_url

pin_promotion_view_tracking_url

The URL used to track views of the promoted Pin.

dimension

pin_repin_count

pin_repin_count

The total number of times the Pin has been re-pinned (saved) by other users.

metric

pin_save

pin_save

The total number of times the Pin was saved to a user’s board.

metric

pin_save_rate

pin_save_rate

The rate at which the Pin was saved relative to its total impressions.

metric

pin_title

pin_title

The title of the Pin.

dimension

pin_tracked_link

pin_tracked_link

The URL used for tracking clicks or views associated with the Pin, distinct from the primary destination URL.

dimension

pin_tracking_params

pin_tracking_params

Parameters appended to the Pin’s URL for analytics and tracking purposes, such as UTM parameters.

dimension

pin_type

pin_type

The classification or format of the Pin, such as standard, video, or product Pin.

dimension

pinterest_checkout_cost_per_action

pinterest_checkout_cost_per_action

The average cost incurred for each checkout action completed by users originating from Pinterest ads. This is a computed metric from ad analytics.

dimension

pinterest_checkout_roas

pinterest_checkout_roas

The Return on Ad Spend (ROAS) for checkout actions on Pinterest, indicating the revenue generated per unit of ad spend for checkouts. This is a computed metric from ad analytics.

dimension

pinterest_total_clicks

pinterest_total_clicks

The total number of clicks on Pinterest content, including both paid and organic clicks.

metric

pinterest_total_impressions

pinterest_total_impressions

The total number of impressions on Pinterest content, including both paid and organic impressions.

metric

pinterest_total_saves

pinterest_total_saves

The total number of times Pinterest content has been saved, including both paid and organic saves.

metric

platform

platform

The platform where the ad or content was displayed.

dimension

platform_id

platform_id

The unique identifier for the platform.

dimension

platform_name

platform_name

The name of the advertising or content platform.

dimension

product

product

The product being advertised or associated with a Pin.

dimension

product_group_id

product_group_id

The unique identifier for a product group.

dimension

product_item_id

product_item_id

The unique identifier for a product item within a catalog.

dimension

product_tags

product_tags

Tags associated with products featured in the Pin, used for catalog and shopping management.

dimension

profile_image

profile_image

The URL or identifier for the profile image of the user account associated with the Pin.

dimension

profile_reach_last_30_days

profile_reach_last_30_days

The number of unique users who have seen the profile within the last 30 days.

metric

profile_views

profile_views

The total number of times the associated user profile was viewed.

metric

profile_visit

profile_visit

The number of times a user visited the profile associated with the content.

metric

promo_id

promo_id

Unique identifier for a promotion associated with a Pin.

dimension

purchase_order_id

purchase_order_id

The identifier for a purchase order associated with a transaction.

dimension

purchases_total

purchases_total

The total number of purchase conversion events.

metric

quartile_95_percent_view

quartile_95_percent_view

The number of times a video played to at least 95% of its duration.

dimension

repin_count

repin_count

The number of times a Pin was saved by other users.

metric

repin_rate

repin_rate

The rate at which Pins are saved by other users.

metric

report_id

report_id

The unique identifier for a generated report.

dimension

report_type

report_type

The category or type of the generated report (e.g., performance, audience).

dimension

revenue

revenue

The total revenue generated from attributed actions.

metric

revenue_total

revenue_total

The total revenue generated from all attributed actions.

metric

save

save

The number of times a Pin was saved to a board.

metric

save_rate

save_rate

The rate at which Pins are saved, calculated as saves divided by impressions.

metric

scope

scope

Defines the permissions granted to an application to access specific user data or functionalities.

dimension

search_desktop_action_desktop_conversion

search_desktop_action_desktop_conversion

The number of search actions leading to a conversion on a desktop device, where the initial action also occurred on a desktop device.

metric

search_desktop_action_mobile_conversion

search_desktop_action_mobile_conversion

The number of search actions leading to a conversion on a mobile device, where the initial action occurred on a desktop device.

metric

search_desktop_action_tablet_conversion

search_desktop_action_tablet_conversion

The number of search actions leading to a conversion on a tablet device, where the initial action occurred on a desktop device.

dimension

search_mobile_action_desktop_conversion

search_mobile_action_desktop_conversion

The number of search actions leading to a conversion on a desktop device, where the initial action occurred on a mobile device.

metric

search_mobile_action_mobile_conversion

search_mobile_action_mobile_conversion

The number of search actions leading to a conversion on a mobile device, where the initial action also occurred on a mobile device.

metric

search_mobile_action_tablet_conversion

search_mobile_action_tablet_conversion

The number of search actions leading to a conversion on a tablet device, where the initial action occurred on a mobile device.

metric

search_tablet_action_desktop_conversion

search_tablet_action_desktop_conversion

The number of search actions leading to a conversion on a desktop device, where the initial action occurred on a tablet device.

metric

search_tablet_action_mobile_conversion

search_tablet_action_mobile_conversion

The number of search actions leading to a conversion on a mobile device, where the initial action occurred on a tablet device.

metric

search_tablet_action_tablet_conversion

search_tablet_action_tablet_conversion

The number of search actions leading to a conversion on a tablet device, where the initial action also occurred on a tablet device.

metric

sharable_link

sharable_link

A direct URL that can be used to share the Pin on or off the Pinterest platform.

dimension

showcase_card_thumbnail_swipe_backward

showcase_card_thumbnail_swipe_backward

The count of backward swipes on showcase card thumbnails. This is an engagement metric for showcase ad formats.

dimension

showcase_card_thumbnail_swipe_forward

showcase_card_thumbnail_swipe_forward

The count of forward swipes on showcase card thumbnails. This is an engagement metric for showcase ad formats.

dimension

showcase_pin_clickthrough

showcase_pin_clickthrough

The number of click-throughs on a Showcase Pin.

dimension

showcase_subpage_clickthrough

showcase_subpage_clickthrough

The total number of clickthroughs on a showcase subpage. This is an engagement metric for showcase ad formats.

dimension

showcase_subpage_closeup

showcase_subpage_closeup

The total number of closeups (enlarged views) of content on a showcase subpage. This is an engagement metric for showcase ad formats.

dimension

showcase_subpage_impression

showcase_subpage_impression

The total number of impressions (views) of a showcase subpage. This is a visibility metric for showcase ad formats.

dimension

showcase_subpage_repin

showcase_subpage_repin

The total number of repins (saves) from a showcase subpage. This is an engagement metric for showcase ad formats.

dimension

showcase_subpage_swipe_left

showcase_subpage_swipe_left

The count of left swipes on a showcase subpage. This is an engagement metric for showcase ad formats.

dimension

showcase_subpage_swipe_right

showcase_subpage_swipe_right

The count of right swipes on a showcase subpage. This is an engagement metric for showcase ad formats.

dimension

showcase_subpin_clickthrough

showcase_subpin_clickthrough

The total number of clickthroughs on a subpin within a showcase. This is an engagement metric for showcase ad formats.

dimension

showcase_subpin_impression

showcase_subpin_impression

The total number of impressions (views) of a subpin within a showcase. This is a visibility metric for showcase ad formats.

dimension

showcase_subpin_repin

showcase_subpin_repin

The total number of repins (saves) from a subpin within a showcase. This is an engagement metric for showcase ad formats.

dimension

showcase_subpin_swipe_left

showcase_subpin_swipe_left

The count of left swipes on a subpin within a showcase. This is an engagement metric for showcase ad formats.

dimension

showcase_subpin_swipe_right

showcase_subpin_swipe_right

The count of right swipes on a subpin within a showcase. This is an engagement metric for showcase ad formats.

dimension

signup_desktop_action_desktop_conversion

signup_desktop_action_desktop_conversion

The number of signup actions leading to a conversion on a desktop device, where the initial action also occurred on a desktop device.

dimension

signup_desktop_action_mobile_conversion

signup_desktop_action_mobile_conversion

The number of signup actions leading to a conversion on a mobile device, where the initial action occurred on a desktop device.

dimension

signup_desktop_action_tablet_conversion

signup_desktop_action_tablet_conversion

The number of signup actions leading to a conversion on a tablet device, where the initial action occurred on a desktop device.

dimension

signup_mobile_action_desktop_conversion

signup_mobile_action_desktop_conversion

The number of signup actions leading to a conversion on a desktop device, where the initial action occurred on a mobile device.

dimension

signup_mobile_action_mobile_conversion

signup_mobile_action_mobile_conversion

The number of signup actions leading to a conversion on a mobile device, where the initial action also occurred on a mobile device.

dimension

signup_mobile_action_tablet_conversion

signup_mobile_action_tablet_conversion

The number of signup actions leading to a conversion on a tablet device, where the initial action occurred on a mobile device.

dimension

signup_tablet_action_desktop_conversion

signup_tablet_action_desktop_conversion

The number of signup actions leading to a conversion on a desktop device, where the initial action occurred on a tablet device.

dimension

signup_tablet_action_mobile_conversion

signup_tablet_action_mobile_conversion

The number of signup actions leading to a conversion on a mobile device, where the initial action occurred on a tablet device.

dimension

signup_tablet_action_tablet_conversion

signup_tablet_action_tablet_conversion

The number of signup actions leading to a conversion on a tablet device, where the initial action also occurred on a tablet device.

dimension

size

size

The size of a specific entity, such as an image or a collection.

dimension

size_is_upper_bound

size_is_upper_bound

Indicates if the reported size represents an upper bound or maximum value.

dimension

social_platform

social_platform

The specific social media platform where the ad or content is displayed.

dimension

source_platform

source_platform

The platform from which the data originates.

dimension

spend

spend

The total amount of money spent on ads.

metric

spend_in_account_currency

spend_in_account_currency

The total amount spent in the ad account’s local currency.

metric

spend_in_account_currency_micro

spend_in_account_currency_micro

The total amount of money spent on ads, expressed in microunits of the ad account’s currency.

metric

spend_in_account_currency_micro_GBP

spend_in_account_currency_micro_GBP

The total amount spent, expressed in micro-units of Great British Pounds.

metric

spend_in_account_currency_micro_float

spend_in_account_currency_micro_float

The total amount spent by the advertiser, expressed in micro-units of the account’s primary currency.

metric

spend_in_dollar

spend_in_dollar

The total amount of money spent on ads, expressed in US dollars.

metric

start_time

start_time

The start date and time (in UTC) for which the data is being reported or when an entity (e.g., ad group, campaign) began.

metric

status

status

The current operational status of an entity, such as an ad group, campaign, or promoted Pin.

dimension

target

target

The specific audience or criteria defined for ad delivery.

dimension

targeting

targeting

Detailed criteria and parameters applied for audience targeting in an ad campaign.

dimension

targeting_description

targeting_description

A description of the specific targeting criteria used for an ad or ad group.

dimension

targeting_type

targeting_type

The category of targeting used for an ad, such as ‘AGE_BUCKET’, ‘GENDER’, ‘LOCATION’, or ‘KEYWORD’.

dimension

targeting_value

targeting_value

The specific value within a targeting type, such as ‘45-49’ for ‘AGE_BUCKET’ or ‘female’ for ‘GENDER’.

dimension

title

title

The title of the Pin or Board.

dimension

to_currency_eur

to_currency_eur

Indicates if the target currency for conversion is Euros.

dimension

to_currency_usd

to_currency_usd

Indicates if the target currency for conversion is US Dollars.

dimension

total conversions

total conversions

The total number of conversion events across all attribution types.

metric

total_checkout_conversion_rate

total_checkout_conversion_rate

The rate at which users complete a checkout after interacting with an ad or Pin.

metric

total_clickthrough

total_clickthrough

The total number of clicks on a Pin or ad that led to a destination.

metric

total_conversion_quantity

total_conversion_quantity

The total number of conversions.

dimension

total_conversion_value

total_conversion_value

The total value of all conversions.

metric

total_conversion_value_micro

total_conversion_value_micro

The total value of all conversions in microcurrency.

metric

total_idea_pin_product_tag_visit

total_idea_pin_product_tag_visit

The total number of visits to product tags within Idea Pins.

dimension

total_impression

total_impression

The total number of impressions, including both paid and organic.

metric

total_impression_frequency

total_impression_frequency

The average number of times an individual user saw an impression from your ads or organic pins.

metric

total_impression_user

total_impression_user

The total number of unique users who saw an ad or Pin.

metric

total_inapp_add_to_cart

total_inapp_add_to_cart

The total number of ‘add to cart’ events recorded within the Pinterest app.

dimension

total_inapp_add_to_cart_value

total_inapp_add_to_cart_value

The total monetary value generated from ‘add to cart’ events occurring within the app, resulting from interactions with your ads.

dimension

total_inapp_add_to_cart_value_micro

total_inapp_add_to_cart_value_micro

The total monetary value, in micro-dollars, of ‘add to cart’ events recorded within the Pinterest app.

metric

total_inapp_app_install

total_inapp_app_install

The total number of app install events recorded within the Pinterest app.

dimension

total_inapp_app_install_value

total_inapp_app_install_value

The total monetary value generated from ‘app install’ events occurring within the app, resulting from interactions with your ads.

dimension

total_inapp_app_install_value_micro

total_inapp_app_install_value_micro

The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app.

metric

total_inapp_checkout

total_inapp_checkout

The total number of in-app checkout conversions.

dimension

total_inapp_checkout_value

total_inapp_checkout_value

The total value of in-app checkout conversions.

dimension

total_inapp_checkout_value_micro

total_inapp_checkout_value_micro

The total value of in-app checkout conversions in microcurrency.

metric

total_inapp_click_add_to_cart

total_inapp_click_add_to_cart

The total number of ‘add to cart’ events recorded within the Pinterest app that were attributed to a click interaction.

dimension

total_inapp_click_add_to_cart_value

total_inapp_click_add_to_cart_value

The total monetary value generated from ‘add to cart’ events occurring within the app, resulting from clicks on your ads.

dimension

total_inapp_click_add_to_cart_value_micro

total_inapp_click_add_to_cart_value_micro

The total monetary value, in micro-dollars, of ‘add to cart’ events recorded within the Pinterest app that were attributed to a click interaction.

metric

total_inapp_click_app_install

total_inapp_click_app_install

The total number of app install events recorded within the Pinterest app that were attributed to a click interaction.

dimension

total_inapp_click_app_install_value

total_inapp_click_app_install_value

The total monetary value generated from ‘app install’ events occurring within the app, resulting from clicks on your ads.

dimension

total_inapp_click_app_install_value_micro

total_inapp_click_app_install_value_micro

The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app that were attributed to a click interaction.

metric

total_inapp_click_app_install_value_micro)

total_inapp_click_app_install_value_micro)

The total value of in-app app install events resulting from clicks on ads, measured in micro currency.

dimension

total_inapp_click_checkout

total_inapp_click_checkout

The total number of checkout events recorded within the Pinterest app that were attributed to a click interaction.

dimension

total_inapp_click_checkout_value

total_inapp_click_checkout_value

The total value of in-app checkout conversions attributed to click actions.

metric

total_inapp_click_checkout_value_micro

total_inapp_click_checkout_value_micro

The total value of in-app checkout conversions in microcurrency attributed to click actions.

metric

total_inapp_click_search

total_inapp_click_search

The total number of search events recorded within the Pinterest app that were attributed to a click interaction.

dimension

total_inapp_click_search_value

total_inapp_click_search_value

The total value of in-app search events resulting from clicks on ads.

dimension

total_inapp_click_search_value_micro

total_inapp_click_search_value_micro

The total monetary value, in micro-dollars, associated with search events recorded within the Pinterest app that were attributed to a click interaction.

metric

total_inapp_click_signup

total_inapp_click_signup

The total number of signup events recorded within the Pinterest app that were attributed to a click interaction.

dimension

total_inapp_click_signup_value

total_inapp_click_signup_value

The total value of in-app signup events resulting from clicks on ads.

dimension

total_inapp_click_signup_value_micro

total_inapp_click_signup_value_micro

The total monetary value, in micro-dollars, associated with signup events recorded within the Pinterest app that were attributed to a click interaction.

metric

total_inapp_click_unknown

total_inapp_click_unknown

The total number of undefined conversion events recorded within the Pinterest app that were attributed to a click interaction.

dimension

total_inapp_click_unknown_value

total_inapp_click_unknown_value

The total value generated from in-app clicks for an unknown conversion type.

dimension

total_inapp_click_unknown_value_micro

total_inapp_click_unknown_value_micro

The total monetary value, in micro-dollars, associated with undefined conversion events recorded within the Pinterest app that were attributed to a click interaction.

metric

total_inapp_engagement_add_to_cart

total_inapp_engagement_add_to_cart

The total number of ‘add to cart’ events recorded within the Pinterest app that were attributed to an engagement (saves, closeups, link clicks, carousel swipes).

dimension

total_inapp_engagement_add_to_cart_value

total_inapp_engagement_add_to_cart_value

The total monetary value generated from ‘add to cart’ events occurring within the app, resulting from engagement with your ads.

dimension

total_inapp_engagement_add_to_cart_value_micro

total_inapp_engagement_add_to_cart_value_micro

The total monetary value, in micro-dollars, of ‘add to cart’ events recorded within the Pinterest app that were attributed to an engagement.

metric

total_inapp_engagement_app_install

total_inapp_engagement_app_install

The total number of app install events recorded within the Pinterest app that were attributed to an engagement.

dimension

total_inapp_engagement_app_install_value

total_inapp_engagement_app_install_value

The total monetary value generated from ‘app install’ events occurring within the app, resulting from engagement with your ads.

dimension

total_inapp_engagement_app_install_value_micro

total_inapp_engagement_app_install_value_micro

The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app that were attributed to an engagement.

metric

total_inapp_engagement_checkout

total_inapp_engagement_checkout

The total number of in-app checkout conversions attributed to engagement actions.

dimension

total_inapp_engagement_checkout_value

total_inapp_engagement_checkout_value

The total value of in-app checkout conversions attributed to engagement actions.

metric

total_inapp_engagement_checkout_value_micro

total_inapp_engagement_checkout_value_micro

The total value of in-app checkout conversions in microcurrency attributed to engagement actions.

metric

total_inapp_engagement_search

total_inapp_engagement_search

The total number of search events recorded within the Pinterest app that were attributed to an engagement.

dimension

total_inapp_engagement_search_value

total_inapp_engagement_search_value

The total value generated from in-app engagements related to search events.

dimension

total_inapp_engagement_search_value_micro

total_inapp_engagement_search_value_micro

The total monetary value, in micro-dollars, associated with search events recorded within the Pinterest app that were attributed to an engagement.

metric

total_inapp_engagement_signup

total_inapp_engagement_signup

The total number of in-app signup conversions attributed to engagement actions.

dimension

total_inapp_engagement_signup_value

total_inapp_engagement_signup_value

The total value generated from in-app engagements related to sign-up events.

dimension

total_inapp_engagement_signup_value_micro

total_inapp_engagement_signup_value_micro

The total monetary value, in micro-dollars, associated with signup events recorded within the Pinterest app that were attributed to an engagement.

metric

total_inapp_engagement_unknown

total_inapp_engagement_unknown

The total number of undefined conversion events recorded within the Pinterest app that were attributed to an engagement.

dimension

total_inapp_engagement_unknown_value

total_inapp_engagement_unknown_value

The total value generated from in-app engagements for an unknown conversion type.

dimension

total_inapp_engagement_unknown_value_micro

total_inapp_engagement_unknown_value_micro

The total monetary value, in micro-dollars, associated with undefined conversion events recorded within the Pinterest app that were attributed to an engagement.

metric

total_inapp_search

total_inapp_search

The total number of search events recorded within the Pinterest app.

dimension

total_inapp_search_value

total_inapp_search_value

The total value generated from in-app search events.

dimension

total_inapp_search_value_micro

total_inapp_search_value_micro

The total monetary value, in micro-dollars, of search events recorded within the Pinterest app.

metric

total_inapp_signup

total_inapp_signup

The total number of in-app signup conversions.

dimension

total_inapp_signup_value

total_inapp_signup_value

The total monetary value generated from ‘signup’ events occurring within the app, resulting from interactions with your ads.

dimension

total_inapp_signup_value_micro

total_inapp_signup_value_micro

The total monetary value, in micro-dollars, of signup events recorded within the Pinterest app.

metric

total_inapp_unknown

total_inapp_unknown

The total number of undefined conversion events recorded within the Pinterest app.

dimension

total_inapp_unknown_value

total_inapp_unknown_value

The total value generated from in-app events categorized as unknown.

dimension

total_inapp_unknown_value_micro

total_inapp_unknown_value_micro

The total monetary value, in micro-dollars, of undefined conversion events recorded within the Pinterest app.

metric

total_inapp_view_add_to_cart

total_inapp_view_add_to_cart

The total number of ‘add to cart’ events recorded within the Pinterest app that were attributed to a view interaction.

dimension

total_inapp_view_add_to_cart_value_micro

total_inapp_view_add_to_cart_value_micro

The total monetary value, in micro-dollars, of ‘add to cart’ events recorded within the Pinterest app that were attributed to a view interaction.

metric

total_inapp_view_app_install

total_inapp_view_app_install

The total number of app install events recorded within the Pinterest app that were attributed to a view interaction.

dimension

total_inapp_view_app_install_value

total_inapp_view_app_install_value

The total monetary value generated from ‘app install’ events occurring within the app, resulting from views of your ads.

dimension

total_inapp_view_app_install_value_micro

total_inapp_view_app_install_value_micro

The total monetary value, in micro-dollars, associated with app install events recorded within the Pinterest app that were attributed to a view interaction.

metric

total_inapp_view_checkout

total_inapp_view_checkout

The total number of checkout events recorded within the Pinterest app that were attributed to a view interaction.

dimension

total_inapp_view_checkout_value

total_inapp_view_checkout_value

The total value of in-app checkout conversions attributed to view-through actions.

metric

total_inapp_view_checkout_value_micro

total_inapp_view_checkout_value_micro

The total value of in-app checkout conversions in microcurrency attributed to view-through actions.

metric

total_inapp_view_search

total_inapp_view_search

The total number of search events recorded within the Pinterest app that were attributed to a view interaction.

dimension

total_inapp_view_search_value

total_inapp_view_search_value

The total value generated from in-app views related to search events.

dimension

total_inapp_view_search_value_micro

total_inapp_view_search_value_micro

The total monetary value, in micro-dollars, associated with search events recorded within the Pinterest app that were attributed to a view interaction.

metric

total_inapp_view_signup

total_inapp_view_signup

The total number of signup events recorded within the Pinterest app that were attributed to a view interaction.

dimension

total_inapp_view_signup_value

total_inapp_view_signup_value

The total value generated from in-app views related to sign-up events.

dimension

total_inapp_view_signup_value_micro

total_inapp_view_signup_value_micro

The total monetary value, in micro-dollars, associated with signup events recorded within the Pinterest app that were attributed to a view interaction.

metric

total_inapp_view_unknown

total_inapp_view_unknown

The total number of undefined conversion events recorded within the Pinterest app that were attributed to a view interaction.

dimension

total_inapp_view_unknown_value

total_inapp_view_unknown_value

The total value generated from in-app views for an unknown conversion type.

dimension

total_inapp_view_unknown_value_micro

total_inapp_view_unknown_value_micro

The total monetary value, in micro-dollars, associated with undefined conversion events recorded within the Pinterest app that were attributed to a view interaction.

metric

total_offline_checkout

total_offline_checkout

The total count of offline checkout conversions. These are conversions that occur outside of online tracking.

dimension

total_offline_checkout_value

total_offline_checkout_value

The total value of offline checkout conversions.

dimension

total_offline_checkout_value_micro

total_offline_checkout_value_micro

The total value of offline checkout conversions in microcurrency.

metric

total_offline_click_checkout

total_offline_click_checkout

The total number of offline checkout events attributed to a click interaction.

dimension

total_offline_click_checkout_value

total_offline_click_checkout_value

The total value of offline checkout conversions attributed to click actions.

dimension

total_offline_click_checkout_value_micro

total_offline_click_checkout_value_micro

The total value of offline checkout conversions in microcurrency attributed to click actions.

metric

total_offline_click_custom

total_offline_click_custom

The total number of custom offline events attributed to a click interaction.

dimension

total_offline_click_custom_value

total_offline_click_custom_value

The total value of custom offline events resulting from clicks on ads.

dimension

total_offline_click_custom_value_micro

total_offline_click_custom_value_micro

The total monetary value, in micro-dollars, of custom offline events attributed to a click interaction.

metric

total_offline_click_lead

total_offline_click_lead

The total number of offline lead events attributed to a click interaction.

dimension

total_offline_click_lead_value

total_offline_click_lead_value

The total value of offline lead events resulting from clicks on ads.

dimension

total_offline_click_lead_value_micro

total_offline_click_lead_value_micro

The total monetary value, in micro-dollars, of offline lead events attributed to a click interaction.

metric

total_offline_click_signup

total_offline_click_signup

The total number of offline signup events attributed to a click interaction.

dimension

total_offline_click_signup_value

total_offline_click_signup_value

The total value of offline signup events resulting from clicks on ads.

dimension

total_offline_click_signup_value_micro

total_offline_click_signup_value_micro

The total monetary value, in micro-dollars, of offline signup events attributed to a click interaction.

metric

total_offline_click_unknown

total_offline_click_unknown

The total number of undefined offline conversion events attributed to a click interaction.

dimension

total_offline_click_unknown_value

total_offline_click_unknown_value

The total value of unknown offline events resulting from clicks on ads.

dimension

total_offline_click_unknown_value_micro

total_offline_click_unknown_value_micro

The total monetary value, in micro-dollars, of undefined offline conversion events attributed to a click interaction.

metric

total_offline_custom

total_offline_custom

The total count of custom offline conversions, defined by the advertiser.

dimension

total_offline_custom_value

total_offline_custom_value

The total monetary value generated from offline custom conversion events resulting from interactions with your ads.

dimension

total_offline_custom_value_micro

total_offline_custom_value_micro

The total monetary value, in micro-dollars, of custom offline events.

metric

total_offline_engagement_checkout

total_offline_engagement_checkout

The total number of offline checkout events attributed to an engagement (saves, closeups, link clicks, carousel swipes).

dimension

total_offline_engagement_checkout_value

total_offline_engagement_checkout_value

The total value of offline checkout conversions attributed to engagement actions.

dimension

total_offline_engagement_checkout_value_micro

total_offline_engagement_checkout_value_micro

The total value of offline checkout conversions in microcurrency attributed to engagement actions.

metric

total_offline_engagement_custom

total_offline_engagement_custom

The total number of custom offline events attributed to an engagement.

dimension

total_offline_engagement_custom_value

total_offline_engagement_custom_value

The total value of custom offline events resulting from engagements with ads.

dimension

total_offline_engagement_custom_value_micro

total_offline_engagement_custom_value_micro

The total monetary value, in micro-dollars, of custom offline events attributed to an engagement.

metric

total_offline_engagement_lead

total_offline_engagement_lead

The total number of offline lead events attributed to an engagement.

dimension

total_offline_engagement_lead_value

total_offline_engagement_lead_value

The total value of offline lead events resulting from engagements with ads.

dimension

total_offline_engagement_lead_value_micro

total_offline_engagement_lead_value_micro

The total monetary value, in micro-dollars, of offline lead events attributed to an engagement.

metric

total_offline_engagement_signup

total_offline_engagement_signup

The total number of offline signup events attributed to an engagement.

dimension

total_offline_engagement_signup_value

total_offline_engagement_signup_value

The total monetary value attributed to offline engagement sign-up conversion events.

dimension

total_offline_engagement_signup_value_micro

total_offline_engagement_signup_value_micro

The total monetary value, in micro-dollars, of offline signup events attributed to an engagement.

metric

total_offline_engagement_unknown

total_offline_engagement_unknown

The total number of undefined offline conversion events attributed to an engagement.

dimension

total_offline_engagement_unknown_value

total_offline_engagement_unknown_value

The total monetary value attributed to unspecified offline engagement conversion events.

dimension

total_offline_engagement_unknown_value_micro

total_offline_engagement_unknown_value_micro

The total monetary value, in micro-dollars, of undefined offline conversion events attributed to an engagement.

metric

total_offline_lead

total_offline_lead

The total count of offline lead generation conversions.

dimension

total_offline_lead_value

total_offline_lead_value

The total monetary value attributed to offline lead conversion events.

dimension

total_offline_lead_value_micro

total_offline_lead_value_micro

The total monetary value, in micro-dollars, of offline lead events.

metric

total_offline_signup

total_offline_signup

The total count of offline signup conversions.

dimension

total_offline_signup_value

total_offline_signup_value

The total monetary value attributed to offline sign-up conversion events.

dimension

total_offline_signup_value_micro

total_offline_signup_value_micro

The total monetary value, in micro-dollars, of offline signup events.

metric

total_offline_unknown

total_offline_unknown

The total number of undefined offline conversion events.

dimension

total_offline_unknown_value

total_offline_unknown_value

The total monetary value attributed to unspecified offline conversion events.

dimension

total_offline_unknown_value_micro

total_offline_unknown_value_micro

The total monetary value, in micro-dollars, of undefined offline conversion events.

metric

total_offline_view_checkout

total_offline_view_checkout

The total number of offline checkout events attributed to a view interaction.

dimension

total_offline_view_checkout_value

total_offline_view_checkout_value

The total value of offline checkout conversions attributed to view-through actions.

metric

total_offline_view_checkout_value_micro

total_offline_view_checkout_value_micro

The total value of offline checkout conversions in microcurrency attributed to view-through actions.

metric

total_offline_view_custom

total_offline_view_custom

The total number of custom offline events attributed to a view interaction.

dimension

total_offline_view_custom_value

total_offline_view_custom_value

The total monetary value attributed to offline custom view conversion events.

dimension

total_offline_view_custom_value_micro

total_offline_view_custom_value_micro

The total monetary value, in micro-dollars, of custom offline events attributed to a view interaction.

metric

total_offline_view_lead

total_offline_view_lead

The total number of offline lead events attributed to a view interaction.

dimension

total_offline_view_lead_value

total_offline_view_lead_value

The total monetary value attributed to offline view-based lead conversion events.

dimension

total_offline_view_lead_value_micro

total_offline_view_lead_value_micro

The total monetary value, in micro-dollars, of offline lead events attributed to a view interaction.

metric

total_offline_view_signup

total_offline_view_signup

The total number of offline signup events attributed to a view interaction.

dimension

total_offline_view_signup_value

total_offline_view_signup_value

The total monetary value attributed to offline view-based sign-up conversion events.

dimension

total_offline_view_signup_value_micro

total_offline_view_signup_value_micro

The total monetary value, in micro-dollars, of offline signup events attributed to a view interaction.

metric

total_offline_view_unknown

total_offline_view_unknown

The total number of offline views for conversions categorized as unknown.

dimension

total_offline_view_unknown_value

total_offline_view_unknown_value

The total value of unknown offline events resulting from viewing ads.

dimension

total_offline_view_unknown_value_micro

total_offline_view_unknown_value_micro

The total value of unknown offline view conversions, represented in micro-units of the advertiser’s currency.

metric

total_onsite_checkouts

total_onsite_checkouts

The total number of checkout events that occurred directly on Pinterest’s platform.

dimension

total_page_visit

total_page_visit

The total number of page visit conversions.

dimension

total_pinterest_checkout

total_pinterest_checkout

The total number of checkout conversions that occurred directly on Pinterest.

dimension

total_pinterest_checkout_value_in_micro_dollar

total_pinterest_checkout_value_in_micro_dollar

The total value of Pinterest checkout conversions in microdollars.

metric

total_repin_rate

total_repin_rate

The total rate at which Pins are saved by other users.

metric

total_signup

total_signup

The total count of all signup conversions, both online and offline.

dimension

total_signup_value_in_micro_dollar

total_signup_value_in_micro_dollar

The total monetary value, in micro-dollars, attributed to signup events across all platforms.

metric

total_video_avg_watchtime_in_second

total_video_avg_watchtime_in_second

The total average watch time in seconds for video Pins.

metric

total_video_mrc_views

total_video_mrc_views

Total video views where the video meets the Media Rating Council (MRC) standard for a view.

metric

total_video_p0_combined

total_video_p0_combined

The total number of video views combined at 0% completion (video starts).

metric

total_video_p100_complete

total_video_p100_complete

Total video plays at 100% completion (both paid and earned).

metric

total_video_p25_combined

total_video_p25_combined

Total video plays at 25% completion combined (both paid and earned).

metric

total_video_p50_combined

total_video_p50_combined

Total video plays at 50% completion combined (both paid and earned).

metric

total_video_p75_combined

total_video_p75_combined

Total video plays at 75% completion combined (both paid and earned).

metric

total_video_p95_combined

total_video_p95_combined

The total number of video views combined at 95% completion.

metric

total_web_add_to_cart

total_web_add_to_cart

The total number of times an item was added to a shopping cart on the web. This is an online conversion metric.

dimension

total_web_add_to_cart_value

total_web_add_to_cart_value

The total monetary value generated from add-to-cart events on the web.

dimension

total_web_add_to_cart_value_micro

total_web_add_to_cart_value_micro

The total monetary value, in micro-dollars, of ‘add to cart’ events recorded on the advertiser’s website.

metric

total_web_checkout

total_web_checkout

The total number of website checkout conversions.

metric

total_web_checkout_value

total_web_checkout_value

The total value of website checkout conversions.

dimension

total_web_checkout_value_micro

total_web_checkout_value_micro

The total value of website checkout conversions in microcurrency.

metric

total_web_click_add_to_cart

total_web_click_add_to_cart

The total number of ‘add to cart’ events recorded on the advertiser’s website that were attributed to a click interaction.

dimension

total_web_click_add_to_cart_value

total_web_click_add_to_cart_value

The total monetary value generated from clicks leading to add-to-cart events on the web.

dimension

total_web_click_add_to_cart_value_micro

total_web_click_add_to_cart_value_micro

The total monetary value, in micro-dollars, of ‘add to cart’ events recorded on the advertiser’s website that were attributed to a click interaction.

metric

total_web_click_checkout

total_web_click_checkout

The total number of website checkout conversions attributed to click actions.

metric

total_web_click_checkout_Value

total_web_click_checkout_Value

The total value of checkout conversions on the web attributed to clicks.

metric

total_web_click_checkout_value

total_web_click_checkout_value

The total monetary value generated from clicks leading to checkout events on the web.

dimension

total_web_click_checkout_value_micro

total_web_click_checkout_value_micro

The total value of website checkout conversions in microcurrency attributed to click actions.

metric

total_web_click_custom

total_web_click_custom

The total number of custom events recorded on the advertiser’s website that were attributed to a click interaction.

dimension

total_web_click_custom_value

total_web_click_custom_value

The total monetary value generated from clicks leading to custom events on the web.

dimension

total_web_click_custom_value_micro

total_web_click_custom_value_micro

The total monetary value, in micro-dollars, of custom events recorded on the advertiser’s website that were attributed to a click interaction.

metric

total_web_click_lead

total_web_click_lead

The total number of lead events recorded on the advertiser’s website that were attributed to a click interaction.

dimension

total_web_click_lead_value

total_web_click_lead_value

The total monetary value generated from clicks leading to lead conversions on the web.

dimension

total_web_click_lead_value_micro

total_web_click_lead_value_micro

The total monetary value, in micro-dollars, of lead events recorded on the advertiser’s website that were attributed to a click interaction.

metric

total_web_click_page_visit

total_web_click_page_visit

The total number of page visit events recorded on the advertiser’s website that were attributed to a click interaction.

metric

total_web_click_page_visit_value

total_web_click_page_visit_value

The total monetary value generated from clicks leading to page visit events on the web.

dimension

total_web_click_page_visit_value_micro

total_web_click_page_visit_value_micro

The total monetary value, in micro-dollars, of page visit events recorded on the advertiser’s website that were attributed to a click interaction.

metric

total_web_click_search

total_web_click_search

The total number of website searches attributed to click actions.

dimension

total_web_click_search_value

total_web_click_search_value

The total monetary value generated from clicks leading to search events on the web.

dimension

total_web_click_search_value_micro

total_web_click_search_value_micro

The total monetary value, in micro-dollars, of search events recorded on the advertiser’s website that were attributed to a click interaction.

metric

total_web_click_signup

total_web_click_signup

The total number of signup events recorded on the advertiser’s website that were attributed to a click interaction.

dimension

total_web_click_signup_value

total_web_click_signup_value

The total monetary value generated from clicks leading to sign-up events on the web.

dimension

total_web_click_signup_value_micro

total_web_click_signup_value_micro

The total monetary value, in micro-dollars, of signup events recorded on the advertiser’s website that were attributed to a click interaction.

metric

total_web_click_unknown

total_web_click_unknown

The total number of undefined conversion events recorded on the advertiser’s website that were attributed to a click interaction.

dimension

total_web_click_unknown_value

total_web_click_unknown_value

The total monetary value generated from clicks leading to unspecified events on the web.

dimension

total_web_click_unknown_value_micro

total_web_click_unknown_value_micro

The total monetary value, in micro-dollars, of undefined conversion events recorded on the advertiser’s website that were attributed to a click interaction.

metric

total_web_click_view_category

total_web_click_view_category

The total number of category view events recorded on the advertiser’s website that were attributed to a click interaction.

dimension

total_web_click_view_category_value

total_web_click_view_category_value

The total monetary value generated from clicks leading to category view events on the web.

dimension

total_web_click_view_category_value_micro

total_web_click_view_category_value_micro

The total monetary value, in micro-dollars, of category view events recorded on the advertiser’s website that were attributed to a click interaction.

metric

total_web_click_watch_video

total_web_click_watch_video

The total number of video watch events recorded on the advertiser’s website that were attributed to a click interaction.

dimension

total_web_click_watch_video_value

total_web_click_watch_video_value

The total monetary value generated from clicks leading to video watch events on the web.

dimension

total_web_click_watch_video_value_micro

total_web_click_watch_video_value_micro

The total monetary value, in micro-dollars, of video watch events recorded on the advertiser’s website that were attributed to a click interaction.

metric

total_web_custom

total_web_custom

The total number of custom events recorded on the advertiser’s website.

dimension

total_web_custom_value

total_web_custom_value

The total monetary value generated from custom events on the web.

dimension

total_web_custom_value_micro

total_web_custom_value_micro

The total monetary value, in micro-dollars, of custom events recorded on the advertiser’s website.

metric

total_web_engagement_add_to_cart

total_web_engagement_add_to_cart

The total number of ‘add to cart’ events recorded on the advertiser’s website that were attributed to an engagement (saves, closeups, link clicks, carousel swipes).

dimension

total_web_engagement_add_to_cart_value

total_web_engagement_add_to_cart_value

The total monetary value generated from engagement leading to add-to-cart events on the web.

dimension

total_web_engagement_add_to_cart_value_micro

total_web_engagement_add_to_cart_value_micro

The total monetary value, in micro-dollars, of ‘add to cart’ events recorded on the advertiser’s website that were attributed to an engagement.

metric

total_web_engagement_checkout

total_web_engagement_checkout

The total number of checkout events recorded on the advertiser’s website that were attributed to an engagement.

dimension

total_web_engagement_checkout_value

total_web_engagement_checkout_value

The total value of website checkout conversions attributed to engagement actions.

metric

total_web_engagement_checkout_value_micro

total_web_engagement_checkout_value_micro

The total value of website checkout conversions in microcurrency attributed to engagement actions.

metric

total_web_engagement_custom

total_web_engagement_custom

The total number of custom events recorded on the advertiser’s website that were attributed to an engagement.

dimension

total_web_engagement_custom_value

total_web_engagement_custom_value

The total monetary value generated from engagement leading to custom events on the web.

dimension

total_web_engagement_custom_value_micro

total_web_engagement_custom_value_micro

The total monetary value, in micro-dollars, of custom events recorded on the advertiser’s website that were attributed to an engagement.

metric

total_web_engagement_lead

total_web_engagement_lead

The total number of lead events recorded on the advertiser’s website that were attributed to an engagement.

dimension

total_web_engagement_lead_value

total_web_engagement_lead_value

The total monetary value generated from engagement leading to lead conversions on the web.

dimension

total_web_engagement_lead_value_micro

total_web_engagement_lead_value_micro

The total monetary value, in micro-dollars, of lead events recorded on the advertiser’s website that were attributed to an engagement.

metric

total_web_engagement_page_visit

total_web_engagement_page_visit

The total number of page visit events recorded on the advertiser’s website that were attributed to an engagement.

dimension

total_web_engagement_page_visit_value

total_web_engagement_page_visit_value

The total monetary value generated from engagement leading to page visit events on the web.

dimension

total_web_engagement_page_visit_value_micro

total_web_engagement_page_visit_value_micro

The total monetary value, in micro-dollars, of page visit events recorded on the advertiser’s website that were attributed to an engagement.

metric

total_web_engagement_search

total_web_engagement_search

The total number of search events recorded on the advertiser’s website that were attributed to an engagement.

metric

total_web_engagement_search_value

total_web_engagement_search_value

The total monetary value generated from engagement leading to search events on the web.

dimension

total_web_engagement_search_value_micro

total_web_engagement_search_value_micro

The total monetary value, in micro-dollars, of search events recorded on the advertiser’s website that were attributed to an engagement.

metric

total_web_engagement_signup

total_web_engagement_signup

The total number of signup events recorded on the advertiser’s website that were attributed to an engagement.

dimension

total_web_engagement_signup_value

total_web_engagement_signup_value

The total monetary value generated from engagement leading to sign-up events on the web.

dimension

total_web_engagement_signup_value_micro

total_web_engagement_signup_value_micro

The total monetary value, in micro-dollars, of signup events recorded on the advertiser’s website that were attributed to an engagement.

metric

total_web_engagement_unknown

total_web_engagement_unknown

Total number of engagement events on the website that do not fit into other defined categories.

dimension

total_web_engagement_unknown_value

total_web_engagement_unknown_value

The total monetary value generated from engagement leading to unspecified events on the web.

dimension

total_web_engagement_unknown_value_micro

total_web_engagement_unknown_value_micro

Total value of engagement events on the website that do not fit into other defined categories, in micro-currency.

metric

total_web_engagement_view_category

total_web_engagement_view_category

Total number of web engagement events where a category was viewed.

metric

total_web_engagement_view_category_value

total_web_engagement_view_category_value

The total monetary value generated from engagement leading to category view events on the web.

dimension

total_web_engagement_view_category_value_micro

total_web_engagement_view_category_value_micro

Total value of web engagement events involving category views, in micro-currency.

metric

total_web_engagement_watch_video

total_web_engagement_watch_video

Total number of web engagement events where a video was watched.

dimension

total_web_engagement_watch_video_value

total_web_engagement_watch_video_value

The total monetary value generated from engagement leading to video watch events on the web.

dimension

total_web_engagement_watch_video_value_micro

total_web_engagement_watch_video_value_micro

Total value of web engagement events involving video watches, in micro-currency.

metric

total_web_lead

total_web_lead

Total number of lead conversion events recorded on the website.

dimension

total_web_lead_value

total_web_lead_value

The total monetary value generated from lead conversions on the web.

dimension

total_web_lead_value_micro

total_web_lead_value_micro

Total value of lead conversion events recorded on the website, in micro-currency.

metric

total_web_page_visit

total_web_page_visit

Total number of page visit conversion events on the website.

dimension

total_web_page_visit_value

total_web_page_visit_value

The total monetary value generated from page visit events on the web.

dimension

total_web_page_visit_value_micro

total_web_page_visit_value_micro

Total value of page visit conversion events on the website, in micro-currency.

metric

total_web_search

total_web_search

Total number of search conversion events on the website.

dimension

total_web_search_value

total_web_search_value

The total monetary value generated from search events on the web.

dimension

total_web_search_value_micro

total_web_search_value_micro

Total value of search conversion events on the website, in micro-currency.

metric

total_web_sessions

total_web_sessions

The total number of web sessions initiated by users.

dimension

total_web_signup

total_web_signup

Total number of signup conversion events on the website.

dimension

total_web_signup_value

total_web_signup_value

The total monetary value generated from sign-up conversions on the web.

dimension

total_web_signup_value_micro

total_web_signup_value_micro

Total value of signup conversion events on the website, in micro-currency.

metric

total_web_unknown

total_web_unknown

Total number of unknown web conversion events.

dimension

total_web_unknown_value

total_web_unknown_value

The total monetary value generated from unspecified web events.

dimension

total_web_unknown_value_micro

total_web_unknown_value_micro

Total value of unknown web conversion events, in micro-currency.

metric

total_web_view_add_to_cart

total_web_view_add_to_cart

Total number of web add-to-cart events resulting from a view.

dimension

total_web_view_add_to_cart_value

total_web_view_add_to_cart_value

The total monetary value generated from view-based add-to-cart events on the web.

dimension

total_web_view_add_to_cart_value_micro

total_web_view_add_to_cart_value_micro

Total value of web add-to-cart events resulting from a view, in micro-currency.

metric

total_web_view_category

total_web_view_category

Total number of web category view events.

dimension

total_web_view_category_value

total_web_view_category_value

The total monetary value generated from view-based category view events on the web.

dimension

total_web_view_category_value_micro

total_web_view_category_value_micro

The total value of website view category conversions in microcurrency.

metric

total_web_view_checkout

total_web_view_checkout

The total number of website checkout conversions attributed to view-through actions.

dimension

total_web_view_checkout_value

total_web_view_checkout_value

The total value of website checkout conversions attributed to view-through actions.

dimension

total_web_view_checkout_value_micro

total_web_view_checkout_value_micro

The total value of website checkout conversions in microcurrency attributed to view-through actions.

metric

total_web_view_custom

total_web_view_custom

The total number of custom web conversions attributed to views.

dimension

total_web_view_custom_value

total_web_view_custom_value

The total value of custom web conversions attributed to views.

dimension

total_web_view_custom_value_micro

total_web_view_custom_value_micro

The total value of custom web conversions attributed to views, expressed in microunits.

metric

total_web_view_lead

total_web_view_lead

Total number of lead events on the website resulting from a view.

dimension

total_web_view_lead_value

total_web_view_lead_value

The total monetary value generated from view-based lead conversions on the web.

dimension

total_web_view_lead_value_micro

total_web_view_lead_value_micro

Total value of lead events on the website resulting from a view, in micro-currency.

metric

total_web_view_page_visit

total_web_view_page_visit

Total number of page visit events on the website resulting from a view.

metric

total_web_view_page_visit_value

total_web_view_page_visit_value

The total monetary value generated from view-based page visit events on the web.

dimension

total_web_view_page_visit_value_micro

total_web_view_page_visit_value_micro

Total value of page visit events on the website resulting from a view, in micro-currency.

metric

total_web_view_search

total_web_view_search

The total number of website searches attributed to view-through actions.

dimension

total_web_view_search_value

total_web_view_search_value

The total monetary value generated from view-based search events on the web.

dimension

total_web_view_search_value_micro

total_web_view_search_value_micro

The total value generated from viewing search results on the web, represented in micro-units of the advertiser’s currency.

metric

total_web_view_signup

total_web_view_signup

Total number of signup events on the website resulting from a view.

dimension

total_web_view_signup_value

total_web_view_signup_value

The total monetary value generated from view-based sign-up conversions on the web.

dimension

total_web_view_signup_value_micro

total_web_view_signup_value_micro

Total value of signup events on the website resulting from a view, in micro-currency.

metric

total_web_view_unknown

total_web_view_unknown

Total number of unknown web events resulting from a view.

dimension

total_web_view_unknown_value

total_web_view_unknown_value

The total value of unknown web conversions attributed to views.

dimension

total_web_view_unknown_value_micro

total_web_view_unknown_value_micro

The total value of unknown web conversions attributed to views, expressed in microunits.

metric

total_web_view_view_category

total_web_view_view_category

The total number of views of product categories on the web. This is an online engagement or conversion metric.

dimension

total_web_view_view_category_value

total_web_view_view_category_value

The total monetary value generated from view-based category view events on the web.

dimension

total_web_view_view_category_value_micro

total_web_view_view_category_value_micro

The total value generated from viewing product categories on the web, represented in micro-units of the advertiser’s currency.

metric

total_web_view_watch_video

total_web_view_watch_video

Total number of video watch events on the website resulting from a view.

dimension

total_web_view_watch_video_value

total_web_view_watch_video_value

The total monetary value generated from view-based video watch events on the web.

dimension

total_web_view_watch_video_value_micro

total_web_view_watch_video_value_micro

Total value of video watch events on the website resulting from a view, in micro-currency.

metric

total_web_watch_video_value

total_web_watch_video_value

The total monetary value generated from video watch events on the web.

dimension

total_web_watch_video_value_micro

total_web_watch_video_value_micro

The total monetary value, in micro units of the advertiser’s currency, generated from users watching videos on the web. This value is expressed in microdollars (1/1,000,000 of a dollar) or microunits of the advertiser’s currency.

metric

type

type

The type of the entity (e.g., Pin, board, ad).

dimension

unknown_desktop_action_desktop_conversion

unknown_desktop_action_desktop_conversion

The number of conversions where the initial action was an unknown event on a desktop device, and the conversion also occurred on a desktop device.

metric

unknown_desktop_action_mobile_conversion

unknown_desktop_action_mobile_conversion

The number of conversions where the initial action was an unknown event on a desktop device, and the conversion occurred on a mobile device.

metric

unknown_desktop_action_tablet_conversion

unknown_desktop_action_tablet_conversion

The number of conversions where the initial action was an unknown event on a desktop device, and the conversion occurred on a tablet device.

dimension

unknown_mobile_action_desktop_conversion

unknown_mobile_action_desktop_conversion

The number of conversions where the initial action was an unknown event on a mobile device, and the conversion occurred on a desktop device.

metric

unknown_mobile_action_mobile_conversion

unknown_mobile_action_mobile_conversion

The number of conversions where the initial action was an unknown event on a mobile device, and the conversion also occurred on a mobile device.

metric

unknown_mobile_action_tablet_conversion

unknown_mobile_action_tablet_conversion

The number of conversions where the initial action was an unknown event on a mobile device, and the conversion occurred on a tablet device.

metric

unknown_tablet_action_desktop_conversion

unknown_tablet_action_desktop_conversion

The number of conversions where the initial action was an unknown event on a tablet device, and the conversion occurred on a desktop device.

metric

unknown_tablet_action_mobile_conversion

unknown_tablet_action_mobile_conversion

The number of conversions where the initial action was an unknown event on a tablet device, and the conversion occurred on a mobile device.

metric

unknown_tablet_action_tablet_conversion

unknown_tablet_action_tablet_conversion

The number of conversions where the initial action was an unknown event on a tablet device, and the conversion also occurred on a tablet device.

metric

usd_conv_rate

usd_conv_rate

The conversion rate used to convert monetary values to US Dollars.

metric

user_follow

user_follow

The number of new followers gained from interactions with the Pin.

metric

user_id

user_id

The unique identifier for a Pinterest user account.

dimension

user_name

user_name

The user-defined name associated with the Pinterest user account.

dimension

username

username

The username of the Pinterest account.

dimension

v50_watch_time

v50_watch_time

The total watch time (in milliseconds or similar unit) for video Pins that reached at least 50% of their length.

metric

value(app_install)

value(app_install)

The monetary value associated with an app install conversion event.

dimension

value_micro(app_install)

value_micro(app_install)

The monetary value in micro-dollars associated with an app install conversion event.

dimension

value_micro_(app_install)

value_micro_(app_install)

The monetary value associated with an app install conversion event, in micro-currency.

metric

video_10s_view

video_10s_view

The number of times a video played for at least 10 seconds.

metric

video_avg_watch_time

video_avg_watch_time

The average watch time of a video in milliseconds.

metric

video_completions_total

video_completions_total

The total number of times video content was watched to completion.

metric

video_mrc_view

video_mrc_view

The number of times a video met the MRC (Media Rating Council) viewability standard.

metric

video_start

video_start

The number of times a video started playing.

metric

video_v50_watch_time

video_v50_watch_time

The watch time of a video where 50% of its duration was viewed.

metric

view_category_desktop_action_desktop_conversion

view_category_desktop_action_desktop_conversion

The number of conversions where the initial action was viewing a category on a desktop device, and the conversion also occurred on a desktop device.

metric

view_category_desktop_action_mobile_conversion

view_category_desktop_action_mobile_conversion

The number of conversions where the initial action was viewing a category on a desktop device, and the conversion occurred on a mobile device.

metric

view_category_desktop_action_tablet_conversion

view_category_desktop_action_tablet_conversion

The number of conversions where the initial action was viewing a category on a desktop device, and the conversion occurred on a tablet device.

metric

view_category_mobile_action_desktop_conversion

view_category_mobile_action_desktop_conversion

The number of conversions where the initial action was viewing a category on a mobile device, and the conversion occurred on a desktop device.

metric

view_category_mobile_action_mobile_conversion

view_category_mobile_action_mobile_conversion

The number of conversions where the initial action was viewing a category on a mobile device, and the conversion also occurred on a mobile device.

metric

view_category_mobile_action_tablet_conversion

view_category_mobile_action_tablet_conversion

The number of conversions where the initial action was viewing a category on a mobile device, and the conversion occurred on a tablet device.

metric

view_category_tablet_action_desktop_conversion

view_category_tablet_action_desktop_conversion

The number of conversions where the initial action was viewing a category on a tablet device, and the conversion occurred on a desktop device.

metric

view_category_tablet_action_mobile_conversion

view_category_tablet_action_mobile_conversion

The number of conversions where the initial action was viewing a category on a tablet device, and the conversion occurred on a mobile device.

metric

view_category_tablet_action_tablet_conversion

view_category_tablet_action_tablet_conversion

The number of conversions where the initial action was viewing a category on a tablet device, and the conversion also occurred on a tablet device.

metric

viewthrough_conversions_(add_to_cart)

viewthrough_conversions_(add_to_cart)

The number of add-to-cart conversions attributed to a view-through action.

dimension

viewthrough_conversions_(app_install)

viewthrough_conversions_(app_install)

The number of app install conversions attributed to view-through actions.

dimension

viewthrough_conversions_(category_view)

viewthrough_conversions_(category_view)

The number of category view conversions attributed to view-through actions.

dimension

viewthrough_conversions_(checkout)

viewthrough_conversions_(checkout)

The number of checkout conversions attributed to a view-through action (user saw an ad but did not click, then converted).

dimension

viewthrough_conversions_(custom)

viewthrough_conversions_(custom)

The number of custom conversions attributed to view-through actions.

dimension

viewthrough_conversions_(lead)

viewthrough_conversions_(lead)

The number of lead conversions attributed to a view-through action.

metric

viewthrough_conversions_(page_visit)

viewthrough_conversions_(page_visit)

The number of page visit conversions attributed to a view-through action.

dimension

viewthrough_conversions_(signup)

viewthrough_conversions_(signup)

The number of signup conversions attributed to a view-through action.

dimension

viewthrough_conversions_(unknown)

viewthrough_conversions_(unknown)

The number of view-through conversions of an unknown type.

metric

viewthrough_conversions_(watch_video)

viewthrough_conversions_(watch_video)

The number of watch video conversions attributed to view-through actions.

dimension

viewthrough_conversions_(website_search)

viewthrough_conversions_(website_search)

The number of website search conversions attributed to view-through actions.

dimension

viewthrough_order_quantity_(checkout)

viewthrough_order_quantity_(checkout)

The quantity of items purchased in checkout conversions attributed to a view-through action.

dimension

viewthrough_value(add_to_cart)

viewthrough_value(add_to_cart)

The monetary value attributed to an add-to-cart conversion from a view-through attribution model.

dimension

viewthrough_value(app_install)

viewthrough_value(app_install)

The monetary value attributed to an app install conversion from a view-through attribution model.

dimension

viewthrough_value(category_view)

viewthrough_value(category_view)

The monetary value attributed to a category view conversion from a view-through attribution model.

dimension

viewthrough_value(custom)

viewthrough_value(custom)

The monetary value attributed to a custom conversion event from a view-through attribution model.

dimension

viewthrough_value(lead)

viewthrough_value(lead)

The monetary value attributed to a lead conversion from a view-through attribution model.

dimension

viewthrough_value(page_visit)

viewthrough_value(page_visit)

The monetary value attributed to a page visit conversion from a view-through attribution model.

dimension

viewthrough_value(signup)

viewthrough_value(signup)

The monetary value attributed to a sign-up conversion from a view-through attribution model.

dimension

viewthrough_value(unknown)

viewthrough_value(unknown)

The monetary value attributed to an unspecified conversion event from a view-through attribution model.

dimension

viewthrough_value(watch_video)

viewthrough_value(watch_video)

The monetary value attributed to a video watch conversion from a view-through attribution model.

dimension

viewthrough_value(website_search)

viewthrough_value(website_search)

The monetary value attributed to a website search conversion from a view-through attribution model.

dimension

viewthrough_value_micro(add_to_cart)

viewthrough_value_micro(add_to_cart)

The monetary value in micro-dollars attributed to an add-to-cart conversion from a view-through attribution model.

dimension

viewthrough_value_micro(app_install)

viewthrough_value_micro(app_install)

The monetary value in micro-dollars attributed to an app install conversion from a view-through attribution model.

dimension

viewthrough_value_micro(category_view)

viewthrough_value_micro(category_view)

The monetary value in micro-dollars attributed to a category view conversion from a view-through attribution model.

dimension

viewthrough_value_micro(custom)

viewthrough_value_micro(custom)

The monetary value in micro-dollars attributed to a custom conversion event from a view-through attribution model.

dimension

viewthrough_value_micro(lead)

viewthrough_value_micro(lead)

The monetary value in micro-dollars attributed to a lead conversion from a view-through attribution model.

dimension

viewthrough_value_micro(page_visit)

viewthrough_value_micro(page_visit)

The monetary value in micro-dollars attributed to a page visit conversion from a view-through attribution model.

dimension

viewthrough_value_micro(signup)

viewthrough_value_micro(signup)

The monetary value in micro-dollars attributed to a sign-up conversion from a view-through attribution model.

dimension

viewthrough_value_micro(unknown)

viewthrough_value_micro(unknown)

The monetary value in micro-dollars attributed to an unspecified conversion event from a view-through attribution model.

dimension

viewthrough_value_micro(watch_video)

viewthrough_value_micro(watch_video)

The monetary value in micro-dollars attributed to a video watch conversion from a view-through attribution model.

dimension

viewthrough_value_micro(website_search)

viewthrough_value_micro(website_search)

The monetary value in micro-dollars attributed to a website search conversion from a view-through attribution model.

dimension

viewthrough_value_micro_(add_to_cart)

viewthrough_value_micro_(add_to_cart)

The monetary value of view-through add-to-cart conversions, in micro-currency.

metric

viewthrough_value_micro_(app_install)

viewthrough_value_micro_(app_install)

The monetary value of view-through app install conversions, in micro-currency.

metric

viewthrough_value_micro_(category_view)

viewthrough_value_micro_(category_view)

The monetary value of view-through category view conversions, in micro-currency.

metric

viewthrough_value_micro_(custom)

viewthrough_value_micro_(custom)

The monetary value of view-through custom conversions, in micro-currency.

metric

viewthrough_value_micro_(lead)

viewthrough_value_micro_(lead)

The value of lead conversions in microcurrency attributed to a view-through action.

metric

viewthrough_value_micro_(page_visit)

viewthrough_value_micro_(page_visit)

The monetary value of view-through page visit conversions, in micro-currency.

metric

viewthrough_value_micro_(signup)

viewthrough_value_micro_(signup)

The value of signup conversions in microcurrency attributed to a view-through action.

metric

viewthrough_value_micro_(unknown)

viewthrough_value_micro_(unknown)

The monetary value of view-through unknown conversions, in micro-currency.

metric

viewthrough_value_micro_(watch_video)

viewthrough_value_micro_(watch_video)

The monetary value of view-through video watch conversions, in micro-currency.

metric

viewthrough_value_micro_(website_search)

viewthrough_value_micro_(website_search)

The monetary value of view-through website search conversions, in micro-currency.

metric

watch_video_desktop_action_desktop_conversion

watch_video_desktop_action_desktop_conversion

The number of conversions where the initial action was watching a video on a desktop device, and the conversion also occurred on a desktop device.

dimension

watch_video_desktop_action_mobile_conversion

watch_video_desktop_action_mobile_conversion

The number of conversions where the initial action was watching a video on a desktop device, and the conversion occurred on a mobile device.

dimension

watch_video_desktop_action_tablet_conversion

watch_video_desktop_action_tablet_conversion

The number of conversions where the initial action was watching a video on a desktop device, and the conversion occurred on a tablet device.

dimension

watch_video_mobile_action_desktop_conversion

watch_video_mobile_action_desktop_conversion

The number of conversions where the initial action was watching a video on a mobile device, and the conversion occurred on a desktop device.

dimension

watch_video_mobile_action_mobile_conversion

watch_video_mobile_action_mobile_conversion

The number of conversions where the initial action was watching a video on a mobile device, and the conversion also occurred on a mobile device.

dimension

watch_video_mobile_action_tablet_conversion

watch_video_mobile_action_tablet_conversion

The number of conversions where the initial action was watching a video on a mobile device, and the conversion occurred on a tablet device.

dimension

watch_video_tablet_action_desktop_conversion

watch_video_tablet_action_desktop_conversion

The number of conversions where the initial action was watching a video on a tablet device, and the conversion occurred on a desktop device.

dimension

watch_video_tablet_action_mobile_conversion

watch_video_tablet_action_mobile_conversion

The number of conversions where the initial action was watching a video on a tablet device, and the conversion occurred on a mobile device.

dimension

watch_video_tablet_action_tablet_conversion

watch_video_tablet_action_tablet_conversion

The number of conversions where the initial action was watching a video on a tablet device, and the conversion also occurred on a tablet device.

dimension

web_add_to_cart_cost_per_action

web_add_to_cart_cost_per_action

The average cost incurred for each add-to-cart action performed on the website.

dimension

web_add_to_cart_roas

web_add_to_cart_roas

The Return on Ad Spend (ROAS) for add-to-cart actions on the website.

metric

web_checkout_cost_per_action

web_checkout_cost_per_action

The average cost incurred for each checkout action performed on the website.

dimension

web_checkout_roas

web_checkout_roas

The Return on Ad Spend (ROAS) for checkout actions on the website.

dimension

web_custom_cost_per_action

web_custom_cost_per_action

The average cost incurred for each custom action performed on the website.

dimension

web_custom_roas

web_custom_roas

The Return on Ad Spend (ROAS) for custom actions on the website.

dimension

web_lead_cost_per_action

web_lead_cost_per_action

The average cost incurred for each lead action performed on the website.

dimension

web_lead_roas

web_lead_roas

The Return on Ad Spend (ROAS) for lead actions on the website.

dimension

web_page_visit_cost_per_action

web_page_visit_cost_per_action

The average cost incurred for each page visit action performed on the website.

dimension

web_page_visit_roas

web_page_visit_roas

The Return on Ad Spend (ROAS) for page visit actions on the website.

metric

web_search_cost_per_action

web_search_cost_per_action

The average cost incurred for each search action performed on the website.

dimension

web_search_roas

web_search_roas

The Return on Ad Spend (ROAS) for search actions on the website.

dimension

web_signup_cost_per_action

web_signup_cost_per_action

The average cost incurred for each signup action performed on the website.

dimension

web_signup_roas

web_signup_roas

The Return on Ad Spend (ROAS) for signup actions on the website.

dimension

web_unknown_cost_per_action

web_unknown_cost_per_action

The average cost incurred for each unknown action performed on the website.

dimension

web_unknown_roas

web_unknown_roas

The Return on Ad Spend (ROAS) for unknown actions on the website.

metric

web_view_category_cost_per_action

web_view_category_cost_per_action

The average cost incurred for each category view action performed on the website.

dimension

web_view_category_roas

web_view_category_roas

The Return on Ad Spend (ROAS) for category view actions on the website.

dimension

web_watch_video_cost_per_action

web_watch_video_cost_per_action

The average cost incurred for each video watch action performed on the website.

dimension

web_watch_video_roas

web_watch_video_roas

The Return on Ad Spend (ROAS) for video watch actions on the website.

dimension

website_url

website_url

The URL of the website associated with the user account or the destination URL of a Pin.

dimension