> 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 de médias sociaux conçu pour permettre l’enregistrement et la découverte d’informations sur Internet à l’aide d’images, de GIF animés et de vidéos, sous forme de tableaux.\
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. Plus de détails techniques sont disponibles via ce [LIEN](https://developers.pinterest.com/docs/api/v5/#tag/conversion_events).

## Fonctionnalités clés

La destination Pinterest offre 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 Pinterest, ce qui signifie que vos données sont correctement associé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 se fait automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être réajusté à l’aide des champs définis dans votre data layer.
* **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 [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>jeton d’accès API</code></td><td><em><strong><code>Requis</code></strong></em><br>L'API Pinterest Conversions nécessite un jeton d’accès pour authentifier vos activités. Plus de détails sont disponibles via 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>ID de l'annonceur</code></td><td><em><strong><code>Requis</code></strong></em><br>ID annonceur Pinterest. Plus de détails sont disponibles via 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>Mappage des événements</code></td><td>Modifiez le mappage standard entre les événements Pinterest et les vôtres ou ajoutez de nouveaux mappages. Assurez-vous de mapper tout événement personnalisé à un événement standard Pinterest. Plus de détails sont disponibles en suivant ce <a href="https://developers.pinterest.com/docs/track-conversions/define-your-own-event-types">LIEN</a>.</td></tr><tr><td><code>Nom du cookie Click Id</code></td><td>Nom du cookie contenant le "Click Id" Pinterest qui identifie de manière unique un clic. C'est fortement recommandé au moins pour les événements de checkout. Cela peut améliorer les performances de reporting telles que 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 toujours 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 via 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>

## Mappages 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éfinie.\
• <mark style="color:bleu;">`user_data.hashed_maids`</mark> est définie.\
• <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 requise et utilisée pour la déduplication. Plus d'informations sont disponibles via ce [LIEN](https://developers.pinterest.com/docs/conversions/conversions/) (voir la section « Comment fonctionne 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>ID d’événement</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>URL source</code></td><td><code>context.page.url</code></td><td><code>event_source_url</code> <strong>[2]</strong></td></tr><tr><td><code>Opt-out utilisateur</code></td><td><code>partners.pinterest.opt_out</code></td><td><code>opt_out</code> <strong>[3]</strong></td></tr><tr><td><code>ID de l’application</code></td><td><code>context.app.namespace</code></td><td><code>app_id</code></td></tr><tr><td><code>Nom de l’application</code></td><td><code>context.app.name</code></td><td><code>app_name</code></td></tr><tr><td><code>Version de l’application</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>Opérateur de l’appareil</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>Type d’appareil</code></td><td><code>context.device.type</code></td><td><code>device_type</code></td></tr><tr><td><code>Version du système d’exploitation de l’appareil</code></td><td><code>context.device.os.version</code></td><td><code>os_version</code></td></tr><tr><td><code>WiFi de l’appareil</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>SHA256 de l’e-mail utilisateur</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>Genre de l’utilisateur</code></td><td><code>user.gender</code></td><td><code>user_data.ge</code> <strong>[4]</strong></td></tr><tr><td><code>Date de naissance de l’utilisateur</code></td><td><code>user.birthdate</code></td><td><code>user_data.db</code> <strong>[4]</strong></td></tr><tr><td><code>Nom de famille 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>Ville de l’utilisateur</code></td><td><code>user.city</code></td><td><code>user_data.ct</code> <strong>[4]</strong></td></tr><tr><td><code>État de l’utilisateur</code></td><td><code>user.state_short</code></td><td><code>user_data.st</code> <strong>[4]</strong></td></tr><tr><td><code>Code postal de l’utilisateur</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 de l’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>IP de l’appareil</code></td><td><code>context.device.ip</code></td><td><code>user_data.client_ip_address</code></td></tr><tr><td><code>User Agent de l’appareil</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>URL source</code><br><code>-</code></td><td><code>partners.pinterest.click_id</code><br><code>context.page.url</code><br><code>Nom du cookie Click Id</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’élément</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’élément</code></td><td><code>items.X.product.price</code></td><td><code>custom_data.contents.X.item_price</code></td></tr><tr><td><code>Quantité de l’élément</code></td><td><code>items.X.quantity</code></td><td><code>custom_data.contents.X.quantity</code></td></tr><tr><td><code>Liste d’éléments</code></td><td><code>items.length</code></td><td><code>custom_data.num_items</code></td></tr><tr><td><code>Terme de recherche</code></td><td><code>search_term</code></td><td><code>custom_data.search_string</code></td></tr><tr><td><code>Type d’Opt-out utilisateur</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, un <mark style="color:bleu;">`action_source`</mark> est récupéré à 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.** S'il est transmis en clair, il est automatiquement haché.\
**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;">`Nom du cookie Click Id`</mark> ou le nom de cookie par défaut`_epik` est utilisé.\
**6.** Tous les identifiants d'item 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 dynamically by asking a question.

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

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.