Snapchat Conversions API v2

Snapchat Conversions API v2 est obsolète (Ref. ici). Snapchat recommande d'utiliser la version la plus récente v3 et la destination associée est disponible ici :

Snapchat Conversions API v3

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 app à Snapchat.

Principales fonctionnalité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 mappé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 haché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 en fonction de vos besoins spécifiques.

• Prise en charge des données multi-articles : les informations incluses dans le tableau item 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 avec Snapchat comme définis dans l'interface Commanders Act via : 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 événements WEB. 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 événements. 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 entre 1 et 5 , inclusivement (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 Nom de la propriété d'événement et en ajoutant le nom du champ contenant la valeur dans Commanders Act event property . Par ex. si vous saisissez size dans le Nom de la propriété d'événement 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 vers le champ spécifique dont vous voulez obtenir la valeur. Voir Référence des événements pour plus de détails sur les noms de champs standard 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 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é.

Propriétés Commanders Act	Propriétés Snapchat
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 listé dans la colonne de gauche. Si context.app.name est défini alors ce champ est renseigné avec 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 sur toutes. Ceci sera utilisé dans une fenêtre de 48 heures à partir de la première occurrence. [4] Chaque information d'article est envoyée dans le tableau associé. [5] Champ automatiquement haché s'il est fourni en clair. [6] Champ automatiquement haché et normalisé. [7] partners.snapchat.uuid_c1 a la priorité sur cookie _scid.