Home
Integrations Library
Media Buying Integrations
Snapchat Integration
Snapchat Integration

SERIES:

Snapchat Integration

Learn how to set up Snapchat Conversions API integration in Everflow to track conversions and send user data including required Snapchat Click ID (ScCid) for campaign optimization.

How to Set Up Snapchat Integration

This guide walks you through setting up Snapchat's Conversions API (CAPI) integration in Everflow to track conversions and optimize your campaigns.

What This Integration Does
  • Tracks Conversions: Sends conversion data directly to Snapchat via their API
  • Improves Targeting: Helps Snapchat optimize your campaigns with first-party data
  • Better Attribution: Uses Snapchat Click ID for accurate conversion tracking
  • Real-time Data: Passes conversion events as they happen

Before You Begin (Prerequisites)

Stop! Before attempting this setup, ensure you have the following items ready. Missing any of these will cause the integration to fail.

Before You Begin (Prerequisites)

Stop! Before attempting this setup, ensure you have the following items ready. Missing any of these will cause the integration to fail.

Prerequisites Checklist

Critical Compliance Warning: Use Direct Linking

We strongly recommend using Direct Linking for all Snapchat campaigns.

Snapchat requires the ScCid (Snapchat Click ID) to be passed seamlessly from the ad click to the landing page. Traditional Redirect Links often strip this parameter or trigger "flagging" mechanisms in Snapchat's ad review process, risking account suspension. Direct Linking ensures the ScCid lands on the page and is captured by the JavaScript SDK.

Step-By-Step Guide

1 Set Up a Dedicated Partner

Even if you are managing the media buy internally, you must create a dedicated "Partner" in Everflow to represent Snapchat. This isolates the traffic and ensures accurate reporting.

Go to Partners → Add Partner and create a new Partner named "Snapchat Media Buying". Once created, click Manage on the partner, then click the three dots and select Impersonate. You are now viewing the portal as the partner. Navigate to Company Settings → Integrations. Select Snapchat and click Connect Integration. Enter your integration details: Name: Give your integration a name (e.g., "Snapchat CAPI"). Access Token: Paste your Snapchat access token here.
2 Core Platform Setup

Now, switch back to your Admin portal to configure the data mapping.

Navigate to Integrations → Media Buying → Snapchat. Click Connect Integration. Basic Settings: Delivery Method: Select "Snapchat". Snapchat Integration: Choose "Affiliate Integration". Snapchat App/Pixel ID: Enter your ID here. Snapchat Event Name: Select "Subscribe", "Purchase", or your preferred optimization event. Event Source URL: Enter your website URL. User Data Fields (Required Macros):

You must map the following macros. These tell Everflow to look for this data in the click URL and pass it to Snapchat (hashed for privacy).

Phone: Set to {phone} macro. Email: Set to {email} macro. Snapchat Click ID (ScCid): Set to {ScCid} macro.
3 Postback Configuration Go to Partners → Postbacks → Add Postback. Partner: Select the "Snapchat Media Buying" partner you created in Step 1. Delivery Method: Select "Snapchat". Transaction ID: Leave as {transaction_id}. 4 Install the JS SDK & Click Script

This is the most critical step. Since you are using Direct Linking, the user lands directly on your page. You must install a script that "grabs" the ScCid from the URL and saves it.

Part A: Get Your Tracking Domain

Go to Control Center > Configuration > Domains. Note your active Tracking Domain (e.g., track.mybrand.com).

Part B: Implement the Code

Copy the code below and paste it into the <head> section of your landing page. You MUST replace TRACKING_DOMAIN with your actual domain from Part A.

Understanding the Code

The line ScCid: EF.urlParameter('ScCid') looks for a parameter in your URL named ?ScCid=.... If Snapchat sends a user to your site with that ID, this script saves it so it can be sent back to Snapchat later.

Troubleshooting

1 Run the Partner Postback Report Go to Reporting > Partner Postbacks. Filter by your Snapchat Partner. Look for the specific conversion attempt. 2 View Debug Info If the status is Failed (Red) or even Success (Green) but data is missing, click the Response column. Common Error: Required fbclid/ScCid is missing. The Fix: This means the click script did not capture the ID. Check your landing page URL. Does it have ?ScCid=12345 attached? If not, check your ad settings in Snapchat. 3 Verify the Click Go to Reporting > Click. Find the click associated with the conversion. Click View Details > Parameters. Confirm that ScCid has a value. If it is empty, your JS SDK implementation in Step 4 is incorrect.

Supported Data & Parameters

This integration automatically handles the security requirements for Snapchat's CAPI.

  • PII Hashing: Emails and Phone numbers are automatically hashed before being sent to Snapchat.
  • Attribution Window: Snapchat accepts events up to 37 days after the click.
  • Dual-Tracking: This CAPI integration is designed to work alongside the standard Snapchat Pixel for maximum data match rates.