# Pinterest

[Pinterest](https://www.pinterest.com) 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](https://developers.pinterest.com/docs/conversions/conversion-management/#Tracking%20conversions%20with%20the%20Pinterest%20API) pour envoyer des événements via des hits server-side. Des détails techniques supplémentaires sont disponibles en suivant ce [LINK](https://developers.pinterest.com/docs/api/v5/#tag/conversion_events).

## Principales fonctionnalités

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

* **Structure des événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) 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](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) array sont envoyées à Pinterest.

## Configuration de la destination

{% hint style="info" %}
Assurez-vous d'avoir accès à un [Pinterest Ads account](https://ads.pinterest.com) avant de configurer cette destination.
{% endhint %}

### Configuration

<table><thead><tr><th width="307">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Advertiser ID</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Pinterest Advertiser ID. Des détails supplémentaires sont disponibles en suivant ce <a href="https://developers.pinterest.com/docs/conversions/3rd-party-api-integrations/#Getting%20your%20Access%20Token%20and%20Advertiser%20ID">LINK</a>.</td></tr><tr><td><code>API Access Token</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le Pinterest Conversions API nécessite un access token pour authentifier vos activités. Des détails supplémentaires sont disponibles en suivant ce <a href="https://developers.pinterest.com/docs/conversions/3rd-party-api-integrations/#Getting%20your%20Access%20Token%20and%20Advertiser%20ID">LINK</a>.</td></tr><tr><td><code>Click Id Cookie Name</code></td><td>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 : <code>_epik</code>. Des détails supplémentaires sont disponibles en suivant ce <a href="https://developers.pinterest.com/docs/conversions/3rd-party-api-integrations/#Pinterest%20API%20for%20Conversions%20Event%20Parameters">LINK</a>.</td></tr><tr><td><code>Envoyer en tant que requête de test</code></td><td>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 <a href="https://developers.pinterest.com/docs/conversions/conversion-management/#Testing%20your%20request">LINK</a>.</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events                                                                                                                                                                                                                                                                                                                                                                                                   | Pinterest Events |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| <p><code>page\_view</code></p><p><code>view\_item</code></p>                                                                                                                                                                                                                                                                                                                                                            | `page_visit`     |
| <p><code>purchase</code></p><p><code>buy</code></p><p><code>pay</code></p><p><code>payment</code></p>                                                                                                                                                                                                                                                                                                                   | `checkout`       |
| <p><code>add\_to\_cart</code></p><p><code>addtocart</code></p>                                                                                                                                                                                                                                                                                                                                                          | `add_to_cart`    |
| <p><code>search</code></p><p><code>find\_location</code></p>                                                                                                                                                                                                                                                                                                                                                            | `search`         |
| <p><code>generate\_lead</code></p><p><code>submit\_application</code></p><p><code>contact</code></p>                                                                                                                                                                                                                                                                                                                    | `lead`           |
| <p><code>sign\_up</code><br><code>signup</code></p><p><code>completeregistration</code></p>                                                                                                                                                                                                                                                                                                                             | `signup`         |
| <p><code>view\_item\_list</code></p><p><code>viewcategory</code></p><p><code>viewcontent</code></p>                                                                                                                                                                                                                                                                                                                     | `view_category`  |
| <p><code>watch\_video</code></p><p><code>watchvideo</code></p>                                                                                                                                                                                                                                                                                                                                                          | `watch_video`    |
| <p><code>add\_payment\_info</code></p><p><code>add\_shipping\_info</code></p><p><code>add\_to\_wishlist</code></p><p><code>begin\_checkout</code></p><p><code>login</code></p><p><code>refund</code></p><p><code>remove\_from\_cart</code></p><p><code>select\_content</code></p><p><code>select\_item</code></p><p><code>view\_cart</code></p><p><code>select\_promotion</code></p><p><code>view\_promotion</code></p> | `custom`         |

## Mappages de champs

{% hint style="info" %}
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 :\
• <mark style="color:blue;">`user_data.em`</mark> est définie.\
• <mark style="color:blue;">`user_data.hashed_maids`</mark> est définie.\
• <mark style="color:blue;">`user_data.client_ip_address`</mark> et <mark style="color:blue;">`user_data.client_user_agent`</mark> sont définis.\
La propriété <mark style="color:blue;">`event_id`</mark> est requise et utilisée pour la déduplication. Plus d'informations sont disponibles en suivant ce [LINK](https://developers.pinterest.com/docs/conversions/conversions/) (Voir la section "How deduplication works").
{% endhint %}

<table><thead><tr><th width="382.6685580062746">Propriétés Commanders Act</th><th>Propriétés Pinterest</th></tr></thead><tbody><tr><td><code>partners.pinterest.event_id</code></td><td><code>event_id</code> <strong>[*]</strong></td></tr><tr><td><code>partners.pinterest.action_source</code></td><td><code>action_source</code> <strong>[1]</strong></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>event_time</code></td></tr><tr><td><code>context.page.url</code></td><td><code>event_source_url</code> <strong>[2]</strong></td></tr><tr><td><code>partners.pinterest.opt_out</code></td><td><code>opt_out</code> <strong>[3]</strong></td></tr><tr><td><code>context.app.namespace</code></td><td><code>app_id</code></td></tr><tr><td><code>context.app.name</code></td><td><code>app_name</code></td></tr><tr><td><code>context.app.version</code></td><td><code>app_version</code></td></tr><tr><td><code>context.device.manufacturer</code></td><td><code>device_brand</code></td></tr><tr><td><code>context.device.network.carrier</code></td><td><code>device_carrier</code></td></tr><tr><td><code>context.device.model</code></td><td><code>device_model</code></td></tr><tr><td><code>context.device.type</code></td><td><code>device_type</code></td></tr><tr><td><code>context.device.os.version</code></td><td><code>os_version</code></td></tr><tr><td><code>context.device.network.wifi</code></td><td><code>wifi</code> <strong>[3]</strong></td></tr><tr><td><code>context.device.lang</code></td><td><code>language</code></td></tr><tr><td><code>user.email_sha256</code></td><td><code>user_data.em</code> <strong>[4]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>user_data.ph</code> <strong>[4]</strong></td></tr><tr><td><code>user.gender</code></td><td><code>user_data.ge</code> <strong>[4]</strong></td></tr><tr><td><code>user.birthdate</code></td><td><code>user_data.db</code> <strong>[4]</strong></td></tr><tr><td><code>user.lastname</code></td><td><code>user_data.ln</code> <strong>[4]</strong></td></tr><tr><td><code>user.firstname</code></td><td><code>user_data.fn</code> <strong>[4]</strong></td></tr><tr><td><code>user.city</code></td><td><code>user_data.ct</code> <strong>[4]</strong></td></tr><tr><td><code>user.state_short</code></td><td><code>user_data.st</code> <strong>[4]</strong></td></tr><tr><td><code>user.zipcode</code></td><td><code>user_data.zp</code> <strong>[4]</strong></td></tr><tr><td><code>user.country</code></td><td><code>user_data.country</code> <strong>[4]</strong></td></tr><tr><td><code>user.id</code></td><td><code>user_data.external_id</code> <strong>[4]</strong></td></tr><tr><td><code>context.device.advertising_id</code></td><td><code>user_data.hashed_maids</code> <strong>[4]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>user_data.client_ip_address</code></td></tr><tr><td><code>context.device.user_agent</code></td><td><code>user_data.client_user_agent</code></td></tr><tr><td><p><code>partners.pinterest.click_id</code><br><code>(context.page.url)</code></p><p><code>Click Id Cookie Name</code></p></td><td><code>user_data.click_id</code> <strong>[5]</strong></td></tr><tr><td><code>id</code></td><td><code>custom_data.order_id</code></td></tr><tr><td><code>currency</code></td><td><code>custom_data.currency</code></td></tr><tr><td><code>value</code></td><td><code>custom_data.value</code></td></tr><tr><td><code>items.X.id</code></td><td><code>custom_data.content_ids</code> <strong>[6]</strong></td></tr><tr><td><code>items.X.product.price</code></td><td><code>custom_data.contents.X.item_price</code></td></tr><tr><td><code>items.X.quantity</code></td><td><code>custom_data.contents.X.quantity</code></td></tr><tr><td><code>items.length</code></td><td><code>custom_data.num_items</code></td></tr><tr><td><code>search_term</code></td><td><code>custom_data.search_string</code></td></tr><tr><td><code>partners.pinterest.opt_out_type</code></td><td><code>custom_data.opt_out_type</code></td></tr></tbody></table>

{% hint style="info" %}

> **\[\*]** Propriété obligatoire.  \
> \&#xNAN;**\[1]** Si cette propriété n'est pas fournie, un <mark style="color:blue;">`action_source`</mark> est récupéré en utilisant les données disponibles. Valeurs prises en charge : <mark style="color:blue;">`app_android`</mark> , <mark style="color:blue;">`app_ios`</mark> , <mark style="color:blue;">`offline`</mark> et <mark style="color:blue;">`web`</mark> . Valeur par défaut : <mark style="color:blue;">`web`</mark> .  \
> \&#xNAN;**\[2]** Si cette propriété n'est pas fournie, un<mark style="color:blue;">`event_source_url`</mark>approprié est récupéré en utilisant les données disponibles.  \
> \&#xNAN;**\[3]** Valeur booléenne ou chaîne équivalente prise en charge.  \
> \&#xNAN;**\[4]** Si elle est transmise en clair, elle est automatiquement hachée.  \
> \&#xNAN;**\[5]** Priorité sur la colonne de gauche. Si la valeur ne peut pas être récupérée depuis l'URL, le <mark style="color:blue;">`Click Id Cookie Name`</mark> ou le nom de cookie par défaut`_epik` est utilisé.  \
> \&#xNAN;**\[6]** Tous les identifiants d'articles sont pris en compte.
> {% endhint %}