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 la 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 LIEN.

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 le modèle couvre les événements de Pinterest, ce qui signifie que vos données sont correctement mappées vers les champs attendus de manière optimisée.

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

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

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

• Prise en charge des données multi-articles : les informations incluses dans le tableau item le tableau est envoyé à 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. Plus de détails sont disponibles en suivant ce LIEN.
API Access Token	Obligatoire Le Pinterest Conversions API nécessite un access token pour authentifier vos actions. Plus de détails sont disponibles en suivant ce LIEN.
Click Id Cookie Name	Nom du cookie contenant le Pinterest "Click Id" qui identifie de manière 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. Plus de détails sont disponibles en suivant ce LIEN.
Send as a test-request	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 construits correctement. Plus de détails sont disponibles en suivant ce LIEN.

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

Mappings de champs

La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping". Au moins une des déclarations 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éfinies. La propriété event_id est requise et utilisée pour la déduplication. Plus d'informations sont disponibles en suivant ce LIEN (Voir la section "How deduplication works").

Propriétés Commanders Act	Pinterest Properties
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
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 équivalente en chaîne prise en charge. [4] S'il est transmis en clair, il est automatiquement hashé. [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_epikest utilisé. [6] Tous les identifiants d'articles sont pris en compte.