# Pinterest

[Pinterest](https://www.pinterest.com) 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 forme de tableaux d'affichage.\
Grâce à 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 [LIEN](https://developers.pinterest.com/docs/api/v5/#tag/conversion_events).

## Fonctionnalités clés

La destination Pinterest fournit les principales fonctionnalités suivantes :

* **Structure des events**: notre [Référence des events](https://community.commandersact.com/platform-x/developers/tracking/events-reference) le modèle couvre les événements de Pinterest, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappings préconfigurés**: le mapping des données pour les destinations basées sur les events 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é à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-éléments**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) le tableau est envoyé à 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. Plus de détails sont disponibles en suivant ce <a href="https://developers.pinterest.com/docs/conversions/3rd-party-api-integrations/#Getting%20your%20Access%20Token%20and%20Advertiser%20ID">LIEN</a>.</td></tr><tr><td><code>API Access Token</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>La Pinterest Conversions API nécessite un jeton d'accès pour authentifier vos activités. Plus de détails sont disponibles en suivant ce <a href="https://developers.pinterest.com/docs/conversions/3rd-party-api-integrations/#Getting%20your%20Access%20Token%20and%20Advertiser%20ID">LIEN</a>.</td></tr><tr><td><code>Click Id Cookie Name</code></td><td>Nom du cookie contenant le "Click Id" Pinterest qui identifie de manière unique un clic. C'est fortement recommandé au minimum pour les événements de paiement. Cela peut améliorer les performances de reporting, comme le ROAS/CPA. Nom du cookie par défaut : <code>_epik</code>. Plus de détails sont disponibles en suivant ce <a href="https://developers.pinterest.com/docs/conversions/3rd-party-api-integrations/#Pinterest%20API%20for%20Conversions%20Event%20Parameters">LIEN</a>.</td></tr><tr><td><code>Envoyer comme requête de test</code></td><td>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 <a href="https://developers.pinterest.com/docs/conversions/conversion-management/#Testing%20your%20request">LIEN</a>.</td></tr></tbody></table>

## Référence rapide

| Events Commanders Act                                                                                                                                                                                                                                                                                                                                                                                                   | 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>paiement</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`         |

## Mappings des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.\
Au moins une des affirmations suivantes doit être satisfaite :\
• <mark style="color:bleu;">`user_data.em`</mark> est défini.\
• <mark style="color:bleu;">`user_data.hashed_maids`</mark> est défini.\
• <mark style="color:bleu;">`user_data.client_ip_address`</mark> and <mark style="color:bleu;">`user_data.client_user_agent`</mark> sont définis.\
La propriété <mark style="color:bleu;">`event_id`</mark> est requise et utilisée pour la déduplication. Plus d'informations sont disponibles en suivant ce [LIEN](https://developers.pinterest.com/docs/conversions/conversions/) (voir la section « Comment fonctionne la déduplication »).
{% endhint %}

<table><thead><tr><th width="382.6685580062746">Propriétés Commanders Act</th><th>Pinterest Properties</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.\
> **1.** Si cette propriété n'est pas fournie, un <mark style="color:bleu;">`action_source`</mark> est récupéré à l'aide des données disponibles. Valeurs prises en charge : <mark style="color:bleu;">`app_android`</mark> , <mark style="color:bleu;">`app_ios`</mark> , <mark style="color:bleu;">`offline`</mark> and <mark style="color:bleu;">`web`</mark> . Valeur par défaut : <mark style="color:bleu;">`web`</mark> .\
> **2.** Si cette propriété n'est pas fournie, un<mark style="color:bleu;">`event_source_url`</mark>approprié est récupéré à l'aide des données disponibles.\
> **3.** Valeur booléenne ou chaîne équivalente prise en charge.\
> **4.** Si elle est transmise en texte clair, elle est automatiquement hachée.\
> **5.** Priorité dans la colonne de gauche. Si la valeur ne peut pas être récupérée à partir de l'URL, le <mark style="color:bleu;">`Click Id Cookie Name`</mark> ou le nom du cookie par défaut`_epik` est utilisé.\
> **6.** Tous les identifiants des articles sont pris en compte.
> {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/pinterest.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.