Snapchat: Most-used fields

Snapchat: Most-used fields#

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

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

API name

Adverity UI name

Description

Use in Adverity

2s_views

2s_views

The total number of video views for at least 2 seconds or a swipe-up action on the Top Snap.

metric

Ad Type

Ad Type

The classification of the ad, indicating its format and purpose (e.g., Snap Ad, App Install Ad, Story Ad, Lead Generation Ad).

dimension

Buying Currency

Buying Currency

The currency used for buying advertisements or for billing purposes.

dimension

Campaign

Campaign

The name of the advertising campaign.

dimension

Campaign Type

Campaign Type

The type or objective of the advertising campaign (e.g., app installs, brand awareness).

dimension

Country

country

The country setting configured for the targeted audience in Snapchat ads.

dimension

Created at

created_at

The timestamp when an entity (e.g., campaign, ad, invoice) was created.

dimension

Creative Dimensions

Creative Dimensions

The dimensions (e.g., width x height) of the creative asset.

dimension

Creative Type

Creative Type

The type of creative asset used in an ad (e.g., image, video, AR lens).

dimension

DMA

dma

The Designated Market Area (DMA) where the ad was shown.

dimension

Data Source

Data Source

The origin of the data, which is Snapchat Ads in this context.

dimension

Due date

due_date

The date by which an invoice payment is expected.

dimension

End Date

End Date

The scheduled end date for a campaign or ad squad.

dimension

Gender

gender

The gender of the audience targeted in Snapchat ads.

dimension

Geo

Geo

Geographical location targeting for ads, including options like country, region, metro area, or postal code.

dimension

Last modified at

last_modified

The timestamp when an invoice or other entity was last changed.

dimension

Market

Market

The geographical market or region where an ad campaign is running or being measured.

dimension

Month

Month

The calendar month for which advertising data or metrics are reported.

metric

Month-Year

Month-Year

A combined field representing the month and year for reporting advertising data.

dimension

Placement

Placement

The location within the Snapchat platform where an ad is displayed, such as Discover Feed, User Stories, or Spotlight.

dimension

Platform

Platform

The advertising platform where the campaign is running, which is Snapchat.

dimension

Region

region

The geographical region where the ad was shown.

dimension

Site

Site

The specific website or platform related to an ad campaign or conversion event.

dimension

Start Date

Start Date

The scheduled start date for a campaign or ad squad.

dimension

Updated at

updated_at

The timestamp when an entity (e.g., campaign, ad, invoice) was last updated.

dimension

Video Length

Video Length

The duration of a video creative in an ad.

dimension

WeekAsDate

WeekAsDate

The start date of the week for which advertising data or metrics are reported.

dimension

WeekNum

WeekNum

The numerical identifier of the week within a year for reporting advertising data.

metric

Year

Year

The calendar year for which advertising data or metrics are reported.

metric

actual_device

actual_device

The specific device model (e.g., iPhone 13, Samsung Galaxy S22) on which the ad was displayed.

dimension

ad_account_id

ad_account_id

The unique identifier for the advertising account.

dimension

ad_account_name

ad_account_name

The name of the advertising account.

dimension

ad_format_{NUM}

ad_format_{NUM}

The format of the ad, such as Single Image or Video Ads, Story Ads, Collection Ads, Commercials, or AR Ads.

dimension

ad_language_{NUM}

ad_language_{NUM}

The language(s) targeted for the ad.

dimension

ad_product

creative_ad_product

The specific ad product used for the creative (e.g., Story Ad, Collection Ad).

dimension

ad_set_id

ad_set_id

Unique identifier for the ad set (also known as ad squad).

dimension

ad_squad_placement

ad_squad_placement

The placement where the ad squad’s ads are displayed (e.g., Content, Story).

dimension

ad_squad_placement_v2_config

ad_squad_placement_v2_config

Configuration settings for the ad squad’s placements using the V2 placement system.

dimension

ad_squad_placement_v2_inclusion

ad_squad_placement_v2_inclusion

Inclusion rules for ad squad placements using the V2 placement system.

dimension

ad_squad_placement_v2_platforms

ad_squad_placement_v2_platforms

The platforms where the ad squad’s ads are allowed to be placed (e.g., Snapchat) using the V2 placement system.

dimension

ad_squad_placement_v2_snapchat_positions

ad_squad_placement_v2_snapchat_positions

Specific positions within Snapchat where the ad squad’s ads are allowed to be placed (e.g., CHAT_FEED) using the V2 placement system.

dimension

ad_squad_targeting_demographics_gender

ad_squad_targeting_demographics_gender

Gender demographic targeting applied at the ad squad level.

dimension

ad_squad_targeting_demographics_languages

ad_squad_targeting_demographics_languages

The demographic (e.g., age, gender) and language targeting settings for the ad squad.

dimension

ad_squad_targeting_demographics_max_age

ad_squad_targeting_demographics_max_age

Maximum age for demographic targeting applied at the ad squad level.

dimension

ad_squad_targeting_demographics_min_age

ad_squad_targeting_demographics_min_age

Minimum age for demographic targeting applied at the ad squad level.

dimension

ad_squad_targeting_geos_country_code

ad_squad_targeting_geos_country_code

The country code used for geographical targeting within an ad squad.

dimension

ad_squad_targeting_geos_excluded

ad_squad_targeting_geos_excluded

Geographic locations explicitly excluded from the ad squad’s targeting.

dimension

ad_squad_targeting_geos_included

ad_squad_targeting_geos_included

Geographic locations included in the targeting for the ad squad.

dimension

ad_squad_targeting_interests_category_id

ad_squad_targeting_interests_category_id

Category ID for interest-based targeting applied at the ad squad level.

dimension

ad_squad_targeting_locations

ad_squad_targeting_locations

Specific geographic locations targeted by the ad squad.

dimension

ad_squad_targeting_regulated_content

ad_squad_targeting_regulated_content

Flag indicating if the ad squad’s content is regulated (e.g., alcohol), requiring specific targeting considerations.

dimension

ad_squad_targeting_segments_excluded

ad_squad_targeting_segments_excluded

Customer list segments or other audience segments explicitly excluded from the ad squad’s targeting.

dimension

ad_squad_targeting_segments_included

ad_squad_targeting_segments_included

Audience segments included in the targeting for the ad squad.

dimension

ad_to_lens_properties

ad_to_lens_properties

Properties specific to an “Ad to Lens” creative type, used when promoting an AR Lens.

dimension

adset_age

adset_age

The age range targeted by the ad set (ad squad).

dimension

adset_bidtype

adset_bidtype

The bidding strategy or type configured for the ad set.

dimension

adset_category_{NUM}

adset_category_{NUM}

Categories used for ad set (Ad Squad) targeting, potentially related to Snap Lifestyle Categories (SLC) which group audiences by interests and behaviors.

dimension

adset_country

adset_country

The country targeted by the ad set (also known as ad squad).

dimension

adset_device_{NUM}

adset_device_{NUM}

Device targeting criteria for the ad set (Ad Squad), such as operating system type, version, or device make.

dimension

adset_gender

adset_gender

The gender targeted by the ad set (ad squad).

dimension

adset_language

adset_language

The language targeted for the ad set (Ad Squad).

dimension

adset_language_{NUM}

adset_language_{NUM}

A list of languages targeted for the ad set (Ad Squad).

dimension

adset_market_{NUM}

adset_market_{NUM}

Market segments or geographical regions targeted for the ad set (Ad Squad).

dimension

adset_placement_{NUM}

adset_placement_{NUM}

The specific locations within the Snapchat platform where ads in the ad set (Ad Squad) can be displayed, such as Public Stories, Discover Feed, or Spotlight.

dimension

adset_platform

adset_platform

The advertising platform where the ad set is running (e.g., Snapchat).

dimension

adset_targeting

adset_targeting

Detailed targeting criteria defined for the ad set.

dimension

adset_targeting_{NUM}

adset_targeting_{NUM}

Detailed targeting specifications applied to the ad set (Ad Squad), encompassing demographics, locations, interests, devices, and custom audiences.

dimension

advertiser

ad_account_advertiser

The advertiser associated with the ad account.

dimension

advertiser_id

advertiser_id

The unique identifier for the advertiser.

dimension

advertiser_organization_id

advertiser_organization_id

Unique identifier for the organization of the advertiser.

dimension

age_bucket

age_bucket

The age range or bucket of the audience targeted in Snapchat ads.

dimension

agency

agency

The advertising agency associated with the campaign or ad account.

dimension

agency_representing_client

agency_representing_client

The name of the advertising agency managing the client’s ad accounts.

dimension

android_installs

android_installs

The total number of app installs on Android devices attributed to the ad.

metric

android_installs_app

android_installs_app

The number of app installs attributed to an ad on Android devices (click-through or swipe-up attribution).

metric

android_installs_app_swipe_up

android_installs_app_swipe_up

The number of app installs attributed to a swipe-up action on an ad on Android devices.

metric

android_installs_app_view

android_installs_app_view

The number of Android app installs attributed to an in-app view of an ad.

metric

android_installs_offline

android_installs_offline

The number of offline installs attributed to an ad on Android devices (click-through or swipe-up attribution).

metric

android_installs_offline_swipe_up

android_installs_offline_swipe_up

The number of offline installs attributed to a swipe-up action on an ad on Android devices.

metric

android_installs_offline_view

android_installs_offline_view

The number of Android app installs attributed to an offline view of an ad.

metric

android_installs_swipe_up

android_installs_swipe_up

The number of app installs on Android devices attributed to users swiping up on the ad.

dimension

android_installs_view

android_installs_view

The number of app installs on Android devices attributed to users who viewed the ad (view-through conversions).

metric

android_installs_web

android_installs_web

The number of web-based installs attributed to an ad on Android devices (click-through or swipe-up attribution).

metric

android_installs_web_swipe_up

android_installs_web_swipe_up

The number of web-based installs attributed to a swipe-up action on an ad on Android devices.

metric

android_installs_web_view

android_installs_web_view

The number of Android app installs attributed to a web view of an ad.

metric

attachment_avg_view_time_millis

attachment_avg_view_time_millis

The average time, in milliseconds, that users viewed the attachment within the ad.

dimension

attachment_frequency

attachment_frequency

The average number of times a unique user viewed the ad’s attachment.

dimension

attachment_impressions

attachment_impressions

The total number of times the ad’s attachment was displayed.

dimension

attachment_quartile_{NUM}

attachment_quartile_{NUM}

Video quartile data (e.g., 25%, 50%, 75%, 100%) for the ad’s attachment.

metric

attachment_total_view_time_millis

attachment_total_view_time_millis

The total time, in milliseconds, that users viewed the ad’s attachment.

metric

attachment_uniques

attachment_uniques

The number of unique users who viewed the ad’s attachment.

dimension

attachment_video_views

attachment_video_views

The number of video views for the ad’s attachment.

metric

attachment_view_completion

attachment_view_completion

The percentage of users who completed viewing the ad’s attachment.

metric

audience_source

audience_source

The origin of the audience data used for targeting, such as customer lists, website events, mobile app events, or ad engagement.

dimension

auto_bid

auto_bid

Indicates whether the ad set uses an automatic bidding strategy.

dimension

avg_screen_time_millis

avg_screen_time_millis

The average time, in milliseconds, that users spent on screen interacting with the ad.

dimension

avg_view_time_millis

avg_view_time_millis

The average time, in milliseconds, that users viewed the ad creative.

dimension

bid_micro

ad_squad_bid

The bid amount for the ad squad, expressed in micro-currency units (1 local currency unit = 1,000,000 micro-currency).

metric

bid_strategy

ad_squad_bid_strategy

The strategy used for bidding on ad placements for the ad squad (e.g., goal-based bidding).

dimension

bid_type_{NUM}

bid_type_{NUM}

The strategy used for bidding in an ad campaign, including options like Auto-Bidding, Target Cost, or Max Bid.

dimension

billing_center_id

billing_center_id

The unique identifier for a billing center, which is the contact responsible for receiving invoices for advertising expenditures.

dimension

billing_event

ad_squad_billing_event

The specific event or action for which an ad squad is billed, such as impressions or conversions.

dimension

billing_type

billing_type

The method of billing used for the advertising account (e.g., credit card, invoice).

dimension

brand

brand

The brand name associated with the ad campaign.

dimension

budget

budget

The allocated financial amount for an advertising campaign or ad squad.

metric

buy_type

buy_type

The purchasing model for an ad campaign (e.g., Auction, Reach & Frequency).

dimension

call_to_action

creative_call_to_action

The button or prompt within a creative that encourages users to take a specific action, such as ‘Shop Now’ or ‘Install App’.

dimension

campaign_calendar_year

campaign_calendar_year

The calendar year in which the campaign is running.

metric

campaign_device_{NUM}

campaign_device_{NUM}

Device targeting criteria set at the campaign level, specifying characteristics like operating system or device model.

dimension

campaign_end_datetime

campaign_end_datetime

The scheduled end date and time for an advertising campaign.

dimension

campaign_end_time

campaign_end_time

The scheduled end timestamp for an advertising campaign.

dimension

campaign_id

campaign_id

The unique identifier for an advertising campaign.

dimension

campaign_id_{NUM}

campaign_id_{NUM}

The unique identifier for an advertising campaign.

dimension

campaign_invoice_number

campaign_invoice_number

metric

campaign_name

campaign_name

The name of the advertising campaign.

dimension

campaign_objective

campaign_objective

The primary goal or objective of the advertising campaign (e.g., app installs, brand awareness).

dimension

campaign_objective_{NUM}

campaign_objective_{NUM}

The primary goal or objective of an advertising campaign, such as brand awareness or app installs.

dimension

campaign_start_datetime

campaign_start_datetime

The scheduled start date and time for an advertising campaign.

dimension

campaign_start_time

campaign_start_time

The scheduled start timestamp for an advertising campaign.

dimension

campaign_status

campaign_status

The current operational status of an advertising campaign (e.g., ACTIVE, PAUSED, COMPLETED).

dimension

campaign_targeting_{NUM}

campaign_targeting_{NUM}

Detailed targeting specifications applied to the campaign, such as demographics, locations, interests, or custom audiences.

dimension

campaign_type

campaign_type

The overall type or objective of the advertising campaign.

dimension

campaign_type_{NUM}

campaign_type_{NUM}

The type or objective of an advertising campaign, defining its primary business goal (e.g., Brand Awareness, App Install, Lead Generation, Sales).

dimension

catalog_properties

catalog_properties

Properties related to product catalogs used for Dynamic Product Ads, enabling automated ad creation based on product feeds.

dimension

clicks

clicks

The total number of clicks on an advertisement.

metric

composite_properties

composite_properties

Properties related to composite creative types (e.g., Story Ads), typically containing a list of creative IDs that form the composite ad.

dimension

content_source_type

content_source_type

The type or origin of the content used in an ad creative.

dimension

conversion_achievement_unlocked

conversion_achievement_unlocked

Total achievement unlocks attributed to ad engagement.

metric

conversion_achievement_unlocked_app

conversion_achievement_unlocked_app

Total achievement unlocks occurring in an app attributed to ad engagement.

metric

conversion_achievement_unlocked_app_swipe_up

conversion_achievement_unlocked_app_swipe_up

Total achievement unlocks occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_achievement_unlocked_app_view

conversion_achievement_unlocked_app_view

Total achievement unlocks occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_achievement_unlocked_offline

conversion_achievement_unlocked_offline

Total achievement unlocks occurring offline attributed to ad engagement.

metric

conversion_achievement_unlocked_offline_swipe_up

conversion_achievement_unlocked_offline_swipe_up

Total achievement unlocks occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_achievement_unlocked_offline_view

conversion_achievement_unlocked_offline_view

Total achievement unlocks occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_achievement_unlocked_swipe_up

conversion_achievement_unlocked_swipe_up

Total achievement unlocks attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_achievement_unlocked_view

conversion_achievement_unlocked_view

Total achievement unlocks attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_achievement_unlocked_web

conversion_achievement_unlocked_web

Total achievement unlocks occurring on the web attributed to ad engagement.

metric

conversion_achievement_unlocked_web_swipe_up

conversion_achievement_unlocked_web_swipe_up

Total achievement unlocks occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_achievement_unlocked_web_view

conversion_achievement_unlocked_web_view

Total achievement unlocks occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_ad_click

conversion_ad_click

The total number of conversions attributed to ad clicks.

metric

conversion_ad_click_app

conversion_ad_click_app

Total ad clicks occurring in an app.

metric

conversion_ad_click_app_swipe_up

conversion_ad_click_app_swipe_up

Total ad clicks occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_ad_click_app_view

conversion_ad_click_app_view

Total ad clicks occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_ad_click_offline

conversion_ad_click_offline

Total ad clicks occurring offline.

metric

conversion_ad_click_offline_swipe_up

conversion_ad_click_offline_swipe_up

Total ad clicks occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_ad_click_offline_view

conversion_ad_click_offline_view

Total ad clicks occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_ad_click_sk_ad_network

conversion_ad_click_sk_ad_network

The count of ad click conversions attributed via SKAdNetwork.

metric

conversion_ad_click_sk_ad_network_total

conversion_ad_click_sk_ad_network_total

The total count of ad click conversions reported via SKAdNetwork, encompassing both view-through and click-through attributions.

metric

conversion_ad_click_sk_ad_network_view

conversion_ad_click_sk_ad_network_view

The count of ad click conversions attributed via SKAdNetwork specifically for view-through attributions.

metric

conversion_ad_click_swipe_up

conversion_ad_click_swipe_up

The number of conversions attributed to ad clicks resulting from a swipe-up action.

metric

conversion_ad_click_view

conversion_ad_click_view

The number of conversions attributed to ad clicks from users who previously viewed the ad.

metric

conversion_ad_click_web

conversion_ad_click_web

Total ad clicks occurring on the web.

metric

conversion_ad_click_web_swipe_up

conversion_ad_click_web_swipe_up

Total ad clicks occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_ad_click_web_view

conversion_ad_click_web_view

Total ad clicks occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_ad_view

conversion_ad_view

The total number of conversions attributed to ad views (view-through conversions).

metric

conversion_ad_view_app

conversion_ad_view_app

Total ad views occurring in an app.

metric

conversion_ad_view_app_swipe_up

conversion_ad_view_app_swipe_up

Total ad views occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_ad_view_app_view

conversion_ad_view_app_view

Total ad views occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_ad_view_offline

conversion_ad_view_offline

Total ad views occurring offline.

metric

conversion_ad_view_offline_swipe_up

conversion_ad_view_offline_swipe_up

Total ad views occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_ad_view_offline_view

conversion_ad_view_offline_view

Total ad views occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_ad_view_swipe_up

conversion_ad_view_swipe_up

The number of conversions attributed to ad views resulting from a swipe-up action.

metric

conversion_ad_view_view

conversion_ad_view_view

A conversion metric indicating that a user viewed an ad and subsequently performed a desired action, attributed to the view.

metric

conversion_ad_view_web

conversion_ad_view_web

Total ad views occurring on the web.

metric

conversion_ad_view_web_swipe_up

conversion_ad_view_web_swipe_up

Total ad views occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_ad_view_web_view

conversion_ad_view_web_view

Total ad views occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_add_billing

conversion_add_billing

The total number of ‘add billing information’ conversions attributed to the ad.

metric

conversion_add_billing_app

conversion_add_billing_app

Total billing information additions occurring in an app attributed to ad engagement.

metric

conversion_add_billing_app_swipe_up

conversion_add_billing_app_swipe_up

Total billing information additions occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_add_billing_app_view

conversion_add_billing_app_view

Total billing information additions occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_add_billing_offline

conversion_add_billing_offline

Total billing information additions occurring offline attributed to ad engagement.

metric

conversion_add_billing_offline_swipe_up

conversion_add_billing_offline_swipe_up

Total billing information additions occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_add_billing_offline_view

conversion_add_billing_offline_view

Total billing information additions occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_add_billing_swipe_up

conversion_add_billing_swipe_up

The number of ‘add billing information’ conversions attributed to users swiping up on the ad.

metric

conversion_add_billing_view

conversion_add_billing_view

The number of ‘add billing information’ conversions attributed to users who viewed the ad (view-through conversions).

metric

conversion_add_billing_web

conversion_add_billing_web

Total billing information additions occurring on the web attributed to ad engagement.

metric

conversion_add_billing_web_swipe_up

conversion_add_billing_web_swipe_up

Total billing information additions occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_add_billing_web_view

conversion_add_billing_web_view

Total billing information additions occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_add_cart

conversion_add_cart

The total number of ‘add to cart’ conversions attributed to the ad.

metric

conversion_add_cart_app

conversion_add_cart_app

Total additions to cart occurring in an app attributed to ad engagement.

metric

conversion_add_cart_app_swipe_up

conversion_add_cart_app_swipe_up

Total additions to cart occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_add_cart_app_view

conversion_add_cart_app_view

Total additions to cart occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_add_cart_offline

conversion_add_cart_offline

Total additions to cart occurring offline attributed to ad engagement.

metric

conversion_add_cart_offline_swipe_up

conversion_add_cart_offline_swipe_up

Total additions to cart occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_add_cart_offline_view

conversion_add_cart_offline_view

Total additions to cart occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_add_cart_sk_ad_network

conversion_add_cart_sk_ad_network

The number of add-to-cart conversions attributed via SKAdNetwork.

metric

conversion_add_cart_sk_ad_network_total

conversion_add_cart_sk_ad_network_total

The total number of add-to-cart conversions attributed via SKAdNetwork.

metric

conversion_add_cart_swipe_up

conversion_add_cart_swipe_up

The number of ‘add to cart’ conversions attributed to users swiping up on the ad.

metric

conversion_add_cart_value

conversion_add_cart_value

The monetary value generated from ‘add to cart’ conversions.

metric

conversion_add_cart_view

conversion_add_cart_view

The number of ‘add to cart’ conversions attributed to users who viewed the ad (view-through conversions).

metric

conversion_add_cart_web

conversion_add_cart_web

Total additions to cart occurring on the web attributed to ad engagement.

metric

conversion_add_cart_web_swipe_up

conversion_add_cart_web_swipe_up

Total additions to cart occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_add_cart_web_view

conversion_add_cart_web_view

Total additions to cart occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_add_to_wishlist

conversion_add_to_wishlist

The total number of ‘add to wishlist’ conversions attributed to the ad.

metric

conversion_add_to_wishlist_app

conversion_add_to_wishlist_app

Total additions to wishlist occurring in an app attributed to ad engagement.

metric

conversion_add_to_wishlist_app_swipe_up

conversion_add_to_wishlist_app_swipe_up

Total additions to wishlist occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_add_to_wishlist_app_view

conversion_add_to_wishlist_app_view

Total additions to wishlist occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_add_to_wishlist_offline

conversion_add_to_wishlist_offline

Total additions to wishlist occurring offline attributed to ad engagement.

metric

conversion_add_to_wishlist_offline_swipe_up

conversion_add_to_wishlist_offline_swipe_up

Total additions to wishlist occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_add_to_wishlist_offline_view

conversion_add_to_wishlist_offline_view

Total additions to wishlist occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_add_to_wishlist_swipe_up

conversion_add_to_wishlist_swipe_up

The number of ‘add to wishlist’ conversions attributed to users swiping up on the ad.

metric

conversion_add_to_wishlist_view

conversion_add_to_wishlist_view

The number of ‘add to wishlist’ conversions attributed to users who viewed the ad (view-through conversions).

metric

conversion_add_to_wishlist_web

conversion_add_to_wishlist_web

Total additions to wishlist occurring on the web attributed to ad engagement.

metric

conversion_add_to_wishlist_web_swipe_up

conversion_add_to_wishlist_web_swipe_up

Total additions to wishlist occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_add_to_wishlist_web_view

conversion_add_to_wishlist_web_view

Total additions to wishlist occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_app_opens

conversion_app_opens

Total app opens attributed to ad engagement.

metric

conversion_app_opens_app

conversion_app_opens_app

Total app opens occurring in an app attributed to ad engagement.

metric

conversion_app_opens_app_swipe_up

conversion_app_opens_app_swipe_up

Total app opens occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_app_opens_app_view

conversion_app_opens_app_view

Total app opens occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_app_opens_offline

conversion_app_opens_offline

Total app opens occurring offline attributed to ad engagement.

metric

conversion_app_opens_offline_swipe_up

conversion_app_opens_offline_swipe_up

Total app opens occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_app_opens_offline_view

conversion_app_opens_offline_view

Total app opens occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_app_opens_swipe_up

conversion_app_opens_swipe_up

Total app opens attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_app_opens_view

conversion_app_opens_view

Total app opens attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_app_opens_web

conversion_app_opens_web

Total app opens occurring on the web attributed to ad engagement.

metric

conversion_app_opens_web_swipe_up

conversion_app_opens_web_swipe_up

Total app opens occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_app_opens_web_view

conversion_app_opens_web_view

Total app opens occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_complete_tutorial

conversion_complete_tutorial

Total completed tutorials attributed to ad engagement.

metric

conversion_complete_tutorial_app

conversion_complete_tutorial_app

Total completed tutorials occurring in an app attributed to ad engagement.

metric

conversion_complete_tutorial_app_swipe_up

conversion_complete_tutorial_app_swipe_up

Total completed tutorials occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_complete_tutorial_app_view

conversion_complete_tutorial_app_view

Total completed tutorials occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_complete_tutorial_offline

conversion_complete_tutorial_offline

Total completed tutorials occurring offline attributed to ad engagement.

metric

conversion_complete_tutorial_offline_swipe_up

conversion_complete_tutorial_offline_swipe_up

Total completed tutorials occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_complete_tutorial_offline_view

conversion_complete_tutorial_offline_view

Total completed tutorials occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_complete_tutorial_swipe_up

conversion_complete_tutorial_swipe_up

Total completed tutorials attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_complete_tutorial_view

conversion_complete_tutorial_view

Total completed tutorials attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_complete_tutorial_web

conversion_complete_tutorial_web

Total completed tutorials occurring on the web attributed to ad engagement.

metric

conversion_complete_tutorial_web_swipe_up

conversion_complete_tutorial_web_swipe_up

Total completed tutorials occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_complete_tutorial_web_view

conversion_complete_tutorial_web_view

Total completed tutorials occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_invite

conversion_invite

Total invites sent attributed to ad engagement.

metric

conversion_invite_app

conversion_invite_app

Total invites sent occurring in an app attributed to ad engagement.

metric

conversion_invite_app_swipe_up

conversion_invite_app_swipe_up

Total invites sent occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_invite_app_view

conversion_invite_app_view

Total invites sent occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_invite_offline

conversion_invite_offline

Total invites sent occurring offline attributed to ad engagement.

metric

conversion_invite_offline_swipe_up

conversion_invite_offline_swipe_up

Total invites sent occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_invite_offline_view

conversion_invite_offline_view

Total invites sent occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_invite_swipe_up

conversion_invite_swipe_up

Total invites sent attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_invite_view

conversion_invite_view

Total invites sent attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_invite_web

conversion_invite_web

Total invites sent occurring on the web attributed to ad engagement.

metric

conversion_invite_web_swipe_up

conversion_invite_web_swipe_up

Total invites sent occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_invite_web_view

conversion_invite_web_view

Total invites sent occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_level_completes

conversion_level_completes

Total level completions attributed to ad engagement.

metric

conversion_level_completes_app

conversion_level_completes_app

Total level completions occurring in an app attributed to ad engagement.

metric

conversion_level_completes_app_swipe_up

conversion_level_completes_app_swipe_up

Total level completions occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_level_completes_app_view

conversion_level_completes_app_view

Total level completions occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_level_completes_offline

conversion_level_completes_offline

Total level completions occurring offline attributed to ad engagement.

metric

conversion_level_completes_offline_swipe_up

conversion_level_completes_offline_swipe_up

Total level completions occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_level_completes_offline_view

conversion_level_completes_offline_view

Total level completions occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_level_completes_swipe_up

conversion_level_completes_swipe_up

Total level completions attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_level_completes_view

conversion_level_completes_view

Total level completions attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_level_completes_web

conversion_level_completes_web

Total level completions occurring on the web attributed to ad engagement.

metric

conversion_level_completes_web_swipe_up

conversion_level_completes_web_swipe_up

Total level completions occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_level_completes_web_view

conversion_level_completes_web_view

Total level completions occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_list_view

conversion_list_view

Total times a list was viewed attributed to ad engagement.

metric

conversion_list_view_app

conversion_list_view_app

Total times a list was viewed occurring in an app attributed to ad engagement.

metric

conversion_list_view_app_swipe_up

conversion_list_view_app_swipe_up

Total times a list was viewed occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_list_view_app_view

conversion_list_view_app_view

Total times a list was viewed occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_list_view_offline

conversion_list_view_offline

Total times a list was viewed occurring offline attributed to ad engagement.

metric

conversion_list_view_offline_swipe_up

conversion_list_view_offline_swipe_up

Total times a list was viewed occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_list_view_offline_view

conversion_list_view_offline_view

Total times a list was viewed occurring offline attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_list_view_swipe_up

conversion_list_view_swipe_up

Total times a list was viewed attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_list_view_view

conversion_list_view_view

Total times a list was viewed attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_list_view_web

conversion_list_view_web

Total times a list was viewed occurring on the web attributed to ad engagement.

metric

conversion_list_view_web_swipe_up

conversion_list_view_web_swipe_up

Total times a list was viewed occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_list_view_web_view

conversion_list_view_web_view

Total times a list was viewed occurring on the web attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_login

conversion_login

Total logins attributed to ad engagement.

metric

conversion_login_app

conversion_login_app

Total logins occurring in an app attributed to ad engagement.

metric

conversion_login_app_swipe_up

conversion_login_app_swipe_up

Total logins occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_login_app_view

conversion_login_app_view

Total logins occurring in an app attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_login_offline

conversion_login_offline

Total logins occurring offline attributed to ad engagement.

metric

conversion_login_offline_swipe_up

conversion_login_offline_swipe_up

The number of times a user logged in offline, attributed to a swipe-up interaction with an ad.

metric

conversion_login_offline_view

conversion_login_offline_view

The number of times a user logged in offline, attributed to viewing an ad.

metric

conversion_login_swipe_up

conversion_login_swipe_up

A conversion metric for users who logged in after swiping up on an ad.

metric

conversion_login_view

conversion_login_view

A conversion metric for users who logged in after viewing an ad.

metric

conversion_login_web

conversion_login_web

The number of times a user logged in on a website, attributed to an ad campaign.

metric

conversion_login_web_swipe_up

conversion_login_web_swipe_up

The number of times a user logged in on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_login_web_view

conversion_login_web_view

The number of times a user logged in on a website, attributed to viewing an ad.

metric

conversion_page_views

conversion_page_views

The total number of page view conversions attributed to the ad.

metric

conversion_page_views_app

conversion_page_views_app

The total number of page views within an app, attributed to an ad campaign.

metric

conversion_page_views_app_swipe_up

conversion_page_views_app_swipe_up

The number of page views within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_page_views_app_view

conversion_page_views_app_view

The number of page views within an app, attributed to viewing an ad.

metric

conversion_page_views_offline

conversion_page_views_offline

A conversion metric for offline page views after interacting with an ad.

metric

conversion_page_views_offline_swipe_up

conversion_page_views_offline_swipe_up

A conversion metric for offline page views after swiping up on an ad.

metric

conversion_page_views_offline_view

conversion_page_views_offline_view

A conversion metric for offline page views after viewing an ad.

metric

conversion_page_views_swipe_up

conversion_page_views_swipe_up

The number of page view conversions attributed to users swiping up on the ad.

metric

conversion_page_views_value

conversion_page_views_value

The monetary value generated from page view conversions.

metric

conversion_page_views_view

conversion_page_views_view

The number of page view conversions attributed to users who viewed the ad (view-through conversions).

metric

conversion_page_views_web

conversion_page_views_web

The total number of page views on a website, attributed to an ad campaign.

metric

conversion_page_views_web_swipe_up

conversion_page_views_web_swipe_up

The number of page views on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_page_views_web_view

conversion_page_views_web_view

The number of page views on a website, attributed to viewing an ad.

metric

conversion_purchases

conversion_purchases

The total number of purchase conversions attributed to the ad.

metric

conversion_purchases_app

conversion_purchases_app

The total number of purchases made within an app, attributed to an ad campaign.

metric

conversion_purchases_app_swipe_up

conversion_purchases_app_swipe_up

The number of purchases made within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_purchases_app_view

conversion_purchases_app_view

The number of purchases made within an app, attributed to viewing an ad.

metric

conversion_purchases_offline

conversion_purchases_offline

The total number of offline purchases, attributed to an ad campaign.

metric

conversion_purchases_offline_swipe_up

conversion_purchases_offline_swipe_up

The number of offline purchases, attributed to a swipe-up interaction with an ad.

metric

conversion_purchases_offline_view

conversion_purchases_offline_view

The number of offline purchases, attributed to viewing an ad.

metric

conversion_purchases_sk_ad_network

conversion_purchases_sk_ad_network

The number of purchases attributed via Apple’s SKAdNetwork.

metric

conversion_purchases_sk_ad_network_total

conversion_purchases_sk_ad_network_total

The total number of purchases attributed via Apple’s SKAdNetwork.

metric

conversion_purchases_sk_ad_network_view

conversion_purchases_sk_ad_network_view

The number of purchases attributed via Apple’s SKAdNetwork, where the attribution is based on an ad view.

metric

conversion_purchases_swipe_up

conversion_purchases_swipe_up

The number of purchase conversions attributed to users swiping up on the ad.

metric

conversion_purchases_value

conversion_purchases_value

The monetary value generated from purchase conversions attributed to the ad.

metric

conversion_purchases_value_app

conversion_purchases_value_app

The total monetary value of purchases made within an app, attributed to an ad campaign.

metric

conversion_purchases_value_app_millis

conversion_purchases_value_app_millis

The monetary value of in-app purchases attributed to ads, expressed in milli-units of the currency (e.g., 1000 milli = 1 unit of currency).

metric

conversion_purchases_value_app_swipe_up

conversion_purchases_value_app_swipe_up

The monetary value of purchases made within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_purchases_value_app_view

conversion_purchases_value_app_view

The monetary value of purchases made within an app, attributed to viewing an ad.

metric

conversion_purchases_value_millis

conversion_purchases_value_millis

The total monetary value of all purchases attributed to ads, expressed in milli-units of the currency.

metric

conversion_purchases_value_offline

conversion_purchases_value_offline

The total monetary value of offline purchases, attributed to an ad campaign.

metric

conversion_purchases_value_offline_millis

conversion_purchases_value_offline_millis

The monetary value of offline purchases attributed to ads, expressed in milli-units of the currency.

metric

conversion_purchases_value_offline_swipe_up

conversion_purchases_value_offline_swipe_up

The monetary value of offline purchases, attributed to a swipe-up interaction with an ad.

metric

conversion_purchases_value_offline_view

conversion_purchases_value_offline_view

The monetary value of offline purchases, attributed to viewing an ad.

metric

conversion_purchases_value_swipe_up

conversion_purchases_value_swipe_up

The monetary value generated from purchase conversions attributed to users swiping up on the ad.

metric

conversion_purchases_value_view

conversion_purchases_value_view

The monetary value generated from purchase conversions attributed to users who viewed the ad (view-through conversions).

metric

conversion_purchases_value_web

conversion_purchases_value_web

The total monetary value of purchases made on a website, attributed to an ad campaign.

metric

conversion_purchases_value_web_millis

conversion_purchases_value_web_millis

The monetary value of web-based purchases attributed to ads, expressed in milli-units of the currency.

metric

conversion_purchases_value_web_swipe_up

conversion_purchases_value_web_swipe_up

The monetary value of purchases made on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_purchases_value_web_view

conversion_purchases_value_web_view

The monetary value of purchases made on a website, attributed to viewing an ad.

metric

conversion_purchases_view

conversion_purchases_view

The number of purchase conversions attributed to users who viewed the ad (view-through conversions).

metric

conversion_purchases_web

conversion_purchases_web

The total number of purchases made on a website, attributed to an ad campaign.

metric

conversion_purchases_web_swipe_up

conversion_purchases_web_swipe_up

The number of purchases made on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_purchases_web_view

conversion_purchases_web_view

The number of purchases made on a website, attributed to viewing an ad.

metric

conversion_rate

conversion_rate

The rate at which ad impressions or clicks lead to a desired conversion event.

metric

conversion_rate_app

conversion_rate_app

The rate of conversions that occurred within an app, attributed to an ad campaign.

metric

conversion_rate_app_swipe_up

conversion_rate_app_swipe_up

The rate of conversions within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_rate_app_view

conversion_rate_app_view

The rate of conversions within an app, attributed to viewing an ad.

metric

conversion_rate_offline

conversion_rate_offline

The rate of offline conversions, attributed to an ad campaign.

metric

conversion_rate_offline_swipe_up

conversion_rate_offline_swipe_up

The rate of offline conversions, attributed to a swipe-up interaction with an ad.

metric

conversion_rate_offline_view

conversion_rate_offline_view

The rate of offline conversions, attributed to viewing an ad.

metric

conversion_rate_swipe_up

conversion_rate_swipe_up

The conversion rate specifically for actions initiated by a swipe-up gesture on the ad.

metric

conversion_rate_view

conversion_rate_view

The conversion rate specifically for view-through conversions (users who saw the ad and later converted).

metric

conversion_rate_web

conversion_rate_web

The rate of conversions that occurred on a website, attributed to an ad campaign.

metric

conversion_rate_web_swipe_up

conversion_rate_web_swipe_up

The rate of conversions on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_rate_web_view

conversion_rate_web_view

The rate of conversions on a website, attributed to viewing an ad.

metric

conversion_reserve

conversion_reserve

The total number of reservation events attributed to an ad campaign.

metric

conversion_reserve_app

conversion_reserve_app

The number of reservation events that occurred within an app, attributed to an ad campaign.

metric

conversion_reserve_app_swipe_up

conversion_reserve_app_swipe_up

The number of reservation events within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_reserve_app_view

conversion_reserve_app_view

The number of reservation events within an app, attributed to viewing an ad.

metric

conversion_reserve_offline

conversion_reserve_offline

The number of offline reservation events, attributed to an ad campaign.

metric

conversion_reserve_offline_swipe_up

conversion_reserve_offline_swipe_up

The number of offline reservation events, attributed to a swipe-up interaction with an ad.

metric

conversion_reserve_offline_view

conversion_reserve_offline_view

The number of offline reservation events, attributed to viewing an ad.

metric

conversion_reserve_swipe_up

conversion_reserve_swipe_up

A conversion metric for users who made a reservation after swiping up on an ad.

metric

conversion_reserve_view

conversion_reserve_view

A conversion metric for users who made a reservation after viewing an ad.

metric

conversion_reserve_web

conversion_reserve_web

The number of reservation events that occurred on a website, attributed to an ad campaign.

metric

conversion_reserve_web_swipe_up

conversion_reserve_web_swipe_up

The number of reservation events on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_reserve_web_view

conversion_reserve_web_view

The number of reservation events on a website, attributed to viewing an ad.

metric

conversion_save

conversion_save

The total number of ‘save’ conversions attributed to the ad.

metric

conversion_save_app

conversion_save_app

The total number of save events that occurred within an app, attributed to an ad campaign.

metric

conversion_save_app_swipe_up

conversion_save_app_swipe_up

The number of save events within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_save_app_view

conversion_save_app_view

The number of save events within an app, attributed to viewing an ad.

metric

conversion_save_offline

conversion_save_offline

A conversion metric for offline saves after interacting with an ad.

metric

conversion_save_offline_swipe_up

conversion_save_offline_swipe_up

A conversion metric for offline saves after swiping up on an ad.

metric

conversion_save_offline_view

conversion_save_offline_view

A conversion metric for offline saves after viewing an ad.

metric

conversion_save_swipe_up

conversion_save_swipe_up

The number of ‘save’ conversions attributed to users swiping up on the ad.

metric

conversion_save_view

conversion_save_view

The number of ‘save’ conversions attributed to users who viewed the ad (view-through conversions).

metric

conversion_save_web

conversion_save_web

The total number of save events that occurred on a website, attributed to an ad campaign.

metric

conversion_save_web_swipe_up

conversion_save_web_swipe_up

The number of save events on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_save_web_view

conversion_save_web_view

The number of save events on a website, attributed to viewing an ad.

metric

conversion_searches

conversion_searches

The total number of ‘search’ conversions attributed to the ad.

metric

conversion_searches_app

conversion_searches_app

The total number of search events that occurred within an app, attributed to an ad campaign.

metric

conversion_searches_app_swipe_up

conversion_searches_app_swipe_up

The number of search events within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_searches_app_view

conversion_searches_app_view

The number of search events within an app, attributed to viewing an ad.

metric

conversion_searches_offline

conversion_searches_offline

A conversion metric for offline searches after interacting with an ad.

metric

conversion_searches_offline_swipe_up

conversion_searches_offline_swipe_up

A conversion metric for offline searches after swiping up on an ad.

metric

conversion_searches_offline_view

conversion_searches_offline_view

A conversion metric for offline searches after viewing an ad.

metric

conversion_searches_swipe_up

conversion_searches_swipe_up

The number of ‘search’ conversions attributed to users swiping up on the ad.

metric

conversion_searches_view

conversion_searches_view

The number of ‘search’ conversions attributed to users who viewed the ad (view-through conversions).

metric

conversion_searches_web

conversion_searches_web

The total number of search events that occurred on a website, attributed to an ad campaign.

metric

conversion_searches_web_swipe_up

conversion_searches_web_swipe_up

The number of search events on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_searches_web_view

conversion_searches_web_view

The number of search events on a website, attributed to viewing an ad.

metric

conversion_share

conversion_share

The total number of share conversions attributed to the ad.

metric

conversion_share_app

conversion_share_app

The total number of share events that occurred within an app, attributed to an ad campaign.

metric

conversion_share_app_swipe_up

conversion_share_app_swipe_up

The number of share events within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_share_app_view

conversion_share_app_view

The number of share events within an app, attributed to viewing an ad.

metric

conversion_share_offline

conversion_share_offline

A conversion metric for offline shares after interacting with an ad.

metric

conversion_share_offline_swipe_up

conversion_share_offline_swipe_up

A conversion metric for offline shares after swiping up on an ad.

metric

conversion_share_offline_view

conversion_share_offline_view

A conversion metric for offline shares after viewing an ad.

metric

conversion_share_swipe_up

conversion_share_swipe_up

The number of ‘share’ conversions attributed to users swiping up on the ad.

metric

conversion_share_view

conversion_share_view

Total shares of content attributed to ad views, based on the view-through attribution window.

metric

conversion_share_web

conversion_share_web

The total number of share events that occurred on a website, attributed to an ad campaign.

metric

conversion_share_web_swipe_up

conversion_share_web_swipe_up

The number of share events on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_share_web_view

conversion_share_web_view

The number of share events on a website, attributed to viewing an ad.

metric

conversion_sign_ups

conversion_sign_ups

Total sign-ups attributed to ad engagement.

metric

conversion_sign_ups_app

conversion_sign_ups_app

The total number of sign-up events that occurred within an app, attributed to an ad campaign.

metric

conversion_sign_ups_app_swipe_up

conversion_sign_ups_app_swipe_up

The number of sign-up events within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_sign_ups_app_view

conversion_sign_ups_app_view

The number of sign-up events within an app, attributed to viewing an ad.

metric

conversion_sign_ups_offline

conversion_sign_ups_offline

A conversion metric for offline sign-ups after interacting with an ad.

metric

conversion_sign_ups_offline_swipe_up

conversion_sign_ups_offline_swipe_up

A conversion metric for offline sign-ups after swiping up on an ad.

metric

conversion_sign_ups_offline_view

conversion_sign_ups_offline_view

A conversion metric for offline sign-ups after viewing an ad.

metric

conversion_sign_ups_swipe_up

conversion_sign_ups_swipe_up

Total sign-ups attributed specifically to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_sign_ups_value

conversion_sign_ups_value

The monetary value generated from sign-up conversions.

metric

conversion_sign_ups_view

conversion_sign_ups_view

Total sign-ups attributed specifically to users viewing an ad, based on the view-through attribution window.

metric

conversion_sign_ups_web

conversion_sign_ups_web

The total number of sign-up events that occurred on a website, attributed to an ad campaign.

metric

conversion_sign_ups_web_swipe_up

conversion_sign_ups_web_swipe_up

The number of sign-up events on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_sign_ups_web_view

conversion_sign_ups_web_view

The number of sign-up events on a website, attributed to viewing an ad.

metric

conversion_spend_credits

conversion_spend_credits

A conversion metric for users who spent credits after interacting with an ad.

metric

conversion_spend_credits_app

conversion_spend_credits_app

A conversion metric for users who spent credits within an app after interacting with an ad.

metric

conversion_spend_credits_app_swipe_up

conversion_spend_credits_app_swipe_up

A conversion metric for users who spent credits within an app after swiping up on an ad.

metric

conversion_spend_credits_app_view

conversion_spend_credits_app_view

A conversion metric for users who spent credits within an app after viewing an ad.

metric

conversion_spend_credits_offline

conversion_spend_credits_offline

A conversion metric for users who spent credits offline after interacting with an ad.

metric

conversion_spend_credits_offline_swipe_up

conversion_spend_credits_offline_swipe_up

A conversion metric for users who spent credits offline after swiping up on an ad.

metric

conversion_spend_credits_offline_view

conversion_spend_credits_offline_view

A conversion metric for users who spent credits offline after viewing an ad.

metric

conversion_spend_credits_swipe_up

conversion_spend_credits_swipe_up

A conversion metric for users who spent credits after swiping up on an ad.

metric

conversion_spend_credits_view

conversion_spend_credits_view

A conversion metric for users who spent credits after viewing an ad.

metric

conversion_spend_credits_web

conversion_spend_credits_web

A conversion metric for users who spent credits on a website after interacting with an ad.

metric

conversion_spend_credits_web_swipe_up

conversion_spend_credits_web_swipe_up

A conversion metric for users who spent credits on a website after swiping up on an ad.

metric

conversion_spend_credits_web_view

conversion_spend_credits_web_view

A conversion metric for users who spent credits on a website after viewing an ad.

metric

conversion_start_checkout

conversion_start_checkout

Total times users initiated a checkout process attributed to ad engagement.

metric

conversion_start_checkout_app

conversion_start_checkout_app

The total number of times users started the checkout process within an app, attributed to an ad campaign.

metric

conversion_start_checkout_app_swipe_up

conversion_start_checkout_app_swipe_up

The number of times users started the checkout process within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_start_checkout_app_view

conversion_start_checkout_app_view

The number of times users started the checkout process within an app, attributed to viewing an ad.

metric

conversion_start_checkout_offline

conversion_start_checkout_offline

A conversion metric for users who started an offline checkout process after interacting with an ad.

metric

conversion_start_checkout_offline_swipe_up

conversion_start_checkout_offline_swipe_up

A conversion metric for users who started an offline checkout process after swiping up on an ad.

metric

conversion_start_checkout_offline_view

conversion_start_checkout_offline_view

A conversion metric for users who started an offline checkout process after viewing an ad.

metric

conversion_start_checkout_swipe_up

conversion_start_checkout_swipe_up

Total times users initiated a checkout process attributed to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_start_checkout_view

conversion_start_checkout_view

Total times users initiated a checkout process attributed to users viewing an ad, based on the view-through attribution window.

metric

conversion_start_checkout_web

conversion_start_checkout_web

The total number of times users started the checkout process on a website, attributed to an ad campaign.

metric

conversion_start_checkout_web_swipe_up

conversion_start_checkout_web_swipe_up

The number of times users started the checkout process on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_start_checkout_web_view

conversion_start_checkout_web_view

The number of times users started the checkout process on a website, attributed to viewing an ad.

metric

conversion_start_trial

conversion_start_trial

A conversion metric for users who started a trial after interacting with an ad.

metric

conversion_start_trial_app

conversion_start_trial_app

A conversion metric for users who started an app trial after interacting with an ad.

metric

conversion_start_trial_app_swipe_up

conversion_start_trial_app_swipe_up

A conversion metric for users who started an app trial after swiping up on an ad.

metric

conversion_start_trial_app_view

conversion_start_trial_app_view

A conversion metric for users who started an app trial after viewing an ad.

metric

conversion_start_trial_offline

conversion_start_trial_offline

A conversion metric for users who started an offline trial after interacting with an ad.

metric

conversion_start_trial_offline_swipe_up

conversion_start_trial_offline_swipe_up

A conversion metric for users who started an offline trial after swiping up on an ad.

metric

conversion_start_trial_offline_view

conversion_start_trial_offline_view

A conversion metric for users who started an offline trial after viewing an ad.

metric

conversion_start_trial_swipe_up

conversion_start_trial_swipe_up

A conversion metric for users who started a trial after swiping up on an ad.

metric

conversion_start_trial_view

conversion_start_trial_view

A conversion metric for users who started a trial after viewing an ad.

metric

conversion_start_trial_web

conversion_start_trial_web

A conversion metric for users who started a web trial after interacting with an ad.

metric

conversion_start_trial_web_swipe_up

conversion_start_trial_web_swipe_up

A conversion metric for users who started a web trial after swiping up on an ad.

metric

conversion_start_trial_web_view

conversion_start_trial_web_view

A conversion metric for users who started a web trial after viewing an ad.

metric

conversion_subscribe

conversion_subscribe

Total subscriptions attributed to ad engagement.

metric

conversion_subscribe_app

conversion_subscribe_app

The total number of subscription events that occurred within an app, attributed to an ad campaign.

metric

conversion_subscribe_app_swipe_up

conversion_subscribe_app_swipe_up

The number of subscription events within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_subscribe_app_view

conversion_subscribe_app_view

The number of subscription events within an app, attributed to viewing an ad.

metric

conversion_subscribe_offline

conversion_subscribe_offline

A conversion metric for offline subscriptions after interacting with an ad.

metric

conversion_subscribe_offline_swipe_up

conversion_subscribe_offline_swipe_up

A conversion metric for offline subscriptions after swiping up on an ad.

metric

conversion_subscribe_offline_view

conversion_subscribe_offline_view

A conversion metric for offline subscriptions after viewing an ad.

metric

conversion_subscribe_swipe_up

conversion_subscribe_swipe_up

Total subscriptions attributed specifically to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_subscribe_view

conversion_subscribe_view

Total subscriptions attributed specifically to users viewing an ad, based on the view-through attribution window.

metric

conversion_subscribe_web

conversion_subscribe_web

The total number of subscription events that occurred on a website, attributed to an ad campaign.

metric

conversion_subscribe_web_swipe_up

conversion_subscribe_web_swipe_up

The number of subscription events on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_subscribe_web_view

conversion_subscribe_web_view

The number of subscription events on a website, attributed to viewing an ad.

metric

conversion_total_installs_sk_ad_network

conversion_total_installs_sk_ad_network

The total number of app installs across all operating systems attributed via SKAdNetwork, without specifying view-through or click-through.

metric

conversion_total_installs_sk_ad_network_total

conversion_total_installs_sk_ad_network_total

The overall total number of app installs across all operating systems attributed via SKAdNetwork, combining all attribution methods.

metric

conversion_view_content

conversion_view_content

Total views of specific content attributed to ad engagement.

metric

conversion_view_content_app

conversion_view_content_app

The total number of content view events that occurred within an app, attributed to an ad campaign.

metric

conversion_view_content_app_swipe_up

conversion_view_content_app_swipe_up

The number of content view events within an app, attributed to a swipe-up interaction with an ad.

metric

conversion_view_content_app_view

conversion_view_content_app_view

The number of content view events within an app, attributed to viewing an ad.

metric

conversion_view_content_offline

conversion_view_content_offline

A conversion metric for offline content views after interacting with an ad.

metric

conversion_view_content_offline_swipe_up

conversion_view_content_offline_swipe_up

A conversion metric for offline content views after swiping up on an ad.

metric

conversion_view_content_offline_view

conversion_view_content_offline_view

A conversion metric for offline content views after viewing an ad.

metric

conversion_view_content_swipe_up

conversion_view_content_swipe_up

Total views of specific content attributed specifically to users swiping up on an ad, based on the swipe-up attribution window.

metric

conversion_view_content_view

conversion_view_content_view

Total views of specific content attributed specifically to users viewing an ad, based on the view-through attribution window.

metric

conversion_view_content_web

conversion_view_content_web

The total number of content view events that occurred on a website, attributed to an ad campaign.

metric

conversion_view_content_web_swipe_up

conversion_view_content_web_swipe_up

The number of content view events on a website, attributed to a swipe-up interaction with an ad.

metric

conversion_view_content_web_view

conversion_view_content_web_view

The number of content view events on a website, attributed to viewing an ad.

metric

conversion_visit

conversion_visit

Attributed visit conversion events.

metric

conversion_visit_app

conversion_visit_app

The number of visit conversion events that occurred within an app.

metric

conversion_visit_offline

conversion_visit_offline

A conversion metric for offline visits after interacting with an ad.

metric

conversion_visit_web

conversion_visit_web

The number of visit conversion events that occurred on a website.

metric

conversion_window

conversion_window

The time period following an ad interaction (view or click) during which a conversion event is attributed to that ad.

dimension

conversion_{NUM}_app

conversion_{NUM}_app

A custom conversion event, where {NUM} represents the unique ID, occurring in an app.

metric

conversion_{NUM}_offline

conversion_{NUM}_offline

A custom conversion event, where {NUM} represents the unique ID, occurring offline.

metric

conversion_{NUM}_web

conversion_{NUM}_web

A custom conversion event, where {NUM} represents the unique ID, occurring on the web.

metric

cost_eur

cost_eur

The total cost of the ad campaign in Euros.

metric

cost_usd

cost_usd

The total cost of the ad campaign in US Dollars.

metric

costs_lc

costs_lc

The total cost of the ad campaign in local currency.

metric

costs_originalcurrency

costs_originalcurrency

The total cost of the ad campaign in its original billing currency.

metric

costs_usd

costs_usd

The total cost of the ad campaign in US Dollars.

metric

country_code

country_code

The standard country code (e.g., US, GB) associated with geographical targeting or reporting.

dimension

created_at_date

created_at_date

The date when an entity was created.

dimension

creation_state

creation_state

The current state of an ad, ad squad, or campaign, such as ‘DRAFT’, ‘ACTIVE’, or ‘PAUSED’.

dimension

creative

creative

The unique identifier or name of the creative asset used in an ad.

dimension

creative_ad_size

creative_ad_size

The dimensions or size of the ad creative.

dimension

creative_calendar_year

creative_calendar_year

The calendar year in which the creative was created or last modified.

metric

creative_campaign

creative_campaign

The campaign to which the creative belongs.

dimension

creative_clickthrough_url

creative_clickthrough_url

The URL that users are directed to when they interact with the ad creative.

dimension

creative_composite_properties

creative_composite_properties

A collection of various properties that define the complex characteristics of a creative.

dimension

creative_duration

creative_duration

The playback duration of the creative content in an ad.

dimension

creative_media_format

creative_media_format

The media format of the creative (e.g., image, video, collection ad).

dimension

creative_preview_properties

creative_preview_properties

Properties related to how an ad creative appears in a preview, including its format and content.

dimension

creator_partnership_type

creator_partnership_type

The type of partnership with a content creator if the ad involves sponsored or collaborative content.

dimension

cta_color_display_mode

cta_color_display_mode

The display mode or color scheme applied to the call-to-action button of a creative.

dimension

currency

ad_account_currency

The currency used for the ad account.

dimension

currency_for_calc

currency_for_calc

The currency used for calculations and reporting of financial metrics.

dimension

currency_type

currency_type

The type of currency used (e.g., USD, EUR).

dimension

custom_conversion[{PLACEHOLDER}]

custom_conversion[{PLACEHOLDER}]

A custom conversion event defined by the advertiser, where ‘PLACEHOLDER’ represents the specific custom event name or ID.

metric

custom_event_{NUM}

custom_event_{NUM}

Total occurrences of a custom conversion event, where {NUM} represents the unique ID of the custom conversion.

metric

custom_event_{NUM}_app

custom_event_{NUM}_app

The total count of a custom event (specified by {NUM}) occurring within an app, attributed to an ad campaign.

metric

custom_event_{NUM}_app_swipe_up

custom_event_{NUM}_app_swipe_up

The count of a custom event (specified by {NUM}) occurring within an app, attributed to a swipe-up interaction with an ad.

metric

custom_event_{NUM}_app_view

custom_event_{NUM}_app_view

The count of a custom event (specified by {NUM}) occurring within an app, attributed to viewing an ad.

metric

custom_event_{NUM}_offline

custom_event_{NUM}_offline

A custom offline conversion event tracked after interacting with an ad, identified by a number.

metric

custom_event_{NUM}_offline_swipe_up

custom_event_{NUM}_offline_swipe_up

A custom offline conversion event tracked after swiping up on an ad, identified by a number.

metric

custom_event_{NUM}_offline_view

custom_event_{NUM}_offline_view

A custom offline conversion event tracked after viewing an ad, identified by a number.

metric

custom_event_{NUM}_swipe_up

custom_event_{NUM}_swipe_up

Total occurrences of a custom conversion event, where {NUM} represents the unique ID, attributed to users swiping up on an ad.

metric

custom_event_{NUM}_view

custom_event_{NUM}_view

Total occurrences of a custom conversion event, where {NUM} represents the unique ID, attributed to users viewing an ad.

metric

custom_event_{NUM}_web

custom_event_{NUM}_web

The total count of a custom event (specified by {NUM}) occurring on a website, attributed to an ad campaign.

metric

custom_event_{NUM}_web_swipe_up

custom_event_{NUM}_web_swipe_up

The count of a custom event (specified by {NUM}) occurring on a website, attributed to a swipe-up interaction with an ad.

metric

custom_event_{NUM}_web_view

custom_event_{NUM}_web_view

The count of a custom event (specified by {NUM}) occurring on a website, attributed to viewing an ad.

metric

customer.name

customer.name

The name of the customer or advertiser associated with the ad account or invoice.

dimension

customer.netsuite_id

customer.netsuite_id

The unique identifier for a customer record as it exists in NetSuite, used for integrating customer data between platforms.

dimension

daily_budget_micro

campaign_daily_budget_micro

The daily budget for a campaign, expressed in micro-currency units.

metric

data_currency

data_currency

The currency in which the reporting data is presented.

dimension

date

date

The specific date for which the data is reported.

dimension

date_updated

date_updated

The date when an entity was last updated.

dimension

day_of_the_year

day_of_the_year

The specific day of the year for which the data is reported.

metric

dayofweek

dayofweek

The day of the week for which advertising data or metrics are reported.

dimension

delivery_status

delivery_status

The current status of an ad’s delivery, indicating if it’s active, paused, or completed.

dimension

demo_media_id

demo_media_id

The unique identifier for a media asset used for demonstration purposes.

dimension

demo_targeting

demo_targeting

Demographic targeting parameters used for the ad.

dimension

device_category

device_category

The general category of devices (e.g., mobile, tablet) on which the ad was shown.

dimension

dma_name

dma_name

The Designated Market Area (DMA) of the audience targeted in Snapchat ads.

dimension

document_number

document_number

A unique identifying number for a document, such as an invoice.

metric

due_date_date

due_date_date

The date when an invoice payment is due.

dimension

dynamic_render_properties

dynamic_render_properties

Properties that control how an ad or creative is dynamically rendered, often used for personalized content.

dimension

earned_impressions

earned_impressions

Impressions generated through organic sharing or viral spread of the ad content, rather than paid placements.

dimension

earned_reach

earned_reach

The number of unique users reached through organic sharing or viral spread of the ad content.

metric

end_date

end_date

The scheduled end date for a campaign or ad squad.

dimension

end_time

campaign_end_time

The scheduled end date and time for the advertising campaign.

dimension

engagements_total

engagements_total

The total number of user engagements with an ad, including various interactions like swipes, clicks, and shares.

metric

environment_device

environment_device

The type of device operating system (e.g., iOS, Android) where the ad was displayed.

dimension

event_name

event_name

The name of a specific conversion event tracked (e.g., PURCHASE, ADD_TO_CART).

dimension

events

events

A collection or count of various user actions or occurrences tracked as part of ad performance.

metric

experiment_id

experiment_id

The unique identifier for an A/B test or other experiment being conducted on an ad campaign.

dimension

favorite_display_mode

favorite_display_mode

Determines whether users can favorite a creative within the Snapchat app, with options to show or hide the favorite functionality.

dimension

forced_view_eligibility

forced_view_eligibility

Indicates if a creative is eligible to be used as an unskippable commercial and for what duration (e.g., full duration or six seconds).

dimension

format_size

format_size

The size specifications of the ad format.

dimension

format_type

format_type

The type of ad format (e.g., Single Image or Video, Collection Ad).

dimension

frequency

frequency

The average number of times a unique user saw the ad.

metric

funding

funding

Information related to the funding source used for an ad account, such as credit card details or lines of credit.

dimension

funding_source_ids

funding_source_ids

A list of identifiers for the financial sources used to fund an ad campaign.

dimension

gross_impressions

gross_impressions

The total number of times an ad was displayed, including repeated displays to the same user.

metric

id

ad_id

The unique identifier for the ad.

dimension

impression_goal

impression_goal

The target number of impressions set for the campaign.

dimension

impressions

impressions

The total number of times the ad was displayed.

metric

industry

industry

The industry classification of the advertiser or client.

dimension

interest_category_id

interest_category_id

The unique identifier for a target audience interest category.

dimension

interest_category_name

interest_category_name

The name of a specific interest category used for audience targeting.

dimension

invoice_id

invoice_id

The unique identifier for a billing invoice.

dimension

invoice_status

invoice_status

The current status of an invoice (e.g., Paid, Due, Overdue).

dimension

ios_installs

ios_installs

The total number of app installs on iOS devices attributed to the ad.

metric

ios_installs_app

ios_installs_app

The number of app installs attributed to an ad on iOS devices (click-through or swipe-up attribution).

metric

ios_installs_app_swipe_up

ios_installs_app_swipe_up

The number of app installs attributed to a swipe-up action on an ad on iOS devices.

metric

ios_installs_app_view

ios_installs_app_view

The number of app installs attributed to an ad on iOS devices, where the install occurred after a user viewed the ad (view-through attribution).

metric

ios_installs_offline

ios_installs_offline

The number of offline installs attributed to an ad on iOS devices (click-through or swipe-up attribution).

metric

ios_installs_offline_swipe_up

ios_installs_offline_swipe_up

The number of offline installs attributed to a swipe-up action on an ad on iOS devices.

metric

ios_installs_offline_view

ios_installs_offline_view

The number of offline installs attributed to an ad on iOS devices, where the install occurred after a user viewed the ad (view-through attribution). Offline installs refer to conversions that happen outside the app or web environment.

metric

ios_installs_swipe_up

ios_installs_swipe_up

The number of app installs on iOS devices attributed to users swiping up on the ad.

dimension

ios_installs_view

ios_installs_view

The number of app installs on iOS devices attributed to users who viewed the ad (view-through conversions).

metric

ios_installs_web

ios_installs_web

The number of web-based installs attributed to an ad on iOS devices (click-through or swipe-up attribution).

metric

ios_installs_web_swipe_up

ios_installs_web_swipe_up

The number of web-based installs attributed to a swipe-up action on an ad on iOS devices.

metric

ios_installs_web_view

ios_installs_web_view

The number of web-based installs attributed to an ad on iOS devices, where the install occurred after a user viewed the ad (view-through attribution).

metric

landing_page_views

landing_page_views

The total number of views for the landing page associated with an advertisement.

metric

language

language

The language targeted by the ad campaign or the language of the ad creative.

dimension

last_modified_date

last_modified_date

The date when an invoice or other entity was last modified.

dimension

last_refresh_date

last_refresh_date

The date and time when the data was last refreshed.

dimension

lc_to_usd

lc_to_usd

The conversion rate from local currency (LC) to US dollars (USD) for monetary values.

metric

lens_package_metadata

lens_package_metadata

Metadata associated with a Snapchat Lens package used in AR advertising campaigns.

dimension

lifetime_budget_micro

ad_squad_lifetime_budget_micro

The total budget allocated for the entire duration of an ad squad’s campaign, expressed in micro-units of the currency (e.g., 1,000,000 micro = 1 unit of currency).

metric

lifetime_spend_cap_micro

campaign_lifetime_spend_cap_micro

The maximum total amount that can be spent on a campaign over its entire lifespan, expressed in micro-units of the currency.

metric

line_last_modified

line_last_modified

The timestamp indicating the last modification date and time of an advertising line item.

dimension

lob_{NUM}

lob_{NUM}

dimension

market_name_{NUM}

market_name_{NUM}

The name of a specific market targeted by the advertising campaigns.

dimension

measured_impressions

measured_impressions

The number of ad impressions that were successfully measured for viewability, indicating they met industry standards for being seen.

metric

media_cost

media_cost

The total cost incurred for media placements in an advertising campaign.

metric

media_usages

media_usages

Details on where and how a specific media asset is utilized across different ad campaigns or creatives.

dimension

name

organization_name

The name of the organization associated with the ad account.

dimension

native_leads

native_leads

The number of leads generated directly through Snapchat’s native lead generation forms.

dimension

non_viewable_impressions

non_viewable_impressions

The number of ad impressions that did not meet the industry standards for viewability and were therefore not considered seen by a user.

metric

objective

campaign_objective

The marketing objective of the advertising campaign (e.g., app installs, brand awareness, conversions).

dimension

objective_v2_properties

objective_v2_properties

Properties related to the specific advertising objective of a campaign, such as app installs or brand awareness.

dimension

offer_disclaimer_id

offer_disclaimer_id

The unique identifier for an offer disclaimer associated with an ad.

dimension

operating_system

operating_system

The operating system (e.g., iOS, Android) of the device on which an ad was displayed or a conversion occurred.

dimension

optimization_goal

ad_squad_optimization_goal

The goal for which the ad squad is optimized, influencing bid strategy and delivery (e.g., app installs, purchases).

dimension

org_id

org_id

The unique identifier for an organization within the Snapchat advertising platform.

dimension

pacing_level

pacing_level

The pacing strategy applied to an ad campaign or ad squad, determining how the budget is spent over time (e.g., standard, accelerated).

dimension

pacing_properties_version

pacing_properties_version

The version of the pacing settings that control how a campaign’s budget is spent over time.

metric

packaging_status

packaging_status

The status indicating how an ad or creative is packaged or bundled for delivery.

dimension

paid_impressions

paid_impressions

Impressions generated from paid placements of the ad content.

metric

pixel_id

pixel_id

The unique identifier for a Snap Pixel, used for tracking website and app events.

dimension

placement_ad_size

placement_ad_size

The size of the ad creative as displayed in a particular placement.

dimension

placement_id

placement_id

The unique identifier for the ad placement within the Snapchat platform.

dimension

placement_media_format

placement_media_format

The media format of the ad as it appears in a specific placement.

dimension

platform_name

platform_name

The name of the advertising platform, which is Snapchat in this context.

dimension

platform_objective

platform_objective

The primary objective set on the advertising platform for a campaign (e.g., app installs, website visits).

dimension

position_impressions

position_impressions

The number of impressions recorded for the ad in a specific placement position.

dimension

position_swipe_up_percent

position_swipe_up_percent

The percentage of impressions in a specific position that resulted in a swipe-up action.

dimension

post_ad_preview_url

post_ad_preview_url

A URL to preview an ad after it has been created or posted, often used for review and quality assurance.

dimension

preview_creative_id

creative_preview_creative_id

The unique identifier for a creative asset used for preview purposes.

dimension

preview_properties

preview_properties

General properties that define the preview settings for an ad or creative.

dimension

primary_profile

primary_profile

The main user or business profile associated with an ad account or creative.

dimension

product_properties

product_properties

Properties describing the product being advertised, used for dynamic product ads or catalog integration.

dimension

profile_properties

profile_properties

A collection of properties related to a user or business profile on Snapchat.

dimension

quarter

quarter

The calendar quarter for which the data is reported.

dimension

quarters

quarters

The financial or calendar quarter for which advertising data or metrics are reported.

dimension

quartile_{NUM}

quartile_{NUM}

Video quartile data (e.g., 25%, 50%, 75%, 100%) for video views within the ad creative.

metric

reach_and_frequency_rate_micro

reach_and_frequency_rate_micro

A granular rate for reach and frequency campaigns, indicating the cost or value per targeted impression.

dimension

reach_and_frequency_status

reach_and_frequency_status

The current status of a reach and frequency campaign, indicating whether it’s active, paused, or completed.

dimension

reach_goal

reach_goal

The target number of unique users to reach with the ad campaign.

dimension

regulations

regulations

Information regarding compliance with advertising policies and specific legal or industry regulations.

dimension

render_type

render_type

The rendering type of the ad, indicating how it is displayed within the Snapchat application.

dimension

reserved_type

reserved_type

Indicates if a campaign or ad buy is a “reserved” type, meaning it typically cannot be modified via the API and requires management through Snap Ads Manager.

dimension

review_status

ad_review_status

The current review status of the ad (e.g., Pending, Approved, Rejected).

dimension

review_status_details

review_status_details

Detailed information regarding the current review status of an ad or creative.

dimension

review_status_reason

ad_review_status_reason

The reason provided for the current review status of an ad, if it’s not approved.

dimension

review_status_reasons

review_status_reasons

A list of reasons contributing to the current review status of an ad or creative.

dimension

saves

saves

The number of times users saved the ad content.

metric

screen_time_millis

screen_time_millis

The total time, in milliseconds, that users spent on screen interacting with the ad.

metric

segment

segment

Audience segment information used for targeting.

dimension

semantic_id

semantic_id

A unique identifier that conveys the semantic meaning of an entity within the advertising system.

dimension

shareable

creative_shareable

Indicates whether the creative content is shareable by users.

dimension

skadnetwork_properties

skadnetwork_properties

Properties and settings related to SKAdNetwork integration for app install attribution.

dimension

skippable

skippable

Indicates whether a video ad can be skipped by the user.

dimension

snap_cost_usd

snap_cost_usd

The cost of the ad campaign in US Dollars, as reported by Snapchat.

metric

snap_id

snap_id

The unique identifier for a Snap or a creative asset on Snapchat.

dimension

snapchat_clicks

snapchat_clicks

The total number of clicks recorded on Snapchat ads.

metric

snapchat_impressions

snapchat_impressions

The number of times an ad was displayed on Snapchat.

metric

source_snaps_host_users_profile_ids

source_snaps_host_users_profile_ids

A list of Public Profile IDs of users who host the source snaps for a creative, used to associate ad content with specific public profiles.

dimension

spend

spend

The total amount of money spent on the advertising campaign.

metric

start_date

start_date

The scheduled start date for a campaign or ad squad.

dimension

start_time

start_time

The scheduled start date and time for the advertising campaign.

dimension

status

campaign_status

The current status of the advertising campaign (e.g., Active, Paused, Completed).

dimension

story_completes

story_completes

The number of times users watched the entire ad creative within a story format.

metric

story_opens

story_opens

The number of times a user opened the story containing the ad.

metric

swipe_up_percent

swipe_up_percent

The percentage of users who swiped up on the ad after viewing it.

dimension

swipes

swipes

The total number of times users swiped up on the ad.

metric

target_bid

target_bid

The specific bid amount or strategy set for reaching a target cost per action.

dimension

target_business_profile_id

target_business_profile_id

The unique identifier of the business profile that an ad or campaign is intended to promote or target.

dimension

targeting

ad_squad_targeting

The comprehensive targeting specifications applied to an Ad Squad, defining the audience based on demographics, location, interests, devices, and custom audience segments.

dimension

targeting.app_install_states

targeting.app_install_states

Specific states of app installation (e.g., installed, not installed) used to target or exclude audiences.

dimension

targeting.auto_expansion_options

targeting.auto_expansion_options

Options for automatically expanding the target audience beyond the initially defined parameters.

dimension

targeting.demographics

targeting.demographics

Demographic attributes (e.g., age, gender) used to define the target audience for an ad.

dimension

targeting.devices

targeting.devices

Device targeting criteria, such as operating system or device model.

dimension

targeting.enable_targeting_expansion

targeting.enable_targeting_expansion

A boolean indicator specifying whether targeting expansion is enabled to reach a broader audience.

dimension

targeting.geos

targeting.geos

Geographical locations (e.g., countries, regions) used to define the target audience for an ad.

dimension

targeting.interests

targeting.interests

User interests used to define the target audience for an ad.

dimension

targeting.maid_status_spec

targeting.maid_status_spec

dimension

targeting.product_audiences

targeting.product_audiences

Audiences defined based on user interactions with specific products, used for retargeting or product-focused campaigns.

dimension

targeting.regulated_content

targeting.regulated_content

Content that is subject to specific regulations, used to ensure compliance with advertising policies during targeting.

dimension

targeting.segments

targeting.segments

Audience segments used for targeting, which can be custom or predefined.

dimension

targeting.separated_types

targeting.separated_types

Indicates when a targeting specification type (e.g., GEO targeting) has been moved to a separate targeting_spec entity due to a large number of criteria.

dimension

targeting_reach_status

targeting_reach_status

The status of the estimated audience reach for the configured targeting criteria.

dimension

targeting_type

targeting_type

The type of targeting used for the ad (e.g., demographic, interest-based).

dimension

third_party_paid_impression_tracking_urls

third_party_paid_impression_tracking_urls

URLs provided by third-party measurement vendors to track paid impressions for an ad, allowing for external verification and reporting.

dimension

tile_media_id

tile_media_id

The unique identifier for the media asset used as a tile in a collection or story ad format.

dimension

timezone

ad_account_timezone

The timezone configured for the ad account.

dimension

top_snap_additional_format_properties

top_snap_additional_format_properties

Additional properties related to the format of the primary snap (Top Snap) within a creative.

dimension

top_snap_media_id

creative_top_snap_media_id

The unique identifier for the primary media asset (Top Snap) used in a creative.

dimension

total_impressions

total_impressions

The cumulative total of all impressions generated by the ad.

dimension

total_installs

total_installs

The overall number of app installs attributed to the ad across all device types.

metric

total_installs_app

total_installs_app

The total number of app installs across all operating systems attributed to an ad (click-through or swipe-up attribution).

metric

total_installs_app_swipe_up

total_installs_app_swipe_up

The total number of app installs across all operating systems attributed to a swipe-up action on an ad.

metric

total_installs_app_view

total_installs_app_view

The total number of app installs across all operating systems attributed to an ad, where the install occurred after a user viewed the ad (view-through attribution).

metric

total_installs_offline

total_installs_offline

The total number of offline installs across all operating systems attributed to an ad (click-through or swipe-up attribution).

metric

total_installs_offline_swipe_up

total_installs_offline_swipe_up

The total number of offline installs across all operating systems attributed to a swipe-up action on an ad.

metric

total_installs_offline_view

total_installs_offline_view

The total number of offline installs across all operating systems attributed to an ad, where the install occurred after a user viewed the ad (view-through attribution).

metric

total_installs_swipe_up

total_installs_swipe_up

The total number of app installs attributed to users swiping up on the ad across all device types.

dimension

total_installs_view

total_installs_view

The total number of app installs attributed to users who viewed the ad (view-through conversions) across all device types.

metric

total_installs_web

total_installs_web

The total number of web-based installs across all operating systems attributed to an ad (click-through or swipe-up attribution).

metric

total_installs_web_swipe_up

total_installs_web_swipe_up

The total number of web-based installs across all operating systems attributed to a swipe-up action on an ad.

metric

total_installs_web_view

total_installs_web_view

The total number of web-based installs across all operating systems attributed to an ad, where the install occurred after a user viewed the ad (view-through attribution).

metric

total_reach

total_reach

The total number of unique users who saw the ad at least once.

metric

type

ad_type

The specific type of ad creative or ad format.

dimension

unique_id

unique_id

A distinct identifier for an entity, ensuring it can be uniquely distinguished from others.

dimension

uniques

uniques

The total number of unique users who saw or interacted with the ad.

metric

url_clicks

url_clicks

The number of clicks on URLs embedded within an ad.

metric

url_macro_parameters

url_macro_parameters

Parameters used in URL macros to dynamically append campaign-specific information to webview URLs, aiding in tracking and attribution with third-party analytics platforms.

dimension

utm_autofix_permission

utm_autofix_permission

Permission setting that determines if UTM parameters in ad URLs are automatically adjusted or fixed by the platform.

dimension

video_starts

video_starts

The number of times a video ad began playing.

metric

video_views

video_views

The total number of times the video ad creative was viewed.

metric

video_views_15s

video_views_15s

The number of times the video ad creative was viewed for at least 15 seconds.

metric

video_views_time_based

video_views_time_based

Video views measured based on a specific time threshold, indicating a longer view duration.

metric

view_completion

view_completion

The percentage of users who completed viewing the ad creative.

metric

view_time_millis

view_time_millis

The total time, in milliseconds, that the ad creative was viewed.

metric

viewable_impressions

viewable_impressions

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

metric

viewable_rate

viewable_rate

The percentage of total impressions that were considered viewable.

metric

viewtime

viewtime

The total duration for which the ad was viewed.

metric

web_view_properties

web_view_properties

Properties that control the behavior and appearance of a web view embedded within an ad creative.

dimension