Skip to content

Latest commit

 

History

History
60 lines (45 loc) · 8.4 KB

alphalyr-marketing-studio.md

File metadata and controls

60 lines (45 loc) · 8.4 KB

Alphalyr Marketing Studio

Alphalyr 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.

Key features

The Alphalyr Marketing Studio destination provides the following key features:

  • Events structure: our 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.
  • Smart mapping: data mapping can be readjusted using your datalayer defined fields.
  • Support for multi-item data: information included in the item array is bridged to Rakuten Advertising.

Destination setup

Configuration

SettingsDescription
Client Public KeyRequired
Your unique public key as given by Alphalyr Marketing Studio. This setting supports dynamic values [1].
Customer TypeDefines your customer type. Takes the value 0 when it is an old client and 1 when it is a new one. This setting supports dynamic values [1].
User Unique Identifier (UUID)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. This setting supports dynamic values [1].
Custom DataAdditional data that can be added for custom data processing. This setting supports dynamic values [1].
Is SPAWhether your website is a Single Page Application.
GDPR ConsentGDPR consent. It takes the value 1 when GDPR applies or 0 otherwise. This setting supports dynamic values [1].
Consent Status for Ads & MarketingConsent status for ads & marketing. It takes the value 1 if the user has consented to the use of his data for targeting and marketing or 0 otherwise. This parameter is transmitted to Alphalyr's partners. This setting supports dynamic values [1].
Consent Status for PerformanceConsent status for performance. It takes the value 1 if the user has consented to the use of his data for the measurement of performance measurement or 0 otherwise. This parameter is transmitted to Alphalyr's partners. This setting supports dynamic values [1].

{% hint style="info" %} [1] This feature allows you to set an event property holding a dynamic value by adding two open braces ({{) in front of your property name and two close braces (}}) at the end (E.g. {{myEventPropertyPathAndName}}). {% endhint %}

Quick reference

{% hint style="info" %} Use 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" %} Most properties can be remapped using our "Smart Mapping" feature. {% endhint %}

Commanders Act PropertiesAlphalyr Properties
(event_name)page [1]
Client Public Keyaid
user.email_md5cid

User Unique Identifier (UUID)

user.consistent_anonymous_id

uuid [2]
context.page.referrerreferrer
context.device.ipip_address [3]
context.device.user_agentuser_agent
(eventModel.app.name)deviceType [4]
context.page.urlpath [5]
items.X.idprodId [6]
items.X.product.nameprodDescription [6]
items.X.product.priceprodPrice [6]
item_list_idcatId [7]
item_list_namecatDescription [7]
items.X.id:items.X.quantity:items.X.product.priceproducts [8][9]
currencycurrency [9]

revenue

value

totalPrice [9][10]
valuetotalPriceWithTax [11]
shipping_amountshippingPrice [11]
idreference [11]
Customer Typenew [11]
coupondiscountCode [11]
items.X.discountdiscountAmount [8][11]
Custom DatacustomData [11]
GDPR Consentgdpr_consent
Consent Status for Ads & Marketingconsent_ads
Consent Status for Performanceconsent_performance
context.device.lifecycle.session_idgaSessionId [12]

{% hint style="info" %} [1] See 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 m or d depending if eventModel.app.name is set or not.
[5] The pathname part of context.page.url is set: additional parameter are added to the request based on searchParams (See URL object for more details).
[6] For Alphalyr product page type only.
[7] For Alphalyr category page type only.
[8] All items are taken into account.
[9] For Alphalyr purchase and cart page type only.
[10] Depending if Alphalyr page type is purchase or cart then revenue or value is used respectively.
[11] For Alphalyr purchase page type only.
[12] When Is SPA is flagged only. {% endhint %}