Snapchat Conversions
Use warehouse conversion events for Snapchat campaign measurement.
Connect this destination to write warehouse conversion events onto Snapchat Ads, for use in campaign measurement.
This destination writes to your Snapchat account and is a good fit when you want to:
- Get measurement for web, app, or offline conversions in Snapchat
- Use a warehouse table that has an event name, event time, source URL, action source, and a match identifier
- Have a Conversion API token, plus a Pixel ID and Snap App ID
This maps to GrowthLoop Syncs:
| Use it for | Syncs |
|---|---|
| Sending conversion events for measurement | ✓ |
Do not use this workflow to add contacts to a customer list. To activate customers for targeting, use Snapchat.
Prerequisites
Make sure you have:
- A Snapchat Ads Manager account. See Snapchat's Ads Manager if you need one.
- A Conversion API Key. In Ads Manager, go to Business Dashboard > Business Details > Conversion API Tokens, then click Generate Token.
- A Pixel ID for web and offline events. In Ads Manager, open Pixels and copy the pixel ID, or click Create Pixel.
- A Snap App ID for app events. In Ads Manager, open Apps, click Add an App, then copy the ID.
- A warehouse table of conversion events.
Set up Snapchat Conversions as a destination
- In GrowthLoop, click the Destinations tab on the left sidebar.
- Click New Destination in the top right corner.
- Search for Snapchat Conversions and click Add Snapchat Conversions.
- Enter the required information, then click Create.
| Field | Description |
|---|---|
| Destination Name | Name this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Snapchat Conversions". |
| Sync Frequency | Set the default sync frequency (for example, daily or weekly). You can override this setting for individual syncs. |
| Conversion API Key | The token from Conversion API Tokens. |
| Pixel ID | Required for web and offline events. GrowthLoop also uses this when it validates the connection. |
| Snap App ID | Required for app events. GrowthLoop also uses this when it validates the connection. |
GrowthLoop validates the Conversion API Key with both a web event and an app event. Enter Pixel ID and Snap App ID. Snapchat Conversions then appears in your list of connected destinations.
Create a sync in GrowthLoop
Create a sync from a warehouse table to write conversion events onto Snapchat. See Syncs for information on how to complete those steps.
Select an Object Type:
| Object | Use it for | Sync modes |
|---|---|---|
| Conversions | Web, app, or offline conversion events | Insert |
When you configure the sync:
- Connection: Select your Snapchat Conversions destination.
- Object Type: Select Conversions.
- Update Rule: Choose Insert. This destination adds new conversion events and does not update or remove previously uploaded events. See Sync behavior.
- Dataset/Table: Select the table that holds your conversion events. Use a unique event key so you do not re-send the same conversion.
- Match Field: Map Email Address, or another user identifier you will send.
After you map fields, click Save Route or Update Route. Enable the sync with the toggle at the top of the page.
When you update mappings on an existing sync, choose Updates only unless you need Back-fill. Back-fill rewrites already synced rows and can be expensive on your warehouse.
Conversion fields
| Destination field | Required | Description |
|---|---|---|
| Event Name | Yes | Event type, such as PURCHASE, SAVE, or START_CHECKOUT. See Snap's event names |
| Conversion Event Time | Yes | When the event occurred |
| Conversion Source URL | Yes | Page URL for the event, including http or https |
| Conversion Action Source | Yes | WEB, OFFLINE, or MOBILE_APP |
| Email Address | No | Map this or another identifier below. GrowthLoop hashes emails as SHA-256 |
| Phone Number | No | GrowthLoop hashes phone numbers as SHA-256 |
| Client IP Address | No | Client IP address |
| Client User Agent | No | Client user agent |
| Mobile Advertiser ID | No | IDFA or AAID |
| Snapchat Cookie (Pixel) | No | Snapchat pixel cookie |
| Snapchat Click ID | No | Snapchat click ID |
| Conversion Event ID | No | Unique ID for the event |
| Currency | No | Required when Event Name is PURCHASE |
| Value | No | Required when Event Name is PURCHASE |
| App ID | No | App identifier for MOBILE_APP events |
| Extended Device Information | No | Device metadata for MOBILE_APP events |
| Is Advertiser Tracking Enabled? | No | Tracking consent for MOBILE_APP events. Defaults to false if you do not map it |
| Integration | No | Integration label |
| Data Proccesing Options | No | Data processing options |
| Test Event Code | No | Test event code |
Map at least one identifier: Email Address, Phone Number, Client IP Address, Client User Agent, Mobile Advertiser ID, Snapchat Cookie (Pixel), or Snapchat Click ID.
For PURCHASE events, also map Currency and Value. For MOBILE_APP events, also map Mobile Advertiser ID, App ID, and Extended Device Information when you have them.
Sync behavior
| Behavior | What happens |
|---|---|
| When it runs | GrowthLoop sends the sync as a batch on the next successful run. |
| Insert | GrowthLoop adds new conversion events. Syncs do not update or remove previously uploaded events. |
| Web and offline | Events with action source WEB or OFFLINE go to the Pixel ID. |
| App | Events with action source MOBILE_APP go to the Snap App ID. |
| Match | Map Event Name, Conversion Event Time, Conversion Source URL, Conversion Action Source, and at least one user identifier. |
| Audience membership | This sync does not create a Snapchat customer list. |
| Deletes | GrowthLoop does not delete previously uploaded conversion events. |
Rows fail when a required field is missing, when no user identifier is mapped, or when a PURCHASE event is missing Currency or Value.
Confirm the export was successful
When the run finishes, confirm you can use the data in Snapchat.
- Conversion sync: Sign in to Snapchat Ads Manager, open the menu in the upper left, and look up Events Manager. Confirm the uploaded conversion events.
This workflow does not create a targeting audience.
In GrowthLoop, confirm the sync appears in the Syncs table. See Syncs for more information.
Congrats on successfully exporting to Snapchat Conversions!
Troubleshooting
These are the issues we see most often. You can always email us at [email protected] for help.
| Problem | Cause | Resolution |
|---|---|---|
| Connection fails to validate | Conversion API Key, Pixel ID, or Snap App ID is missing or wrong | Paste the token from Conversion API Tokens. Enter both Pixel ID and Snap App ID. GrowthLoop validates with a web event and an app event |
| A conversion sync fails | A required field is missing, or no user identifier is mapped | Map Event Name, Conversion Event Time, Conversion Source URL, Conversion Action Source, and at least one identifier |
| A purchase event fails | Event Name is PURCHASE and Currency or Value is blank | Map Currency and Value |
| Web or offline events fail | Pixel ID is blank, or Conversion Action Source is not WEB or OFFLINE | Enter Pixel ID on the destination. Use WEB or OFFLINE |
| App events fail | Snap App ID is blank, or Conversion Action Source is not MOBILE_APP | Enter Snap App ID on the destination. Use MOBILE_APP |
| A sync did not change Audiences | This sync writes conversion events, not customer lists | Export an audience on Snapchat to create or update a customer list |
Updated 16 days ago