Snapchat Conversions API

Snapchat est une application et un service de messagerie instantanée multimédia. Cette destination exploite le Snapchat Conversions API v2 pour envoyer des événements web et application à Snapchat.

Fonctionnalités clés

La destination Snapchat fournit les fonctionnalités clés suivantes :

• Structure des événements : notre Référence des événements correspond Types d'événements Snapchat, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.

• Mappings préconstruits : le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.

• Hachage automatique : les informations sont automatiquement hashées conformément aux spécifications du partenaire.

• Mapping intelligent : le mapping des données peut être réajusté en utilisant les champs définis dans votre datalayer.

• Événements personnalisés : vous pouvez librement envoyer des événements personnalisés selon vos besoins spécifiques.

• Prise en charge des données multi-articles : les informations incluses dans le item array sont envoyées à Snapchat.

Configuration de la destination

Avant de commencer avec cette destination, assurez-vous de pouvoir accéder au Snapchat Ads Manager.

Configuration

Paramètres	Description
Identifiants	Requis si API Token n'est pas défini Vos identifiants chez Snapchat tels que définis dans l'interface Commanders Act comme suit : Administration ➜ Connector Credentials ➜ Ajouter des connector credentials ➜ Snapchat
API Token	Requis si Credentials n'est pas défini Saisissez votre "API Token", également connu sous le nom de "Static long lived token", tel que généré dans Snapchat Business Manager → "Business Details" en suivant ce LINK. Ce champ a la priorité sur Identifiants.
Pixel Id (WEB)	Requis pour WEB events. Votre Pixel Id tel que fourni par Snapchat pour les événements de type "Web". Pour plus de détails, vous pouvez consulter le LINK.
Snap App Id (APP)	Requis pour MOBILE APP events. Votre Snap App Id tel que fourni par Snapchat pour les événements de type "Mobile App". Pour plus de détails, vous pouvez consulter le LINK.
Mapping d'événements personnalisés	Snapchat permet de suivre jusqu'à cinq (5) événements personnalisés. Dans Commanders Act Event Name saisissez un nom d'événement, tandis que dans Snapchat Event Name définissez un nom comme suit : CUSTOM_EVENT_X , où X est un nombre compris entre 1 et 5 , inclus (Ex. CUSTOM_EVENT_1 ).
Propriétés d'événements personnalisés	Mappez vos propriétés d'événements personnalisés en définissant leurs noms de champ dans Event property name et en ajoutant le nom du champ contenant la valeur dans Commanders Act event property . Ex. si vous saisissez size dans le Event property name et items.0.product.size [1] dans Commanders Act event property , vous aurez une propriété d'événement personnalisée dans Snapchat appelée size avec une valeur basée sur le contenu du champ items.0.product.size .

[1] En utilisant des "dots" (".") vous pouvez naviguer plus profondément jusqu'au champ spécifique dont vous souhaitez obtenir la valeur. Voir Référence des événements pour plus de détails sur les noms de champs standards par événement. Vous pouvez également définir librement des champs personnalisés : il n'y a pas de limites.

Référence rapide

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
invite	INVITE
login	LOGIN
page_view	PAGE_VIEW
purchase	PURCHASE
reserve	RESERVE
search	SEARCH
sign_up	SIGN_UP
view_item	VIEW_CONTENT
view_item_list	LIST_VIEW
Commanders Act Event Name	CUSTOM_EVENT_X [1]

[1] Où X est un nombre compris entre 1 et 5 , inclus. Voir Mapping d'événements personnalisés dans Configuration pour plus de détails sur la façon dont vous pouvez suivre des événements personnalisés avec Snapchat.

Mappings de champs

Cette destination définira l'identifiant unique du visiteur, que vous pouvez fournir si vous utilisez Snapchat Pixel SDK, comme valeur pour la propriété Snapchat uuid_c1 en recherchant la propriété partners.snapchat.uuid_c1 . Si elle n'est pas présente, le cookie _scid est utilisé.

Commanders Act Properties	Snapchat Properties
context.event_timestamp	timestamp [1]
Pixel Id (WEB)	pixel_id
Snap App Id (APP)	snap_app_id
partners.snapchat.event_conversion_type (context.app.name)	event_conversion_type [2]
context.page.url	page_url
context.app.namespace	app_id
id	client_dedup_id [3]
items.X.id	item_ids.X
items.length	number_items
items.X.id	item_ids [4]
items.X.product.category_1	item_category [4]
value	price
currency	currency
id	transaction_id
method	sign_up_method
search_term	search_string
user.email	hashed_email [5]
user.phone	hashed_phone_number [6]
context.device.ip	hashed_ip_address [5]
context.device.user_agent	user_agent
context.device.advertising_id	hashed_mobile_ad_id
context.device.idfv	hashed_idfv
context.device.model	device_model
context.device.os.version	os_version
partners.snapchat.uuid_c1	uuid_c1 [7]
partners.snapchat.click_id	click_id
partners.snapchat.att_status	att_status

[1] Champ généré automatiquement lorsqu'il n'est pas défini. [2] L'ordre de priorité est indiqué dans la colonne de gauche. Si context.app.name est défini alors ce champ est réglé sur MOBILE_APP , sinon, WEB . [3] Si vous signalez des événements en utilisant plusieurs méthodes (Ex. Snap Pixel et Conversions API), vous devez utiliser le même client_dedup_id across all of them. This will be used within a 48 hour scope of the first occurrence. [4] Chaque information d'article est envoyée dans le tableau associé. [5] Champ haché automatiquement s'il est fourni en clair. [6] Champ automatiquement hashé et normalisé. [7] partners.snapchat.uuid_c1 a la priorité sur cookie _scid.