Snapchat CAPI tag setup
As detailed in our documentation, the integration of Snapchat CAPI has become an imperative for advertisers. It is currently the most effective solution for maximizing the number of conversions attributed to your advertising campaigns. If implementing Snapchat CAPI seems complex, don't worry, the tag developed by Addingwell will simplify the process considerably! Follow our detailed guide to the optimal configuration of Snapchat CAPI...
Import Snapchat CAPI tag
Download Snapchat CAPI tag
Click here (opens in a new tab) to download the Snapchat Conversion API tag and click on the download icon to retrieve the file.
Import tag into sGTM
Go to the Templates tab of the server container, then, in the Tag templates section, click on New.
Then click on the three small dots in the top right-hand corner, and select Import.
Save the new imported tag
Then select the newly uploaded template.tpl file, and click Save.
Configuring the Snapchat CAPI tag
Create a new tag in Google Tag Manager Server-Side and select the newly created Snapchat CAPI tag.
To configure the tag, two pieces of information are required:
- The Snapchat Pixel ID on which to send data.
- The Access Token to communicate with the conversion API.
Once you've retrieved the access token and pixel ID, configure the Snapchat CAPI tag.
Event Name Setup Method
| Setup Method | Description |
|---|---|
| Inherit from client | Tell the tag to map between GA4 events received from the client-side container and standard Snapchat events. |
| Override | Match GA4 events to what needs to be sent to Snapchat. Choose to send either a standard event or a custom event (CUSTOM_EVENT_[1-5]). |
Access Token
Enter here the access token retrieved in Business Settings.
Pixel ID
Enter the pixel ID retrieved from Business Settings or Event Manager.
Test Events
Check this box only for test sending events to Snapchat
It's not advisable to keep this box checked in the Snapchat Conversion API tag in production. Remember to uncheck it before publishing your server container.
Triggering the Snapchat CAPI tag
Trigger the Snapchat CAPI tag on relevant GA4 events using the tag mapping table.
For example, for an e-commerce site, the following events are typically used:
| Event name |
|---|
| page_view |
| view_item_list |
| view_item |
| add_to_cart |
| begin_checkout |
| add_payment_info |
| purchase |
This list of events is of course not exhaustive and depends on your situation.
For optimal organization, create a Lookup Table variable configured as follows:
In the Snapchat CAPI tag, create a custom trigger verifying that the events come from GA4 (Client Name = GA4) and that the previously configured Lookup Table returns true.
Congratulations, you've completed the configuration of Addingwell's Snapchat CAPI tag.
Snap Pixel setup (Optional)
As explained in our documentation, the Snap Pixel remains the most effective solution when third-party cookies are still available (especially on browsers like Chrome). If deduplicating events between Snap Pixel and Snapchat CAPI seems complex, don't worry, we'll explain it all in this documentation.
In this documentation, we'll assume that you've already configured the Snap Pixel tag, and that all that's left is for you to handle deduplication with the event ID.
Add event id to Snap Pixel
In addition to your usual Snap Pixel tag configuration, you need to add the client_deduplication_id parameter in the Additionnal Initialization Data section.
Click on Add Row, then enter client_deduplication_id in the Key field.
For the Value field, click on the LEGO to the right of the field and create a new variable. Click on Discover more variable types in the Community Template Gallery to access the variable template gallery. Then select the Event Id variable from mbaersch.
Then click on Add to workspace.
Here is the result after this configuration:
Event id added to GA4 events
For the Google tag
For a GA4 event tag
Triggering the Snap Pixel tag
For deduplication to work properly on the Snapchat side, it's necessary to trigger your Snapchat events from the same triggers used for GA4.
Next step
Now that you've finished configuring the Addingwell Snapchat CAPI tag and Snap Pixel, it's time to check received data.