> 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 fait actuellement l’objet d’un examen final et sera bientôt disponible.
{% endhint %}

[La plateforme de Clinch](https://www.clinch.co/) est utilisée pour l’orchestration de contenu omnicanal. Cette destination vous permet d’activer le tracking server-to-server afin d’envoyer des événements à Clinch.

## Fonctionnalités clés

La destination Clinch offre les principales fonctionnalités suivantes :

* **Structure des événements** : notre [référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) couvre les types d’événements de Clinch, 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.
* **Mapping des événements** : modifiez le mapping standard entre les événements Clinch et les vôtres.
* **Prise en charge des données multi-éléments** : les informations incluses dans le tableau [élément](https://doc.commandersact.com/developers/tracking/events-reference#item) sont transmises à Clinch.

## Configuration de la destination

### Configuration

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Client Id</code></td><td><em><strong><code>Required</code></strong></em><br>Votre identifiant client encodé (cid). Vous trouverez cette valeur dans l’interface de Clinch en suivant <code>Accounts</code> → <code>Data Sources</code> après avoir créé un <code>Website Pixel</code>. Vous y trouverez l’ <code>Advertiser ID (cid)</code>.</td></tr><tr><td><code>Data Source Id</code></td><td><em><strong><code>Required</code></strong></em><br>Votre identifiant de source de données encodé (dsid). Vous trouverez cette valeur dans l’interface de Clinch en suivant <code>Accounts</code> → <code>Data Sources</code> après avoir créé un <code>Website Pixel</code>. Vous y trouverez l’ <code>Pixel ID (dsid)</code>.</td></tr><tr><td><code>Event Mapping</code></td><td>Modifiez le mapping standard entre les types d’événements Clinch et vos événements, ou ajoutez de nouveaux mappings. Valeurs acceptées pour <code>Clinch event type</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 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>Événements Commanders Act</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>[Any Other Event]</code></td><td><code>Other</code></td></tr><tr><td><code>[Any Event]</code></td><td><code>[Any Event]</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.** Consultez <mark style="color:bleu;">`Event Mapping`</mark> dans [Configuration](#configuration).
{% endhint %}

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l’aide de notre fonctionnalité [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) .
{% 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>Client Id</code></td><td><code>cid</code> <strong>[*]</strong></td></tr><tr><td><code>-</code></td><td><code>Data Source Id</code></td><td><code>dsid</code> <strong>[*]</strong></td></tr><tr><td><code>Device IP</code></td><td><code>context.device.ip</code></td><td><code>user_ip</code> <strong>[*]</strong></td></tr><tr><td><code>Device User Agent</code></td><td><code>context.device.user_agent</code></td><td><code>user_agent</code> <strong>[*]</strong></td></tr><tr><td><code>Page URL</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>Vendor Partner Id</code></td><td><code>partners.clinch.partner</code></td><td><code>partner</code></td></tr><tr><td><code>Clinch Cookie Id</code></td><td><code>partners.clinch.clinch_sid</code></td><td><code>clinch-sid</code> <strong>[1]</strong></td></tr><tr><td><code>Clinch Click Id</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 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>Liveramp ATS Envelope</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>Item List</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>Search Term</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 de 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>TCF String</code></td><td><code>partners.clinch.tcf_string</code></td><td><code>tcf_string</code></td></tr><tr><td><code>Chaîne US Privacy</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>ID des sections GPP appliquées</code></td><td><code>partners.clinch.gpp_sid</code></td><td><code>gpp_sid</code></td></tr><tr><td><code>Balises 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>[Toute propriété]</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 clair.\
**4.** Voir [Référence rapide](#quick-reference).\
**5.** Valeur par défaut : issue de la propriété <mark style="color:bleu;">`event_name`</mark> .\
**6.** Valeurs acceptées : <mark style="color:bleu;">`Ecommerce`</mark>, <mark style="color:bleu;">`Flight`</mark>, <mark style="color:bleu;">`Hotel`</mark> et <mark style="color:bleu;">`Car`</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 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/clinch-conversions-api.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.
