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 associée est disponible comme suit

Snapchat Conversions API v3

Snapchat est une application et un service de messagerie instantanée multimédia. Cette destination s'appuie sur le Snapchat Conversions API v2 pour envoyer les événements web et app vers Snapchat.

Fonctionnalités clés

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

• Structure des Events : notre référence des Events correspond à types d'events 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 mapping des données pour les destinations basées sur des events se fait automatiquement, ce qui simplifie la saisie utilisateur.

• Hachage automatique : l'information est automatiquement hachée conformément aux spécifications du partenaire.

• Mapping intelligent : le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.

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

• Prise en charge des données multi-item : 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 aucun API Token n'est défini Vos identifiants Snapchat tels que définis dans l'interface Commanders Act en suivant : Administration ➜ Connector Credentials ➜ Ajouter des identifiants du connecteur ➜ Snapchat
API Token	Requis si Credentials n'est pas défini Renseignez 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 est prioritaire sur Identifiants.
Pixel Id (WEB)	Requis pour événements WEB. Votre Pixel Id tel que fourni par Snapchat pour les events 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 events de type "Mobile App". Pour plus de détails, vous pouvez consulter le LINK.
Mapping des Custom Events	Snapchat permet de suivre jusqu'à cinq (5) custom events. Dans Nom de l'event Commanders Act saisissez un nom d'event, tandis que dans Nom de l'event Snapchat définissez un nom comme suit : CUSTOM_EVENT_X , où X est un nombre compris entre 1 et 5 , incluses (p. ex. CUSTOM_EVENT_1 ).
Propriétés des Custom Events	Mappez les propriétés de votre custom event en définissant leurs noms de champ dans Nom de la propriété d'event et en ajoutant le nom du champ contenant la valeur dans propriété d'event Commanders Act . p. ex. si vous saisissez size dans le Nom de la propriété d'event et items.0.product.size [1] dans propriété d'event Commanders Act , vous aurez dans Snapchat une propriété d'event personnalisée 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 en profondeur vers le champ spécifique dont vous souhaitez obtenir la valeur. Voir référence des Events pour plus de détails sur les noms de champ standard par event. Vous pouvez également définir librement des champs personnalisés : il n'y a aucune limite.

Référence rapide

Événements Commanders Act	É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'event Commanders Act	CUSTOM_EVENT_X [1]

1. Où X est un nombre compris entre 1 et 5 , les deux inclus. Voir Mapping des Custom Events dans Configuration pour plus de détails sur la façon de suivre des custom events avec Snapchat.

Mappages 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 le Snapchat uuid_c1 propriété en recherchant la partners.snapchat.uuid_c1 propriété. 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 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 events en utilisant plusieurs méthodes (p. ex. Snap Pixel et Conversions API), vous devez utiliser le même client_dedup_id pour toutes. Cela sera utilisé dans une fenêtre de 48 heures à partir de la première occurrence. 4. Les informations de chaque item sont envoyées dans le tableau associé. 5. Champ automatiquement haché s'il est fourni en texte clair. 6. Champ automatiquement haché et normalisé. 7. partners.snapchat.uuid_c1 est prioritaire sur cookie _scid.