# Alphalyr Marketing Studio

[Alphalyr](https://alphalyr.fr/) vous aide à booster 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/).

## Key features

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

* **Events structure**: notre [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) prend en charge les types de page Alphalyr, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Prebuilt mappings**: le mapping des données pour les destinations basées sur les events se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Smart mapping**: le mapping des données peut être réajusté à l’aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-item**: les informations incluses dans le tableau [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)Le tableau est rapproché de 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 les 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 les valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>User Unique Identifier (UUID)</code></td><td>Valeur UUID du cookie de l'utilisateur. À la suite des dernières mises à jour du protocole ITP sur Safari / iOS, Alphalyr recommande fortement d'utiliser un cookie "server" provenant directement de votre domaine First party. Ce paramètre prend en charge les valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Custom Data</code></td><td>Données supplémentaires pouvant être ajoutées pour le traitement de données personnalisées. Ce paramètre prend en charge les 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> dans le cas contraire. Ce paramètre prend en charge les valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Consent Status for Ads &#x26; Marketing</code></td><td>Statut de consentement pour ads &#x26; marketing. Il prend la valeur <code>1</code> si l'utilisateur a consenti à l'utilisation de ses données à des fins de ciblage et de marketing ou <code>0</code> dans le cas contraire. Ce paramètre est transmis aux partenaires d'Alphalyr. Ce paramètre prend en charge les valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Consent Status for Performance</code></td><td>Statut de consentement pour 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> dans le cas contraire. Ce paramètre est transmis aux partenaires d'Alphalyr. Ce paramètre prend en charge les 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 (par ex. `{{myEventPropertyPathAndName}}`).
{% endhint %}

## Référence rapide

{% hint style="info" %}
Utilisez [**les filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos événements correspondants.
{% 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 à l’aide de 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>valeur</code></p></td><td><code>totalPrice</code> <strong>[9][10]</strong></td></tr><tr><td><code>valeur</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 fourni dans la colonne de gauche.\
> \&#xNAN;**\[3]** Champ anonymisé.\
> \&#xNAN;**\[4]** Il s'agit soit de <mark style="color:bleu;">`m`</mark> ou <mark style="color:bleu;">`d`</mark> selon que <mark style="color:bleu;">`eventModel.app.name`</mark> est défini ou non.\
> \&#xNAN;**\[5]** Le <mark style="color:bleu;">`pathname`</mark> partie de <mark style="color:bleu;">`context.page.url`</mark> est défini : des paramètres supplémentaires sont ajoutés à la requête en fonction de <mark style="color:bleu;">`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:bleu;">`product`</mark> uniquement pour le type de page.\
> \&#xNAN;**\[7]** Pour Alphalyr <mark style="color:bleu;">`category`</mark> uniquement pour le type de page.\
> \&#xNAN;**\[8]** Tous les éléments sont pris en compte.\
> \&#xNAN;**\[9]** Pour Alphalyr <mark style="color:bleu;">`purchase`</mark> et <mark style="color:bleu;">`cart`</mark> uniquement pour le type de page.\
> \&#xNAN;**\[10]** Selon que le type de page Alphalyr est <mark style="color:bleu;">`purchase`</mark> ou <mark style="color:bleu;">`cart`</mark> ensuite <mark style="color:bleu;">`revenue`</mark> ou <mark style="color:bleu;">`valeur`</mark> est utilisé respectivement.\
> \&#xNAN;**\[11]** Pour Alphalyr <mark style="color:bleu;">`purchase`</mark> uniquement pour le type de page.\
> \&#xNAN;**\[12]** Quand <mark style="color:bleu;">`Is SPA`</mark> est uniquement signalé.
> {% endhint %}


---

# Agent Instructions: 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:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/alphalyr-marketing-studio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.