Snapchat Conversions API v3

Snapchat est une application et un service de messagerie instantanée multimédia. Cette destination exploite le dernier Snapchat Conversions API v3 pour envoyer des événements web et app à Snapchat, conduisant à des campagnes publicitaires optimisées, un meilleur ciblage et à mesurer les conversions résultant de vos campagnes Snapchat.

Fonctionnalités clés

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.

• Mappings préconstruits: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les entrées utilisateur.

• Hachage automatique: les informations sont automatiquement hachées conformément aux spécifications du partenaire.

• Mapping intelligent: 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-articles: les informations incluses dans le tableau item sont envoyées à 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 en suivant : Administration ➜ Connector Credentials ➜ Ajouter des identifiants de 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.
Envoyer l'adresse IP	Cochez cette option pour envoyer l'adresse IP telle que définie dans le Smart Mapping champ Device IP .
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 Snapchat Event Name définissez un nom comme suit : CUSTOM_EVENT_X , où X est un nombre entre 1 et 5 , inclusivement (par ex. CUSTOM_EVENT_1 ).
Propriétés d'événements personnalisés	Mappez vos propriétés d'événements personnalisés en définissant leurs noms de champ dans Nom de propriété Snapchat et en ajoutant la valeur dans Votre valeur événement .

Référence rapide

Commanders Act Events	Snapchat Events
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 entre 1 et 5 , tous deux inclus. Voir Mapping d'événements personnalisés dans Configuration pour plus de détails sur la façon dont vous pouvez suivre des événements personnalisés avec Snapchat.

Mappings de champs

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

• user_data.em (Email 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

La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping". 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é sur le côté gauche. Si context.app.name est défini MOBILE_APP est retourné. 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'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ésentent. Définir avec product pour des articles individuels ou product_group pour des articles qui ont plusieurs options en taille, couleur ou toute autre variation. Valeur par défaut : product . [7] La date d'enregistrement 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 (par ex. destination1,destination2 ou ["destination1", "destination2"] ). [9] Code IATA. [10] Le pays basé sur le lieu que l'utilisateur a l'intention de visiter. [11] La ville basée sur le lieu que l'utilisateur a l'intention de visiter. [12] Il pourrait s'agir de l'état, du district ou de la région d'intérêt pour 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éfinir 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é sur le côté gauche.