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 number of times an ad was viewed for at least 2 seconds.

metric

Ad Type

Ad Type

The type of ad being run, such as Story Ad, Single Image or Video Ad, etc.

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 Name

Campaign Name

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 data for the ad.

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 targeted by an ad campaign.

dimension

Month

Month

The month associated with the reporting data.

metric

Month-Year

Month-Year

The month and year associated with the reporting data.

dimension

Placement

Placement

The specific location on the Snapchat platform where an ad is displayed (e.g., Stories, Discover).

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

Refers to the platform or location where an ad is run. In the context of Snapchat, this typically refers to the Snapchat app itself.

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 date representing the start of the week for which the data is reported.

dimension

WeekNum

WeekNum

The numerical identifier for the week within a year for which data is reported.

metric

Year

Year

The year associated with the reporting data or entity creation/update.

metric

actual_device

actual_device

The specific device model 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, allowing for multiple format types to be reported.

dimension

ad_language_{NUM}

ad_language_{NUM}

The language targeting for the ad, allowing for multiple languages to be reported.

dimension

ad_product

creative_ad_product

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

dimension

ad_scheduling_config

ad_scheduling_config

Configuration details for when the ad is scheduled to run.

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 related to ads that integrate with Snapchat Lenses.

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}

Category information associated with the ad set, allowing for multiple categories.

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 for the ad set, allowing for multiple device types.

dimension

adset_gender

adset_gender

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

dimension

adset_language

adset_language

The primary language setting for the ad set.

dimension

adset_language_{NUM}

adset_language_{NUM}

Specific language targeting for the ad set, allowing for multiple language options.

dimension

adset_market_{NUM}

adset_market_{NUM}

Market targeting for the ad set, allowing for multiple market segments.

dimension

adset_placement_{NUM}

adset_placement_{NUM}

Placement settings for the ad set, indicating where the ads will appear, allowing for multiple placements.

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}

Specific targeting criteria for the ad set, allowing for multiple targeting options.

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

dimension

agency_client_metadata

agency_client_metadata

Metadata about the client managed by an agency.

dimension

agency_representing_client

agency_representing_client

Information about the agency that represents the client.

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

Android app installs attributed to in-app ad views.

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

Android app installs attributed to offline ad views.

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

Android app installs attributed to web ad views.

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 source of the audience used for targeting (e.g., custom audience, lookalike audience).

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 type of bid used for the campaign or ad set, allowing for multiple bid types.

dimension

billing_center_id

billing_center_id

Unique identifier for the billing center associated with the ad account.

dimension

billing_event

ad_squad_billing_event

The billing event type for the ad squad, which determines when an advertiser is charged (e.g., impressions, swipes).

dimension

billing_period

billing_period

The period covered by the billing information.

dimension

billing_type

billing_type

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

dimension

brand

brand

dimension

brand_safety_config

brand_safety_config

Configuration settings related to brand safety for ad placements.

dimension

budget

budget

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

metric

buy_model

buy_model

The purchasing model used for the ad campaign (e.g., auction, reach and frequency).

dimension

buy_type

buy_type

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

dimension

buying_type

buying_type

The type of buying strategy employed for the ad (e.g., auction, reservation).

dimension

call_to_action

creative_call_to_action

The specific call to action button or text used in the ad creative.

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 for the campaign, allowing for multiple device types.

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}

A placeholder for a campaign identifier, where {NUM} indicates a specific instance or level of ID.

dimension

campaign_invoice_number

campaign_invoice_number

The invoice number associated with the campaign.

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}

A placeholder for a campaign objective, where {NUM} indicates a specific instance or level of objective details.

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}

Specific targeting criteria applied at the campaign level, allowing for multiple targeting options.

dimension

campaign_type

campaign_type

The overall type or objective of the advertising campaign.

dimension

campaign_type_{NUM}

campaign_type_{NUM}

Specific types or objectives for the advertising campaign, allowing for multiple types.

dimension

cap_and_exclusion_config

cap_and_exclusion_config

Configuration settings for frequency capping and audience exclusions in the campaign.

dimension

catalog_properties

catalog_properties

Properties related to product catalogs used in dynamic ads.

dimension

clicks

clicks

The total number of clicks on an advertisement.

metric

client_paying_invoices

client_paying_invoices

Information about the client responsible for paying invoices.

dimension

composite_properties

composite_properties

dimension

content_source_type

content_source_type

Indicates the origin or type 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_value

conversion_ad_view_value

The monetary value generated from conversions attributed to ad views.

metric

conversion_ad_view_view

conversion_ad_view_view

The number of conversions attributed to ad views from users who had previously viewed the ad (view-through conversions). This might refer to a specific view attribution window.

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_ios_installs_sk_ad_network

conversion_ios_installs_sk_ad_network

The number of iOS app installs attributed via SKAdNetwork, without specifying view-through or click-through.

metric

conversion_ios_installs_sk_ad_network_total

conversion_ios_installs_sk_ad_network_total

The total number of iOS app installs attributed via SKAdNetwork, combining all attribution methods.

metric

conversion_ios_installs_sk_ad_network_view

conversion_ios_installs_sk_ad_network_view

The number of iOS app installs attributed via SKAdNetwork specifically for view-through conversions.

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

The number of times a user logged in, attributed to a swipe-up interaction with an ad, encompassing both app and web conversions.

metric

conversion_login_view

conversion_login_view

The number of times a user logged in, attributed to viewing an ad, encompassing both app and web conversions.

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

metric

conversion_page_views_offline_swipe_up

conversion_page_views_offline_swipe_up

metric

conversion_page_views_offline_view

conversion_page_views_offline_view

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

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

metric

conversion_reserve_view

conversion_reserve_view

The number of reservation events attributed to 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

metric

conversion_save_offline_swipe_up

conversion_save_offline_swipe_up

metric

conversion_save_offline_view

conversion_save_offline_view

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

metric

conversion_searches_offline_swipe_up

conversion_searches_offline_swipe_up

metric

conversion_searches_offline_view

conversion_searches_offline_view

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

metric

conversion_share_offline_swipe_up

conversion_share_offline_swipe_up

metric

conversion_share_offline_view

conversion_share_offline_view

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

metric

conversion_sign_ups_offline_swipe_up

conversion_sign_ups_offline_swipe_up

metric

conversion_sign_ups_offline_view

conversion_sign_ups_offline_view

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

metric

conversion_spend_credits_app

conversion_spend_credits_app

metric

conversion_spend_credits_app_swipe_up

conversion_spend_credits_app_swipe_up

metric

conversion_spend_credits_app_view

conversion_spend_credits_app_view

metric

conversion_spend_credits_offline

conversion_spend_credits_offline

metric

conversion_spend_credits_offline_swipe_up

conversion_spend_credits_offline_swipe_up

metric

conversion_spend_credits_offline_view

conversion_spend_credits_offline_view

metric

conversion_spend_credits_swipe_up

conversion_spend_credits_swipe_up

metric

conversion_spend_credits_view

conversion_spend_credits_view

metric

conversion_spend_credits_web

conversion_spend_credits_web

metric

conversion_spend_credits_web_swipe_up

conversion_spend_credits_web_swipe_up

metric

conversion_spend_credits_web_view

conversion_spend_credits_web_view

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

metric

conversion_start_checkout_offline_swipe_up

conversion_start_checkout_offline_swipe_up

metric

conversion_start_checkout_offline_view

conversion_start_checkout_offline_view

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

metric

conversion_start_trial_app

conversion_start_trial_app

metric

conversion_start_trial_app_swipe_up

conversion_start_trial_app_swipe_up

metric

conversion_start_trial_app_view

conversion_start_trial_app_view

metric

conversion_start_trial_offline

conversion_start_trial_offline

metric

conversion_start_trial_offline_swipe_up

conversion_start_trial_offline_swipe_up

metric

conversion_start_trial_offline_view

conversion_start_trial_offline_view

metric

conversion_start_trial_swipe_up

conversion_start_trial_swipe_up

metric

conversion_start_trial_view

conversion_start_trial_view

metric

conversion_start_trial_web

conversion_start_trial_web

metric

conversion_start_trial_web_swipe_up

conversion_start_trial_web_swipe_up

metric

conversion_start_trial_web_view

conversion_start_trial_web_view

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

metric

conversion_subscribe_offline_swipe_up

conversion_subscribe_offline_swipe_up

metric

conversion_subscribe_offline_view

conversion_subscribe_offline_view

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

metric

conversion_view_content_offline_swipe_up

conversion_view_content_offline_swipe_up

metric

conversion_view_content_offline_view

conversion_view_content_offline_view

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

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_structure

cost_structure

Details about how costs are structured for the advertising campaign.

dimension

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 or progress of an entity’s creation process.

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 associated with the creative asset.

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

dimension

creative_duration

creative_duration

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

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

dimension

creator_partnership_type

creator_partnership_type

dimension

cta_color_display_mode

cta_color_display_mode

The display mode or style for the call-to-action button’s color in an ad 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

metric

custom_event_{NUM}_offline_swipe_up

custom_event_{NUM}_offline_swipe_up

metric

custom_event_{NUM}_offline_view

custom_event_{NUM}_offline_view

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

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 the data is reported.

dimension

delivery_constraint

delivery_constraint

Constraints applied to the delivery of the ad, such as pacing or frequency caps.

dimension

delivery_constraint_sub_type

delivery_constraint_sub_type

A more specific type of delivery constraint.

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 specifically 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 related to how an ad creative is dynamically rendered, possibly 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 operating environment and device type 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

event_sources

event_sources

The source(s) from which conversion events are being tracked (e.g., Snap Pixel, Conversions API).

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

dimension

forced_view_eligibility

forced_view_eligibility

Indicates whether an ad creative is eligible for a forced view placement (e.g., non-skippable ads).

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 for the ad account or campaign.

dimension

funding_source_ids

funding_source_ids

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

dimension

funnel_stage

funnel_stage

The stage of the marketing funnel that the campaign is targeting (e.g., Awareness, Consideration, Conversion).

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

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 the interest category used for targeting in an ad campaign. This is typically used to segment audiences based on their declared interests.

dimension

inventory_type

inventory_type

The type of ad inventory where the ads are displayed (e.g., Snapchat Stories, Shows).

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 exchange rate used to convert local currency (LC) amounts to US Dollars (USD).

metric

lens_package_metadata

lens_package_metadata

Metadata related to an AR Lens package used in an ad creative, possibly including version or properties.

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 when a specific line item within an invoice or other document was last modified.

dimension

lob_{NUM}

lob_{NUM}

Line of business associated with the advertiser or campaign, allowing for multiple LOBs.

dimension

market_name_{NUM}

market_name_{NUM}

The name of the market targeted by the campaign, allowing for multiple markets.

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

Information regarding where and how a particular media asset is being used across ad creatives or campaigns.

dimension

name

organization_name

The name of the organization associated with the ad account.

dimension

national_or_local

national_or_local

Indicates whether the campaign targets a national or local audience.

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 updated version (v2) of campaign objectives.

dimension

offer_disclaimer_id

offer_disclaimer_id

The unique identifier for a legal disclaimer associated with an offer presented in 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 properties used for an ad campaign or ad squad.

metric

pacing_type

pacing_type

The budget pacing strategy used for the campaign (e.g., standard, accelerated).

dimension

packaging_status

packaging_status

The status of the packaging process for a creative asset or other deliverable.

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

pmp_channel

pmp_channel

The Private Marketplace (PMP) channel through which the ad inventory was purchased.

dimension

position_frequency

position_frequency

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

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 the ad after it has been created.

dimension

preview_creative_id

creative_preview_creative_id

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

dimension

preview_properties

preview_properties

Properties related to how an ad creative or campaign is displayed in a preview.

dimension

primary_profile

primary_profile

dimension

primary_target

primary_target

The main audience segment or objective targeted by the campaign.

dimension

product_properties

product_properties

Properties related to the specific product being advertised.

dimension

profile_properties

profile_properties

dimension

quarter

quarter

The calendar quarter for which the data is reported.

dimension

quarters

quarters

The financial quarter (e.g., Q1, Q2) for which the data is 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

The estimated rate for reach and frequency campaigns, often expressed in micro-units.

dimension

reach_and_frequency_status

reach_and_frequency_status

The current status of a reach and frequency campaign.

dimension

reach_goal

reach_goal

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

dimension

registration

registration

Metrics related to user registrations as a conversion event.

metric

regulations

regulations

Information about regulatory compliance or restrictions applicable to an ad campaign or creative.

dimension

render_type

render_type

The method or type of rendering used for an ad creative.

dimension

reserved_end_target_date

reserved_end_target_date

The target end date for a reserved (fixed-price) campaign.

dimension

reserved_rate_micro

reserved_rate_micro

The reserved rate for impressions or other metrics in a guaranteed buy, often in micro-units.

dimension

reserved_start_target_date

reserved_start_target_date

The target start date for a reserved (fixed-price) campaign.

dimension

reserved_status

reserved_status

The current status of a reserved (guaranteed delivery) campaign.

dimension

reserved_type

reserved_type

Indicates if an ad inventory or placement is reserved, typically for programmatic guaranteed deals.

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, explaining why it might be pending, approved, or rejected.

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

dimension

share_of_voice

share_of_voice

The percentage of total impressions within a specific audience or market that an advertiser’s campaign captured.

dimension

shareable

creative_shareable

Indicates whether the creative content is shareable by users.

dimension

shares

shares

The total number of times the ad creative was shared by users.

metric

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 profile IDs of users who hosted the source Snaps used in an ad, relevant for creator partnerships.

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

subtitles

subtitles

Information about subtitles or captions included in the ad creative.

dimension

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 is the target of an ad campaign.

dimension

targeting

ad_squad_targeting

A collection of parameters defining the audience an ad squad aims to reach (e.g., demographics, interests, locations).

dimension

targeting.app_install_states

targeting.app_install_states

Targeting based on the installation status of specific apps on a user’s device.

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.locations

targeting.locations

Geographical location targeting criteria, such as countries, regions, or cities.

dimension

targeting.maid_status_spec

targeting.maid_status_spec

dimension

targeting.product_audiences

targeting.product_audiences

Specific product-based audience segments used for targeting.

dimension

targeting.regulated_content

targeting.regulated_content

Information about whether the ad content is subject to specific regulations, potentially impacting targeting options.

dimension

targeting.segments

targeting.segments

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

dimension

targeting.separated_types

targeting.separated_types

dimension

targeting_reach_status

targeting_reach_status

The status of the estimated audience reach based on targeting settings.

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 for third-party services to track paid impressions.

dimension

tile_media_id

tile_media_id

The unique identifier for the media asset used as a tile or thumbnail for an ad.

dimension

timezone

ad_account_timezone

The timezone configured for the ad account.

dimension

top_snap_additional_format_properties

top_snap_additional_format_properties

Additional formatting properties specific to the ‘top Snap’ creative within an ad, typically the initial visible part.

dimension

top_snap_crop_position

creative_top_snap_crop_position

The crop position of the ‘top Snap’ image or video within the creative.

dimension

top_snap_media_id

creative_top_snap_media_id

The unique identifier for the media asset used as the ‘top Snap’ in the 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 that can be dynamically inserted into URLs for tracking purposes.

dimension

utm_autofix_permission

utm_autofix_permission

Permission setting for whether UTM parameters in ad URLs can be automatically fixed or adjusted.

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 related to the in-app web view experience when a user interacts with an ad.

dimension

week_no

week_no

The week number within a year for which the data is reported.

metric