Snapchat Conversions API v3

Snapchat est une application et un service de messagerie instantanée multimédia. Cette destination exploite la dernière Snapchat Conversions API v3 pour envoyer les événements web et app à Snapchat, ce qui permet d'optimiser les campagnes publicitaires, d'améliorer le ciblage et de mesurer les conversions issues de vos campagnes Snapchat.

Fonctionnalités clés

La destination Snapchat offre les principales fonctionnalités suivantes :

• Structure des événements: notre Référence des événements prend en charge É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

Configuration

Paramètres	Description
Identifiants	Requis si API Token n'est pas défini Vos identifiants avec Snapchat tels que définis dans l'interface Commanders Act suivante : 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 qu'il est généré dans Snapchat Business Manager → "Business Details" en suivant ceci LINK. Ce champ a la 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 LINK.
Snap App ID (APP)	Obligatoire 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.
Envoyer l'adresse IP	Cochez cette option pour envoyer l'adresse IP telle qu'elle est définie dans le Mappage intelligent champ IP de l'appareil .
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 propriété Snapchat et en ajoutant la valeur dans Votre valeur d'événement .

Référence rapide

Commanders Act Events	Événements Snapchat
achievement_unlocked	ACHIEVEMENT_UNLOCKED
ad_click	AD_CLICK
ad_view	AD_VIEW
add_payment_info add_billing	ADD_BILLING
add_to_cart	ADD_CART
add_to_wishlist	ADD_TO_WISHLIST
app_open	APP_OPEN
begin_checkout	START_CHECKOUT
complete_tutorial	COMPLETE_TUTORIAL
generate_lead	SUBSCRIBE
invite	INVITE
level_complete	LEVEL_COMPLETE
login	LOGIN
page_view	PAGE_VIEW
purchase	PURCHASE
rate	RATE
reserve	RESERVE
enregistrez	SAVE
search	SEARCH
share	SHARE
sign_up	SIGN_UP
spent_credits	SPENT_CREDITS
start_trial	START_TRIAL
view_item	VIEW_CONTENT
view_item_list	LIST_VIEW
[ANY EVENT]	CUSTOM_EVENT_X [1]

1. Où X est un nombre compris entre 1 et 5 , bornes incluses. Voir Mappage des é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.

Correspondances des champs

Au moins l'un des éléments suivants doit être fourni :

• user_data.em (E-mail de l'utilisateur)

• user_data.ph (Téléphone de l'utilisateur)

• user_data.madid (Identifiant mobile de l'appareil)

• user_data.client_ip_address ET user_data.client_user_agent

Les propriétés peuvent être remappées à l'aide de notre Mappage intelligent fonctionnalité. Toutes les propriétés Snapchat sont définies dans le chemin de base data.0 .

Propriétés Commanders Act	Propriétés Snapchat
context.event_timestamp	event_time
(event_name)	event_name [1]
partners.snapchat.event_conversion_type (context.app.name)	action_source [2]
context.page.url	event_source_url
id	event_id [3]
partners.snapchat.dpo	data_processing_options
partners.snapchat.test_code	test_event_code
items.X.id	custom_data.content_ids [4]
items.X.product.category_1	custom_data.content_category [5]
context.page.title	custom_data.content_name
partners.snapchat.content_type	custom_data.content_type [6]
items.X.id	custom_data.contents.X.id
items.X.quantity	custom_data.contents.X.quantity
items.X.product.price	custom_data.contents.X.item_price
items.X.product.delivery_category	custom_data.contents.X.delivery_category
items.length	custom_data.num_items
valeur	custom_data.value
currency	custom_data.currency
id	custom_data.order_id
partners.snapchat.predicted_ltv	custom_data.predicted_ltv
search_term	custom_data.search_string
partners.snapchat.checkin_date	custom_data.checkin_date [7]
partners.snapchat.travel_end	custom_data.travel_end
partners.snapchat.travel_start	custom_data.travel_start
partners.snapchat.suggest_dest	custom_data.suggested_destinations [8]
partners.snapchat.dest_airport	custom_data.destination_airport [9]
partners.snapchat.dest_country	custom_data.country [10]
partners.snapchat.dest_city	custom_data.city [11]
partners.snapchat.dest_region	custom_data.region [12]
partners.snapchat.dest_neigh	custom_data.neighborhood [13]
method	custom_data.sign_up_method
context.device.user_agent	user_data.client_user_agent
context.app.namespace	app_data.app_id extinfo.1
context.device.advertising_id	user_data.madid
context.device.idfv	user_data.idfv [14]
(context.device.os.name)	extinfo.0 [15]
context.app.version	extinfo.2
context.app.version_long	extinfo.3
context.device.os.version	custom_data.os_version extinfo.4
context.device.model	custom_data.device_model extinfo.5
context.device.language	extinfo.6
context.device.timezone_short	extinfo.7
context.device.network.carrier	extinfo.8
context.device.screen.width	extinfo.9
context.device.screen.height	extinfo.10
context.device.screen.density	extinfo.11
context.device.cpu_core	extinfo.12
context.device.storage	extinfo.13
context.device.ex_storage	extinfo.14
context.device.timezone	extinfo.15
context.device.ad_tracking_enabled	app_data.advertiser_tracking_enabled
user.email	user_data.em [16]
user.phone	user_data.ph [16]
user.firstname	user_data.fn [16]
user.lastname	user_data.ln [16]
user.gender	user_data.ge [16]
user.city	user_data.ct [16]
user.state_short	user_data.st [16]
user.zipcode	user_data.zp [16]
user.country	user_data.country [16]
context.device.ip	user_data.client_ip_address
user.id	user_data.external_id
partners.snapchat.sub_id	user_data.subscription_id
partners.snapchat.lead_id	user_data.lead_id
partners.snapchat.app_install_id	user_data.anon_id
partners.snapchat.download_id	user_data.download_id
partners.snapchat.partner_id	user_data.partner_id
partners.snapchat.uuid_c1 cookie _scid	user_data.sc_cookie1 [17]
partners.snapchat.click_id	user_data.sc_click_id

1. Voir Référence rapide pour plus de détails. 2. Priorité à gauche. Si context.app.name est défini MOBILE APP est renvoyé. Valeurs autorisées : OFFLINE , MOBILE APP et WEB . Valeur par défaut : WEB . 3. Si vous signalez des événements via plus d'une méthode (Snap Pixel, App Ads Kit, Conversions API), vous devez utiliser le même identifiant d'événement pour toutes les méthodes. Si vous utilisez Snap Pixel, cela doit correspondre au client_dedup_id pour l'événement correspondant. 4. Tous les identifiants d'article sont inclus. 5. Toutes les catégories sont incluses. 6. Indique ce que représentent les clés de content_ids ou contents . Définissez avec product pour des articles individuels ou product_group pour les articles qui ont plusieurs options de taille, de couleur ou toute autre variation. Valeur par défaut : product . 7. La date d'arrivée souhaitée à l'hôtel, dans le fuseau horaire de l'hôtel. Les formats acceptés sont : YYYYMMDD , YYYY-MM-DD , YYYY-MM-DDThh:mmTZD et YYYY-MM-DDThh:mm:ssTZD . 8. Destinations suggérées. Destinations séparées par des virgules ou liste de destinations (p. ex. destination1,destination2 ou ["destination1", "destination2"] ). 9. Code IATA. 10. Le pays correspondant à la destination que l'utilisateur prévoit de visiter. 11. La ville correspondant à la destination que l'utilisateur prévoit de visiter. 12. Il peut s'agir de l'État, du district ou de la région qui intéresse l'utilisateur. 13. Le quartier qui intéresse l'utilisateur. 14. IDFV iOS. S'il est transmis en clair, il est automatiquement haché via SHA256. 15. Défini avec a2 si context.device.os.name est Android (insensible à la casse) ou i2 si context.device.os.name est iOS (insensible à la casse). 16. S'il est transmis en clair, il est normalisé et automatiquement haché via SHA256. 17. Priorité à gauche.