Snapchat Ads
Redes sociais · DisponívelConsultar via API
GET https://askaner.askan.com.br/api/v1/data/snapchat?fields=date,account_id&date_preset=last_30d Authorization: Bearer ik_...
Campos (72 métricas, 50 dimensões)
| ID | Tipo | Natureza | Descrição |
|---|---|---|---|
age | TEXT | Dimensão | Age buckets (Report dimension) |
country | COUNTRY | Dimensão | Country (Report dimension) |
dma | TEXT | Dimensão | DMA (Report dimension) |
gender | TEXT | Dimensão | Gender (Report dimension) |
lifestyle_category | TEXT | Dimensão | Snapchat Lifestyle Category (Report dimension) |
make | TEXT | Dimensão | Device Make (Report dimension) |
os | TEXT | Dimensão | Operating System (Report dimension) |
region | REGION | Dimensão | Region (Report dimension) |
account_id | TEXT | Dimensão | Snapchat Ads advertiser ID. |
account_name | TEXT | Dimensão | Snapchat Ads advertiser name. |
ad_id | TEXT | Dimensão | Ad ID |
ad_name | TEXT | Dimensão | Ad name |
ad_squad_daily_budget | NUMERIC | Métrica | Ad squad daily budget |
ad_squad_delivery_status | TEXT | Dimensão | Operational delivery status of the ad squad (e.g. ACTIVE, PAUSED, INVALID_END_TIME); comma-joined when the API returns multiple. |
ad_squad_end_date | DATE | Dimensão | Ad squad end time (ISO 8601 datetime); empty for open-ended ad squads |
ad_squad_id | TEXT | Dimensão | Ad squad ID |
ad_squad_lifetime_budget | NUMERIC | Métrica | Ad squad lifetime budget |
ad_squad_name | TEXT | Dimensão | Ad squad name |
ad_squad_optimization_goal | TEXT | Dimensão | Ad squad optimization goal |
ad_squad_start_date | DATE | Dimensão | Ad squad start time (ISO 8601 datetime) |
ad_squad_status | TEXT | Dimensão | Ad squad status |
ad_squad_type | TEXT | Dimensão | Ad squad type |
adnetwork_conversions | NUMERIC | Métrica | Ad network reported conversions (alias for Purchases) |
adnetwork_revenue | NUMERIC | Métrica | Ad network reported revenue (alias for Purchase Value) |
android_installs | NUMERIC | Métrica | Number of app installs on the Android platform |
campaign | TEXT | Dimensão | Campaign name |
campaign_delivery_status | TEXT | Dimensão | Operational delivery status of the campaign (e.g. ACTIVE, PAUSED, INVALID_END_TIME); comma-joined when the API returns multiple. |
campaign_end_date | DATE | Dimensão | Campaign end time (ISO 8601 datetime); empty for open-ended campaigns |
campaign_id | TEXT | Dimensão | Campaign ID |
campaign_start_date | DATE | Dimensão | Campaign start time (ISO 8601 datetime) |
campaign_status | TEXT | Dimensão | Campaign status |
clicks | NUMERIC | Métrica | Number of ad clicks (alias for Ad Click) |
conversion_achievement_unlocked | NUMERIC | Métrica | Number of attributed "ACHIEVEMENT_UNLOCKED" conversion events |
conversion_ad_click | NUMERIC | Métrica | Number of attributed "AD_CLICK" conversion events |
conversion_ad_view | NUMERIC | Métrica | Number of attributed "AD_VIEW" conversion events |
conversion_add_billing | NUMERIC | Métrica | Number of attributed "ADD_BILLING" conversion events |
conversion_add_cart | NUMERIC | Métrica | Number of attributed "ADD_CART" conversion events |
conversion_add_cart_value | NUMERIC | Métrica | Value of attributed "ADD_CART" conversion events (in Ad Account’s currency). |
conversion_add_to_wishlist | NUMERIC | Métrica | Number of attributed "ADD_TO_WISHLIST" conversion events |
conversion_app_opens | NUMERIC | Métrica | Number of attributed "APP_OPEN" conversion events |
conversion_complete_tutorial | NUMERIC | Métrica | Number of attributed "COMPLETE_TUTORIAL" conversion events |
conversion_invite | NUMERIC | Métrica | Number of attributed "INVITE" conversion events |
conversion_level_completes | NUMERIC | Métrica | Number of attributed "LEVEL_COMPLETE" conversion events |
conversion_list_view | NUMERIC | Métrica | Number of attributed "LIST_VIEW" conversion events |
conversion_login | NUMERIC | Métrica | Number of attributed "LOGIN" conversion events |
conversion_page_views | NUMERIC | Métrica | Number of attributed "PAGE_VIEW" conversion events |
conversion_purchases | NUMERIC | Métrica | Number of attributed "PURCHASE" conversion events |
conversion_purchases_value | NUMERIC | Métrica | Value of attributed "PURCHASE" conversion events (in Ad Account’s currency) |
conversion_purchases_value_web | NUMERIC | Métrica | Value of web-attributed "PURCHASE" conversion events (in Ad Account’s currency). |
conversion_purchases_web | NUMERIC | Métrica | Number of web-attributed "PURCHASE" conversion events. |
conversion_rate | PERCENT | Métrica | Number of attributed "RATE" conversion events |
conversion_reserve | NUMERIC | Métrica | Number of attributed "RESERVE" conversion events |
conversion_save | NUMERIC | Métrica | Number of attributed "SAVE" conversion events |
conversion_searches | NUMERIC | Métrica | Number of attributed "SEARCH" conversion events |
conversion_share | NUMERIC | Métrica | Number of attributed "SHARE" conversion events |
conversion_sign_ups | NUMERIC | Métrica | Number of attributed "SIGN_UP" conversion events |
conversion_sign_ups_value | NUMERIC | Métrica | Value of attributed "SIGN_UP" conversion events (in Ad Account’s currency). |
conversion_spend_credits | NUMERIC | Métrica | Number of attributed "SPENT_CREDITS" conversion events |
conversion_start_checkout | NUMERIC | Métrica | Number of attributed "START_CHECKOUT" conversion events |
conversion_start_checkout_value | NUMERIC | Métrica | Value of attributed "START_CHECKOUT" conversion events (in Ad Account’s currency). |
conversion_start_trial | NUMERIC | Métrica | Number of attributed "START_TRIAL" conversion events |
conversion_subscribe | NUMERIC | Métrica | Number of attributed "SUBSCRIBE" conversion events |
conversion_subscribe_value | NUMERIC | Métrica | Value of attributed "SUBSCRIBE" conversion events (in Ad Account’s currency). |
conversion_view_content | NUMERIC | Métrica | Number of attributed "VIEW_CONTENT" conversion events |
conversion_view_content_value | NUMERIC | Métrica | Value of attributed "VIEW_CONTENT" conversion events (in Ad Account’s currency). |
conversion_visit | NUMERIC | Métrica | Number of attributed "VISIT" conversion events |
cpc | NUMERIC | Métrica | The spend per click. |
cpm | NUMERIC | Métrica | Cost per thousand impressions |
creative_id | TEXT | Dimensão | ID of the creative attached to the ad; use it to build a creative preview link. |
creative_media_url | TEXT | Dimensão | Top-snap creative asset download URL; an image for image creatives and the video file for video creatives. |
ctr | PERCENT | Métrica | Click-through rate |
currency | TEXT | Dimensão | Ad Account currency |
custom_event_1 | NUMERIC | Métrica | Number of attributed "CUSTOM_EVENT_1" conversion events |
custom_event_2 | NUMERIC | Métrica | Number of attributed "CUSTOM_EVENT_2" conversion events |
custom_event_3 | NUMERIC | Métrica | Number of attributed "CUSTOM_EVENT_3" conversion events |
custom_event_4 | NUMERIC | Métrica | Number of attributed "CUSTOM_EVENT_4" conversion events |
custom_event_5 | NUMERIC | Métrica | Number of attributed "CUSTOM_EVENT_5" conversion events |
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_impressions | NUMERIC | Métrica | The number of times your ad was viewed after being shared by a Snapchatter via Chat or Stories |
frequency | NUMERIC | Métrica | The Average number of Impressions per User Reached. |
impressions | NUMERIC | Métrica | Number of impressions |
ios_installs | NUMERIC | Métrica | Number of app installs on the iOS platform |
landing_page_views | NUMERIC | Métrica | Total number of times a user loaded the ad's landing page after a click. |
month | TEXT | Dimensão | Number of the month |
native_leads | NUMERIC | Métrica | Total number of Snapchat users that swipe up, fill out the required fields, and hit ‘Submit’ on Lead Form attachments. If a user swipes down or cancels before hitting 'Submit,' this action is not counted |
now | TIMESTAMP | Dimensão | Current timestamp |
objective | TEXT | Dimensão | The Objective of the campaign |
paid_impressions | NUMERIC | Métrica | The total number of times your ad was served to a Snapchatter. Tracked when the ad fully renders on a device for the first time during a Snapchatter’s viewing session. |
quartile_1 | NUMERIC | Métrica | Video views to 25% |
quartile_2 | NUMERIC | Métrica | Video views to 50% |
quartile_3 | NUMERIC | Métrica | Video views to 75% |
screen_time_millis | NUMERIC | Métrica | Total time spent on top Snap ad (milliseconds) |
source | TEXT | Dimensão | The name of the Windsor connector returning the row |
spend | NUMERIC | Métrica | Amount of money spent |
swipe_up_percent | PERCENT | Métrica | The Swipe Up Rate |
swipes | NUMERIC | Métrica | Number of swipes |
thumbnail_url | IMAGE | Dimensão | Thumbnail image URL for the ad's top snap media. For video media this is a signed link that expires after ~24 hours; image media use the image file URL. |
today | DATE | Dimensão | Today's date |
total_impressions | NUMERIC | Métrica | The total number of impressions (Paid and Earned). |
total_installs | NUMERIC | Métrica | Total number of app installs |
total_reach | NUMERIC | Métrica | The number of unique Snapchatters who viewed your Lens ad, either by receiving a Paid or Earned Impression. |
totalcost | NUMERIC | Métrica | Amount of money spent (alias for Spend) |
transactionrevenue | NUMERIC | Métrica | Transaction revenue (alias for Purchase Value) |
transactions | NUMERIC | Métrica | Number of transactions (alias for Purchases) |
uniques | NUMERIC | Métrica | Number of unique impressions. |
video_views | NUMERIC | Métrica | Total number of impressions that meet the qualifying video view criteria of at least 2 seconds of consecutive watch time or a swipe up action on the Top Snap |
video_views_time_based | NUMERIC | Métrica | Total number of impressions that meet the qualifying video view criteria of at least 2 seconds, not including swipe ups |
view_completion | NUMERIC | Métrica | Video views to completion |
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 |