Snapchat Conversions API v2

Le Snapchat Conversions API v2 est obsolète (Réf. ici). Snapchat recommande d'utiliser la version la plus récente v3 et la destination correspondante est disponible comme suit

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 les événements web et app à Snapchat.

Fonctionnalités clés

La destination Snapchat offre 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.

• Mappages prédéfinis: le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie utilisateur.

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

• Smart mapping: le mapping des données peut être réajusté à l'aide des 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-items: les informations incluses dans le item le tableau est envoyé à 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 Snapchat tels que définis dans l'interface Commanders Act, comme suit : Administration ➜ Identifiants du connecteur ➜ Ajouter des identifiants de connecteur ➜ Snapchat
API Token	Requis si Credentials n'est pas défini Saisissez votre « API Token », également appelé « Static long lived token », tel que généré dans Snapchat Business Manager → « Business Details » en suivant ce LINK. Ce champ a priorité sur Identifiants.
Pixel Id (WEB)	Obligatoire pour les é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 lien suivant LINK.
Snap App Id (APP)	Obligatoire pour APPLICATION MOBILE é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 lien suivant LINK.
Mappage des événements personnalisés	Snapchat permet de suivre jusqu'à cinq (5) événements personnalisés. Dans Nom de l'événement Commanders Act saisissez un nom d'événement, tandis que dans Nom de l'événement Snapchat définissez un nom comme suit : CUSTOM_EVENT_X , où X est un nombre compris entre 1 et 5 , bornes incluses (p. ex. CUSTOM_EVENT_1 ).
Propriétés d'événement personnalisées	Mappez vos propriétés d'événement personnalisées en définissant leurs noms de champ dans Nom de la propriété de l'événement et en ajoutant le nom du champ contenant la valeur dans propriété d'événement Commanders Act . p. ex. si vous saisissez size dans le Nom de la propriété de l'événement et items.0.product.size [1] dans propriété d'événement Commanders Act , 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 « points » ("."), 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 standard par événement. Vous pouvez également définir librement des champs personnalisés : il n'y a aucune limite.

Référence rapide

Commanders Act Events	Événements Snapchat
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
Nom de l'événement Commanders Act	CUSTOM_EVENT_X [1]

1. Où X est un nombre compris entre 1 et 5 , incluses. Voir Mappage des événements personnalisés dans Configuration pour plus de détails sur la façon de suivre des événements personnalisés avec Snapchat.

Correspondances des 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 partners.snapchat.uuid_c1 propriété. S'il n'est pas présent, 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]
valeur	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 défini avec MOBILE_APP , sinon, WEB . 3. Si vous signalez des événements en utilisant plusieurs méthodes (p. ex. Snap Pixel et Conversions API), vous devez utiliser le même client_dedup_id pour tous. Cela sera utilisé dans une fenêtre de 48 heures à partir de la première occurrence. 4. Les informations de chaque article sont envoyées dans le tableau correspondant. 5. Champ haché automatiquement s'il est fourni en texte clair. 6. Champ haché automatiquement et normalisés. 7. partners.snapchat.uuid_c1 a priorité sur le cookie _scid.