Overview

SnapSnap

Branch can help track your Snap Ad campaigns through our integration with Snap.

Snap is a self-attributing network (SAN).

Snap campaign tracking can show you how many installs and conversion events were attributed to Snap, allowing you to make informed decisions with your advertising dollars.

Branch and Snap supports mobile app conversion attribution for the following campaign objectives:

  • Drive Traffic to App

Prerequisites

Before you begin, be sure the following is confirmed.

  • First, the Branch SDK must be integrated into your app, for both iOS and Android.
  • You must also collect the IDFA on iOS, or the AAID on Android. For specifics, refer to the set up guide for iOS and Android respectively.
  • Make sure to track all necessary events through the SDKs.

Authenticate with Snap

  1. Navigate to the partner management tab and search for Snap.
  2. Click Log in with Snapchat.
  3. Read and accept the Snap Advertiser Agreement terms if you haven't already.

📘

Branch Admin Required

You must be an Admin on the Branch account in order to accept the Snap Advertiser Agreement terms. You must accept the terms to track your Snap advertising.

  1. Log in to Snap. Once logged in, accept permissions and click Continue .

🚧

Warning

Due to an issue with Snap Login, if you see the Snap "My Account" screen after logging in, you'll need to manually return to the Branch dashboard at https://dashboard.branch.io/ads/partner-management/a_snap?tab=settings. Click Log in with Snapchat again in the same browser, and you should see the Continue button instead of the login screen.

  1. Click Continue to return to the Branch dashboard.
  1. Confirm the ad accounts that you would like to track.
  1. Enter your Snap App ID. To use different IDs for your Android and iOS apps, check the Use different iOS and Android app IDs.

Note: The Snap App ID is optional. It is not required for authentication & attribution to work.

  1. Click Save to finish.

📘

Connecting Multiple Accounts

All SANs - including Snap - accept multiple accounts. However, only a single Branch user can authenticate the integration. This means that the single user must have access to all of the accounts you wish to connect.

Note: The Snap measurement integration requires you to have configured your Android and iOS apps on the Link Settings page. If those have not been set up, you will not be able to track ads and you may see a validation warning.

Snap App ID

Snap App IDs are generated by an advertiser in Snap’s Business Manager or when they register their app for Snap at https://kit.snapchat.com/ and tied to the advertiser’s organization ID. Snap App IDs are associated to an advertiser’s organization in Snap’s ad platform. If the Snap App ID is generated in Snap Kit, it will need to be linked to their organization in Business Manager.

Advertisers will only be able to build mobile app custom audiences from their mobile measurement events inside Snap’s ad platform from postback events that have their Snap App ID(s).

Learn more about the Snap App ID.

Snap Audience Network

Snap Audience Network (SDK and RTB) is a network where advertisers can expand the reach of their campaigns beyond Snapchat. Conversion attribution will work the same as Snapchat conversion attribution and advertisers will have the ability to run a single campaign across both Snapchat and
the Snap Audience Network (SAN).

Learn more about Snap Custom Audiences.

Using Branch Links in Snap Campaigns

Branch links are not necessary for attribution, however, you can insert Branch links into the Drive Traffic to App campaign type if you are trying to use deferred deeplinking (send users to a specific page after install+launch).

To use Branch links in your Drive Traffic to App campaigns:

  1. Generate/fetch your Branch link from the Branch dashboard.
  2. Set up your Snap campaign, selecting Drive Traffic to App.
    imageimage
  3. On the Build Your Ads page:
    1. Paste your Branch link into the DEEPLINK URI field.
    2. Select Web Site as the FALLBACK TYPE to ensure deferred deep linking via your Branch link.
      imageimage
  4. Finish building your Snap campaign.

🚧

Web Site as Fallback Required for Deferred Deep Linking

Please ensure you choose Web Site as the FALLBACK TYPE and inserting the same Branch link into the provided field. If you choose App Install as the FALLBACK TYPE, users not properly routed will be sent to the App Store without the Branch link and deferred deep linking will not occur.

📘

Agency-Managed Campaigns

View Attribution on Dashboard

All attribution can be visible on the Branch dashboard summary page. All installs and opens registered from this channel will automatically be tagged with Ad Partner: Snap. Other analytics tags will reflect the campaign, ad squad and ad names you set up in the Snap Ads dashboard.

Note that these stats are limited to the date range at the top of the page. You can expand the range if you'd like.

Data Mapping

Event Names

Branch supports sending Standard and Custom Events{target:"_blank"} to Snap. Here are the mappings for Branch events to Snap events.

By default, all events in the below table will be sent to Snap.

Branch Event Name

Snap Event Name

INSTALL

APP_INSTALL

VIEW_ITEM

VIEW_CONTENT

ADD_TO_CART

ADD_CART

INITIATE_PURCHASE

START_CHECKOUT

PURCHASE

PURCHASE

ADD_PAYMENT_INFO

ADD_BILLING

COMPLETE_REGISTRATION

SIGN_UP

SEARCH

SEARCH

ACHIEVE_LEVEL

LEVEL_COMPLETE`

OPEN / REINSTALL

APP_OPEN

SUBSCRIBE

SUBSCRIBE

CLICK_AD

AD_CLICK

VIEW_AD

AD_VIEW

COMPLETE_TUTORIAL

COMPLETE_TUTORIAL

INVITE

INVITE

LOGIN

LOGIN

SHARE

SHARE

RESERVE

RESERVE

UNLOCK_ACHIEVEMENT

ACHIEVEMENT_UNLOCKED

ADD_TO_WISHLIST

ADD_TO_WISHLIST

SPEND_CREDITS

SPENT_CREDITS

RATE

RATE

START_TRIAL

START_TRIAL

VIEW_ITEMS

LIST_VIEW

custom

CUSTOM_EVENT_1

custom

CUSTOM_EVENT_2

custom

CUSTOM_EVENT_3

custom

CUSTOM_EVENT_4

custom

CUSTOM_EVENT_5

The below events can be sent to Snap by registering custom events {target:"_blank"} that exactly match the Branch custom event name below. Snap does not accept other custom events, so they will not be sent to Snap.

Branch custom event nameSnap event name
SAVESAVE
PAGE_VIEWPAGE_VIEW

Campaign Data

Branch maps the following data fields from Snap to Branch.

Branch DataSnap Data
~campaigncampaign_name
~campaign_idcampaign_id
~ad_set_namead_squad_name
~ad_set_idad_squad_id
~ad_namead_name
~ad_idad_id

Metadata

Branch metadataSnap MetadataDescription
SKU (list of)item_idsInternational Article Number (EAN) when applicable, or other product or category identifier.
Quantitynumber_itemsNumber of items.
revenuepriceMonetary value of the conversion event in float format. Please do not include currency symbols or commas as part of the value. (ex. single value: price=34.24, multiple values: price=99.43,45.34;34.27)
currency_codecurrencyCurrency in standard ISO 4217 code (ex. EUR, USD, JPY). Required if price is included.
transactionIDtransaction_idTransaction ID.
searchQuerysearch_stringThe text string that was searched.
custom_data.levellevelLevel in the game.

Cost Data

Troubleshooting

Discrepancies

  • Snap Ads Manager time zones are set at the time your ad account is created. You can see your Snap time zone in your Snap Ad Account Settings, but you cannot change it. You can change your Branch dashboard time zone in Account Settings to match.

  • Verify your Snap attribution windows match your Branch attribution windows. Ask your Snap account manager for your attribution windows. Your Branch windows are visible either in Link Settings (global windows) or in the Attribution Windows section of the Snap entry in Ads Partner Manager. Snap windows can be configured under "Customize Columns" in the Snap UI.

    Snap - Attribution WindowsSnap - Attribution Windows

  • When deep linking, create a link via the Branch dashboard. If you are running an app campaign, please ensure your link has %24deeplink_no_attribution=true as a query parameter to remove that link's ability to claim attribution, otherwise the link may claim attribution over the SAN claim. The link will still deep link.

  • Snap's reporting API does not provide any "compare by" functionality outside of the ads analytics tags. So, you cannot compare Snap click + impression data by platform, OS or country, for example.

Exporting Snap Data

You can see analytics on impressions, clicks, installs, opens and conversion events on various pages of the Branch Dashboard.

We cannot send device-level Snap attribution data to third parties. Thus we cannot send events attributed to Snap via Data Integrations. Please instead consider analyzing this data in-house (using Webhooks, the Daily Export API, or CSV Exports), or using the Branch Dashboard for all of your analytics and attribution needs.

Updated 4 days ago



Snap


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.