Pinterest Ads

Creating the data source

How to Connect Your Pinterest Ads Account

  1. Click the "Connect with Pinterest" button
  2. Log in to your Pinterest Business account
  3. Authorize Kondado to access your ad data
  4. Select the ad accounts you want to sync

Requirements:

  • Active Pinterest Business account
  • Admin or analyst access to the ad account

Pipelines

Summary

Relationship chart

Click to expand

Ad performance

Replication type: Full

Parameters:

  • Update window: Number of periods before savepoint to re-sync for capturing retroactively attributed conversions. Default: 30.
  • Accounts: Select one or more ad accounts. Leave empty to include all accounts linked to the connector.
  • Breakdown (optional): Additional data segmentation by: Keyword, Gender, Age Range, Location, Country, Region, Geo, Placement, App Type, Targeted Interest, Pinner Interest, Audience.
  • Period: Time granularity. Hour: max 30 days, no reach metrics. Day: daily. Week: Sunday-Saturday. Month: monthly.
  • Conversion window: Conversion attribution period for clicks and views. Options: 1/1, 7/1, 7/7, 30/1, 30/7, 30/30, 60/1, 60/7, 60/30, 60/60 (click days / view days).
  • Read start date (Savepoint): Date from which data will be extracted. For Hour: max 30 days. For other periods: up to 20 years.
  • Conversion date option: Defines conversion recording date. Time of ad action: interaction date. Time of conversion: date when conversion occurred.
  • Entity level: Defines data aggregation level. Options: Advertiser, Campaign, Ad Group, Pin Promotion, Keyword, Product Group, Product Item. 'Targeting' versions allow adding breakdowns.
Campo Tipo

ad_account_id

text

[en] Unique identifier for the ad account

account_name

text

[en] Ad account name

hour

float

[en] Hour

metric_date

date

[en] Day

spend_micro

float

[en] Spend (micro) - Total amount spent on the campaign in microunits of the account's currency. For USD, 1 microunit = $0.000001 (one millionth of a dollar). Values are based on the currency defined in the advertiser's profile.

ads_credit_spend_micro

float

[en] Ads credit spend (micro) - Amount spent using ads credits in microunits of the account's currency.

ads_credit_spend

float

[en] Ads credit spend - Amount spent using ads credits in the account's currency.

paid_impression

float

[en] Number of paid impressions served

spend

float

[en] Spend - Total amount spent on the campaign in the account's currency (e.g., USD, GBP, BRL). Values are based on the currency defined in the advertiser's profile.

cpc_micro

float

[en] Cost per click (micro) - Cost per click in microunits of the account's currency.

ecpc_micro

float

[en] Effective cost per click (micro) - Effective cost per click in microunits of the account's currency.

ecpc

float

[en] Effective cost per click - Effective cost per click in the account's currency.

ctr

float

[en] Click-through rate (clicks/impressions)

ectr

float

[en] Effective click-through rate

outbound_ctr_1

float

[en] Outbound click-through rate (variant 1)

campaign_name

text

[en] Name of the campaign

campaign_status

text

[en] Status of the campaign

pin_promotion_status

text

[en] Status of the pin promotion

ad_status

text

[en] Status of the ad

pin_id

text

[en] Unique identifier for the pin

total_engagement

float

[en] Total number of engagements

engagement_1

float

[en] Engagements (variant 1)

engagement_2

float

[en] Engagements (variant 2)

ecpe

float

[en] Effective cost per engagement - Effective cost per engagement in the account's currency.

engagement_rate

float

[en] Engagement rate (engagements/impressions)

eengagement_rate

float

[en] Effective engagement rate

ecpm_micro

float

[en] Effective cost per mille (micro) - Effective cost per thousand impressions in microunits of the account's currency.

repin_rate

float

[en] Repin rate (repins/impressions)

ctr_2

float

[en] Click-through rate (variant 2)

campaign_id

text

[en] Unique identifier for the campaign

advertiser_id

text

[en] Unique identifier for the advertiser

pin_promotion_id

text

[en] Unique identifier for the pin promotion

ad_id

text

[en] Unique identifier for the ad

ad_group_id

text

[en] Unique identifier for the ad group

campaign_entity_status

text

[en] Entity status of the campaign

campaign_managed_status

text

[en] Managed status of the campaign

campaign_objective_type

text

[en] Objective type of the campaign

cpm_micro

float

[en] Cost per mille (micro) - Cost per thousand impressions in microunits of the account's currency.

cpm

float

[en] Cost per mille - Cost per thousand impressions in the account's currency.

ad_group_name

text

[en] Name of the ad group

ad_group_status

text

[en] Status of the ad group

ad_group_budget_type

text

[en] Budget type for the ad group

ad_group_budget_in_local_currency

float

[en] Budget amount in local currency for the ad group

ad_group_entity_status

text

[en] Entity status of the ad group

ad_group_bid_multiplier

float

[en] Bid multiplier for the ad group

product_group_id

text

[en] Unique identifier for the product group

product_group_status

text

[en] Status of the product group

promo_id

text

[en] Unique identifier for the promotion

promo_name

text

[en] Name of the promotion

product_item_name

text

[en] Name of the product item

product_item_image_url

float

[en] Image URL for the product item

product_item_price

float

[en] Price of the product item

product_item_product_url

float

[en] Product URL for the product item

product_item_pin_url

float

[en] Pin URL for the product item

product_item_brand

float

[en] Brand of the product item

product_item_description

float

[en] Description of the product item

product_item_sale_price

float

[en] Sale price of the product item

product_item_product_type

text

[en] Product type of the product item

product_item_product_category

float

[en] Product category of the product item

order_line_id

text

[en] Unique identifier for the order line

order_line_name

text

[en] Name of the order line

clickthrough_1

float

[en] Clickthroughs (variant 1)

repin_1

float

[en] Repins (variant 1)

impression_1

float

[en] Impressions (variant 1)

impression_1_gross

float

[en] Gross impressions (variant 1)

clickthrough_1_gross

float

[en] Gross clickthroughs (variant 1)

outbound_click_1

float

[en] Outbound clicks (variant 1)

clickthrough_2

float

[en] Clickthroughs (variant 2)

repin_2

float

[en] Repins (variant 2)

impression_2

float

[en] Impressions (Variant 2)

outbound_click_2

float

[en] Outbound clicks (variant 2)

total_clickthrough

float

[en] Total number of clickthroughs - Total times people clicked on your Pin to go to the destination (total ad clicks)

total_impression

float

[en] Total number of impressions

total_impression_user

float

[en] Total number of unique users who saw impressions

total_impression_frequency

float

[en] Average frequency of impressions per user

cost_per_outbound_click

float

[en] Cost per outbound click - Cost per outbound click in the account's currency.

cost_per_outbound_click_v1

float

[en] Cost per outbound click (v1) - Cost per outbound click in the account's currency (variant 1).

total_engagement_page_visit

float

[en] Total page visit engagements

total_engagement_signup

float

[en] Total signup engagements

total_engagement_checkout

float

[en] Total checkout engagements

total_engagement_custom

float

[en] Total custom engagements

total_engagement_add_to_cart

float

[en] Total add to cart engagements

total_engagement_lead

float

[en] Total lead engagements

total_engagement_search

float

[en] Total search engagements

total_engagement_watch_video

float

[en] Total video watch engagements

total_engagement_view_category

float

[en] Total category view engagements

total_engagement_app_install

float

[en] Total app install engagements

total_engagement_unknown

float

[en] Total unknown engagements

total_click_page_visit

float

[en] Total page visit clicks

total_click_signup

float

[en] Total signup clicks

total_click_checkout

float

[en] Total checkout clicks

total_click_custom

float

[en] Total custom clicks

total_click_add_to_cart

float

[en] Total add to cart clicks

total_click_lead

float

[en] Total lead clicks

total_click_search

float

[en] Total search clicks

total_click_watch_video

float

[en] Total video watch clicks

total_click_view_category

float

[en] Total category view clicks

total_click_app_install

float

[en] Total app install clicks

total_click_unknown

float

[en] Total unknown clicks

total_view_page_visit

float

[en] Total page visit views

total_view_signup

float

[en] Total signup views

total_view_checkout

float

[en] Total checkout views

total_view_custom

float

[en] Total custom views

total_view_add_to_cart

float

[en] Total add to cart views

total_view_lead

float

[en] Total lead views

total_view_search

float

[en] Total search views

total_view_watch_video

float

[en] Total video watch views

total_view_view_category

float

[en] Total category view views

total_view_app_install

float

[en] Total app install views

total_view_unknown

float

[en] Total unknown views

total_conversions

float

[en] Total number of conversions

total_engagement_page_visit_value_micro

float

[en] Total page visit engagement value (microunits of the account currency)

total_engagement_signup_value_micro

float

[en] Total signup engagement value (microunits of the account currency)

total_engagement_checkout_value_micro

float

[en] Total checkout engagement value (microunits of the account currency)

total_engagement_custom_value_micro

float

[en] Total custom engagement value (microunits of the account currency)

total_engagement_add_to_cart_value_micro

float

[en] Total add to cart engagement value (microunits of the account currency)

total_engagement_lead_value_micro

float

[en] Total lead engagement value (microunits of the account currency)

total_engagement_search_value_micro

float

[en] Total search engagement value (microunits of the account currency)

total_engagement_watch_video_value_micro

float

[en] Total video watch engagement value (microunits of the account currency)

total_engagement_view_category_value_micro

float

[en] Total category view engagement value (microunits of the account currency)

total_engagement_app_install_value_micro

float

[en] Total app install engagement value (microunits of the account currency)

total_engagement_unknown_value_micro

float

[en] Total unknown engagement value (microunits of the account currency)

total_click_page_visit_value_micro

float

[en] Total page visit click value (microunits of the account currency)

total_click_signup_value_micro

float

[en] Total signup click value (microunits of the account currency)

total_click_checkout_value_micro

float

[en] Total checkout click value (microunits of the account currency)

total_click_custom_value_micro

float

[en] Total custom click value (microunits of the account currency)

total_click_add_to_cart_value_micro

float

[en] Total add to cart click value (microunits of the account currency)

total_click_lead_value_micro

float

[en] Total lead click value (microunits of the account currency)

total_click_search_value_micro

float

[en] Total search click value (microunits of the account currency)

total_click_watch_video_value_micro

float

[en] Total video watch click value (microunits of the account currency)

total_click_view_category_value_micro

float

[en] Total category view click value (microunits of the account currency)

total_click_app_install_value_micro

float

[en] Total app install click value (microunits of the account currency)

total_click_unknown_value_micro

float

[en] Total unknown click value (microunits of the account currency)

total_view_page_visit_value_micro

float

[en] Total page visit view value (microunits of the account currency)

total_view_signup_value_micro

float

[en] Total signup view value (microunits of the account currency)

total_view_checkout_value_micro

float

[en] Total checkout view value (microunits of the account currency)

total_view_custom_value_micro

float

[en] Total custom view value (microunits of the account currency)

total_view_add_to_cart_value_micro

float

[en] Total add to cart view value (microunits of the account currency)

total_view_lead_value_micro

float

[en] Total lead view value (microunits of the account currency)

total_view_search_value_micro

float

[en] Total search view value (microunits of the account currency)

total_view_watch_video_value_micro

float

[en] Total video watch view value (microunits of the account currency)

total_view_view_category_value_micro

float

[en] Total category view view value (microunits of the account currency)

total_view_app_install_value_micro

float

[en] Total app install view value (microunits of the account currency)

total_view_unknown_value_micro

float

[en] Total unknown view value (microunits of the account currency)

total_conversions_value_micro

float

[en] Total value of conversions (microunits of the account currency)

total_engagement_page_visit_quantity

float

[en] Total page visit engagement quantity

total_engagement_signup_quantity

float

[en] Total signup engagement quantity

total_engagement_checkout_quantity

float

[en] Total checkout engagement quantity

total_engagement_custom_quantity

float

[en] Total custom engagement quantity

total_engagement_add_to_cart_quantity

float

[en] Total add to cart engagement quantity

total_engagement_lead_quantity

float

[en] Total lead engagement quantity

total_engagement_search_quantity

float

[en] Total search engagement quantity

total_engagement_watch_video_quantity

float

[en] Total video watch engagement quantity

total_engagement_view_category_quantity

float

[en] Total category view engagement quantity

total_engagement_unknown_quantity

float

[en] Total unknown engagement quantity

total_click_page_visit_quantity

float

[en] Total page visit click quantity

total_click_signup_quantity

float

[en] Total signup click quantity

total_click_checkout_quantity

float

[en] Total checkout click quantity

total_click_custom_quantity

float

[en] Total custom click quantity

total_click_add_to_cart_quantity

float

[en] Total add to cart click quantity

total_click_lead_quantity

float

[en] Total lead click quantity

total_click_search_quantity

float

[en] Total search click quantity

total_click_watch_video_quantity

float

[en] Total video watch click quantity

total_click_view_category_quantity

float

[en] Total category view click quantity

total_click_unknown_quantity

float

[en] Total unknown click quantity

total_view_page_visit_quantity

float

[en] Total page visit view quantity

total_view_signup_quantity

float

[en] Total signup view quantity

total_view_checkout_quantity

float

[en] Total checkout view quantity

total_view_custom_quantity

float

[en] Total custom view quantity

total_view_add_to_cart_quantity

float

[en] Total add to cart view quantity

total_view_lead_quantity

float

[en] Total lead view quantity

total_view_search_quantity

float

[en] Total search view quantity

total_view_watch_video_quantity

float

[en] Total video watch view quantity

total_view_view_category_quantity

float

[en] Total category view view quantity

total_view_unknown_quantity

float

[en] Total unknown view quantity

total_conversions_quantity

float

[en] Total quantity of conversions

total_web_sessions

float

[en] Total number of web sessions

web_sessions_1

float

[en] Web sessions (variant 1)

web_sessions_2

float

[en] Web sessions (variant 2)

onsite_checkouts_1

float

[en] Onsite checkouts (variant 1)

pin_promotion_name

text

[en] Name of the pin promotion

ad_name

text

[en] Name of the ad

campaign_lifetime_spend_cap

float

[en] Lifetime spend cap for the campaign

ad_group_optimization

text

[en] Optimization setting for the ad group

campaign_daily_spend_cap

float

[en] Daily spend cap for the campaign

campaign_budget_optimization

boolean

[en] Budget optimization setting for the campaign

total_page_visit_desktop_action_to_desktop_conversion

float

[en] Total page visit desktop to desktop conversions

total_page_visit_desktop_action_to_mobile_conversion

float

[en] Total page visit desktop to mobile conversions

total_page_visit_desktop_action_to_tablet_conversion

float

[en] Total page visit desktop to tablet conversions

total_page_visit_mobile_action_to_desktop_conversion

float

[en] Total page visit mobile to desktop conversions

total_page_visit_mobile_action_to_mobile_conversion

float

[en] Total page visit mobile to mobile conversions

total_page_visit_mobile_action_to_tablet_conversion

float

[en] Total page visit mobile to tablet conversions

total_page_visit_tablet_action_to_desktop_conversion

float

[en] Total page visit tablet to desktop conversions

total_page_visit_tablet_action_to_mobile_conversion

float

[en] Total page visit tablet to mobile conversions

total_page_visit_tablet_action_to_tablet_conversion

float

[en] Total page visit tablet to tablet conversions

total_signup_desktop_action_to_desktop_conversion

float

[en] Total signup desktop to desktop conversions

total_signup_desktop_action_to_mobile_conversion

float

[en] Total signup desktop to mobile conversions

total_signup_desktop_action_to_tablet_conversion

float

[en] Total signup desktop to tablet conversions

total_signup_mobile_action_to_desktop_conversion

float

[en] Total signup mobile to desktop conversions

total_signup_mobile_action_to_mobile_conversion

float

[en] Total signup mobile to mobile conversions

total_signup_mobile_action_to_tablet_conversion

float

[en] Total signup mobile to tablet conversions

total_signup_tablet_action_to_desktop_conversion

float

[en] Total signup tablet to desktop conversions

total_signup_tablet_action_to_mobile_conversion

float

[en] Total signup tablet to mobile conversions

total_signup_tablet_action_to_tablet_conversion

float

[en] Total signup tablet to tablet conversions

total_checkout_desktop_action_to_desktop_conversion

float

[en] Total checkout desktop to desktop conversions

total_checkout_desktop_action_to_mobile_conversion

float

[en] Total checkout desktop to mobile conversions

total_checkout_desktop_action_to_tablet_conversion

float

[en] Total checkout desktop to tablet conversions

total_checkout_mobile_action_to_desktop_conversion

float

[en] Total checkout mobile to desktop conversions

total_checkout_mobile_action_to_mobile_conversion

float

[en] Total mobile to mobile checkout conversions

total_checkout_mobile_action_to_tablet_conversion

float

[en] Total checkout mobile to tablet conversions

total_checkout_tablet_action_to_desktop_conversion

float

[en] Total checkout tablet to desktop conversions

total_checkout_tablet_action_to_mobile_conversion

float

[en] Total checkout tablet to mobile conversions

total_checkout_tablet_action_to_tablet_conversion

float

[en] Total tablet-to-tablet checkout conversions

total_custom_desktop_action_to_desktop_conversion

float

[en] Total custom desktop to desktop conversions

total_custom_desktop_action_to_mobile_conversion

float

[en] Total conversions from custom desktop to mobile

total_custom_desktop_action_to_tablet_conversion

float

[en] Total conversions from custom desktop to tablet

total_custom_mobile_action_to_desktop_conversion

float

[en] Total conversions from custom mobile to desktop

total_custom_mobile_action_to_mobile_conversion

float

[en] Total conversions from custom mobile to mobile

total_custom_mobile_action_to_tablet_conversion

float

[en] Total conversions from custom mobile to tablet

total_custom_tablet_action_to_desktop_conversion

float

[en] Total conversions from custom tablet to desktop

total_custom_tablet_action_to_mobile_conversion

float

[en] Total conversions from custom tablet to mobile

total_custom_tablet_action_to_tablet_conversion

float

[en] Total custom tablet to tablet conversions

total_add_to_cart_desktop_action_to_desktop_conversion

float

[en] Total add to cart desktop to desktop conversions

total_add_to_cart_desktop_action_to_mobile_conversion

float

[en] Total add to cart desktop to mobile conversions

total_add_to_cart_desktop_action_to_tablet_conversion

float

[en] Total add to conversions desktop cart for tablet

total_add_to_cart_mobile_action_to_desktop_conversion

float

[en] Total add to cart mobile to desktop conversionsp

total_add_to_cart_mobile_action_to_mobile_conversion

float

[en] Total mobile to mobile add to cart conversions

total_add_to_cart_mobile_action_to_tablet_conversion

float

[en] Total add to cart mobile to tablet conversions

total_add_to_cart_tablet_action_to_desktop_conversion

float

[en] Total add to cart tablet to desktop conversions

total_add_to_cart_tablet_action_to_mobile_conversion

float

[en] Total add to cart tablet to mobile conversions

total_add_to_cart_tablet_action_to_tablet_conversion

float

[en] Total add to cart tablet to tablet conversions

total_lead_desktop_action_to_desktop_conversion

float

[en] Total lead desktop to desktop conversions

total_lead_desktop_action_to_mobile_conversion

float

[en] Total desktop to mobile lead conversions

total_lead_desktop_action_to_tablet_conversion

float

[en] Total desktop to tablet lead conversions

total_lead_mobile_action_to_desktop_conversion

float

[en] Total mobile to desktop lead conversions

total_lead_mobile_action_to_mobile_conversion

float

[en] Total mobile to mobile lead conversions

total_lead_mobile_action_to_tablet_conversion

float

[en] Total mobile to tablet lead conversions

total_lead_tablet_action_to_desktop_conversion

float

[en] Total tablet to desktop lead conversions

total_lead_tablet_action_to_mobile_conversion

float

[en] Total lead tablet to mobile conversions

total_lead_tablet_action_to_tablet_conversion

float

[en] Total tablet to tablet lead conversions

total_search_desktop_action_to_desktop_conversion

float

[en] Total search desktop to desktop conversions

total_search_desktop_action_to_mobile_conversion

float

[en] Total desktop to mobile search conversions

total_search_desktop_action_to_tablet_conversion

float

[en] Total search desktop to tablet conversions

total_search_mobile_action_to_desktop_conversion

float

[en] Total mobile search to desktop conversions

total_search_mobile_action_to_mobile_conversion

float

[en] Total mobile search conversions to mobile

total_search_mobile_action_to_tablet_conversion

float

[en] Total mobile search conversions to tablet

total_search_tablet_action_to_desktop_conversion

float

[en] Total search tablet to desktop conversions

total_search_tablet_action_to_mobile_conversion

float

[en] Total search conversions from tablet to mobile

total_search_tablet_action_to_tablet_conversion

float

[en] Total search tablet to tablet conversions

total_watch_video_desktop_action_to_desktop_conversion

float

[en] Total video watch desktop to desktop conversions

total_watch_video_desktop_action_to_mobile_conversion

float

[en] Total desktop to mobile watch video conversions

total_watch_video_desktop_action_to_tablet_conversion

float

[en] Total watch video desktop to tablet conversions

total_watch_video_mobile_action_to_desktop_conversion

float

[en] Total watch video mobile to desktop conversions

total_watch_video_mobile_action_to_mobile_conversion

float

[en] Total mobile to mobile watch video conversions

total_watch_video_mobile_action_to_tablet_conversion

float

[en] Total watch video mobile to tablet conversions

total_watch_video_tablet_action_to_desktop_conversion

float

[en] Total watch video tablet to desktop conversions

total_watch_video_tablet_action_to_mobile_conversion

float

[en] Total watch video tablet to mobile conversions

total_watch_video_tablet_action_to_tablet_conversion

float

[en] Total watch video tablet to tablet conversions

total_view_category_desktop_action_to_desktop_conversion

float

[en] Total category view desktop to desktop conversions

total_view_category_desktop_action_to_mobile_conversion

float

[en] Total view category desktop to mobile conversions

total_view_category_desktop_action_to_tablet_conversion

float

[en] Total view category desktop to tablet conversions

total_view_category_mobile_action_to_desktop_conversion

float

[en] Total view category conversions from mobile to desktop

total_view_category_mobile_action_to_mobile_conversion

float

[en] Total mobile to mobile view category conversions

total_view_category_mobile_action_to_tablet_conversion

float

[en] Total view category conversions from mobile to tablet

total_view_category_tablet_action_to_desktop_conversion

float

[en] Total view category tablet to desktop conversions

total_view_category_tablet_action_to_mobile_conversion

float

[en] Total conversions from view category tablet to mobile

total_view_category_tablet_action_to_tablet_conversion

float

[en] Total view category tablet to tablet conversions

total_app_install_desktop_action_to_desktop_conversion

float

[en] Total app install desktop to desktop conversions

total_app_install_desktop_action_to_mobile_conversion

float

[en] Total conversions from app install desktop to mobile

total_app_install_desktop_action_to_tablet_conversion

float

[en] Total conversions from app install desktop to tablet

total_app_install_mobile_action_to_desktop_conversion

float

[en] Total conversions from mobile app installs to desktop

total_app_install_mobile_action_to_mobile_conversion

float

[en] Total conversions from mobile app installs to mobile

total_app_install_mobile_action_to_tablet_conversion

float

[en] Total conversions from mobile app installs to tablet

total_app_install_tablet_action_to_desktop_conversion

float

[en] Total conversions from tablet app installs to desktop

total_app_install_tablet_action_to_mobile_conversion

float

[en] Total conversions from tablet app installs to mobile

total_app_install_tablet_action_to_tablet_conversion

float

[en] Total app install tablet to tablet conversions

total_unknown_desktop_action_to_desktop_conversion

float

[en] Total unknown desktop to desktop conversions

total_unknown_desktop_action_to_mobile_conversion

float

[en] Total conversions from unknown desktop to mobile

total_unknown_desktop_action_to_tablet_conversion

float

[en] Total conversions from unknown desktop to tablet

total_unknown_mobile_action_to_desktop_conversion

float

[en] Total conversions from unknown mobile to desktop

total_unknown_mobile_action_to_mobile_conversion

float

[en] Total conversions from unknown mobile to mobile

total_unknown_mobile_action_to_tablet_conversion

float

[en] Total conversions from unknown mobile to tablet

total_unknown_tablet_action_to_desktop_conversion

float

[en] Total conversions from unknown tablet to desktop

total_unknown_tablet_action_to_mobile_conversion

float

[en] Total conversions from unknown tablet to mobile

total_unknown_tablet_action_to_tablet_conversion

float

[en] Total conversions from unknown tablet to tablet

total_page_visit

float

[en] Total page visit actions

total_signup

float

[en] Total signup actions

total_checkout

float

[en] Total checkout actions

total_custom

float

[en] Total custom actions

total_add_to_cart

float

[en] Total add to cart actions

total_lead

float

[en] Total lead actions

total_search

float

[en] Total search actions

total_watch_video

float

[en] Total video watch actions

total_view_category

float

[en] Total category view actions

total_app_install

float

[en] Total app install actions

total_signup_value_micro

float

[en] Total signup value (microunits of the account currency)

total_checkout_value_micro

float

[en] Total checkout value (microunits of the account currency)

total_custom_value_micro

float

[en] Total custom value (microunits of the account currency)

total_add_to_cart_value_micro

float

[en] Total add to cart value (microunits of the account currency)

total_lead_value_micro

float

[en] Total lead value (microunits of the account currency)

total_search_value_micro

float

[en] Total search value (microunits of the account currency)

total_watch_video_value_micro

float

[en] Total video watch value (microunits of the account currency)

total_view_category_value_micro

float

[en] Total category view value (microunits of the account currency)

total_app_install_value_micro

float

[en] Total app install value (microunits of the account currency)

total_checkout_quantity

float

[en] Total checkout quantity

page_visit_cost_per_action

float

[en] Cost per page visit action

app_install_cost_per_action

float

[en] Cost per app install action

page_visit_roas

float

[en] Return on ad spend for page visits

checkout_roas

float

[en] Return on ad spend for checkouts

custom_roas

float

[en] Return on ad spend for custom actions

product_group_ad_image_tag

float

[en] Image tag for the product group ad

product_group_ad_video_tag

float

[en] Video tag for the product group ad

video_3sec_views_1

float

[en] Video 3-second views (variant 1)

video_p100_complete_1

float

[en] Video 100%% completion views (variant 1)

video_p0_combined_1

float

[en] Video 0%% completion views (variant 1)

video_p25_combined_1

float

[en] Video 25%% completion views (variant 1)

video_p50_combined_1

float

[en] Video 50%% completion views (variant 1)

video_p75_combined_1

float

[en] Video 75%% completion views (variant 1)

video_p95_combined_1

float

[en] Video 95%% completion views (variant 1)

video_mrc_views_1

float

[en] Video MRC (Media Rating Council) views (variant 1)

video_3sec_views_2

float

[en] Video 3-second views (variant 2)

video_p100_complete_2

float

[en] Video 100%% completion views (variant 2)

video_p0_combined_2

float

[en] Video 0%% completion views (variant 2)

video_p25_combined_2

float

[en] Video 25%% completion views (variant 2)

video_p50_combined_2

float

[en] Video 50%% completion views (variant 2)

video_p75_combined_2

float

[en] Video 75%% completion views (variant 2)

video_p95_combined_2

float

[en] Video 95%% completion views (variant 2)

video_mrc_views_2

float

[en] Video MRC (Media Rating Council) views (variant 2)

paid_video_viewable_rate

float

[en] Rate of paid video views that were viewable

video_length

float

[en] Length of the video in seconds

video_spend

float

[en] Video spend - Amount spent on video ads in the account's currency.

cpv_micro

float

[en] Cost per video view (microunits of the account currency)

ecpv

float

[en] Effective cost per video view (in account currency)

cpcv_micro

float

[en] Cost per completed video view (microunits of the account currency)

ecpcv

float

[en] Effective cost per completed video view (in account currency)

cpcv_p95_micro

float

[en] Cost per 95%% completed video view (microunits of the account currency)

ecpcv_p95

float

[en] Effective cost per 95%% completed video view (in account currency)

total_video_3sec_views

float

[en] Total video 3-second views

total_video_p100_complete

float

[en] Total video 100%% completion views

total_video_p0_combined

float

[en] Total video 0%% completion views

total_video_p25_combined

float

[en] Total video 25%% completion views

total_video_p50_combined

float

[en] Total video 50%% completion views

total_video_p75_combined

float

[en] Total video 75%% completion views

total_video_p95_combined

float

[en] Total video 95%% completion views

total_video_mrc_views

float

[en] Total video MRC (Media Rating Council) views

video_avg_watchtime_in_second_1

float

[en] Average video watch time in seconds (variant 1)

video_avg_watchtime_in_second_2

float

[en] Average video watch time in seconds (variant 2)

total_video_avg_watchtime_in_second

float

[en] Total average video watch time in seconds

total_destination_views

float

[en] Total number of destination views

total_repin_rate

float

[en] Total repin rate

web_checkout_cost_per_action

float

[en] Cost per web checkout action

web_checkout_roas

float

[en] Return on ad spend for web checkouts

total_web_checkout

float

[en] Total web checkout conversions

total_web_checkout_value_micro

float

[en] Total web checkout conversions in microunits of account currency

total_web_click_checkout

float

[en] Total web checkout clicks

total_web_click_checkout_value_micro

float

[en] Total web checkout click value (microunits of the account currency)

total_web_engagement_checkout

float

[en] Total web checkout engagements

total_web_engagement_checkout_value_micro

float

[en] Total web checkout engagement value (microunits of the account currency)

total_web_view_checkout

float

[en] Total web checkout views

total_web_view_checkout_value_micro

float

[en] Total web checkout view value (microunits of the account currency)

inapp_checkout_cost_per_action

float

[en] Cost per in-app checkout action

inapp_checkout_roas

float

[en] Return on ad spend for in-app checkouts

total_inapp_checkout

float

[en] Total in-app checkout conversions

total_inapp_checkout_value_micro

float

[en] Total in-app checkout conversions in microunits of account currency

total_inapp_click_checkout

float

[en] Total in-app checkout clicks

total_inapp_click_checkout_value_micro

float

[en] Total in-app checkout click value (microunits of the account currency)

total_inapp_engagement_checkout

float

[en] Total in-app checkout engagements

total_inapp_engagement_checkout_value_micro

float

[en] Total in-app checkout engagement value (microunits of the account currency)

total_inapp_view_checkout

float

[en] Total in-app checkout views

total_inapp_view_checkout_value_micro

float

[en] Total in-app checkout view value (microunits of the account currency)

offline_checkout_cost_per_action

float

[en] Cost per offline checkout action

offline_checkout_roas

float

[en] Return on ad spend for offline checkouts

total_offline_checkout

float

[en] Total offline checkout conversions

total_offline_checkout_value_micro

float

[en] Total offline checkout conversions in microunits of account currency

total_offline_click_checkout

float

[en] Total offline checkout clicks

total_offline_click_checkout_value_micro

float

[en] Total offline checkout click value (microunits of the account currency)

total_offline_engagement_checkout

float

[en] Total offline checkout engagements

total_offline_engagement_checkout_value_micro

float

[en] Total offline checkout engagement value (microunits of the account currency)

total_offline_view_checkout

float

[en] Total offline checkout views

total_offline_view_checkout_value_micro

float

[en] Total offline checkout view value (microunits of the account currency)

pinterest_checkout_cost_per_action

float

[en] Cost per Pinterest checkout action

pinterest_checkout_roas

float

[en] Return on ad spend for Pinterest checkouts

total_pinterest_checkout

float

[en] Total Pinterest checkout actions

total_pinterest_checkout_value_micro

float

[en] Total Pinterest checkout value (microunits of the account currency)

web_add_to_cart_cost_per_action

float

[en] Cost per web add to cart action

web_add_to_cart_roas

float

[en] Return on ad spend for web add to cart

total_web_add_to_cart

float

[en] Total web add to cart actions

total_web_add_to_cart_value_micro

float

[en] Total web add to cart value (microunits of the account currency)

total_web_click_add_to_cart

float

[en] Total web add to cart clicks

total_web_click_add_to_cart_value_micro

float

[en] Total web add to cart click value (microunits of the account currency)

total_web_engagement_add_to_cart

float

[en] Total web add to cart engagements

total_web_engagement_add_to_cart_value_micro

float

[en] Total web add to cart engagement value (microunits of the account currency)

total_web_view_add_to_cart

float

[en] Total web add to cart views

total_web_view_add_to_cart_value_micro

float

[en] Total web add to cart view value (microunits of the account currency)

inapp_add_to_cart_cost_per_action

float

[en] Cost per in-app add to cart action

inapp_add_to_cart_roas

float

[en] Return on ad spend for in-app add to cart

total_inapp_add_to_cart

float

[en] Total in-app add to cart actions

total_inapp_add_to_cart_value_micro

float

[en] Total in-app add to cart value (microunits of the account currency)

total_inapp_click_add_to_cart

float

[en] Total in-app add to cart clicks

total_inapp_click_add_to_cart_value_micro

float

[en] Total in-app add to cart click value (microunits of the account currency)

total_inapp_engagement_add_to_cart

float

[en] Total in-app add to cart engagements

total_inapp_engagement_add_to_cart_value_micro

float

[en] Total in-app add to cart engagement value (microunits of the account currency)

total_inapp_view_add_to_cart

float

[en] Total in-app add to cart views

total_inapp_view_add_to_cart_value_micro

float

[en] Total in-app add to cart view value (microunits of the account currency)

web_page_visit_cost_per_action

float

[en] Cost per web page visit action

web_page_visit_roas

float

[en] Return on ad spend for web page visits

total_web_page_visit

float

[en] Total web page visit actions

total_web_page_visit_value_micro

float

[en] Total web page visit value (microunits of the account currency)

total_web_click_page_visit

float

[en] Total web page visit clicks

total_web_click_page_visit_value_micro

float

[en] Total web page visit click value (microunits of the account currency)

total_web_engagement_page_visit

float

[en] Total web page visit engagements

total_web_engagement_page_visit_value_micro

float

[en] Total web page visit engagement value (microunits of the account currency)

total_web_view_page_visit

float

[en] Total web page visit views

total_web_view_page_visit_value_micro

float

[en] Total web page visit view value (microunits of the account currency)

web_signup_cost_per_action

float

[en] Cost per web signup action

web_signup_roas

float

[en] Return on ad spend for web signups

total_web_signup

float

[en] Total web signup actions

total_web_signup_value_micro

float

[en] Total web signup value (microunits of the account currency)

total_web_click_signup

float

[en] Total web signup clicks

total_web_click_signup_value_micro

float

[en] Total web signup click value (microunits of the account currency)

total_web_engagement_signup

float

[en] Total web signup engagements

total_web_engagement_signup_value_micro

float

[en] Total web signup engagement value (microunits of the account currency)

total_web_view_signup

float

[en] Total web signup views

total_web_view_signup_value_micro

float

[en] Total web signup view value (microunits of the account currency)

inapp_signup_cost_per_action

float

[en] Cost per in-app signup action

inapp_signup_roas

float

[en] Return on ad spend for in-app signups

total_inapp_signup

float

[en] Total in-app signup actions

total_inapp_signup_value_micro

float

[en] Total in-app signup value (microunits of the account currency)

total_inapp_click_signup

float

[en] Total in-app signup clicks

total_inapp_click_signup_value_micro

float

[en] Total in-app signup click value (microunits of the account currency)

total_inapp_engagement_signup

float

[en] Total in-app signup engagements

total_inapp_engagement_signup_value_micro

float

[en] Total in-app signup engagement value (microunits of the account currency)

total_inapp_view_signup

float

[en] Total in-app signup views

total_inapp_view_signup_value_micro

float

[en] Total in-app signup view value (microunits of the account currency)

offline_signup_cost_per_action

float

[en] Cost per offline signup action

offline_signup_roas

float

[en] Return on ad spend for offline signups

total_offline_signup

float

[en] Total offline signup actions

total_offline_signup_value_micro

float

[en] Total offline signup value (microunits of the account currency)

total_offline_click_signup

float

[en] Total offline signup clicks

total_offline_click_signup_value_micro

float

[en] Total offline signup click value (microunits of the account currency)

total_offline_engagement_signup

float

[en] Total offline signup engagements

total_offline_engagement_signup_value_micro

float

[en] Total offline signup engagement value (microunits of the account currency)

total_offline_view_signup

float

[en] Total offline signup views

total_offline_view_signup_value_micro

float

[en] Total offline signup view value (microunits of the account currency)

web_watch_video_cost_per_action

float

[en] Cost per web video watch action

web_watch_video_roas

float

[en] Return on ad spend for web video watches

total_web_watch_video

float

[en] Total web video watch actions

total_web_watch_video_value_micro

float

[en] Total web video watch value (microunits of the account currency)

total_web_click_watch_video

float

[en] Total web video watch clicks

total_web_click_watch_video_value_micro

float

[en] Total web video watch click value (microunits of the account currency)

total_web_engagement_watch_video

float

[en] Total web video watch engagements

total_web_engagement_watch_video_value_micro

float

[en] Total web video watch engagement value (microunits of the account currency)

total_web_view_watch_video

float

[en] Total web video watch views

total_web_view_watch_video_value_micro

float

[en] Total web video watch view value (microunits of the account currency)

web_lead_cost_per_action

float

[en] Cost per web lead action

web_lead_roas

float

[en] Return on ad spend for web leads

total_web_lead

float

[en] Total web lead actions

total_web_lead_value_micro

float

[en] Total web lead value (microunits of the account currency)

total_web_click_lead

float

[en] Total web lead clicks

total_web_click_lead_value_micro

float

[en] Total web lead click value (microunits of the account currency)

total_web_engagement_lead

float

[en] Total web lead engagements

total_web_engagement_lead_value_micro

float

[en] Total web lead engagement value (microunits of the account currency)

total_web_view_lead

float

[en] Total web lead views

total_web_view_lead_value_micro

float

[en] Total web lead view value (microunits of the account currency)

offline_lead_cost_per_action

float

[en] Cost per offline lead action

offline_lead_roas

float

[en] Return on ad spend for offline leads

total_offline_lead

float

[en] Total offline lead actions

total_offline_lead_value_micro

float

[en] Total offline lead value (microunits of the account currency)

total_offline_click_lead

float

[en] Total offline lead clicks

total_offline_click_lead_value_micro

float

[en] Total offline lead click value (microunits of the account currency)

total_offline_engagement_lead

float

[en] Total offline lead engagements

total_offline_engagement_lead_value_micro

float

[en] Total offline lead engagement value (microunits of the account currency)

total_offline_view_lead

float

[en] Total offline lead views

total_offline_view_lead_value_micro

float

[en] Total offline lead view value (microunits of the account currency)

web_search_cost_per_action

float

[en] Cost per web search action

web_search_roas

float

[en] Return on ad spend for web searches

total_web_search

float

[en] Total web search actions

total_web_search_value_micro

float

[en] Total web search value (microunits of the account currency)

total_web_click_search

float

[en] Total web search clicks

total_web_click_search_value_micro

float

[en] Total web search click value (microunits of the account currency)

total_web_engagement_search

float

[en] Total web search engagements

total_web_engagement_search_value_micro

float

[en] Total web search engagement value (microunits of the account currency)

total_web_view_search

float

[en] Total web search views

total_web_view_search_value_micro

float

[en] Total web search view value (microunits of the account currency)

inapp_search_cost_per_action

float

[en] Cost per in-app search action

inapp_search_roas

float

[en] Return on ad spend for in-app searches

total_inapp_search

float

[en] Total in-app search actions

total_inapp_search_value_micro

float

[en] Total in-app search value (microunits of the account currency)

total_inapp_click_search

float

[en] Total in-app search clicks

total_inapp_click_search_value_micro

float

[en] Total in-app search click value (microunits of the account currency)

total_inapp_engagement_search

float

[en] Total in-app search engagements

total_inapp_engagement_search_value_micro

float

[en] Total in-app search engagement value (microunits of the account currency)

total_inapp_view_search

float

[en] Total in-app search views

total_inapp_view_search_value_micro

float

[en] Total in-app search view value (microunits of the account currency)

web_view_category_cost_per_action

float

[en] Cost per web category view action

web_view_category_roas

float

[en] Return on ad spend for web category views

total_web_view_category

float

[en] Total web category view actions

total_web_view_category_value_micro

float

[en] Total web category view value (microunits of the account currency)

total_web_click_view_category

float

[en] Total web category view clicks

total_web_click_view_category_value_micro

float

[en] Total web category view click value (microunits of the account currency)

total_web_engagement_view_category

float

[en] Total web category view engagements

total_web_engagement_view_category_value_micro

float

[en] Total web category view engagement value (microunits of the account currency)

total_web_view_view_category

float

[en] Total web category view views

total_web_view_view_category_value_micro

float

[en] Total web category view view value (microunits of the account currency)

web_custom_cost_per_action

float

[en] Cost per web custom action

web_custom_roas

float

[en] Return on ad spend for web custom actions

total_web_custom

float

[en] Total web custom actions

total_web_custom_value_micro

float

[en] Total web custom value (microunits of the account currency)

total_web_click_custom

float

[en] Total web custom clicks

total_web_click_custom_value_micro

float

[en] Total web custom click value (microunits of the account currency)

total_web_engagement_custom

float

[en] Total web custom engagements

total_web_engagement_custom_value_micro

float

[en] Total web custom engagement value (microunits of the account currency)

total_web_view_custom

float

[en] Total web custom views

total_web_view_custom_value_micro

float

[en] Total web custom view value (microunits of the account currency)

offline_custom_cost_per_action

float

[en] Cost per offline custom action

offline_custom_roas

float

[en] Return on ad spend for offline custom actions

total_offline_custom

float

[en] Total offline custom actions

total_offline_custom_value_micro

float

[en] Total offline custom value (microunits of the account currency)

total_offline_click_custom

float

[en] Total offline custom clicks

total_offline_click_custom_value_micro

float

[en] Total offline custom click value (microunits of the account currency)

total_offline_engagement_custom

float

[en] Total offline custom engagements

total_offline_engagement_custom_value_micro

float

[en] Total offline custom engagement value (microunits of the account currency)

total_offline_view_custom

float

[en] Total offline custom views

total_offline_view_custom_value_micro

float

[en] Total offline custom view value (microunits of the account currency)

web_unknown_cost_per_action

float

[en] Cost per web unknown action

web_unknown_roas

float

[en] Return on ad spend for web unknown actions

total_web_unknown

float

[en] Total web unknown actions

total_web_unknown_value_micro

float

[en] Total web unknown value (microunits of the account currency)

total_web_click_unknown

float

[en] Total web unknown clicks

total_web_click_unknown_value_micro

float

[en] Total web unknown click value (microunits of the account currency)

total_web_engagement_unknown

float

[en] Total web unknown engagements

total_web_engagement_unknown_value_micro

float

[en] Total web unknown engagement value (microunits of the account currency)

total_web_view_unknown

float

[en] Total web unknown views

total_web_view_unknown_value_micro

float

[en] Total web unknown view value (microunits of the account currency)

inapp_unknown_cost_per_action

float

[en] Cost per in-app unknown action

inapp_unknown_roas

float

[en] Return on ad spend for in-app unknown actions

total_inapp_unknown

float

[en] Total in-app unknown actions

total_inapp_unknown_value_micro

float

[en] Total in-app unknown value (microunits of the account currency)

total_inapp_click_unknown

float

[en] Total in-app unknown clicks

total_inapp_click_unknown_value_micro

float

[en] Total in-app unknown click value (microunits of the account currency)

total_inapp_engagement_unknown

float

[en] Total in-app unknown engagements

total_inapp_engagement_unknown_value_micro

float

[en] Total in-app unknown engagement value (microunits of the account currency)

total_inapp_view_unknown

float

[en] Total in-app unknown views

total_inapp_view_unknown_value_micro

float

[en] Total in-app unknown view value (microunits of the account currency)

offline_unknown_cost_per_action

float

[en] Cost per offline unknown action

offline_unknown_roas

float

[en] Return on ad spend for offline unknown actions

total_offline_unknown

float

[en] Total offline unknown actions

total_offline_unknown_value_micro

float

[en] Total offline unknown value (microunits of the account currency)

total_offline_click_unknown

float

[en] Total offline unknown clicks

total_offline_click_unknown_value_micro

float

[en] Total offline unknown click value (microunits of the account currency)

total_offline_engagement_unknown

float

[en] Total offline unknown engagements

total_offline_engagement_unknown_value_micro

float

[en] Total offline unknown engagement value (microunits of the account currency)

total_offline_view_unknown

float

[en] Total offline unknown views

total_offline_view_unknown_value_micro

float

[en] Total offline unknown view value (microunits of the account currency)

inapp_app_install_cost_per_action

float

[en] Cost per in-app app install action

inapp_app_install_roas

float

[en] Return on ad spend for in-app app installs

total_inapp_app_install

float

[en] Total in-app app install actions

total_inapp_app_install_value_micro

float

[en] Total in-app app install value (microunits of the account currency)

total_inapp_click_app_install

float

[en] Total in-app app install clicks

total_inapp_click_app_install_value_micro

float

[en] Total in-app app install click value (microunits of the account currency)

total_inapp_engagement_app_install

float

[en] Total in-app app install engagements

total_inapp_engagement_app_install_value_micro

float

[en] Total in-app app install engagement value (microunits of the account currency)

total_inapp_view_app_install

float

[en] Total in-app app install views

total_inapp_view_app_install_value_micro

float

[en] Total in-app app install view value (microunits of the account currency)

idea_pin_page_forward_1

float

[en] Idea pin page forward actions (variant 1)

idea_pin_page_forward_2

float

[en] Idea pin page forward actions (variant 2)

idea_pin_page_backward_1

float

[en] Idea pin page backward actions (variant 1)

idea_pin_page_backward_2

float

[en] Idea pin page backward actions (variant 2)

total_idea_pin_page_forward

text

[en] Total idea pin page forward actions

total_idea_pin_page_backward

text

[en] Total idea pin page backward actions

idea_pin_product_tag_visit_1

float

[en] Idea pin product tag visits (variant 1)

idea_pin_product_tag_visit_2

float

[en] Idea pin product tag visits (variant 2)

total_idea_pin_product_tag_visit

text

[en] Total idea pin product tag visits

leads

float

[en] Number of leads generated

cost_per_lead

float

[en] Cost per lead generated

quiz_completed

float

[en] Number of quizzes completed

quiz_completion_rate

float

[en] Rate of quiz completion

showcase_pin_clickthrough

float

[en] Number of showcase pin clickthroughs

showcase_subpage_clickthrough

float

[en] Number of showcase subpage clickthroughs

showcase_subpin_clickthrough

float

[en] Number of showcase subpin clickthroughs

showcase_subpage_impression

float

[en] Number of showcase subpage impressions

showcase_subpin_impression

float

[en] Number of showcase subpin impressions

showcase_subpage_swipe_left

float

[en] Number of showcase subpage left swipes

showcase_subpage_swipe_right

float

[en] Number of showcase subpage right swipes

showcase_subpin_swipe_left

float

[en] Number of showcase subpin left swipes

showcase_subpin_swipe_right

float

[en] Number of showcase subpin right swipes

showcase_subpage_repin

float

[en] Number of showcase subpage repins

showcase_subpin_repin

float

[en] Number of showcase subpin repins

showcase_subpage_closeup

float

[en] Number of showcase subpage closeups

showcase_card_thumbnail_swipe_forward

float

[en] Number of showcase card thumbnail forward swipes

showcase_card_thumbnail_swipe_backward

float

[en] Number of showcase card thumbnail backward swipes

showcase_average_subpage_closeup_per_session

float

[en] Average showcase subpage closeups per session

total_checkout_conversion_rate

float

[en] Total checkout conversion rate

total_view_category_conversion_rate

float

[en] Total category view conversion rate

total_add_to_cart_conversion_rate

float

[en] Total add to cart conversion rate

total_signup_conversion_rate

float

[en] Total signup conversion rate

total_page_visit_conversion_rate

float

[en] Total page visit conversion rate

total_lead_conversion_rate

float

[en] Total lead conversion rate

total_search_conversion_rate

float

[en] Total search conversion rate

total_watch_video_conversion_rate

float

[en] Total video watch conversion rate

total_unknown_conversion_rate

float

[en] Total unknown conversion rate

total_custom_conversion_rate

float

[en] Total custom conversion rate

standard_ad_feed_item_id

text

[en] Unique identifier for the standard ad feed item

placement

text

[en] Placement

apptype

text

[en] App Type

targeted_interest

text

[en] Targeted Interest

country

text

[en] Country

audience_include

text

[en] Audience Include

media_type

text

[en] Media Type

keyword

text

[en] Keyword

gender

text

[en] Gender

region

text

[en] Region

audience_multiplier

text

[en] Audience Multiplier

local_ads_store_code

text

[en] Local Ads Store Code

location

text

[en] Location

pinner_interest

text

[en] Pinner Interest

geo

text

[en] Geo

age_bucket_and_gender

text

[en] Age Bucket and Gender

keyword

text

[en] Keyword

Notes

Period limitations:

  • If the granularity is not HOUR, you can extract data up to 914 days before the current date
  • If the granularity is HOUR, you can extract data up to 8 days before the current date
  • Part of this documentation was automatically generated by AI and may contain errors. We recommend verifying critical information