Snapchat Conversions API Quick Start Guide

Destination Info

Client-side
Server-side

Web

Mobile

Server

Getting Started

This guide enables you to fully enable the Snapchat Conversions API destination for your site. For simplicity the event used for demonstration purposes is the generic Page View event. For more complex events see our additional documentation. Additionally this guide assumes you have the Freshpaint snippet installed on your site, if you do not please follow this guide.

  1. Enable the Freshpaint Snapchat destination

    • If in HIPAA mode enable the required fields

  2. Confirm and validate events

Find/create your Snapchat Pixel ID

  1. Log in to your Snapchat Ads Manager.

  2. From the top-left menu select Pixels.

  3. Create or view your existing Pixel.

  4. Copy the Pixel ID from the top of the Pixel Details page.

Associate your Pixel with your Ad Account

Select the Ad Account from the drop down on the Pixel Details page that you want to associate with your Pixel. This enables you to view your event details and performance in the Snapchat Events Manager.

Find/create your Snapchat Authentication Token

From the Pixels page or from the Business Dashboard in the top-left menu, select Business Details on the left-side menu.

Scroll down to the Conversions API Tokens section and click Generate Token.

After creating your token, you can hover your mouse over the row to copy the token value.

Enable the Freshpaint Snapchat destination

  1. Search for the Snapchat destination.

  2. Select Configure to paste your Pixel ID and API Key from the above steps.

  3. Customers that use HIPAA mode should then configure the required, recommended, and recommended view-through properties. You can find all properties that the Freshpaint Snapchat integration supports here.

  4. Enable Snapchat.

Once you've followed the steps above you can start sending events to Snapchat Conversions API.

Confirm and validate events

Confirm and Validate Conversions in Freshpaint

  1. Navigate to your site and visit a page that should trigger your event (For demonstration purposes we will use FreshHealth.co).

  2. Add a query parameter called sccid to the URL (Example: https://www.freshhealth.co/?sccid=TEST).

  3. Trigger your event (Our demonstration event is any Page View).

  4. Navigate to the Event Verification tool.

  5. Select Snapchat and verify your event went through.

    • This can take up to 90 seconds.

  6. Verify the event is marked as OK or resolve missing property issues.

Our Snapchat event went through smoothly with all required properties in place

Confirm and Validate Conversions in Snapchat

To check whether Snapchat is receiving events.

  1. Log in to your Snapchat Ads Manager.

  2. From the top-left menu select Events Manager.

  3. Select Events Sources > Event Manager in the left-side menu.

  4. You should see events coming through under the large graph under Event Details on this page

There is more information on how to understand and use this page in the Snapchat documentation.

Last updated

Was this helpful?