Pinterest Ads
Redes sociais · DisponívelConsultar via API
GET https://askaner.askan.com.br/api/v1/data/pinterest?fields=date,account_id&date_preset=last_30d Authorization: Bearer ik_...
Campos (141 métricas, 54 dimensões)
| ID | Tipo | Natureza | Descrição |
|---|---|---|---|
audience_age | TEXT | Dimensão | Age bracket of the ad account's audience (audience insights, not a targeting breakdown). |
audience_gender | TEXT | Dimensão | Gender of the ad account's audience (audience insights, not a targeting breakdown). |
audience_insight_type | TEXT | Dimensão | Audience segment the demographics describe: 'YOUR_TOTAL_AUDIENCE', 'YOUR_ENGAGED_AUDIENCE' or 'PINTEREST_TOTAL_AUDIENCE'. |
audience_share | PERCENT | Métrica | Share of the audience segment in this demographic bucket (0-1). Multiply by Audience Size for the bucket's population. |
audience_size | NUMERIC | Métrica | Rounded total population of the audience segment. |
age | TEXT | Dimensão | Age bracket breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
app_type | TEXT | Dimensão | App type breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
country | COUNTRY | Dimensão | Country breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
gender | TEXT | Dimensão | Gender breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
geo | TEXT | Dimensão | Geo breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
keyword | TEXT | Dimensão | Keyword breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
location | TEXT | Dimensão | Location breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
pinner_interest | TEXT | Dimensão | Pinner Interest breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
placement | TEXT | Dimensão | Placement breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
region | REGION | Dimensão | Region breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
targeted_interest | TEXT | Dimensão | Targeted Interest breakdown (Targeting type). Up to 5 targeting types allowed. Note: The reporting per targeting type is independent from each other. |
account_id | TEXT | Dimensão | Your Pinterest Advertiser ID |
account_name | TEXT | Dimensão | The account (advertiser) name |
ad_group | TEXT | Dimensão | Alias for ad group name. |
ad_group_budget | NUMERIC | Métrica | Ad group budget in the account currency. Interpreted according to the ad group budget type (daily or lifetime). |
ad_group_budget_type | TEXT | Dimensão | Ad group budget type ('DAILY', 'LIFETIME', 'CBO_ADGROUP'). CBO_ADGROUP means the budget is set at the campaign level and distributed automatically across the campaign's ad groups. |
ad_group_entity_status | TEXT | Dimensão | Your ad group entity status. |
ad_group_id | TEXT | Dimensão | Your ad group ID. |
ad_group_name | TEXT | Dimensão | Your ad group name. |
ad_group_status | TEXT | Dimensão | Your ad group status. |
ad_id | TEXT | Dimensão | Your ad ID. |
adnetwork_conversions | NUMERIC | Métrica | Total number of conversions for all event types using the Pinterest Tag integration after an ad interaction |
adnetwork_revenue | NUMERIC | Métrica | The value from web conversions from your promoted Pins, including both first-order and downstream, in account currency |
advertiserid | TEXT | Dimensão | Your Pinterest Advertiser ID |
average_order_value_checkout | NUMERIC | Métrica | Average value per checkout event, calculated as checkout order value divided by the number of checkout conversions. |
campaign | TEXT | Dimensão | Alias for Campaign Name |
campaign_daily_spend_cap | NUMERIC | Métrica | Campaign-level daily spend cap in the account currency (converted from micro-currency). Null or 0 means no cap is set. |
campaign_end_time | TIMESTAMP | Dimensão | Campaign end time converted from Unix timestamp. |
campaign_id | TEXT | Dimensão | Campaign ID |
campaign_lifetime_spend_cap | NUMERIC | Métrica | Campaign-level lifetime spend cap in the account currency (converted from micro-currency). Null or 0 means no cap is set. |
campaign_name | TEXT | Dimensão | Campaign Name |
campaign_objective | TEXT | Dimensão | Campaign objective type ('AWARENESS', 'CONSIDERATION', 'SALES', 'LEADS', 'APP_INSTALL', 'VIDEO_COMPLETION'; legacy: 'WEB_CONVERSION', 'CATALOG_SALES') |
campaign_start_time | TIMESTAMP | Dimensão | Campaign start time converted from Unix timestamp. |
campaign_status | TEXT | Dimensão | Campaign status ('ADVERTISER_DISABLED', 'ARCHIVED', 'COMPLETED', 'NOT_STARTED', 'PAUSED', 'RUNNING') |
checkout_revenue | NUMERIC | Métrica | Total value of checkout events resulting from interactions with your ad. |
clicks | NUMERIC | Métrica | The total number of clicks on your Pin to content on or off of Pinterest (paid and earned) |
clickthrough | NUMERIC | Métrica | The total number of clicks on your Pin to content on or off of Pinterest (paid and earned) |
clickthrough_earned | NUMERIC | Métrica | Total number of Pin clicks from ads saved to another person's board |
clickthrough_paid | NUMERIC | Métrica | The total number of clicks on your Pin to content on or off of Pinterest |
cpa | NUMERIC | Métrica | The average CPA for all event types using the Pinterest Tag integration after an ad interaction |
cpc | NUMERIC | Métrica | Cost-per-click (CPC) bidding means that you pay for each click on your ads |
cpm | NUMERIC | Métrica | Cost per 1000 impressions (paid and earned) |
ctr | PERCENT | Métrica | Click-through rate of clicks on your Pin to content on or off of Pinterest (paid and earned) |
currency | TEXT | Dimensão | Account currency |
data_fetched_at | TIMESTAMP | Dimensão | UTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed. |
datasource | TEXT | Dimensão | The name of the Windsor connector returning the row |
date | DATE | Dimensão | Date |
day_of_month | TEXT | Dimensão | Day of the month |
earned_saves | NUMERIC | Métrica | Number of times your ad was saved from another person's board. |
engagement_earned | NUMERIC | Métrica | Earned actions from ads saved to boards |
engagement_paid | NUMERIC | Métrica | Paid actions taken as a result of your ads |
engagements | NUMERIC | Métrica | The total number of engagements on your ads, including clicks, saves, carousel swipes, and collections secondary saves |
frequency | NUMERIC | Métrica | The average number of times each user saw your ad. |
impressions | NUMERIC | Métrica | Number of times someone saw your ad (paid and earned) |
impressions_earned | NUMERIC | Métrica | Total number of times your ad was viewed after being saved to another person's board |
impressions_paid | NUMERIC | Métrica | The number of times your ad was seen |
month | TEXT | Dimensão | Number of the month |
now | TIMESTAMP | Dimensão | Current timestamp |
outbound_clicks | NUMERIC | Métrica | The total number of clicks to the destination URL associated with your ad (paid and earned) |
outbound_clicks_earned | NUMERIC | Métrica | The total number of clicks to the destination URL associated with your ad saved to another person's board |
outbound_clicks_paid | NUMERIC | Métrica | The total number of clicks to the destination URL associated with your ad |
paid_saves | NUMERIC | Métrica | Total number of saves for ad. |
pin_promotion_id | TEXT | Dimensão | Your ad ID. |
pin_promotion_name | TEXT | Dimensão | Your ad name. |
pin_promotion_status | TEXT | Dimensão | Ad status ('ACTIVE', 'OTHER', 'PAUSED') |
reach | NUMERIC | Métrica | Total number of unique users who saw your ads |
roas | PERCENT | Métrica | The average ROAS from web conversions from your promoted Pins, including both first-order and downstream, in account currency |
roas_checkout | PERCENT | Métrica | Average return on ad spend for checkout events. This metric may include conversions that are modeled. |
source | TEXT | Dimensão | The name of the Windsor connector returning the row |
spend | NUMERIC | Métrica | Total amount you've spent during the reporting time period. Represents the spend amount depending on the level of detail of the report. If requested fields are at the campaign level, the spend is the sum of the spend for all ads in the campaign. If requested fields are at the ad group level, the spend is the sum of the spend for all ads in the ad group. If requested fields are at the pin promotion level, the spend is the spend for the pin promotion. |
today | DATE | Dimensão | Today's date |
total_add_to_cart | NUMERIC | Métrica | Total number of add to cart events resulting from interactions with your ad |
total_add_to_cart_value | NUMERIC | Métrica | Total value of add to cart events resulting from interactions with your ad, in account currency |
total_checkout | NUMERIC | Métrica | Total number of checkout events resulting from interactions with your ad |
total_checkout_value | NUMERIC | Métrica | Total value of checkout events resulting from interactions with your ad, in account currency |
total_click_add_to_cart | NUMERIC | Métrica | The number of add to cart events resulting from clicks on your ad |
total_click_add_to_cart_value | NUMERIC | Métrica | Total value of add to cart events resulting from clicks on your ad, in account currency |
total_click_checkout | NUMERIC | Métrica | The number of checkout events resulting from clicks on your ad |
total_click_checkout_value | NUMERIC | Métrica | Total value of checkout events resulting from clicks on your ad, in account currency |
total_click_checkout_value_micros | NUMERIC | Métrica | Total value of checkout events resulting from clicks on your ad, in micros of account currency |
total_click_contact | NUMERIC | Métrica | The number of contact events resulting from clicks on your ad |
total_click_contact_value | NUMERIC | Métrica | Total value of contact events resulting from clicks on your ad, in account currency |
total_click_custom | NUMERIC | Métrica | The number of custom events resulting from clicks on your ad |
total_click_custom_value | NUMERIC | Métrica | Total value of custom events resulting from clicks on your ad, in account currency |
total_click_lead | NUMERIC | Métrica | The number of lead events resulting from clicks on your ad |
total_click_lead_value | NUMERIC | Métrica | Total value of lead events resulting from clicks on your ad, in account currency |
total_click_page_visit | NUMERIC | Métrica | The number of page visit events resulting from clicks on your ad |
total_click_page_visit_value | NUMERIC | Métrica | Total value of page visit events resulting from clicks on your ad, in account currency |
total_click_search | NUMERIC | Métrica | The number of website search events resulting from clicks on your ad |
total_click_search_value | NUMERIC | Métrica | Total value of website search events resulting from clicks on your ad, in account currency |
total_click_signup | NUMERIC | Métrica | The number of signup events resulting from clicks on your ad |
total_click_signup_value | NUMERIC | Métrica | Total value of signup events resulting from clicks on your ad, in account currency |
total_click_view_category | NUMERIC | Métrica | The number of category view events resulting from clicks on your ad |
total_click_view_category_value | NUMERIC | Métrica | Total value of category view events resulting from clicks on your ad, in account currency |
total_click_watch_video | NUMERIC | Métrica | The number of watch video events resulting from clicks on your ad |
total_click_watch_video_value | NUMERIC | Métrica | Total value of watch video events resulting from clicks on your ad, in account currency |
total_contact | NUMERIC | Métrica | Total number of contact events resulting from interactions with your ad |
total_contact_value | NUMERIC | Métrica | Total value of contact events resulting from interactions with your ad, in account currency |
total_conversions | NUMERIC | Métrica | Total number of conversions for all event types using the Pinterest Tag integration after an ad interaction |
total_conversions_value | NUMERIC | Métrica | The value from web conversions from your promoted Pins, including both first-order and downstream, in account currency |
total_custom | NUMERIC | Métrica | Total number of custom events resulting from interactions with your ad |
total_custom_value | NUMERIC | Métrica | Total value of custom events resulting from interactions with your ad, in account currency |
total_engagement | NUMERIC | Métrica | The total number of engagements on your ads, including clicks, saves, carousel swipes, and collections secondary saves |
total_engagement_add_to_cart | NUMERIC | Métrica | Total number of add to cart events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_add_to_cart_value | NUMERIC | Métrica | Total value of add to cart events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_checkout | NUMERIC | Métrica | Total number of checkout events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_checkout_value | NUMERIC | Métrica | Total value of checkout events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_contact | NUMERIC | Métrica | Total number of contact events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_contact_value | NUMERIC | Métrica | Total value of contact events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_custom | NUMERIC | Métrica | Total number of custom events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_custom_value | NUMERIC | Métrica | Total value of custom events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_lead | NUMERIC | Métrica | Total number of lead events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_lead_value | NUMERIC | Métrica | Total value of lead events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_page_visit | NUMERIC | Métrica | Total number of page visit events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_page_visit_value | NUMERIC | Métrica | Total value of page visit events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_search | NUMERIC | Métrica | Total number of website search events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_search_value | NUMERIC | Métrica | Total value of website search events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_signup | NUMERIC | Métrica | Total number of signup events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_signup_value | NUMERIC | Métrica | Total value of signup events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_view_category | NUMERIC | Métrica | Total number of category view events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_view_category_value | NUMERIC | Métrica | Total value of category view events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_watch_video | NUMERIC | Métrica | Total number of watch video events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_engagement_watch_video_value | NUMERIC | Métrica | Total value of watch video events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. |
total_lead | NUMERIC | Métrica | Total number of lead events resulting from interactions with your ad |
total_lead_value | NUMERIC | Métrica | Total value of lead events resulting from interactions with your ad, in account currency |
total_page_visit | NUMERIC | Métrica | Total number of page visit events resulting from interactions with your ad |
total_page_visit_value | NUMERIC | Métrica | Total value of page visit events resulting from interactions with your ad, in account currency |
total_saves | NUMERIC | Métrica | The number of Repins from earned and paid sources. |
total_search | NUMERIC | Métrica | Total number of website search events resulting from interactions with your ad |
total_search_value | NUMERIC | Métrica | Total value of website search events resulting from interactions with your ad, in account currency |
total_signup | NUMERIC | Métrica | Total number of signup events resulting from interactions with your ad |
total_signup_value | NUMERIC | Métrica | Total value of signup events resulting from interactions with your ad, in account currency |
total_video_75_combined | NUMERIC | Métrica | Total number of times your video ad played 75% of its length, including views that skipped ahead to this point (paid and earned) |
total_video_p0_combined | NUMERIC | Métrica | Total number of times your video ad started playing (paid and earned) |
total_video_p100_complete | NUMERIC | Métrica | Total number of times your video ad played 100% of its length, including views that skipped ahead to this point (paid and earned) |
total_video_p25_combined | NUMERIC | Métrica | Total number of times your video ad played 25% of its length, including views that skipped ahead to this point (paid and earned) |
total_video_p50_combined | NUMERIC | Métrica | Total number of times your video ad played 50% of its length, including views that skipped ahead to this point (paid and earned) |
total_video_p95_combined | NUMERIC | Métrica | Total number of times your video ad played 95% of its length, including views that skipped ahead to this point (paid and earned) |
total_video_views | NUMERIC | Métrica | Total video views. |
total_view_add_to_cart | NUMERIC | Métrica | Total number of add to cart events resulting from views of your ad |
total_view_add_to_cart_value | NUMERIC | Métrica | Total value of add to cart events resulting from views of your ad, in account currency |
total_view_category | NUMERIC | Métrica | Total number of category view events resulting from interactions with your ad |
total_view_category_value | NUMERIC | Métrica | Total value of category view events resulting from interactions with your ad, in account currency |
total_view_checkout | NUMERIC | Métrica | Total number of checkout events resulting from views of your ad |
total_view_checkout_value | NUMERIC | Métrica | Total value of checkout events resulting from views of your ad, in account currency |
total_view_checkout_value_micros | NUMERIC | Métrica | Total value of checkout events resulting from views of your ad, in micros of account currency |
total_view_contact | NUMERIC | Métrica | Total number of contact events resulting from views of your ad |
total_view_contact_value | NUMERIC | Métrica | Total value of contact events resulting from views of your ad, in account currency |
total_view_custom | NUMERIC | Métrica | Total number of custom events resulting from views of your ad |
total_view_custom_value | NUMERIC | Métrica | Total value of custom events resulting from views of your ad, in account currency |
total_view_lead | NUMERIC | Métrica | Total number of lead events resulting from views of your ad |
total_view_lead_value | NUMERIC | Métrica | Total value of lead events resulting from views of your ad, in account currency |
total_view_page_visit | NUMERIC | Métrica | Total number of page visit events resulting from views of your ad |
total_view_page_visit_value | NUMERIC | Métrica | Total value of page visit events resulting from views of your ad, in account currency |
total_view_search | NUMERIC | Métrica | Total number of website search events resulting from views of your ad |
total_view_search_value | NUMERIC | Métrica | Total value of website search events resulting from views of your ad, in account currency |
total_view_signup | NUMERIC | Métrica | Total number of signup events resulting from views of your ad |
total_view_signup_value | NUMERIC | Métrica | Total value of signup events resulting from views of your ad, in account currency |
total_view_view_category | NUMERIC | Métrica | Total number of category view events resulting from views of your ad |
total_view_view_category_value | NUMERIC | Métrica | Total value of category view events resulting from views of your ad, in account currency |
total_view_watch_video | NUMERIC | Métrica | Total number of watch video events resulting from views of your ad |
total_view_watch_video_value | NUMERIC | Métrica | Total value of watch video events resulting from views of your ad, in account currency |
total_watch_video | NUMERIC | Métrica | Total number of watch video events resulting from interactions with your ad |
total_watch_video_value | NUMERIC | Métrica | Total value of watch video events resulting from interactions with your ad, in account currency |
totalcost | NUMERIC | Métrica | Total amount you've spent during the reporting time period. Represents the spend amount depending on the level of detail of the report. If requested fields are at the campaign level, the spend is the sum of the spend for all ads in the campaign. If requested fields are at the ad group level, the spend is the sum of the spend for all ads in the ad group. If requested fields are at the pin promotion level, the spend is the spend for the pin promotion. |
transactionrevenue | NUMERIC | Métrica | The value from web conversions from your promoted Pins, including both first-order and downstream, in account currency |
transactions | NUMERIC | Métrica | Total number of conversions for all event types using the Pinterest Tag integration after an ad interaction |
video_p0_combined_earned | NUMERIC | Métrica | Total number of times your video ad started playing after it was saved to another person's board |
video_p0_combined_paid | NUMERIC | Métrica | Number of times your video ad started playing |
video_p100_complete_earned | NUMERIC | Métrica | Total number of times your video ad reached 100% of its length after it was saved to another person's board, including views that skipped ahead to this point |
video_p100_complete_paid | NUMERIC | Métrica | Number of times your video ad reached 100% of its length, including views that skipped ahead to this point |
video_p25_combined_earned | NUMERIC | Métrica | Total number of times your video ad reached 25% of its length after it was saved to another person's board, including views that skipped ahead to this point |
video_p25_combined_paid | NUMERIC | Métrica | Number of times your video ad reached 25% of its length, including views that skipped ahead to this point |
video_p50_combined_earned | NUMERIC | Métrica | Total number of times your video ad reached 50% of its length after it was saved to another person's board, including views that skipped ahead to this point |
video_p50_combined_paid | NUMERIC | Métrica | Number of times your video ad reached 50% of its length, including views that skipped ahead to this point |
video_p75_combined_earned | NUMERIC | Métrica | Total number of times your video ad reached 75% of its length after it was saved to another person's board, including views that skipped ahead to this point |
video_p75_combined_paid | NUMERIC | Métrica | Number of times your video ad reached 75% of its length, including views that skipped ahead to this point |
video_p95_combined_earned | NUMERIC | Métrica | Total number of times your video ad reached 95% of its length after it was saved to another person's board, including views that skipped ahead to this point |
video_p95_combined_paid | NUMERIC | Métrica | Number of times your video ad reached 95% of its length, including views that skipped ahead to this point |
week | TEXT | Dimensão | Week (Sun-Sat). |
week_day | TEXT | Dimensão | Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday. |
week_day_iso | TEXT | Dimensão | Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7 |
week_iso | TEXT | Dimensão | Week, ISO format (Mon-Sun). |
year | TEXT | Dimensão | Year |
year_month | TEXT | Dimensão | Year and month, e.g. 2024|3 |
year_month_name | TEXT | Dimensão | Year and month with the month name written out, e.g. "Jan 2025". |
year_of_week | TEXT | Dimensão | The year that contains first day of the week (Sun-Sat). |
year_of_week_iso | TEXT | Dimensão | The year that contains first day of the ISO week (Mon-Sun). |
year_week | TEXT | Dimensão | Year and week for US weeks (Sun-Sat), e.g. 2024|15 |
year_week_iso | TEXT | Dimensão | Year and week for ISO weeks (Mon-Sun), e.g. 2024|20 |