Snapchat Conversions API

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

Fonctionnalités clés

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

• Structure des événements : notre Référence des Events convient Types d'événements Snapchat, ce qui signifie que vos données sont correctement mappées vers les 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 mapping des données peut être réajusté en utilisant vos champs définis dans le 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-éléments : les informations incluses dans le tableau 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

Settings	Description
Identifiants	Requis si le API Token n'est pas défini Vos identifiants auprès de Snapchat tels que configurés 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 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 , inclus (par 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é 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 la 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 souhaitez obtenir la valeur. Voir Référence des Events 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	É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
inviter	INVITE
login	LOGIN
page_view	PAGE_VIEW
purchase	PURCHASE
réserver	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 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 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]
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. &#xNAN;[2] L'ordre de priorité est indiqué dans la colonne de gauche. Si context.app.name est défini alors ce champ est renseigné avec MOBILE_APP , sinon, WEB . &#xNAN;[3] Si vous signalez des événements en utilisant plusieurs méthodes (par ex. Snap Pixel et Conversions API) vous devez utiliser le même client_dedup_id sur toutes. Cela sera utilisé dans une fenêtre de 48 heures à partir de la première occurrence. &#xNAN;[4] Chaque information d'article est envoyée dans le tableau correspondant. &#xNAN;[5] Champ automatiquement haché s'il est fourni en clair. &#xNAN;[6] Champ automatiquement haché et normalisés. &#xNAN;[7] partners.snapchat.uuid_c1 a la priorité sur cookie _scid.