[UPDATED] Snapchat Data Connector

Setting Up Snapchat Ads

 

Updates [November 2021]:

  • Additional breakdowns available: DMA and Region (available to choose instead of Country)
  • Campaign Properties now available: Campaign Status, Campaign Objective, Bid Type, Original Bid Amount
  • Additional metrics from Snapchat can be pulled by creating conversion events (see instructions below).

Quick Details

Data Connector Technology API (Snapchat API v. 1 - see documentation)
Data breakdown (segmentation)

Your data is broken down by Campaign, Sub-Campaign ("Ad Squad"), Platform, and Creative.

In addition, Snapchat lets you choose one of the following breakdowns:

  • Country (default)
  • DMA (USA only)
  • Region
Time zone The time zone configured for your ad account in Snapchat.
Is data available on the creative level? Yes
Does Singular show your creative assets?

Yes, for the following Snapchat ad types:

  • APP_INSTALL
  • COMPOSITE and DEEP_LINK
  • FILTER
  • WEB_VIEW
  • LENS_DEEP_LINK
  • LENS_APP_INSTALL

Creative assets are not available for other ad types.

Data Mapping

  • Singular’s Sub-Campaign corresponds to Snapchat's Ad Squad.
  • Singular's Creative corresponds to Snapchat's Ad.

For descriptions of all fields, see the Singular Metrics and Dimensions Glossary.

Field in Singular UI Field in Singular API Field in Network
Dimensions
Account ID adn_account_id Ad Account ID
Account Name adn_account_name Ad Account Name
App app App Name
App Site ID app_site_id Either 'iOS App ID" or "Google Play Store ID"
Bid Type
bid_type

optimization_goal

Campaign Objective
campaign_objective

Campaign Objective

Campaign Status
campaign_status

campaign status

Country country_field "Country Code" from the Targeting Spec for the Ad Squad
Creative ID creative_id Ad ID
Creative Name creative_name Ad Name
Date date_field Date
DMA ID
dma_id_field dma
DMA Name
dma_name_field  
Network Campaign ID adn_campaign_id Campaign ID
Network Campaign Name adn_campaign_name Campaign Name
Network Creative ID adn_creative_id Ad ID
Network Creative Name adn_creative_name Ad Name
Network Sub Campaign ID adn_sub_campaign_id Ad Squad ID
Network Sub Campaign Name adn_sub_campaign_name Ad Squad Name
Original Bid Amount original_bid_amount bid_micro
Placement
placement
Placement_v2.snapchat_positions (if placement_v2.config == “AUTOMATIC” we hard coding - ["INTERSTITIAL_USER", "INTERSTITIAL_CONTENT","INSTREAM", "FEED", "GAMES"]
Platform platform OS Type
Public Id site_public_id iOS App ID
Google Play Store ID
Region
region_field

region (in Region breakdown)

regions (in DMA breakdown - it's possible to have multiple regions in the same DMA)

Sub Campaign ID sub_campaign_id Ad Squad ID
Sub Campaign Name sub_campaign_name Ad Squad Name
Metrics
Cost adn_cost Spend
Network Clicks adn_clicks Swipes
Network Impressions adn_impressions Impressions
Network Installs adn_installs Total Installs
Original Cost adn_original_cost Spend
Original Currency adn_original_currency Pulled from the Ad Account's Currency
Video Views   Video Views
Video Views 25%   Video Views to 25% (Quartile 1)
Video Views 50%   Video Views to 50% (Quartile 2)
Video Views 75%   Video Views to 75% (Quartile 3)
Completed Video Views   View Completion

Special Setup Instructions

In addition to the metrics that Singular pulls from Snapchat by default, you can pull any Snapchat metric (see list) by creating a conversion event in Singular.

To create a conversion event:

  1. In Singular, go to Settings > Events. If you have both Custom Events and Conversion Events tabs, select Conversion Events.
  2. Click New Event.
  3. In the Snapchat dropdown, select the desired metric.

    The next day, when Singular pulls daily data for your account, it will pull completions as well.

  4. After the new event is populated with some data, run a report in the Reports page, and choose the conversion event you created from Events dropdown.

snapchat_conversion_event.png

Was this article helpful?