Set up data connector
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:
|
| 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:
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.
- Snapchat's video_views_15s can be pulled, but you will not be able to use a data breakdown.
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 | ||
| Average Frequency |
frequency | frequency |
| 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 |
| Reach |
reach | total_reach |
| Video Views | video_views | video_views |
| Video Views 25% | video_views_25pct | quartile_1 (Video Views to 25%) |
| Video Views 50% | video_views_50pct | quartile_2 (Video Views to 50%) |
| Video Views 75% | video_views_75pct | quartile_3 (Video Views to 75%) |
| Completed Video Views | 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:
- In Singular, go to Settings > Events. If you have both Custom Events and Conversion Events tabs, select Conversion Events.
- Click New Event.
-
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.
- 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.
