> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/pinterest.md).

# Pinterest

[Pinterest](https://www.pinterest.com) est un service de partage d’images et un réseau social conçu pour permettre d’enregistrer et de découvrir des informations sur Internet à l’aide d’images, de GIF animés et de vidéos, sous forme de tableaux d’épingles.\
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. Vous trouverez davantage de détails techniques en suivant ce [LIEN](https://developers.pinterest.com/docs/api/v5/#tag/conversion_events).

## Fonctionnalités clés

La destination Pinterest propose 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) couvre les événements Pinterest, ce qui permet de faire correspondre correctement vos données aux champs attendus, de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur les événements s’effectue automatiquement, ce qui simplifie la saisie.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être ajusté à l’aide des champs définis dans votre datalayer.
* **Prise en charge des données à plusieurs éléments** : les informations incluses dans le tableau [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) sont transmises à Pinterest.

## Configuration de la destination

{% hint style="info" %}
Assurez-vous d’avoir accès à un [compte Pinterest Ads](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>API Access Token</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L’API Conversions de Pinterest nécessite un jeton d’accès pour authentifier vos activités. Vous trouverez plus de détails 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>Advertiser ID</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>ID de l’annonceur Pinterest. Vous trouverez plus de détails 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>Event Mapping</code></td><td>Modifiez le mappage standard entre les événements Pinterest et les vôtres, ou ajoutez de nouveaux mappages. Veillez à associer tout événement personnalisé à un événement standard Pinterest. Vous trouverez plus de détails en suivant ce <a href="https://developers.pinterest.com/docs/track-conversions/define-your-own-event-types">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. Il est fortement recommandé de le renseigner au moins pour les événements de paiement. Cela peut améliorer les performances des rapports, comme le ROAS/CPA. Nom du cookie par défaut : <code>_epik</code>. Vous trouverez plus de détails 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 en tant que 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 les mêmes messages de réponse. Utilisez ce mode pour vérifier vos requêtes et vous assurer que vos événements sont correctement construits. Vous trouverez plus de détails 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

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Événements Commanders Act</th><th>Événements Pinterest</th></tr></thead><tbody><tr><td><code>add_payment_info</code></td><td><code>add_payment_info</code></td></tr><tr><td><code>add_to_cart</code><br><code>addtocart</code></td><td><code>add_to_cart</code></td></tr><tr><td><code>add_to_wishlist</code></td><td><code>add_to_wishlist</code></td></tr><tr><td><code>app_install</code></td><td><code>app_install</code></td></tr><tr><td><code>app_open</code></td><td><code>app_open</code></td></tr><tr><td><code>begin_checkout</code></td><td><code>initiate_checkout</code></td></tr><tr><td><code>contact</code></td><td><code>contact</code></td></tr><tr><td><code>customize_product</code></td><td><code>customize_product</code></td></tr><tr><td><code>find_location</code></td><td><code>find_location</code></td></tr><tr><td><code>generate_lead</code></td><td><code>lead</code></td></tr><tr><td><code>page_view</code><br><code>pageview</code><br><code>pagevisit</code><br><code>view_item</code></td><td><code>page_visit</code></td></tr><tr><td><code>purchase</code><br><code>buy</code><br><code>pay</code><br><code>payment</code></td><td><code>checkout</code></td></tr><tr><td><code>schedule</code></td><td><code>schedule</code></td></tr><tr><td><code>search</code></td><td><code>search</code></td></tr><tr><td><code>sign_up</code><br><code>signup</code><br><code>completeregistration</code></td><td><code>signup</code></td></tr><tr><td><code>start_trial</code></td><td><code>start_trial</code></td></tr><tr><td><code>submit_application</code></td><td><code>submit_application</code></td></tr><tr><td><code>subscribe</code></td><td><code>subscribe</code></td></tr><tr><td><code>view_category</code><br><code>viewcategory</code><br><code>view_item_list</code></td><td><code>view_category</code></td></tr><tr><td><code>view_content</code><br><code>viewcontent</code></td><td><code>view_content</code></td></tr><tr><td><code>watch_video</code><br><code>watchvideo</code></td><td><code>watch_video</code></td></tr><tr><td><code>add_shipping_info</code><br><code>login</code><br><code>refund</code><br><code>remove_from_cart</code><br><code>select_content</code><br><code>select_item</code><br><code>view_cart</code><br><code>select_promotion</code><br><code>view_promotion</code></td><td><code>custom</code></td></tr></tbody></table>

## Correspondances 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 l’une des conditions suivantes doit être remplie :\
• <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> et <mark style="color:bleu;">`user_data.client_user_agent`</mark> sont définis.\
La propriété <mark style="color:bleu;">`event_id`</mark> est obligatoire et utilisée pour la déduplication. Vous trouverez plus d’informations en suivant ce [LIEN](https://developers.pinterest.com/docs/conversions/conversions/) (Voir la section « Fonctionnement de la déduplication »).
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Champs Smart Mapping</th><th>Propriétés par défaut de Commanders Act</th><th>Propriétés Pinterest</th></tr></thead><tbody><tr><td><code>Event Id</code></td><td><code>context.event_id</code></td><td><code>event_id</code> <strong>[*]</strong></td></tr><tr><td><code>Source de l’action</code></td><td><code>partners.pinterest.action_source</code></td><td><code>action_source</code> <strong>[1]</strong></td></tr><tr><td><code>Horodatage de l’événement</code></td><td><code>context.event_timestamp</code></td><td><code>event_time</code></td></tr><tr><td><code>Source URL</code></td><td><code>context.page.url</code></td><td><code>event_source_url</code> <strong>[2]</strong></td></tr><tr><td><code>User Opt-Out</code></td><td><code>partners.pinterest.opt_out</code></td><td><code>opt_out</code> <strong>[3]</strong></td></tr><tr><td><code>App Id</code></td><td><code>context.app.namespace</code></td><td><code>app_id</code></td></tr><tr><td><code>App Name</code></td><td><code>context.app.name</code></td><td><code>app_name</code></td></tr><tr><td><code>App Version</code></td><td><code>context.app.version</code></td><td><code>app_version</code></td></tr><tr><td><code>Marque de l’appareil</code></td><td><code>context.device.manufacturer</code></td><td><code>device_brand</code></td></tr><tr><td><code>Device Carrier</code></td><td><code>context.device.network.carrier</code></td><td><code>device_carrier</code></td></tr><tr><td><code>Modèle de l’appareil</code></td><td><code>context.device.model</code></td><td><code>device_model</code></td></tr><tr><td><code>Device Type</code></td><td><code>context.device.type</code></td><td><code>device_type</code></td></tr><tr><td><code>Device OS Version</code></td><td><code>context.device.os.version</code></td><td><code>os_version</code></td></tr><tr><td><code>Device WiFi</code></td><td><code>context.device.network.wifi</code></td><td><code>wifi</code> <strong>[3]</strong></td></tr><tr><td><code>Langue de l’utilisateur</code></td><td><code>context.device.lang</code></td><td><code>language</code></td></tr><tr><td><code>User Email SHA256</code></td><td><code>user.email_sha256</code></td><td><code>user_data.em</code> <strong>[4]</strong></td></tr><tr><td><code>Téléphone de l’utilisateur</code></td><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.gender</code></td><td><code>user_data.ge</code> <strong>[4]</strong></td></tr><tr><td><code>User Birthdate</code></td><td><code>user.birthdate</code></td><td><code>user_data.db</code> <strong>[4]</strong></td></tr><tr><td><code>Nom de l’utilisateur</code></td><td><code>user.lastname</code></td><td><code>user_data.ln</code> <strong>[4]</strong></td></tr><tr><td><code>Prénom de l’utilisateur</code></td><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.city</code></td><td><code>user_data.ct</code> <strong>[4]</strong></td></tr><tr><td><code>User State</code></td><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.zipcode</code></td><td><code>user_data.zp</code> <strong>[4]</strong></td></tr><tr><td><code>Pays de l’utilisateur</code></td><td><code>user.country</code></td><td><code>user_data.country</code> <strong>[4]</strong></td></tr><tr><td><code>ID utilisateur</code></td><td><code>user.id</code></td><td><code>user_data.external_id</code> <strong>[4]</strong></td></tr><tr><td><code>Identifiant mobile de l’appareil</code></td><td><code>context.device.advertising_id</code></td><td><code>user_data.hashed_maids</code> <strong>[4]</strong></td></tr><tr><td><code>Device IP</code></td><td><code>context.device.ip</code></td><td><code>user_data.client_ip_address</code></td></tr><tr><td><code>Device User Agent</code></td><td><code>context.device.user_agent</code></td><td><code>user_data.client_user_agent</code></td></tr><tr><td><code>Click Id</code><br><code>Source URL</code><br><code>-</code></td><td><code>partners.pinterest.click_id</code><br><code>context.page.url</code><br><code>Click Id Cookie Name</code></td><td><code>user_data.click_id</code> <strong>[5]</strong></td></tr><tr><td><code>ID de transaction</code></td><td><code>id</code></td><td><code>custom_data.order_id</code></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>custom_data.currency</code></td></tr><tr><td><code>Valeur</code></td><td><code>value</code></td><td><code>custom_data.value</code></td></tr><tr><td><code>ID de l’article</code></td><td><code>items.X.id</code></td><td><code>custom_data.content_ids</code> <strong>[6]</strong></td></tr><tr><td><code>Prix de l’article</code></td><td><code>items.X.product.price</code></td><td><code>custom_data.contents.X.item_price</code></td></tr><tr><td><code>Item Quantity</code></td><td><code>items.X.quantity</code></td><td><code>custom_data.contents.X.quantity</code></td></tr><tr><td><code>Item List</code></td><td><code>items.length</code></td><td><code>custom_data.num_items</code></td></tr><tr><td><code>Search Term</code></td><td><code>search_term</code></td><td><code>custom_data.search_string</code></td></tr><tr><td><code>User Opt-Out Type</code></td><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, une valeur <mark style="color:bleu;">`action_source`</mark> est récupérée à partir 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> et <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, une valeur appropriée<mark style="color:bleu;">`event_source_url`</mark>est récupérée à partir 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 depuis l’URL, le <mark style="color:bleu;">`Click Id Cookie Name`</mark> ou le nom de cookie par défaut`_epik` est utilisé.\
**6.** Tous les identifiants d’élément sont pris en compte.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
