# Button

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

[Button](https://www.usebutton.com/) fournit le deep linking et l’optimisation du trafic affiliate, creator & social.\
En utilisant cette destination, vous pouvez exploiter Button [Orders API pour signaler un achat](https://developer.usebutton.com/reference/report-an-order).

## Fonctionnalités clés

La destination Button fournit les principales fonctionnalités suivantes :

* **Structure des events**: notre [Référence des events](https://community.commandersact.com/platform-x/developers/tracking/events-reference) couvre [Button Orders API](https://developer.usebutton.com/reference/report-an-order), ce qui signifie que vos données sont correctement bridgées vers les champs attendus de manière optimisée.
* **Mappings préconfigurés**: le mapping des données pour les destinations basées sur les events se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Smart Mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-éléments**: les informations incluses dans le [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)array est bridged vers Button.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="349">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>API Key</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre clé API générée par Button. Pour plus de détails, vous pouvez consulter le lien suivant <a href="https://developer.usebutton.com/reference/authentication">LIEN</a>.</td></tr><tr><td><code>Source Token</code></td><td>Token de source/attribution Button. Ce champ est facultatif pour créer une commande, mais il est requis pour l’attribution. Lors des tests de votre intégration, vous devez envoyer des faux source tokens à Button, au format suivant : <code>^fakesrctok-[a-f0-9]{16}$</code> (Par ex. <code>fakesrctok-abcdef0123456789</code>). Chaîne sécurisée pour une URL jusqu’à 255 caractères.</td></tr><tr><td><code>Propriétés personnalisées d’événement</code></td><td>Mappez vos propriétés personnalisées d’événement en définissant leurs noms de champ dans <code>Nom de propriété Button</code> et en ajoutant le nom du champ qui contient la valeur dans <code>Votre propriété d’événement</code>. Dans la colonne <code>La position de la propriété de votre événement</code> vous devez conserver la valeur par défaut <code>Default (root)</code> car elle convient mieux à la plupart des scénarios. Si vous sélectionnez soit <code>Dans "items" {items.X}</code> soit de <code>Dans "product" {items.X.product}</code> cette destination recherchera la propriété d’événement d’entrée à partir du niveau <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#item">items </a>soit de <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#product">product </a>niveau respectivement et définissez la valeur dans <code>line_items.X.attributes</code> .</td></tr></tbody></table>

## Référence rapide

| Events Commanders Act | Button Tracking              |
| --------------------- | ---------------------------- |
| `[Tout événement]`    | `Enregistrement de commande` |

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

<table data-full-width="true"><thead><tr><th width="673.3333740234375">Propriétés Commanders Act</th><th>Propriétés Button</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>order_id</code> <strong>[*]</strong></td></tr><tr><td><code>revenue</code></td><td><code>total</code> <strong>[*]</strong></td></tr><tr><td><code>currency</code></td><td><code>currency</code> <strong>[*]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>line_items.X.identifier</code> <strong>[*]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>line_items.X.sku</code> <strong>[*]</strong></td></tr><tr><td><code>items.X.product.price</code> <strong>[*]</strong>, <code>items.X.quantity</code> <strong>[*]</strong> and <code>items.X.discount</code></td><td><code>line_items.X.total</code> <strong>[*][1]</strong></td></tr><tr><td><p><code>items.X.product.category_1</code> <strong>[*]</strong></p><p><code>items.X.product.category_2</code></p><p><code>items.X.product.category_3</code></p><p><code>items.X.product.category_4</code></p><p><code>items.X.product.category_5</code></p></td><td><code>line_items.X.category</code> <strong>[*][2]</strong></td></tr><tr><td><code>items.X.product.name</code></td><td><code>line_items.X.description</code> <strong>[*]</strong></td></tr><tr><td><code>source_token</code></td><td><code>btn_ref</code></td></tr><tr><td><p><code>partners.button.purchase_date</code></p><p><code>context.event_timestamp</code></p></td><td><code>purchase_date</code> <strong>[3]</strong></td></tr><tr><td><code>partners.button.total_as_decimal</code></td><td><code>total_as_decimal</code> <strong>[4]</strong></td></tr><tr><td><code>user.id</code></td><td><code>customer.id</code></td></tr><tr><td><code>user.email</code></td><td><code>customer.email_sha256</code> <strong>[5]</strong></td></tr><tr><td><code>context.device.advertising_id</code></td><td><code>customer.device_id</code></td></tr><tr><td><code>user.new_user</code></td><td><code>customer.is_new_user</code></td></tr><tr><td><code>id_variant</code></td><td><code>customer_order_id</code></td></tr><tr><td><code>partners.button.order_channel</code></td><td><code>partner_order_channel</code> <strong>[6]</strong></td></tr><tr><td><code>partners.button.finalization_date</code></td><td><code>finalization_date</code></td></tr><tr><td><code>items.X.quantity</code></td><td><code>line_items.X.quantity</code></td></tr><tr><td><code>items.X.id</code></td><td><code>line_items.X.upc</code></td></tr><tr><td><code>items.X.coupon</code></td><td><code>line_items.X.attributes.coupon_code</code></td></tr></tbody></table>

{% hint style="info" %}

> **\*** Propriété obligatoire.\
> **1.** En fonction des valeurs à gauche et selon la propriété `partners.button.total_as_decimal` .\
> **2.** Définissez-la comme un array avec toutes les catégories fournies.\
> **3.** si `partners.button.purchase_date` n’est pas fournie, `context.event_timestamp` est utilisé.\
> **4.** Passez `true` (Boolean) si vous souhaitez définir des valeurs décimales pour les deux propriétés Button `total` and `line_items.X.total` , `false` (Boolean) ou ne définissez rien dans le cas contraire.\
> **5.** S’il est transmis en texte clair, il est automatiquement haché via SHA256.\
> **6.** Valeurs acceptées : `app` and `webview`. S’il n’est pas fourni, définissez automatiquement `app` lorsque la propriété `context.app.name` est non vide. Valeur par défaut : `webview`.
> {% endhint %}


---

# Agent Instructions: 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/button.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.