> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Snapchat Conversions
> Send web and offline conversion events from MoEngage to Snapchat's Conversions API to attribute conversions and optimize ad spend.
# Introduction
The Snapchat Conversions integration establishes a secure, server-to-server (S2S) connection between MoEngage and Snapchat. By bypassing browser-side obstacles such as cookie restrictions and ad blockers, this integration ensures a consistent and high-quality data stream for accurate attribution.
MoEngage supports the following distinct connectors for Snapchat:
* [**Snapchat Web Conversions**](#integration-with-snapchat-web-conversions): Tracks purchase, checkout, and other on-site conversion events that occur on your website.
* [**Snapchat Offline Conversions**](#integration-with-snapchat-offline-conversions): Tracks conversions that happen outside your website in physical stores, over the phone, via email, or through other offline channels.
## Use Cases
Integrating Snapchat Conversions with MoEngage allows you to sync event data to support the following use cases:
* **Signal resilience**: Recover "lost" conversions typically blocked by browser privacy settings or ad-blocking software.
* **Offline to online attribution**: Bridge the gap between physical storefront transactions and digital ad exposure to measure total ROI.
* **Return on Ad Spend (ROAS) optimization**: Provide high-quality, real-time data to machine-learning algorithms of Snapchat and Meta to lower your Cost Per Acquisition (CPA) and improve ad delivery.
**Prerequisites**
Before setting up either connector, ensure you have the following from your [Snapchat Ads Manager:](https://businesshelp.snapchat.com/s/article/set-up-snapchat?language=en_US#:~:text=in%20to%20Ads-,Manager,-using%20your%20preferred)
* **Snapchat Pixel ID**: Your unique Pixel ID that identifies the Snapchat Pixel associated with your ad account.
* **Access Token**: The Bearer token used to authenticate MoEngage's requests to the Snapchat Conversions API.
* **Active MoEngage account**: Contact your MoEngage CSM if Connected Apps is not enabled.
# Integration with Snapchat Web Conversions
## Step 1: Generate Credentials in Snapchat
To ensure a stable connection, you must retrieve your Pixel ID and generate an Access Token in Snapchat Ads Manager.
### Step 1.1: Retrieve the Snapchat Pixel ID
1. Log in to [Snapchat Ads Manager](https://businesshelp.snapchat.com/s/article/set-up-snapchat?language=en_US#:~:text=in%20to%20Ads-,Manager,-using%20your%20preferred).
2. On the left navigation menu, click **Events Manager**.
3. Select your Pixel. The **Pixel ID** is displayed at the top of the Pixel detail page.
4. Copy the Pixel ID for use in [Step 2](#step-2-connect-snapchat-web-conversions-in-the-app-marketplace).Â
### Step 1.2: Generate a Permanent Access Token
**Long Lived Token**: This method of authentication does not need the 3-legged OAuth flow and does not expire.
1. To find your Conversions API Token, go to the **Business Details** view on your Snap dashboard. You will see a section called Conversions API Tokens. Please note that you must be an Organization Admin to view this section of the page.
2. Generate a new access token or copy an existing one.
**Note**: Save this token immediately (for security, handle the token as a password). It is not displayed again.
## Step 2: Connect Snapchat Web Conversions in the App Marketplace
To connect the Snapchat Web Conversions in the App marketplace, perform the following steps:
1. On the left navigation menu in the MoEngage UI, click **App marketplace**.
2. On the **App marketplace** page, search for **Snapchat Conversions**.
3. Click the **Snapchat Conversions** tile.
4. On the **Snapchat Conversions** page, click the **Integrate** tab.
5. Click the down arrow key, and then click **Snapchat Conversions API - Web Events**.
6. Enter the following details:
| Field | Required | Description |
| --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Connection name | Yes | A unique internal name (for example, Snapchat\_Web\_Conversions). |
| Access Token | Yes | This is the permanent access token generated in Snapchat Ads Manager (from [Step 1.2](/partner-guide/retargeting-and-audience-sync/ad-conversions/snapchat-conversions#step-1-2-generate-a-permanent-access-token)). |
| Pixel ID | Yes | Your unique Snapchat Pixel ID (retrieved in [Step 1.1](/partner-guide/retargeting-and-audience-sync/ad-conversions/snapchat-conversions#step-1-1-retrieve-the-snapchat-pixel-id)). |
7. Click **Connect**. Your integration is now authorized.
## Step 3: Create a Snapchat Web Conversions Campaign
To create a Snapchat Web Conversions campaign, perform the following steps:
1. On the left navigation menu in the MoEngage UI, click **Engage**, and then click **Campaigns**.
2. On the **All campaigns** page, click **+ Create campaign**.
3. In the **Create campaign** dialog box, under **Connected Apps**, click **Snapchat Conversions**, and then click the most suitable delivery type.
4. In **Step 1** (Target Users), select your audience.
5. In **Step 2** (Content), select your Connector (**Snapchat Conversions API - Web Events**) and your created connection.
6. Under **Conversion Goals**, enter the following fields:
| Field | Required | Description |
| ----------------- | -------- | ----------------------------------------------------------------------------- |
| Event Name | Yes | A standard Snapchat conversion event (for example, Purchase, Add to Cart). |
| Transaction ID | No | A unique ID is used for deduplication (for example, `{{Event['order_id']}}`). |
| Snapchat Click ID | No | Parameter used for matching events to ad clicks. |
| Conversion Value | No | The numeric value of the transaction. |
| Currency Code | No | The ISO 4217 currency code (for example, USD). |
| Event Source URL | No | The URL of the page where the conversion occurred. |
**Attribution**
MoEngage uses specific customer PII fields to attribute conversion events to Snapchat users. These fields are automatically populated from the MoEngage user profile and secured with SHA-256 hashing before transmission—ensuring raw values are never shared.
| Field | Description |
| ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Email | This is automatically populated from the user's *Email (Standard)* attribute in MoEngage. This is hashed with SHA-256 before being sent to Snapchat for attribution. |
| Phone | This is automatically populated from the user's *Mobile Number (Standard)* attribute in MoEngage. The value is normalized to E.164 format and hashed with SHA-256 before transmission. |
Providing at least one attribution signal (Email or Phone) significantly improves match rates and overall attribution accuracy. For the most precise results, it is recommended to provide both.
7. Your campaign is now ready to be tested and sent. Using the *Test* functionality, you can also test your connector configuration.
If your test user successfully receives the message, your setup is complete.
8. Publish the campaign.
# Integration with Snapchat Offline Conversions
## Step 1: Generate credentials in Snapchat
Follow the same process as the Web Conversions setup to retrieve your Pixel ID (from [Step 1.1](/partner-guide/retargeting-and-audience-sync/ad-conversions/snapchat-conversions#step-1-1-retrieve-the-snapchat-pixel-id)) and Access Token (from [Step 1.2](/partner-guide/retargeting-and-audience-sync/ad-conversions/snapchat-conversions#step-1-2-generate-a-permanent-access-token)).
## Step 2: Connect Snapchat Offline Conversions in the App marketplace
1. On the left navigation menu in the MoEngage UI, click **App marketplace**.
2. On the **App marketplace** page, search for **Snapchat Conversions**.
3. Click the **Snapchat Conversions** tile.
4. On the **Snapchat Conversions** page, click the **Integrate** tab.
5. Click the down arrow key, and then click **Snapchat Conversions API - Offline Events**.
6. Enter the following details:
| Field | Required | Description |
| --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Connection name | Yes | A unique internal name (for example, Snapchat\_Web\_Conversions). |
| Access Token | Yes | This is the permanent access token generated in Snapchat Ads Manager (from [Step 1.2](/partner-guide/retargeting-and-audience-sync/ad-conversions/snapchat-conversions#step-1-2-generate-a-permanent-access-token)). |
| Pixel ID | Yes | Your unique Snapchat Pixel ID (retrieved in [Step 1.1](/partner-guide/retargeting-and-audience-sync/ad-conversions/snapchat-conversions#step-1-1-retrieve-the-snapchat-pixel-id)). |
7. Click **Connect**. Your integration is now authorized.
## Step 3: Create a Snapchat Offline Conversions Campaign
1. On the left navigation menu in the MoEngage UI, click **Engage**, and then click **Campaigns**.
2. On the **All campaigns** page, click **+ Create campaign**.
3. In the **Create campaign** dialog box, under **Connected Apps**, click **Snapchat Conversions**, and then click the most suitable delivery type.
4. In **Step 1** (Target Users), select your audience.
5. In **Step 2** (Content), select your Connector (**Snapchat Conversions API - Offline Events**) and your created connection.
6. Under **Conversion Goals**, enter the following fields:
| Field | Required | Description |
| ---------------- | -------- | -------------------------------------------------------------------------------------------------- |
| Event Name | Yes | A standard Snapchat conversion event (for example, Purchase, Add to Cart). |
| Action Source | Yes | The offline channel where the conversion occurred (for example, Physical Store, Phone Call, Chat). |
| Event ID | No | The unique ID used for deduplication (for example, `{{Event['order_id']}}`). |
| Conversion Value | No | The numeric value of the transaction. |
| Currency Code | No | The ISO 4217 currency code (for example, USD). |
| Event Tag | No | A custom label to sub-categorize the offline event (for example, 'flagship-store'). |
**Attribution**
At least one of Email or Phone must be provided for offline conversion events. Snapchat requires a customer identity signal to attribute offline conversions to ad exposure. Both fields are automatically populated from the MoEngage user profile and secured with SHA-256 hashing before transmission.
| Field | Description |
| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Email | This is automatically populated from the user's *Email (Standard)* attribute in MoEngage. This is required if a phone is not provided and is hashed with SHA-256 before being sent to Snapchat for attribution. |
| Phone | This is automatically populated from the user's *Mobile Number (Standard)* attribute in MoEngage. This is required if an email is not provided. It is normalized to E.164 format and hashed with SHA-256 before being sent to Snapchat for attribution. |
For offline events, Snapchat requires at least one attribution signal. Campaigns where neither Email nor Phone is available on the user profile will not result in a successful attribution and will lead to unattributed conversions.
7. Your campaign is now ready to be tested and sent. Using the *Test* functionality, you can also test your connector configuration.
If your test user successfully receives the message, your setup is complete.
8. Publish the campaign.
## Supported Conversion Events
Both the Web and Offline connectors support the following standard Snapchat conversion events:
| Event Name (MoEngage) | Snapchat Event Key |
| --------------------- | -------------------- |
| Purchase | Purchase (PURCHASE) |
| Add to Cart | ADD\_TO\_CART |
| View Content | VIEW\_CONTENT |
| Initiate Checkout | (INITIATE\_CHECKOUT) |
| Add to Wishlist | (ADD\_TO\_WISHLIST) |
| Sign Up | (SIGN\_UP) |
| Subscribe | (SUBSCRIBE) |
| Start Trial | (START\_TRIAL) |
| Download | (DOWNLOAD) |
| List | (LIST) |
| Other | (OTHER) |
**Information**
* **Data privacy**: MoEngage automatically hashes customer PII (Email and Phone) with SHA-256 before transmission to Snapchat. Raw values are never sent.
* **Event timestamp**: Event time is automatically set to the current timestamp at the time of sending and cannot be backdated.
* **Matching signals**: At least one matching signal must be present on the user profile. Events without a matching signal may result in zero match rates in reporting.
* **Default event name**: Purchase is the default event type for both connectors. If your campaign goal is a non-purchase conversion (for example, Sign Up or Download), remember to update the **Event Name** field in Step 3 of the campaign creation process for both web and offline conversions.