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 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 mappées aux champs attendus de manière optimisée.

• Mappings préconstruits: le mapping des données pour les destinations basées sur les é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.

• Smart mapping: le mappage des données peut être réajusté en utilisant vos champs définis dans le datalayer.

• Events 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 tableau item le tableau est envoyé à Snapchat.

Configuration de la destination

Avant de commencer avec cette destination, assurez-vous d'avoir accès au Snapchat Ads Manager.

Configuration

Settings	Description
Identifiants	Requis si le API Token n'est pas défini Vos identifiants auprès de Snapchat tels que définis dans l'interface Commanders Act comme suit : Administration ➜ Identifiants du connecteur ➜ Ajouter les identifiants du connecteur ➜ 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 Nom d'événement Snapchat 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énement personnalisées	Mappez vos propriétés d'événement personnalisées en définissant leurs noms de champ dans Nom de propriété d'événement et en ajoutant le nom du champ contenant la valeur dans Propriété d'événement Commanders Act . Par ex. si vous saisissez size dans le Nom de propriété d'é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é 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 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	É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
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 manière de suivre des événements personnalisés avec Snapchat.

Field Mappings

Cette destination définira l'identifiant unique du visiteur, que vous pouvez fournir si vous utilisez le 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]
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 listé dans la colonne de gauche. Si context.app.name est défini alors ce champ est rempli avec MOBILE_APP , sinon, WEB . [3] Si vous signalez des événements en utilisant plusieurs méthodes (Ex. Snap Pixel et Conversions API) vous devriez utiliser le même client_dedup_id sur toutes. Cela sera utilisé dans un délai de 48 heures à partir de la première occurrence. [4] Chaque information d'article est poussée dans le tableau lié. [5] Champ automatiquement haché s'il est fourni en clair. [6] Champ automatiquement haché et normalisés. [7] partners.snapchat.uuid_c1 a la priorité sur le cookie _scid.