Pinterest

Pinterest est un service de partage d’images et de médias sociaux conçu pour permettre la sauvegarde et la découverte d’informations sur Internet à l’aide d’images, de GIF animés et de vidéos, sous la forme de tableaux d’inspiration. Avec cette destination, vous pouvez exploiter Pinterest API pour envoyer des événements via des hits server-side. Des détails techniques supplémentaires sont disponibles en suivant ce LINK.

Fonctionnalités clés

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

• Structure des événements: notre Référence des événements modèle couvre les événements Pinterest, 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 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 data layer.

• Prise en charge des données multi-éléments: les informations incluses dans le item array sont envoyées à Pinterest.

Configuration de la destination

Assurez-vous d’avoir accès à un compte Pinterest Ads avant de configurer cette destination.

Configuration

Paramètres	Description
Jeton d'accès API	Obligatoire L’API Conversions de Pinterest a besoin d’un jeton d’accès pour authentifier vos activités. Plus de détails sont disponibles en suivant ce LINK.
ID de l’annonceur	Obligatoire ID de l’annonceur Pinterest. Plus de détails sont disponibles en suivant ce LINK.
Nom du cookie Click ID	Nom du cookie contenant le "Click ID" Pinterest qui identifie un clic de manière unique. C’est fortement recommandé au minimum pour les événements de checkout. Cela peut améliorer les performances de reporting telles que ROAS/CPA. Nom de cookie par défaut : _epik. Plus de détails sont disponibles en suivant ce LINK.
Envoyer en tant que requête de test	Si cette option est cochée, l’événement ne sera pas enregistré dans Pinterest Ads, mais l’API renverra tout de même les mêmes messages de réponse. Utilisez ce mode pour vérifier vos requêtes et que vos événements sont correctement construits. Plus de détails sont disponibles en suivant ce LINK.

Référence rapide

Commanders Act Events	Pinterest Events
add_payment_info	add_payment_info
add_to_cart addtocart	add_to_cart
add_to_wishlist	add_to_wishlist
app_install	app_install
app_open	app_open
begin_checkout	initiate_checkout
contact	contact
customize_product	customize_product
find_location	find_location
generate_lead	lead
page_view pageview pagevisit view_item	page_visit
purchase buy pay payment	checkout
schedule	schedule
search	search
sign_up signup completeregistration	signup
start_trial	start_trial
submit_application	submit_application
subscribe	subscribe
view_category viewcategory view_item_list	view_category
view_content viewcontent	view_content
watch_video watchvideo	watch_video
add_shipping_info login refund remove_from_cart select_content select_item view_cart select_promotion view_promotion	custom

Mappages de champs

Les propriétés peuvent être remappées à l’aide de notre Smart Mapping fonctionnalité. Au moins l’une des affirmations suivantes doit être remplie : • user_data.em est défini. • user_data.hashed_maids est défini. • user_data.client_ip_address et user_data.client_user_agent sont définis. La propriété event_id est obligatoire et utilisée pour la déduplication. Plus d’informations sont disponibles en suivant ce LINK (voir la section « Comment fonctionne la déduplication »).

Champs de Smart Mapping	Propriétés par défaut de Commanders Act	Propriétés Pinterest
ID de l’événement	context.event_id	event_id [*]
Source de l’action	partners.pinterest.action_source	action_source [1]
Horodatage de l’événement	context.event_timestamp	event_time
URL source	context.page.url	event_source_url [2]
Opt-out utilisateur	partners.pinterest.opt_out	opt_out [3]
ID de l’application	context.app.namespace	app_id
Nom de l’application	context.app.name	app_name
Version de l’application	context.app.version	app_version
Marque de l’appareil	context.device.manufacturer	device_brand
Opérateur de l’appareil	context.device.network.carrier	device_carrier
Modèle de l’appareil	context.device.model	device_model
Type d’appareil	context.device.type	device_type
Version de l’OS de l’appareil	context.device.os.version	os_version
WiFi de l’appareil	context.device.network.wifi	wifi [3]
Langue de l’utilisateur	context.device.lang	language
SHA256 de l’email utilisateur	user.email_sha256	user_data.em [4]
Téléphone utilisateur	user.phone	user_data.ph [4]
Sexe utilisateur	user.gender	user_data.ge [4]
Date de naissance utilisateur	user.birthdate	user_data.db [4]
Nom de famille utilisateur	user.lastname	user_data.ln [4]
Prénom utilisateur	user.firstname	user_data.fn [4]
Ville utilisateur	user.city	user_data.ct [4]
État utilisateur	user.state_short	user_data.st [4]
Code postal utilisateur	user.zipcode	user_data.zp [4]
Pays utilisateur	user.country	user_data.country [4]
ID utilisateur	user.id	user_data.external_id [4]
Identifiant mobile de l’appareil	context.device.advertising_id	user_data.hashed_maids [4]
IP de l’appareil	context.device.ip	user_data.client_ip_address
User Agent de l’appareil	context.device.user_agent	user_data.client_user_agent
ID de clic URL source -	partners.pinterest.click_id context.page.url Nom du cookie Click ID	user_data.click_id [5]
ID de transaction	id	custom_data.order_id
Currency	currency	custom_data.currency
Value	value	custom_data.value
ID de l’item	items.X.id	custom_data.content_ids [6]
Prix de l’item	items.X.product.price	custom_data.contents.X.item_price
Quantité de l’item	items.X.quantity	custom_data.contents.X.quantity
Liste d’items	items.length	custom_data.num_items
Terme de recherche	search_term	custom_data.search_string
Type d’Opt-out utilisateur	partners.pinterest.opt_out_type	custom_data.opt_out_type

* Propriété obligatoire. 1. Si cette propriété n’est pas fournie, un action_source est récupéré à partir des données disponibles. Valeurs prises en charge : app_android , app_ios , offline et web . Valeur par défaut : web . 2. Si cette propriété n’est pas fournie, une valeur appropriéeevent_source_urlest récupérée à partir des données disponibles. 3. Valeur booléenne ou chaîne équivalente prise en charge. 4. S’il est transmis en clair, il est automatiquement haché. 5. Priorité sur la colonne de gauche. Si la valeur ne peut pas être récupérée depuis l’URL, le Nom du cookie Click ID ou le nom de cookie par défaut_epik est utilisé. 6. Tous les identifiants des items sont pris en compte.