# Button

{% hint style="info" %}
Cette destination est actuellement en cours de révision finale et sera bientôt disponible.
{% endhint %}

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

## Principales fonctionnalités

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

* **Structure des events**: notre [Events reference](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 mappées vers les champs attendus de manière optimisée.
* **Mappings préconçus**: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les entrées utilisateur.
* **Smart mapping** : le mapping des données peut être réajusté en utilisant vos champs définis dans le datalayer.
* **Support des données multi-item**: les informations incluses dans le [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)array est transmis à Button.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="349">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>API Key</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre API key générée par Button. Pour plus de détails, vous pouvez consulter le suivant <a href="https://developer.usebutton.com/reference/authentication">LINK</a>.</td></tr><tr><td><code>Source Token</code></td><td>Token source/attribution Button. Ce champ est optionnel pour créer une commande, mais requis pour l'attribution. Lors du test de votre intégration, vous devez envoyer des source tokens factices à Button, au format suivant : <code>^fakesrctok-[a-f0-9]{16}$</code> (Par ex. <code>fakesrctok-abcdef0123456789</code>). Chaîne sécurisée pour URL jusqu'à 255 caractères.</td></tr><tr><td><code>Custom Event Properties</code></td><td>Mappez 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>Your event property</code>. Dans la colonne <code>Position de votre propriété d'événement</code> vous devriez conserver la valeur par défaut <code>Default (root)</code> car elle correspond mieux à la plupart des scénarios. Dans le cas où vous sélectionnez soit <code>In "items" {items.X}</code> ou <code>In "product" {items.X.product}</code> cette destination cherchera la propriété d'événement d'entrée en commençant par le 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>niveau respectivement 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              |
| ---------------------------- | ---------------------------- |
| `[N'importe quel événement]` | `Enregistrement de commande` |

## Mappages de champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping".
{% endhint %}

<table data-full-width="true"><thead><tr><th width="673.3333740234375">Propriétés Commanders Act</th><th>Butto Properties</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> et <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.  \
> \&#xNAN;**\[1]** Basé sur les valeurs à gauche et en fonction de la propriété `partners.button.total_as_decimal` .  \
> \&#xNAN;**\[2]** Définir comme un array contenant toutes les catégories fournies.  \
> \&#xNAN;**\[3]** si `partners.button.purchase_date` n'est pas fourni, `context.event_timestamp` est utilisé.  \
> \&#xNAN;**\[4]** Passer `true` (Boolean) si vous souhaitez définir des valeurs décimales pour les deux propriétés Button `total` et `line_items.X.total` , `false` (Boolean) ou ne pas définir sinon.  \
> \&#xNAN;**\[5]** S'il est transmis en clair, il est automatiquement haché via SHA256.  \
> \&#xNAN;**\[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 %}