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

[Button](https://www.usebutton.com/) permet le deep linking et l'optimisation du trafic affiliate, creator et social.\
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 fonctionnalités clés suivantes :

* **Structure des événements**: notre [référence des événements](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 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 les événements se fait automatiquement, ce qui simplifie la saisie utilisateur.
* **Smart mapping**: le mappage des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données à plusieurs items**: les informations incluses dans le [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)le tableau est transmis à 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>Clé API</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre clé API générée par Button. Pour plus de détails, vous pouvez consulter ce qui suit <a href="https://developer.usebutton.com/reference/authentication">LINK</a>.</td></tr><tr><td><code>Source Token</code></td><td>Token source/d'attribution Button. Ce champ est facultatif pour créer une commande, mais il est requis pour l'attribution. Lorsque vous testez votre intégration, vous devez envoyer des source tokens factices à Button, au format suivant : <code>^fakesrctok-[a-f0-9]{16}$</code> (p. ex. <code>fakesrctok-abcdef0123456789</code>). Chaîne URL-safe jusqu'à 255 caractères.</td></tr><tr><td><code>Propriétés d'événement personnalisées</code></td><td>Mappez vos propriétés d'événement personnalisées en définissant leurs noms de champ dans <code>nom de propriété Button</code> et en ajoutant le nom de champ contenant 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>Par défaut (racine)</code> car cela convient mieux à la plupart des scénarios. Si vous choisissez l'un ou l'autre <code>Dans "items" {items.X}</code> soit <code>Dans "product" {items.X.product}</code> cette destination recherchera la propriété d'événement en entrée à partir du <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#item">items </a>soit <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#product">product </a>niveau respectif et définissez la valeur dans <code>line_items.X.attributes</code> .</td></tr></tbody></table>

## Référence rapide

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

## Mappages 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 data-full-width="true"><thead><tr><th>Smart Mapping Fields</th><th width="330.3333740234375">Propriétés par défaut Commanders Act</th><th width="341.6666259765625">Propriétés Butto</th></tr></thead><tbody><tr><td><code>ID de la transaction</code></td><td><code>id</code></td><td><code>order_id</code> <strong>[*]</strong></td></tr><tr><td><code>Revenu de 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'item</code><br><code>Remise sur l'item</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 de l'article 1</code><br><code>Catégorie de l'article 2</code><br><code>Catégorie de l'article 3</code><br><code>Catégorie de l'article 4</code><br><code>Catégorie de l'article 5</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 en 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>ID de transaction client</code></td><td><code>id_variant</code></td><td><code>customer_order_id</code></td></tr><tr><td><code>Canal de commande du partenaire</code></td><td><code>partners.button.order_channel</code></td><td><code>partner_order_channel</code> <strong>[6]</strong></td></tr><tr><td><code>Date de finalisation</code></td><td><code>partners.button.finalization_date</code></td><td><code>finalization_date</code></td></tr><tr><td><code>Quantité de l'item</code></td><td><code>items.X.quantity</code></td><td><code>line_items.X.quantity</code></td></tr><tr><td><code>UPC de l'article</code></td><td><code>items.X.id</code></td><td><code>line_items.X.upc</code></td></tr><tr><td><code>Coupon de l'article</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 selon la propriété `partners.button.total_as_decimal` .\
**2.** Définissez-la comme un tableau contenant toutes les catégories fournies.\
**3.** si `partners.button.purchase_date` n'est pas fournie, `context.event_timestamp` est utilisée.\
**4.** Passez `vrai` (Booléen) si vous souhaitez définir des valeurs décimales pour les deux propriétés Button `total` et `line_items.X.total` , `faux` (Booléen) ou ne le définissez pas dans le cas contraire.\
**5.** S'il est transmis en clair, il est automatiquement haché via SHA256.\
**6.** Valeurs acceptées : `app` et `webview`. S'il n'est pas fourni, défini automatiquement 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 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/button.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.