> 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 phase de revue finale et sera bientôt disponible.
{% endhint %}

[La plateforme de Clinch](https://www.clinch.co/) est utilisée pour l’orchestration de contenu omnicanal. Grâce à cette destination, vous pouvez activer le tracking server-to-server pour envoyer des événements à Clinch.

## Fonctionnalités clés

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

* **Structure des événements**: notre [Référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) le 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édéfinis**: le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement 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.
* **Mappage d'événements**: modifiez le mappage standard entre les événements Clinch et les vôtres.
* **Prise en charge des données multi-items**: les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) Le tableau est transmis à 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>Obligatoire</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 source de données</code></td><td><em><strong><code>Obligatoire</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>ID du pixel (dsid)</code>.</td></tr><tr><td><code>Correspondance des événements</code></td><td>Modifiez le mappage standard entre les types d’événements Clinch et vos événements, ou ajoutez de nouveaux mappages. 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>Détails</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 d'événement personnalisées</code></td><td>Envoyez des propriétés personnalisées.</td></tr></tbody></table>

## Référence rapide

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Commanders Act Events</th><th>Types d’événements Clinch</th></tr></thead><tbody><tr><td><code>page_view</code></td><td><p><code>HomePage</code> <strong>[1]</strong></p><p><code>Landing</code> <strong>[2]</strong></p><p><code>PageView</code></p></td></tr><tr><td><code>search</code></td><td><code>Search</code></td></tr><tr><td><code>view_item_list</code></td><td><code>Category</code></td></tr><tr><td><code>view_item</code></td><td><code>Détails</code></td></tr><tr><td><code>add_to_cart</code></td><td><code>AddToCart</code></td></tr><tr><td><code>remove_from_cart</code></td><td><code>RemFromCart</code></td></tr><tr><td><code>view_cart</code></td><td><code>CartPage</code></td></tr><tr><td><code>add_to_wishlist</code></td><td><code>AddToWishList</code></td></tr><tr><td><code>begin_checkout</code></td><td><code>Checkout</code></td></tr><tr><td><code>purchase</code></td><td><p><code>OfflineConv</code> <strong>[3]</strong></p><p><code>conv</code></p></td></tr><tr><td><code>generate_lead</code></td><td><code>Registration</code></td></tr><tr><td><code>[Tout autre événement]</code></td><td><code>Autre</code></td></tr><tr><td><code>[Tout événement]</code></td><td><code>[Tout événement]</code> <strong>[4]</strong></td></tr></tbody></table>

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

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Mappage intelligent](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.
{% 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 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 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>Agent utilisateur 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>e-mail 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 de 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 d’é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 des articles</code></td><td><code>items</code></td><td><code>-</code></td></tr><tr><td><code>ID de l'item</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>catégorie</code></td></tr><tr><td><code>ID de l’élément recommandé</code></td><td><code>items.X.rec_id</code></td><td><code>recommandé</code> <strong>[7]</strong></td></tr><tr><td><code>Terme de recherche</code></td><td><code>search_term</code></td><td><code>terme</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>depuis</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>à</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>valeur</code></td><td><code>montant</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>Tags utilisateur</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 d'événement personnalisées</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 : depuis le cookie <mark style="color:bleu;">`clinch-sid`</mark> .\
**2.** Valeur par défaut : depuis le paramètre <mark style="color:bleu;">`clinchClickId_[Client Id]`</mark> dans <mark style="color:bleu;">`URL de la page`</mark> ou cookie portant le même nom.\
**3.** Haché automatiquement s’il est transmis en texte clair.\
**4.** Voir [Référence rapide](#quick-reference).\
**5.** Valeur par défaut : depuis la propriété <mark style="color:bleu;">`event_name`</mark> .\
**6.** Valeurs acceptées : <mark style="color:bleu;">`E-commerce`</mark>, <mark style="color:bleu;">`Vol`</mark>, <mark style="color:bleu;">`Hôtel`</mark> et <mark style="color:bleu;">`Voiture`</mark>.\
**7.** Chaîne séparée par des virgules contenant tous les identifiants de produit.\
**8.** Voir <mark style="color:bleu;">`Propriétés d'événement personnalisées`</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, and the optional `goal` query parameter:

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