Platform X
Search…
⌃K

Snapchat Conversions API

Snapchat is a multimedia instant messaging app and service. The Snapchat Conversions API allows you to bridge web and app events to Snapchat via a server-side integration.

Key features

The Snapchat destination provides the following key features:
  • Events structure: our Events reference fits Snapchat's one, meaning that your data is properly bridged to the expected fields in an optimized way.
  • Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.
  • Custom events: you can freely push custom events based on your specific needs.
  • Support for multi-item data: information included in the item array is dispatched to Snapchat.

Destination setup

Before you get started with this destination, make sure you can access the Snapchat Ads Manager.

Configuration

Settings
Description
Authentication
Required Your credentials with Snapchat as set in the Commanders Act interface following: AdministrationConnector CredentialsAdd connector credentialsSnapchat
Pixel Id (WEB)
Required for WEB events.
Your Pixel Id as provided by Snapchat for "Web" type events. For more details, you can check the following LINK.
Snap App Id (APP)
Required for MOBILE APP events.
Your Snap App Id as provided by Snapchat for "Mobile App" type events. For more details, you can check the following LINK.
Custom Event Mapping
Snapchat allows up to five (5) custom events to be tracked. In Commanders Act Event Name input an event name, while in Snapchat Event Name set a name as follows: CUSTOM_EVENT_X, where X is a number between1and5, both included (E.g. CUSTOM_EVENT_1).
Custom Event Properties
Map your custom event properties by setting their field names in Event property name and adding the field name holding the value in Commanders Act event property or static value. E.g. if you inputsizein the Event property name andproperties.items.0.product.size [1] in Commanders Act event property or static value, you will have a custom event property in Snapchat calledsizewith a value based on the content of the fieldproperties.items.0.product.size. You also have the option to set a static string/numeric value in Commanders Act event property or static value.

Quick reference

Commanders Act Events
Snapchat Events
add_payment_info
ADD_BILLING
add_to_cart
ADD_CART
add_to_wishlist
ADD_TO_WISHLIST
begin_checkout
START_CHECKOUT
generate_lead
SUBSCRIBE
login
LOGIN
page_view
PAGE_VIEW
purchase
PURCHASE
search
SEARCH
sign_up
SIGN_UP
view_item
VIEW_CONTENT
view_item_list
LIST_VIEW
Commanders Act Event Name
CUSTOM_EVENT_X [1]
[1] WhereXis a number between1and5, both included. See Custom Event Mapping in Configuration for more details on how you can track custom events with Snapchat.

Field Mappings

If you're also using Snapchat Pixel SDK, this destination will set the unique visitor identifier as value for the Snapchatuuid_c1property by looking for the Commanders Actpartners.snapchat.uuid_c1property. If it's not present, the cookie _scid is used.
Commanders Act Properties
Snapchat Properties
event_timestamp
timestamp [1]
Pixel Id (WEB)
pixel_id
Snap App Id (APP)
snap_app_id
(app.name)
event_conversion_type [2]
app.namespace
app_id
client_dedup_id
client_dedup_id [3]
properties.items.X.id
item_ids.X
properties.items.length
number_items
properties.value
price
properties.currency
currency
properties.id
transaction_id
properties.search_term
search_string
device.ip
hashed_ip_address [4]
device.user_agent
user_agent
device.advertising_id
hashed_mobile_ad_id
device.idfv
hashed_idfv
device.model
device_model
device.os
os_version
partners.snapchat.uuid_c1
uuid_c1 [5]
properties.user.email_sha256 or properties.user.email
hashed_email [6]
properties.user.phone
hashed_phone_number [7]
[1] Field automatically generated when it's not set. [2] Ifapp.nameis defined then this field is set with MOBILE_APP, otherwise,WEB. [3] If you are reporting events using multiple methods (E.g. Snap Pixel and Conversions API) you should use the sameclient_dedup_idacross all of them. This will be used within a 48 hour scope of the first occurrence. [4] Field automatically hashed. [5]partners.snapchat.uuid_c1has priority over cookie _scid. [6] In caseproperties.user.email_sha256is not provided, properties.user.emailis hashed and used in its place. [7] Field automatically hashed and normalized.
Last modified 1mo ago