> 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/button.md).

# Button

{% hint style="info" %}
Cette destination fait actuellement l’objet d’un examen final et sera bientôt disponible.
{% endhint %}

[Button](https://www.usebutton.com/) permet le deep linking et l’optimisation du trafic d’affiliation, des créateurs et des réseaux sociaux.\
En utilisant cette destination, vous pouvez tirer parti de Button [Orders API pour signaler un achat](https://developer.usebutton.com/reference/report-an-order).

## Fonctionnalités clés

La destination Button offre les principales fonctionnalités suivantes :

* **Structure des événements** : notre [référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) couvre [l’Orders API de Button](https://developer.usebutton.com/reference/report-an-order), 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.
* **Mappage intelligent**: le mappage des données peut être ajusté à l’aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-articles** : les informations incluses dans le tableau [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)sont transmises à Button.

## Configuration de la destination

### Configuration

<table data-header-hidden="false" data-header-sticky><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, consultez le lien suivant <a href="https://developer.usebutton.com/reference/authentication">LINK</a>.</td></tr><tr><td><code>Source Token</code></td><td>Jeton source/d’attribution de Button. Ce champ est facultatif pour créer une commande, mais obligatoire pour l’attribution. Lors du test de votre intégration, vous devez envoyer à Button des jetons source fictifs au format suivant : <code>^fakesrctok-[a-f0-9]{16}$</code> (par exemple, <code>fakesrctok-abcdef0123456789</code>). Chaîne compatible avec les URL, d’une longueur maximale de 255 caractères.</td></tr><tr><td><code>Propriétés d’événement personnalisées</code></td><td>Associez vos propriétés d’événement personnalisées en définissant leurs noms de champ dans <code>Nom de la propriété Button</code> et en ajoutant le nom du champ contenant la valeur dans <code>Votre propriété d’événement</code>. Dans la colonne <code>Position de votre propriété d’événement</code> conservez la valeur par défaut <code>Par défaut (racine)</code> car elle convient à la plupart des cas. Si vous sélectionnez <code>Dans "items" {items.X}</code> ou <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>ou <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#product">product </a>respectivement, puis définira la valeur dans <code>line_items.X.attributes</code> .</td></tr></tbody></table>

## Référence rapide

| Événements Commanders Act | Suivi Button                 |
| ------------------------- | ---------------------------- |
| `[Tout événement]`        | `Enregistrement de commande` |

## 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 data-full-width="true"><thead><tr><th>Champs Smart Mapping</th><th width="330.3333740234375">Propriétés par défaut de Commanders Act</th><th width="341.6666259765625">Propriétés Butto</th></tr></thead><tbody><tr><td><code>ID de transaction</code></td><td><code>id</code></td><td><code>order_id</code> <strong>[*]</strong></td></tr><tr><td><code>Chiffre d’affaires de la transaction</code></td><td><code>revenue</code></td><td><code>total</code> <strong>[*]</strong></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>currency</code> <strong>[*]</strong></td></tr><tr><td><code>ID de l’article</code></td><td><code>items.X.id</code></td><td><code>line_items.X.identifier</code> <strong>[*]</strong></td></tr><tr><td><code>SKU de l’article</code></td><td><code>items.X.id</code></td><td><code>line_items.X.sku</code> <strong>[*]</strong></td></tr><tr><td><p><code>Prix de l’article</code></p><p><code>Quantité de l’article</code><br><code>Remise sur l’article</code></p></td><td><code>items.X.product.price</code> <strong>[*]</strong><br><code>items.X.quantity</code> <strong>[*]</strong><br><code>items.X.discount</code></td><td><code>line_items.X.total</code> <strong>[*][1]</strong></td></tr><tr><td><code>Catégorie 1 de l’article</code><br><code>Catégorie 2 de l’article</code><br><code>Catégorie 3 de l’article</code><br><code>Catégorie 4 de l’article</code><br><code>Catégorie 5 de l’article</code></td><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>Description de l’article</code></td><td><code>items.X.product.name</code></td><td><code>line_items.X.description</code> <strong>[*]</strong></td></tr><tr><td><code>-</code></td><td><code>Source Token</code></td><td><code>btn_ref</code></td></tr><tr><td><code>Date d’achat</code><br><code>Horodatage de l’événement</code></td><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>Total au format décimal</code></td><td><code>partners.button.total_as_decimal</code></td><td><code>total_as_decimal</code> <strong>[4]</strong></td></tr><tr><td><code>ID utilisateur</code></td><td><code>user.id</code></td><td><code>customer.id</code></td></tr><tr><td><code>E-mail de l’utilisateur</code></td><td><code>user.email</code></td><td><code>customer.email_sha256</code> <strong>[5]</strong></td></tr><tr><td><code>Identifiant mobile de l’appareil</code></td><td><code>context.device.advertising_id</code></td><td><code>customer.device_id</code></td></tr><tr><td><code>L’utilisateur est-il nouveau ?</code></td><td><code>user.new_user</code></td><td><code>customer.is_new_user</code></td></tr><tr><td><code>Customer Transaction Id</code></td><td><code>id_variant</code></td><td><code>customer_order_id</code></td></tr><tr><td><code>Partner Order Channel</code></td><td><code>partners.button.order_channel</code></td><td><code>partner_order_channel</code> <strong>[6]</strong></td></tr><tr><td><code>Finalization Date</code></td><td><code>partners.button.finalization_date</code></td><td><code>finalization_date</code></td></tr><tr><td><code>Item Quantity</code></td><td><code>items.X.quantity</code></td><td><code>line_items.X.quantity</code></td></tr><tr><td><code>Item UPC</code></td><td><code>items.X.id</code></td><td><code>line_items.X.upc</code></td></tr><tr><td><code>Item Coupon</code></td><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 de la propriété `partners.button.total_as_decimal` .\
**2.** Définir comme un tableau contenant toutes les catégories fournies.\
**3.** si `partners.button.purchase_date` n'est pas renseigné, `context.event_timestamp` est utilisé.\
**4.** Transmettez `true` (booléen) si vous souhaitez définir des valeurs décimales pour les propriétés Button `total` et `line_items.X.total` , `false` (booléen) dans le cas contraire.\
**5.** Si cette valeur est transmise en clair, elle est automatiquement hachée avec SHA256.\
**6.** Valeurs acceptées : `app` et `webview`. Si elle n'est pas renseignée, la valeur est automatiquement définie sur `app` lorsque la propriété `context.app.name` n'est pas vide. Valeur par défaut : `webview`.
{% 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/button.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.
