> 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/clinch-conversions-api.md).

# Clinch

{% hint style="info" %}
Cette destination est actuellement en cours de validation finale et sera bientôt disponible.
{% endhint %}

[la plateforme de Clinch](https://www.clinch.co/) est utilisée pour l'orchestration de contenu omnicanal. En utilisant cette destination, vous pouvez activer le suivi server-to-server pour envoyer des événements à Clinch.

## Fonctionnalités clés

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

* **Structure des Events**: notre [Référence des Events](https://doc.commandersact.com/developers/tracking/events-reference) modèle couvre les types d'événements de Clinch, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages préétablis**: 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.
* **Mapping intelligent**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Mapping des Events**: changez le mapping standard entre les événements Clinch et les vôtres.
* **Prise en charge des données multi-articles**: les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) array sont envoyées à Clinch.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>ID client</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre identifiant client encodé (cid). Vous pouvez trouver cette valeur dans l'interface Clinch en suivant <code>Comptes</code> → <code>Sources de données</code> après avoir créé un <code>Pixel du site Web</code>. Ici, vous pouvez trouver le <code>ID de l'annonceur (cid)</code>.</td></tr><tr><td><code>ID de la source de données</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre identifiant de source de données encodé (dsid). Vous pouvez trouver cette valeur dans l'interface Clinch en suivant <code>Comptes</code> → <code>Sources de données</code> après avoir créé un <code>Pixel du site Web</code>. Ici, vous pouvez trouver le <code>Pixel ID (dsid)</code>.</td></tr><tr><td><code>Mapping des Events</code></td><td>Modifiez le mapping standard entre les types d'événements Clinch et vos Events ou ajoutez de nouveaux mappings. Valeur acceptée pour <code>type d'événement Clinch</code>: <code>PageView</code>, <code>HomePage</code>, <code>Landing</code>, <code>Search</code>, <code>Category</code>, <code>Details</code>, <code>DetailsExit</code>, <code>AddToCart</code>, <code>RemFromCart</code>, <code>CartPage</code>, <code>AddToWishList</code>, <code>Checkout</code>, <code>conv</code>, <code>Registration</code> et <code>OfflineConv</code>.</td></tr><tr><td><code>Propriétés personnalisées de l'événement</code></td><td>Envoyez des propriétés personnalisées.</td></tr></tbody></table>

## Référence rapide

| Events de Commanders Act | Types d'événements Clinch                                                                                                       |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `page_view`              | <p><code>HomePage</code> <strong>\[1]</strong></p><p><code>Landing</code> <strong>\[2]</strong></p><p><code>PageView</code></p> |
| `search`                 | `Search`                                                                                                                        |
| `view_item_list`         | `Category`                                                                                                                      |
| `view_item`              | `Details`                                                                                                                       |
| `add_to_cart`            | `AddToCart`                                                                                                                     |
| `remove_from_cart`       | `RemFromCart`                                                                                                                   |
| `view_cart`              | `CartPage`                                                                                                                      |
| `add_to_wishlist`        | `AddToWishList`                                                                                                                 |
| `begin_checkout`         | `Checkout`                                                                                                                      |
| `purchase`               | <p><code>OfflineConv</code> <strong>\[3]</strong></p><p><code>conv</code></p>                                                   |
| `generate_lead`          | `Registration`                                                                                                                  |
| `[Any Other Event]`      | `Autre`                                                                                                                         |
| `[Any Event]`            | `[Any Event]` **\[4]**                                                                                                          |

{% hint style="info" %}
**1.** Définissez si la propriété <mark style="color:blue;">`page_type`</mark> est <mark style="color:blue;">`home`</mark> .\
**2.** Définissez si la propriété <mark style="color:blue;">`page_type`</mark> est <mark style="color:blue;">`landing`</mark> .\
**3.** Définissez si la propriété <mark style="color:blue;">`type`</mark> est <mark style="color:blue;">`offline`</mark> .\
**4.** Voir <mark style="color:blue;">`Mapping des Events`</mark> dans [Configuration](#configuration).
{% endhint %}

## Mappings de 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é.
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="361">Champ Smart Mapping</th><th width="423">Propriétés par défaut de Commanders Act</th><th width="393">Propriétés Clinch</th></tr></thead><tbody><tr><td><code>-</code></td><td><code>ID client</code></td><td><code>cid</code> <strong>[*]</strong></td></tr><tr><td><code>-</code></td><td><code>ID de la source de données</code></td><td><code>dsid</code> <strong>[*]</strong></td></tr><tr><td><code>IP de l'appareil</code></td><td><code>context.device.ip</code></td><td><code>user_ip</code> <strong>[*]</strong></td></tr><tr><td><code>User Agent de l'appareil</code></td><td><code>context.device.user_agent</code></td><td><code>user_agent</code> <strong>[*]</strong></td></tr><tr><td><code>URL de la page</code></td><td><code>context.page.url</code></td><td><code>referrer</code> <strong>[*]</strong></td></tr><tr><td><code>Horodatage de l'événement</code></td><td><code>context.event_timestamp</code></td><td><code>timestamp</code></td></tr><tr><td><code>ID du partenaire fournisseur</code></td><td><code>partners.clinch.partner</code></td><td><code>partner</code></td></tr><tr><td><code>ID cookie Clinch</code></td><td><code>partners.clinch.clinch_sid</code></td><td><code>clinch-sid</code> <strong>[1]</strong></td></tr><tr><td><code>ID de clic Clinch</code></td><td><code>partners.clinch.click_id</code></td><td><code>clinchClickId_[Client ID]</code> <strong>[2]</strong></td></tr><tr><td><code>Adresse e-mail de l'utilisateur</code></td><td><code>user.email</code></td><td><code>hem</code> <strong>[3]</strong></td></tr><tr><td><code>Identifiant mobile de l'appareil</code></td><td><code>context.device.advertising_id</code></td><td><code>did</code></td></tr><tr><td><code>Enveloppe ATS Liveramp</code></td><td><code>partners.clinch.ats_envelop</code></td><td><code>atsEnvelop</code></td></tr><tr><td><code>Uid2</code></td><td><code>partners.clinch.uid2</code></td><td><code>uid2</code></td></tr><tr><td><code>-</code></td><td><code>(event_name)</code></td><td><code>type</code> <strong>[4]</strong></td></tr><tr><td><code>Type secondaire de l'événement</code></td><td><code>partners.clinch.stype</code></td><td><code>stype</code> <strong>[5]</strong></td></tr><tr><td><code>Type de produit</code></td><td><code>partners.clinch.product</code></td><td><code>product</code> <strong>[6]</strong></td></tr><tr><td><code>Liste d'articles</code></td><td><code>items</code></td><td><code>-</code></td></tr><tr><td><code>ID de l'article</code></td><td><code>items.X.id</code></td><td><code>ids</code> <strong>[7]</strong></td></tr><tr><td><code>Catégorie de produit</code></td><td><code>partners.clinch.category</code></td><td><code>category</code></td></tr><tr><td><code>ID de l'article recommandé</code></td><td><code>items.X.rec_id</code></td><td><code>recommended</code> <strong>[7]</strong></td></tr><tr><td><code>Terme de recherche</code></td><td><code>search_term</code></td><td><code>term</code></td></tr><tr><td><code>Code IATA de la ville/de l'aéroport d'origine</code></td><td><code>partners.clinch.from</code></td><td><code>from</code></td></tr><tr><td><code>Code IATA de la ville/de l'aéroport de destination</code></td><td><code>partners.clinch.to</code></td><td><code>to</code></td></tr><tr><td><code>Départ</code></td><td><code>partners.clinch.departure</code></td><td><code>depart</code></td></tr><tr><td><code>Retour</code></td><td><code>partners.clinch.return</code></td><td><code>return</code></td></tr><tr><td><code>Code ville</code></td><td><code>partners.clinch.city</code></td><td><code>city</code></td></tr><tr><td><code>ID de transaction</code></td><td><code>id</code></td><td><code>orderId</code></td></tr><tr><td><code>Valeur de la transaction</code></td><td><code>value</code></td><td><code>amount</code></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>currency</code></td></tr><tr><td><code>Chaîne TCF</code></td><td><code>partners.clinch.tcf_string</code></td><td><code>tcf_string</code></td></tr><tr><td><code>Chaîne de confidentialité US</code></td><td><code>partners.clinch.usp_string</code></td><td><code>usp_string</code></td></tr><tr><td><code>Global Privacy Platform</code></td><td><code>partners.clinch.gpp_string</code></td><td><code>gpp_string</code></td></tr><tr><td><code>IDs de section imposés par GPP</code></td><td><code>partners.clinch.gpp_sid</code></td><td><code>gpp_sid</code></td></tr><tr><td><code>User Tags</code></td><td><code>partners.clinch.utags</code></td><td><code>utags</code></td></tr><tr><td><code>-</code></td><td><code>Propriétés personnalisées de l'événement</code></td><td><code>[Any property]</code> <strong>[8]</strong></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Valeur par défaut : à partir du cookie <mark style="color:blue;">`clinch-sid`</mark> .\
**2.** Valeur par défaut : à partir du paramètre <mark style="color:blue;">`clinchClickId_[Client ID]`</mark> dans <mark style="color:blue;">`URL de la page`</mark> ou cookie portant le même nom.\
**3.** Haché automatiquement s'il est transmis en clair.\
**4.** Voir [Référence rapide](#quick-reference).\
**5.** Valeur par défaut : à partir de la propriété <mark style="color:blue;">`event_name`</mark> .\
**6.** Valeurs acceptées : <mark style="color:blue;">`Ecommerce`</mark>, <mark style="color:blue;">`Flight`</mark>, <mark style="color:blue;">`Hotel`</mark> et <mark style="color:blue;">`Car`</mark>.\
**7.** Chaîne séparée par des virgules avec tous les identifiants de produit.\
**8.** Voir <mark style="color:blue;">`Propriétés personnalisées de l'événement`</mark>  dans [Configuration](#configuration).
{% 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:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/clinch-conversions-api.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.