# Alphalyr Marketing Studio

[Alphalyr](https://alphalyr.fr/) vous aide à dynamiser votre commerce omnicanal avec les données qui comptent.\
En utilisant cette destination, vous pouvez connecter vos activités et événements avec [Alphalyr Marketing Studio](https://alphalyr.fr/marketing-studio/).

## Principales fonctionnalités

La destination Alphalyr Marketing Studio fournit les fonctionnalités clés suivantes :

* **Structure des events**: notre [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) prend en charge les types de page d'Alphalyr, 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.
* **Hachage automatique** : l'information est automatiquement hachée conformément aux spécifications du partenaire.
* **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 mappé vers Rakuten Advertising.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="404">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>Client Public Key</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre clé publique unique fournie par Alphalyr Marketing Studio. Ce paramètre prend en charge des valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Customer Type</code></td><td>Définit votre type de client. Prend la valeur <code>0</code> lorsqu'il s'agit d'un ancien client et <code>1</code> lorsqu'il s'agit d'un nouveau. Ce paramètre prend en charge des valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>User Unique Identifier (UUID)</code></td><td>Valeur UUID du cookie de l'utilisateur. Suite aux dernières mises à jour du protocole ITP sur Safari / iOS, Alphalyr recommande vivement d'utiliser un cookie « server » provenant directement de votre domaine First party. Ce paramètre prend en charge des valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Custom Data</code></td><td>Données supplémentaires pouvant être ajoutées pour un traitement de données personnalisé. Ce paramètre prend en charge des valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Is SPA</code></td><td>Indique si votre site web est une Single Page Application.</td></tr><tr><td><code>GDPR Consent</code></td><td>Consentement GDPR. Il prend la valeur <code>1</code> lorsque le GDPR s'applique ou <code>0</code> sinon. Ce paramètre prend en charge des valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Consent Status for Ads &#x26; Marketing</code></td><td>Statut de consentement pour les ads &#x26; marketing. Il prend la valeur <code>1</code> si l'utilisateur a consenti à l'utilisation de ses données pour le ciblage et le marketing ou <code>0</code> sinon. Ce paramètre est transmis aux partenaires d'Alphalyr. Ce paramètre prend en charge des valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Consent Status for Performance</code></td><td>Statut de consentement pour la performance. Il prend la valeur <code>1</code> si l'utilisateur a consenti à l'utilisation de ses données pour la mesure de la performance ou <code>0</code> sinon. Ce paramètre est transmis aux partenaires d'Alphalyr. Ce paramètre prend en charge des valeurs dynamiques <strong>[1].</strong></td></tr></tbody></table>

{% hint style="info" %}
**\[1]** Cette fonctionnalité vous permet de définir une propriété d'événement contenant une valeur dynamique en ajoutant deux accolades ouvrantes (`{{`) devant le nom de votre propriété et deux accolades fermantes (`}}`) à la fin (Ex. `{{myEventPropertyPathAndName}}`).
{% endhint %}

## Référence rapide

{% hint style="info" %}
Use [**Filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos événements de correspondance.
{% endhint %}

| Commanders Act Events | Alphalyr Page Types |
| --------------------- | ------------------- |
| `purchase`            | `purchase`          |
| `view_cart`           | `cart`              |
| `view_item`           | `product`           |
| `view_item_list`      | `category`          |
| `[Any Other Event]`   | `home`              |

## Mappages de champs

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

<table><thead><tr><th width="412.6685580062746">Propriétés Commanders Act</th><th>Alphalyr Properties</th></tr></thead><tbody><tr><td><code>(event_name)</code></td><td><code>page</code> <strong>[1]</strong></td></tr><tr><td><code>Client Public Key</code></td><td><code>aid</code></td></tr><tr><td><code>user.email_md5</code></td><td><code>cid</code></td></tr><tr><td><p><code>User Unique Identifier (UUID)</code></p><p><code>user.consistent_anonymous_id</code></p></td><td><code>uuid</code> <strong>[2]</strong></td></tr><tr><td><code>context.page.referrer</code></td><td><code>referrer</code></td></tr><tr><td><code>context.device.ip</code></td><td><code>ip_address</code> <strong>[3]</strong></td></tr><tr><td><code>context.device.user_agent</code></td><td><code>user_agent</code></td></tr><tr><td><code>(eventModel.app.name)</code></td><td><code>deviceType</code> <strong>[4]</strong></td></tr><tr><td><code>context.page.url</code></td><td><code>path</code> <strong>[5]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>prodId</code> <strong>[6]</strong></td></tr><tr><td><code>items.X.product.name</code></td><td><code>prodDescription</code> <strong>[6]</strong></td></tr><tr><td><code>items.X.product.price</code></td><td><code>prodPrice</code> <strong>[6]</strong></td></tr><tr><td><code>item_list_id</code></td><td><code>catId</code> <strong>[7]</strong></td></tr><tr><td><code>item_list_name</code></td><td><code>catDescription</code> <strong>[7]</strong></td></tr><tr><td><code>items.X.id</code>:<code>items.X.quantity</code>:<code>items.X.product.price</code></td><td><code>products</code> <strong>[8][9]</strong></td></tr><tr><td><code>currency</code></td><td><code>currency</code> <strong>[9]</strong></td></tr><tr><td><p><code>revenue</code></p><p><code>valeurs</code></p></td><td><code>totalPrice</code> <strong>[9][10]</strong></td></tr><tr><td><code>valeurs</code></td><td><code>totalPriceWithTax</code> <strong>[11]</strong></td></tr><tr><td><code>shipping_amount</code></td><td><code>shippingPrice</code> <strong>[11]</strong></td></tr><tr><td><code>id</code></td><td><code>reference</code> <strong>[11]</strong></td></tr><tr><td><code>Customer Type</code></td><td><code>new</code> <strong>[11]</strong></td></tr><tr><td><code>coupon</code></td><td><code>discountCode</code> <strong>[11]</strong></td></tr><tr><td><code>items.X.discount</code></td><td><code>discountAmount</code> <strong>[8][11]</strong></td></tr><tr><td><code>Custom Data</code></td><td><code>customData</code> <strong>[11]</strong></td></tr><tr><td><code>GDPR Consent</code></td><td><code>gdpr_consent</code></td></tr><tr><td><code>Consent Status for Ads &#x26; Marketing</code></td><td><code>consent_ads</code></td></tr><tr><td><code>Consent Status for Performance</code></td><td><code>consent_performance</code></td></tr><tr><td><code>context.device.lifecycle.session_id</code></td><td><code>gaSessionId</code> <strong>[12]</strong></td></tr></tbody></table>

{% hint style="info" %}

> **\[1]** Voir [Référence rapide](#quick-reference) pour plus de détails.  \
> \&#xNAN;**\[2]** Champ automatiquement haché avec SHA256 s'il est transmis en clair. L'ordre de priorité est indiqué dans la colonne de gauche.  \
> \&#xNAN;**\[3]** Champ anonymisé.  \
> \&#xNAN;**\[4]** Ceci est soit <mark style="color:blue;">`m`</mark> ou <mark style="color:blue;">`d`</mark> en fonction de si <mark style="color:blue;">`eventModel.app.name`</mark> est défini ou non.  \
> \&#xNAN;**\[5]** Le <mark style="color:blue;">`pathname`</mark> partie de <mark style="color:blue;">`context.page.url`</mark> est défini : des paramètres supplémentaires sont ajoutés à la requête en fonction de <mark style="color:blue;">`searchParams`</mark> (Voir [URL object](https://developer.mozilla.org/en-US/docs/Web/API/URL) pour plus de détails).  \
> \&#xNAN;**\[6]** Pour Alphalyr <mark style="color:blue;">`product`</mark> type de page uniquement.  \
> \&#xNAN;**\[7]** Pour Alphalyr <mark style="color:blue;">`category`</mark> type de page uniquement.  \
> \&#xNAN;**\[8]** Tous les éléments sont pris en compte.  \
> \&#xNAN;**\[9]** Pour Alphalyr <mark style="color:blue;">`purchase`</mark> et <mark style="color:blue;">`cart`</mark> type de page uniquement.  \
> \&#xNAN;**\[10]** Selon que le type de page Alphalyr est <mark style="color:blue;">`purchase`</mark> ou <mark style="color:blue;">`cart`</mark> puis <mark style="color:blue;">`revenue`</mark> ou <mark style="color:blue;">`valeurs`</mark> est utilisé respectivement.  \
> \&#xNAN;**\[11]** Pour Alphalyr <mark style="color:blue;">`purchase`</mark> type de page uniquement.  \
> \&#xNAN;**\[12]** Lorsque <mark style="color:blue;">`Is SPA`</mark> est uniquement signalé.
> {% endhint %}