Snap Pixel Tag Setup Guide
This article describes how to set up the Snap Pixel tag.
The Snap Pixel helps advertisers measure the cross-device impact of campaigns. Advertisers will be able to see how many Snapchatters take action on their websites after seeing their ad.
Tag tips
- Purchase tracking fires automatically when Order ID is set. To disable automatic purchase tracking, set the destination
auto_page_tracking
tofalse
via mappings. - Automatic page view tracking is enabled by default. To disable automatic page view tracking, set
auto_page_tracking
tofalse
via mappings. - Supports the following E-Commerce extension parameters:
- Order ID (
_corder
) - Sub Total (
_csubtotal
) - Currency (
_ccurrency
) - Customer ID (
_ccustid
) - List of Product IDs (
_cprod
) - List of Categories (
_ccat
) - List of Quantities (
_cquan
) - List of Prices (
_cprice
)
- Order ID (
- User Email and Phone Number are converted to SHA256 within the Snap Pixel SDK before being passed to Snap’s server.
- To make Snap Pixel Event IDs available as server-side attributes, set Generate Event ID to
true
and use the latest version of the Tealium Collect tag. - The event ID attribute names are in the format
snap_event_id_<Event Name>_<Tag UID>
(for example:snap_event_id_PageView_512
).
Tag configuration
Navigate to the Tag Marketplace to add a new tag. For more information, see About tags.
When adding the tag, configure the following settings:
- Pixel ID: Found in your Snapchat Ads Manager.
- Generate Event ID: Automatically generate an Event ID for every Snap tracking event.
Load rules
Load the tag on all pages or set conditions for when your tag will load. For more information, see About load rules.
Data mappings
Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For more information, see About data mappings.
The available categories are:
Tag Configurations
Variable | Type | Description |
---|---|---|
pixel_id |
String | Pixel ID |
auto_page_tracking |
Boolean | Automatic Page Tracking |
auto_purchase_tracking |
Boolean | Automatic Purchase Tracking |
generate_event_id |
Boolean | Generate Event IDs |
Standard Parameters
Variable | Type | Description |
---|---|---|
currency |
String | Currency |
description |
String | Description |
item_category |
String | Item Category |
item_ids |
Array | Item IDs |
number_items |
Integer | Number of Items |
payment_info_available |
Boolean | Payment Info Available |
price |
Array | Price |
search_string |
String | Search |
sign_up_method |
String | Sign Up Method |
success |
Boolean | Success |
transaction_id |
String | Transaction ID |
E-Commerce
Variable | Type | Description |
---|---|---|
order_id (Overrides _corder ) |
String | Order ID |
order_subtotal (Overrides _csubtotal ) |
String | Sub Total |
order_currency (Overrides _ccurrency ) |
String | Currency |
customer_id (Overrides _ccustid ) |
String | Customer ID |
product_id (Overrides _cprod ) |
Array | List of Product IDs |
product_category (Overrides _ccat ) |
Array | List of Categories |
product_unit_price (Overrides _cprice ) |
Array | List of Prices |
product_quantity (Overrides _cquan ) |
Array | List of Quantities |
User Parameters
Variable | Type | Description |
---|---|---|
user_email |
String | Email address of currently signed in user. |
user_hashed_email |
String | SHA256 hash of lowercase and whitespace-removed email address. |
user_hashed_phone_number |
String | SHA256 hash of lowercase and whitespace-removed phone number. |
user_phone_number |
String | Only digits with country code, area code, and number. No other formatting characters. |
Events
To map events, refer to Create an Event Mapping
Variable | Description |
---|---|
ACHIEVEMENT_UNLOCKED |
ACHIEVEMENT_UNLOCKED |
ADD_BILLING |
ADD_BILLING |
ADD_CART |
ADD_CART |
ADD_TO_WISHLIST |
ADD_TO_WISHLIST |
AD_CLICK |
AD_CLICK |
AD_VIEW |
AD_VIEW |
COMPLETE_TUTORIAL |
COMPLETE_TUTORIAL |
INVITE |
INVITE |
LIST_VIEW |
LIST_VIEW |
LOGIN |
LOGIN |
OPEN_APP |
OPEN_APP |
PAGE_VIEW |
PAGE_VIEW |
PURCHASE |
PURCHASE |
RATE |
RATE |
RESERVE |
RESERVE |
SAVE |
SAVE |
SEARCH |
SEARCH |
SHARE |
SHARE |
SIGN_UP |
SIGN_UP |
SPENT_CREDITS |
SPENT_CREDITS |
START_CHECKOUT |
START_CHECKOUT |
START_TRIAL |
START_TRIAL |
SUBSCRIBE |
SUBSCRIBE |
VIEW_CONTENT |
VIEW_CONTENT |
CUSTOM_EVENT_1 |
CUSTOM_EVENT_1 |
CUSTOM_EVENT_2 |
CUSTOM_EVENT_2 |
CUSTOM_EVENT_3 |
CUSTOM_EVENT_3 |
CUSTOM_EVENT_4 |
CUSTOM_EVENT_4 |
CUSTOM_EVENT_5 |
CUSTOM_EVENT_5 |
Custom |
Custom |
Event-specific Parameters
To map events, refer to Create an Event Mapping
Variable | Type | Description |
---|---|---|
currency |
String | ISO-4217 currency code |
description |
String | Description |
item_category |
String | Item category |
item_ids |
Array | Item IDs |
number_items |
Number | Number of items |
payment_info_available |
Boolean | Payment information available |
price |
Number | Price of the purchase |
search_string |
String | Search string |
sign_up_method |
String | Sign up method |
success |
Boolean | Success |
transaction_id |
String | Transaction ID |
custom_parameter |
String | Custom parameter |
This page was last updated: June 14, 2023