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 afin d'optimiser les campagnes publicitaires, d'améliorer le ciblage et de mesurer les conversions résultant de vos campagnes Snapchat.

Caractéristiques principales

La destination Snapchat fournit les fonctionnalités clé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éconfigurés: le mappage des données pour les destinations basées sur des é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.

• Mappage intelligent: le mappage 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 en fonction de vos besoins spécifiques.

• Prise en charge des données multi-articles: les informations incluses dans le élément 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 Snapchat tels que définis dans l'interface Commanders Act, en suivant : Administration ➜ Identifiants du connecteur ➜ Ajouter des identifiants du 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 ce LIEN. Ce champ est prioritaire sur Identifiants.
Pixel ID (WEB)	Obligatoire 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 LIEN.
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.
Envoyer l'adresse IP	Activez cette option pour envoyer l'adresse IP telle que définie dans le Smart Mapping 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 la propriété Snapchat et en ajoutant la valeur dans La valeur de votre événement .

Référence rapide

Événements Commanders Act	É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
save	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 de suivre des événements personnalisés avec Snapchat.

Mappages de 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 Smart Mapping 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
value	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 plusieurs méthodes (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'articles sont inclus. 5. Toutes les catégories sont incluses. 6. Indique ce que représentent les clés dans content_ids ou contents Représentez. Définissez avec product pour les articles individuels ou product_group pour les articles qui ont plusieurs options en taille, 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. Séparées par des virgules ou liste de destinations (p. ex. destination1,destination2 ou ["destination1", "destination2"] ). 9. Code IATA. 10. Le pays correspondant au lieu que l'utilisateur prévoit de visiter. 11. La ville correspondant au lieu 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é puis automatiquement haché via SHA256. 17. Priorité à gauche.