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

# Alphalyr Marketing Studio

[Alphalyr](https://alphalyr.fr/) helps you boosting your omnichannel commerce with the data that matters.\
Using this destination you can connect your activities and events with [Alphalyr Marketing Studio](https://alphalyr.fr/marketing-studio/).

## Key features

The Alphalyr Marketing Studio destination provides the following key features:

* **Events structure**: our [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) supports Alphalyr's page types, meaning that your data is properly bridged to the expected fields in an optimized way.
* **Prebuilt mappings**: data mapping for event-based destinations happens automatically, which simplifies user inputs.
* **Automatic hashing**: information is automatically hashed matching partner specifications.
* **Smart mapping**: data mapping can be readjusted using your datalayer defined fields.
* **Support for multi-item data**: information included in the [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)array is bridged to Rakuten Advertising.

## Destination setup

### 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>Required</code></strong></em><br>Your unique public key as given by Alphalyr Marketing Studio.</td></tr><tr><td><code>Customer Type</code></td><td>Defines your customer type. Takes the value <code>0</code> when it is an old client and <code>1</code> when it is a new one.</td></tr><tr><td><code>User Unique Identifier (UUID)</code></td><td>UUID value of the user's cookie. Following the latest updates to the ITP protocol on Safari / iOS, Alphalyr strongly recommends that you use a "server" cookie coming directly from your first party domain.</td></tr><tr><td><code>Custom Data</code></td><td>Additional data that can be added for custom data processing.</td></tr><tr><td><code>Is SPA</code></td><td>Whether your website is a Single Page Application.</td></tr><tr><td><code>GDPR Consent</code></td><td>GDPR consent. It takes the value <code>1</code> when GDPR applies or <code>0</code> otherwise.</td></tr><tr><td><code>Consent Status for Ads &#x26; Marketing</code></td><td>Consent status for ads &#x26; marketing. It takes the value <code>1</code> if the user has consented to the use of his data for targeting and marketing or <code>0</code> otherwise. This parameter is transmitted to Alphalyr's partners.</td></tr><tr><td><code>Consent Status for Performance</code></td><td>Consent status for performance. It takes the value <code>1</code> if the user has consented to the use of his data for the measurement of performance measurement or <code>0</code> otherwise. This parameter is transmitted to Alphalyr's partners.</td></tr></tbody></table>

## Quick reference

{% hint style="info" %}
Use [**Destination filters**](https://doc.commandersact.com/features/destinations/destination-filters) to specify your matching events.
{% endhint %}

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

## Field mappings

{% hint style="info" %}
Properties can be remapped using our [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) feature.
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="218">Smart Mapping Fields</th><th width="334.6685580062746">Commanders Act Default Properties</th><th width="216.33144199372532">Alphalyr Properties</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>Client Public Key</code></td><td><code>aid</code></td></tr><tr><td><code>User Email MD5</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>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>Page Referrer</code></td><td><code>context.page.referrer</code></td><td><code>referrer</code></td></tr><tr><td><code>Device IP</code></td><td><code>context.device.ip</code></td><td><code>ip_address</code> <strong>[3]</strong></td></tr><tr><td><code>Device User Agent</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>Page URL</code></td><td><code>context.page.url</code></td><td><code>path</code> <strong>[5]</strong></td></tr><tr><td><code>Item Id</code></td><td><code>items.X.id</code></td><td><code>prodId</code> <strong>[6]</strong></td></tr><tr><td><code>Item Name</code></td><td><code>items.X.product.name</code></td><td><code>prodDescription</code> <strong>[6]</strong></td></tr><tr><td><code>Item Price</code></td><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>item_list_id</code></td><td><code>catId</code> <strong>[7]</strong></td></tr><tr><td><code>Item List Name</code></td><td><code>item_list_name</code></td><td><code>catDescription</code> <strong>[7]</strong></td></tr><tr><td><p><code>Item Id</code></p><p><code>Item Quantity</code></p><p><code>Item Price</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>Currency</code></td><td><code>currency</code></td><td><code>currency</code> <strong>[9]</strong></td></tr><tr><td><code>Transaction Revenue</code><br><code>Transaction Value</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>Transaction Value</code></td><td><code>value</code></td><td><code>totalPriceWithTax</code> <strong>[11]</strong></td></tr><tr><td><code>Shipping Amount</code></td><td><code>shipping_amount</code></td><td><code>shippingPrice</code> <strong>[11]</strong></td></tr><tr><td><code>Transaction Id</code></td><td><code>id</code></td><td><code>reference</code> <strong>[11]</strong></td></tr><tr><td><code>-</code></td><td><code>Customer Type</code></td><td><code>new</code> <strong>[11]</strong></td></tr><tr><td><code>Coupon Code</code></td><td><code>coupon</code></td><td><code>discountCode</code> <strong>[11]</strong></td></tr><tr><td><code>Item Discount</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>Custom Data</code></td><td><code>customData</code> <strong>[11]</strong></td></tr><tr><td><code>-</code></td><td><code>GDPR Consent</code></td><td><code>gdpr_consent</code></td></tr><tr><td><code>-</code></td><td><code>Consent Status for Ads &#x26; Marketing</code></td><td><code>consent_ads</code></td></tr><tr><td><code>-</code></td><td><code>Consent Status for 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.** See [Quick reference](#quick-reference) for more details.\
**2.** Field automatically hashed with SHA256 if passed in clear. Priority order is provided on the left column.\
**3.** Field anonymized.\
**4.** This is either <mark style="color:blue;">`m`</mark> or <mark style="color:blue;">`d`</mark> depending if <mark style="color:blue;">`eventModel.app.name`</mark> is set or not.\
**5.** The <mark style="color:blue;">`pathname`</mark> part of <mark style="color:blue;">`context.page.url`</mark> is set: additional parameter are added to the request based on <mark style="color:blue;">`searchParams`</mark> (See [URL object](https://developer.mozilla.org/en-US/docs/Web/API/URL) for more details).\
**6.** For Alphalyr <mark style="color:blue;">`product`</mark> page type only.\
**7.** For Alphalyr <mark style="color:blue;">`category`</mark> page type only.\
**8.** All items are taken into account.\
**9.** For Alphalyr <mark style="color:blue;">`purchase`</mark> and <mark style="color:blue;">`cart`</mark> page type only.\
**10.** Depending if Alphalyr page type is <mark style="color:blue;">`purchase`</mark> or <mark style="color:blue;">`cart`</mark> then <mark style="color:blue;">`revenue`</mark> or <mark style="color:blue;">`value`</mark> is used respectively.\
**11.** For Alphalyr <mark style="color:blue;">`purchase`</mark> page type only.\
**12.** When <mark style="color:blue;">`Is SPA`</mark> is flagged only.
{% 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/features/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.