> 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/alphalyr-marketing-studio.md).

# 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/).

## Fonctionnalités clés

La destination Alphalyr Marketing Studio 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) prend en charge les page types d'Alphalyr, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages préconfigurés**: le mappage des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage 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 sont transmises à Rakuten Advertising.

## Configuration de la destination

### Configuration

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="404">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Clé publique client</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre clé publique unique fournie par Alphalyr Marketing Studio.</td></tr><tr><td><code>Type de client</code></td><td>Définit votre type de client. Prend la valeur <code>0</code> lorsqu'il s'agit d'un client existant et <code>1</code> lorsqu'il s'agit d'un nouveau client.</td></tr><tr><td><code>Identifiant unique de l'utilisateur (UUID)</code></td><td>Valeur UUID du cookie de l'utilisateur. Suite aux dernières mises à jour du protocole ITP sur Safari / iOS, Alphalyr vous recommande fortement d'utiliser un cookie "server" provenant directement de votre domaine First party.</td></tr><tr><td><code>Données personnalisées</code></td><td>Données supplémentaires pouvant être ajoutées pour un traitement personnalisé des données.</td></tr><tr><td><code>Est une SPA</code></td><td>Indique si votre site web est une Single Page Application.</td></tr><tr><td><code>Consentement GDPR</code></td><td>Consentement GDPR. Prend la valeur <code>1</code> lorsque le GDPR s'applique ou <code>0</code> sinon.</td></tr><tr><td><code>Statut du consentement pour Ads &#x26; Marketing</code></td><td>Statut du consentement pour Ads &#x26; Marketing. 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.</td></tr><tr><td><code>Statut du consentement pour Performance</code></td><td>Statut du consentement pour Performance. 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.</td></tr></tbody></table>

## Référence rapide

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

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Commanders Act Events</th><th>Types de page Alphalyr</th></tr></thead><tbody><tr><td><code>purchase</code></td><td><code>purchase</code></td></tr><tr><td><code>view_cart</code></td><td><code>cart</code></td></tr><tr><td><code>view_item</code></td><td><code>product</code></td></tr><tr><td><code>view_item_list</code></td><td><code>category</code></td></tr><tr><td><code>[Any Other Event]</code></td><td><code>home</code></td></tr></tbody></table>

## Correspondance 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-header-hidden="false" data-header-sticky><thead><tr><th>Champs Smart Mapping</th><th>Propriétés par défaut de Commanders Act</th><th>Propriétés Alphalyr</th></tr></thead><tbody><tr><td><code>-</code></td><td><code>event_name</code></td><td><code>page</code> <strong>[1]</strong></td></tr><tr><td><code>-</code></td><td><code>Clé publique client</code></td><td><code>aid</code></td></tr><tr><td><code>MD5 de l'e-mail utilisateur</code></td><td><code>user.email_md5</code></td><td><code>cid</code></td></tr><tr><td><code>-</code><br><code>-</code></td><td><p><code>Identifiant unique de l'utilisateur (UUID)</code></p><p><code>user.consistent_anonymous_id</code></p></td><td><code>uuid</code> <strong>[2]</strong></td></tr><tr><td><code>Référent de page</code></td><td><code>context.page.referrer</code></td><td><code>referrer</code></td></tr><tr><td><code>IP de l'appareil</code></td><td><code>context.device.ip</code></td><td><code>ip_address</code> <strong>[3]</strong></td></tr><tr><td><code>User Agent de l'appareil</code></td><td><code>context.device.user_agent</code></td><td><code>user_agent</code></td></tr><tr><td><code>-</code></td><td><code>app.name</code></td><td><code>deviceType</code> <strong>[4]</strong></td></tr><tr><td><code>URL de la page</code></td><td><code>context.page.url</code></td><td><code>path</code> <strong>[5]</strong></td></tr><tr><td><code>ID de l'item</code></td><td><code>items.X.id</code></td><td><code>prodId</code> <strong>[6]</strong></td></tr><tr><td><code>Nom de l'item</code></td><td><code>items.X.product.name</code></td><td><code>prodDescription</code> <strong>[6]</strong></td></tr><tr><td><code>Prix de l'item</code></td><td><code>items.X.product.price</code></td><td><code>prodPrice</code> <strong>[6]</strong></td></tr><tr><td><code>ID de la liste d'items</code></td><td><code>item_list_id</code></td><td><code>catId</code> <strong>[7]</strong></td></tr><tr><td><code>Nom de la liste d'items</code></td><td><code>item_list_name</code></td><td><code>catDescription</code> <strong>[7]</strong></td></tr><tr><td><p><code>ID de l'item</code></p><p><code>Quantité de l'item</code></p><p><code>Prix de l'item</code></p></td><td><p><code>items.X.id</code></p><p><code>items.X.quantity</code></p><p><code>items.X.product.price</code></p></td><td><code>products</code> <strong>[8][9]</strong></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>currency</code> <strong>[9]</strong></td></tr><tr><td><code>Revenu de transaction</code><br><code>Valeur de transaction</code></td><td><p><code>revenue</code></p><p><code>value</code></p></td><td><code>totalPrice</code> <strong>[9][10]</strong></td></tr><tr><td><code>Valeur de transaction</code></td><td><code>value</code></td><td><code>totalPriceWithTax</code> <strong>[11]</strong></td></tr><tr><td><code>Montant de livraison</code></td><td><code>shipping_amount</code></td><td><code>shippingPrice</code> <strong>[11]</strong></td></tr><tr><td><code>ID de transaction</code></td><td><code>id</code></td><td><code>reference</code> <strong>[11]</strong></td></tr><tr><td><code>-</code></td><td><code>Type de client</code></td><td><code>new</code> <strong>[11]</strong></td></tr><tr><td><code>Code coupon</code></td><td><code>coupon</code></td><td><code>discountCode</code> <strong>[11]</strong></td></tr><tr><td><code>Remise sur l'item</code></td><td><code>items.X.discount</code></td><td><code>discountAmount</code> <strong>[8][11]</strong></td></tr><tr><td><code>-</code></td><td><code>Données personnalisées</code></td><td><code>customData</code> <strong>[11]</strong></td></tr><tr><td><code>-</code></td><td><code>Consentement GDPR</code></td><td><code>gdpr_consent</code></td></tr><tr><td><code>-</code></td><td><code>Statut du consentement pour Ads &#x26; Marketing</code></td><td><code>consent_ads</code></td></tr><tr><td><code>-</code></td><td><code>Statut du consentement pour Performance</code></td><td><code>consent_performance</code></td></tr><tr><td><code>-</code></td><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.\
**2.** Champ automatiquement haché avec SHA256 s'il est transmis en clair. L'ordre de priorité est indiqué dans la colonne de gauche.\
**3.** Champ anonymisé.\
**4.** Il s'agit soit de <mark style="color:blue;">`m`</mark> ou <mark style="color:blue;">`d`</mark> selon que <mark style="color:blue;">`eventModel.app.name`</mark> est défini ou non.\
**5.** La <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 [objet URL](https://developer.mozilla.org/en-US/docs/Web/API/URL) pour plus de détails).\
**6.** Pour Alphalyr <mark style="color:blue;">`product`</mark> type de page uniquement.\
**7.** Pour Alphalyr <mark style="color:blue;">`category`</mark> type de page uniquement.\
**8.** Tous les items sont pris en compte.\
**9.** Pour Alphalyr <mark style="color:blue;">`purchase`</mark> et <mark style="color:blue;">`cart`</mark> type de page uniquement.\
**10.** Selon que le type de page Alphalyr est <mark style="color:blue;">`purchase`</mark> ou <mark style="color:blue;">`cart`</mark> alors <mark style="color:blue;">`revenue`</mark> ou <mark style="color:blue;">`value`</mark> est utilisé respectivement.\
**11.** Pour Alphalyr <mark style="color:blue;">`purchase`</mark> type de page uniquement.\
**12.** Lorsque <mark style="color:blue;">`Est une SPA`</mark> est signalé uniquement.
{% 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/alphalyr-marketing-studio.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.
