Pinterest

Pinterest est un service de partage d'images et de réseau social 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 forme de tableaux d'épingles. En utilisant 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.

Principales fonctionnalité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 de Pinterest, ce qui signifie que vos données sont correctement mappé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 saisies utilisateur.

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

• Smart mapping: le mapping des données peut être réajusté en utilisant vos champs définis dans le datalayer.

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

Configuration de la destination

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

Configuration

Paramètres	Description
Advertiser ID	Obligatoire Pinterest Advertiser ID. Des détails supplémentaires sont disponibles en suivant ce LINK.
API Access Token	Obligatoire Le Pinterest Conversions API nécessite un access token pour authentifier vos activités. Des détails supplémentaires sont disponibles en suivant ce LINK.
Click Id Cookie Name	Nom du cookie contenant le "Click Id" Pinterest qui identifie de façon unique un clic. Ceci est fortement recommandé au moins 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. Des détails supplémentaires sont disponibles en suivant ce LINK.
Envoyer en tant que requête de test	Si coché, l'événement ne sera pas enregistré dans Pinterest Ads, mais l'API retournera toujours les mêmes messages de réponse. Utilisez ce mode pour vérifier vos requêtes et si vos événements sont correctement construits. Des détails supplémentaires sont disponibles en suivant ce LINK.

Référence rapide

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

Mappages de champs

La plupart des propriétés peuvent être remappées à l'aide de notre fonctionnalité "Smart Mapping". Au moins une des affirmations suivantes doit être remplie : • user_data.em est définie. • user_data.hashed_maids est définie. • user_data.client_ip_address et user_data.client_user_agent sont définis. La propriété event_id est requise et utilisée pour la déduplication. Plus d'informations sont disponibles en suivant ce LINK (Voir la section "How deduplication works").

Propriétés Commanders Act	Propriétés Pinterest
partners.pinterest.event_id	event_id [*]
partners.pinterest.action_source	action_source [1]
context.event_timestamp	event_time
context.page.url	event_source_url [2]
partners.pinterest.opt_out	opt_out [3]
context.app.namespace	app_id
context.app.name	app_name
context.app.version	app_version
context.device.manufacturer	device_brand
context.device.network.carrier	device_carrier
context.device.model	device_model
context.device.type	device_type
context.device.os.version	os_version
context.device.network.wifi	wifi [3]
context.device.lang	language
user.email_sha256	user_data.em [4]
user.phone	user_data.ph [4]
user.gender	user_data.ge [4]
user.birthdate	user_data.db [4]
user.lastname	user_data.ln [4]
user.firstname	user_data.fn [4]
user.city	user_data.ct [4]
user.state_short	user_data.st [4]
user.zipcode	user_data.zp [4]
user.country	user_data.country [4]
user.id	user_data.external_id [4]
context.device.advertising_id	user_data.hashed_maids [4]
context.device.ip	user_data.client_ip_address
context.device.user_agent	user_data.client_user_agent
partners.pinterest.click_id (context.page.url) Click Id Cookie Name	user_data.click_id [5]
id	custom_data.order_id
currency	custom_data.currency
value	custom_data.value
items.X.id	custom_data.content_ids [6]
items.X.product.price	custom_data.contents.X.item_price
items.X.quantity	custom_data.contents.X.quantity
items.length	custom_data.num_items
search_term	custom_data.search_string
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é en utilisant les 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, unevent_source_urlapproprié est récupéré en utilisant les données disponibles. [3] Valeur booléenne ou chaîne équivalente prise en charge. [4] Si elle est transmise en clair, elle est automatiquement hachée. [5] Priorité sur la colonne de gauche. Si la valeur ne peut pas être récupérée depuis l'URL, le Click Id Cookie Name ou le nom de cookie par défaut_epik est utilisé. [6] Tous les identifiants d'articles sont pris en compte.