Raccogliere dati Commerce tramite tag Adobe Experience Platform
Anche se è possibile utilizzare l'estensione Data Connection per pubblicare e sottoscrivere eventi storefront, alcuni commercianti potrebbero già utilizzare una soluzione di raccolta dati, ad esempio i tag Adobe Experience Platform. Per questi commercianti, Adobe Commerce fornisce un'opzione di sola pubblicazione nell'estensione Data Connection che utilizza Adobe Commerce Event SDK.
Flusso di dati dell'estensione
Flusso di dati dell'estensione Data Connectioncon tag
In questo argomento verrà illustrato come mappare i valori degli eventi storefront forniti dall'estensione Data Connection alla soluzione di tag Adobe Experience Platform già in uso.
Raccogliere dati evento da Adobe Commerce
Per raccogliere i dati evento di Commerce:
-
Installa Adobe Commerce Events SDK. Per le vetrine PHP, vedere l'argomento install. Per le vetrine PWA Studi, consulta la guida PWA Studi.
note note NOTE non configurare l'ID organizzazione e l'ID dello stream di dati.
Mappatura dei dati della vetrina Commerce su Adobe Experience Platform
Per mappare i dati della vetrina Commerce a Adobe Experience Platform, configura e installa quanto segue dai tag di Adobe Experience Platform:
-
Impostare una proprietà tag in Raccolta dati di Adobe Experience Platform.
-
In Authoring, seleziona Estensioni e installa e configura le seguenti estensioni:
-
Tag Publish per l'ambiente di sviluppo.
-
Segui i passaggi Mappatura eventi seguenti per configurare elementi di dati e regole per eventi specifici.
Mappatura di eventi
Poiché la raccolta dei dati utilizzando i tag è diversa dall’utilizzo dell’SDK degli eventi di Adobe Commerce, è importante comprendere i termini equivalenti utilizzati in entrambi i framework.
azioni regola - gestori eventi (inviare a Adobe Experience Platform)
Quando aggiorni gli elementi dati e le regole nei tag Adobe Experience Platform con dati evento specifici per Adobe Commerce, puoi adottare alcuni passaggi comuni.
Aggiungiamo ad esempio l'evento Adobe Commerce signOut
ai tag Adobe Experience Platform. I passaggi descritti di seguito, fatta eccezione per i valori specifici impostati, descrivono come aggiungere elementi dati e regole, applicabili a tutti gli eventi Adobe Commerce che si stanno aggiungendo ai tag.
-
Creare un elemento dati:
Crea nuovo elemento dati -
Imposta Name su
sign out
. -
Imposta Estensione su
Adobe Experience Platform Web SDK
. -
Imposta Data Element Type su
XDM object
. -
Seleziona la Sandbox e lo Schema che desideri aggiornare.
-
In userAccount > logout, imposta il valore in Logout visitatore su
1
.
Aggiorna valore disconnessione -
Seleziona Salva.
-
Crea una regola:
Crea nuova regola -
Seleziona Aggiungi in EVENTI.
-
Imposta Estensione su
Adobe Client Data Layer
. -
Imposta Tipo evento su
Data Pushed
. -
Seleziona Evento specifico e imposta Evento/Chiave da registrare per su
sign-out
. -
Seleziona Mantieni modifiche per salvare la nuova regola.
-
Aggiungi un’azione.
-
Imposta Estensione su
Adobe Experience Platform Web SDK
. -
Imposta Tipo azione su
Send Event
. -
Imposta Istanza su
Alloy
. -
Imposta Type su
userAccount.logout
. -
Imposta dati XDM su
%sign out%
. -
Fai clic su Salva.
Hai creato un elemento dati nello schema per l'evento
signOut
da Adobe Commerce. Inoltre, hai creato una regola con un’azione specifica che deve verificarsi quando l’evento viene attivato dalla vetrina Adobe Commerce.
Ripeti i passaggi precedenti nei tag per ciascuno degli eventi Adobe Commerce descritti di seguito.
Eventi disponibili
Per ciascuno dei seguenti eventi, mappa gli eventi Adobe Commerce nel tuo XDM seguendo i passaggi precedenti.
disconnetti
Attivazione quando un acquirente tenta di uscire.
Elementi dati
Crea il seguente elemento dati:
-
Esci:
- Nome:
Sign out
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
userAccount
>logout
- Disconnessione visitatore: Valore =
1
- Nome:
Regole
- Nome:
Sign out
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
sign-out
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
userAccount.logout
- Dati XDM:
%sign-out%
signIn
Attivazione quando un acquirente tenta di accedere.
Elementi dati
Crea i seguenti elementi dati:
-
E-mail account:
- Nome:
account email
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
accountContext.emailAddress
- Nome:
-
Tipo di account:
- Nome:
account type
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
accountContext.accountType
- Nome:
-
ID account:
- Nome:
account id
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]*:
accountContext.accountId
- Nome:
-
Accedi:
- Nome:
sign in
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
person
>accountID
- ID account: Valore =
%account id%
- Gruppo di campi:
person
>accountType
- Tipo di account: Valore =
%account type%
- Gruppo di campi:
person
>personalEmailID
- Indirizzo e-mail personale: Valore =
%account email%
- Gruppo di campi:
personalEmail
>address
- Indirizzo: Valore =
%account email%
- Gruppo di campi:
userAccount
>login
- Accesso visitatore: Valore =
1
- Nome:
Regole
- Nome:
sign in
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
sign-in
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
userAccount.login
- Dati XDM:
%sign in%
createAccount
Attivazione quando un acquirente tenta di creare un account.
Elementi dati
Crea i seguenti elementi dati:
-
E-mail account:
- Nome:
account email
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
accountContext.emailAddress
- Nome:
-
Tipo di account:
- Nome:
account type
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
accountContext.accountType
- Nome:
-
ID account:
- Nome:
account id
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
accountContext.accountId
- Nome:
-
Crea account:
- Nome:
Create account
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
person
>accountID
- ID account: Valore =
%account id%
- Gruppo di campi:
person
>accountType
- Tipo di account: Valore =
%account type%
- Gruppo di campi:
person
>personalEmailID
- Indirizzo e-mail personale: Valore =
%account email%
- Gruppo di campi:
personalEmail
>address
- Indirizzo: Valore =
%account email%
- Gruppo di campi:
userAccount
>createProfile
- Creazione profilo account: Valore =
1
- Nome:
Regole
- Nome:
Create account
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
create-account
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
userAccount.createProfile
- Dati XDM:
%create account%
editAccount
Attivazione quando un acquirente tenta di modificare un account.
Elementi dati
Crea i seguenti elementi dati:
-
E-mail account:
- Nome:
account email
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
accountContext.emailAddress
- Nome:
-
Tipo di account:
- Nome:
account type
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
accountContext.accountType
- Nome:
-
ID account:
- Nome:
account id
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
accountContext.accountId
- Nome:
-
Modifica account:
- Nome:
Edit account
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
person
>accountID
- ID account: Valore =
%account id%
- Gruppo di campi:
person
>accountType
- Tipo di account: Valore =
%account type%
- Gruppo di campi:
person
>personalEmailID
- Indirizzo e-mail personale: Valore =
%account email%
- Gruppo di campi:
personalEmail
>address
- Indirizzo: Valore =
%account email%
- Gruppo di campi:
userAccount
>updateProfile
- Creazione profilo account: Valore =
1
- Nome:
Regole
- Nome:
Edit account
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
edit-account
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
userAccount.updateProfile
- Dati XDM:
%edit account%
pageView
Attivazione al caricamento di qualsiasi pagina.
Elementi dati
Crea i seguenti elementi dati:
-
Nome pagina:
- Nome:
page name
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
pageContext.pageName
- Nome:
Regole
- Nome:
page view
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
page-view
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
web.webPageDetails.pageViews
- Dati XDM:
%page view%
productView
Attivazione al caricamento di qualsiasi pagina di prodotto.
Elementi dati
Crea i seguenti elementi dati:
-
Nome prodotto:
- Nome:
product name
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.name
- Nome:
-
SKU prodotto:
- Nome:
product sku
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.sku
- Nome:
-
URL immagine prodotto:
- Nome:
product image
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.mainImageUrl
- Nome:
-
Valuta prodotto:
- Nome:
product currency
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.pricing.currencyCode
- Nome:
-
Codice valuta:
- Nome:
currency code
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('product currency') || _satellite.getVar('storefront').storeViewCurrencyCode
- Nome:
-
Prezzo speciale:
- Nome:
special price
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.pricing.specialPrice
- Nome:
-
Prezzo normale:
- Nome:
regular price
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.pricing.regularPrice
- Nome:
-
Prezzo del prodotto:
- Nome:
product price
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('product regular price') || _satellite.getVar('product special price')
- Nome:
-
Visualizzazione prodotto:
- Nome:
product view
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
productListItems
. Selezionare Fornisci singoli elementi e fare clic sul pulsante Aggiungi elemento. Poiché questa vista è destinata a un PDP, è possibile compilare con un singolo elemento. - Gruppo di campi:
productListItems
>name
- Nome: Valore =
%product name%
- Gruppo di campi:
productListItems
>SKU
- SKU: Valore =
%product sku%
- Gruppo di campi:
productListItems
>priceTotal
- Prezzo totale: Valore =
%product price%
- Gruppo di campi:
productListItems
>currencyCode
- Codice valuta: Valore =
%currency code%
- Gruppo di campi:
productListItems
>ProductImageUrl
- ProductImageUrl: Valore =
%product image%
- Gruppo di campi:
commerce
>productViews
>value
- valore: Valore =
1
- Nome:
Regole
- Nome:
product view
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
product-page-view
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
commerce.productViews
- Dati XDM:
%product view%
searchRequestSent
Attivazione da eventi nel popover "cerca durante la digitazione" e da eventi nelle pagine dei risultati di ricerca.
Elementi dati
Crea i seguenti elementi dati:
-
Cerca input
- Nome:
search input
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
searchInputContext.units[0]
- Nome:
-
Cerca frase di input
- Nome:
search input phrase
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('search input').phrase;
- Nome:
-
Cerca ordinamento input
- Nome:
search input sort
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash const searchInput = _satellite.getVar('search input'); const sortFromInput = searchInput ? searchInput.sort : []; const sort = sortFromInput.map((searchSort) => { return { attribute: searchSort.attribute, order: searchSort.direction, }; }); return sort;
- Nome:
-
Cerca filtri di input
- Nome:
search input filters
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash const searchInput = _satellite.getVar('search input'); const filtersFromInput = searchInput ? searchInput.filter : []; const filters = filtersFromInput.map( (searchFilter) => { let value = []; let isRange = false; if (searchFilter.eq) { value.push(searchFilter.eq); } else if (searchFilter.in) { value = searchFilter.in; } else if (searchFilter.range) { isRange = true; value.push(String(searchFilter.range.from)); value.push(String(searchFilter.range.to)); } return { attribute: searchFilter.attribute, value, isRange, }; } ); return filters;
- Nome:
-
Richiesta di ricerca:
- Nome:
search request
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
siteSearch
>phrase
- value: non ancora disponibile
- Gruppo di campi:
siteSearch
>sort
. Selezionare Fornire l'intero oggetto. - Gruppo di campi:
siteSearch
>filter
. Selezionare Fornire l'intero oggetto. - Gruppo di campi:
searchRequest
>id
- Identificatore univoco: Valore =
%search request ID%
- Gruppo di campi:
searchRequest
>value
- valore: Valore =
1
- Nome:
Regole
- Nome:
search request sent
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
search-request-sent
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
searchRequest
- Dati XDM:
%search request%
searchResponseReceived
Attivazione quando Live Search restituisce i risultati per la pagina dei risultati di ricerca o popover "cerca durante la digitazione".
Elementi dati
Crea i seguenti elementi dati:
-
Risultati ricerca:
- Nome:
search results
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
searchResultsContext.units[0]
- Nome:
-
Numero di risultati della ricerca:
- Nome:
search result number of products
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('search result').products.length;
- Nome:
-
Prodotti dei risultati di ricerca:
- Nome:
search result products
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash const searchResult = _satellite.getVar('search result'); const productsFromResult = searchResult.products ? searchResult.products : []; const products = productsFromResult.map( (product) => { return { SKU: product.sku, name: product.name }; } ); return products;
- Nome:
-
Suggerimenti risultati ricerca:
- Nome:
search result products
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash const searchResult = _satellite.getVar('search result'); const suggestionsFromResult = searchResult.suggestions ? searchResult.suggestions : []; const suggestions = suggestionsFromResult.map((suggestion) => suggestion.suggestion); return suggestions;
- Nome:
-
URL immagine prodotto:
- Nome:
product image
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.mainImageUrl
- Nome:
-
Risposta di ricerca:
- Nome:
search response
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
siteSearch
>suggestions
. Selezionare Fornire l'intero oggetto. - Elemento dati:
%search result suggestions%
- Gruppo di campi:
siteSearch
>numberOfResults
- valore:
%search result number of products%
- Gruppo di campi:
productListItems
. Selezionare Fornire l'intero oggetto. - Gruppo di campi:
productListItems
>ProductImageUrl
- ProductImageUrl: Valore =
%product image%
- Elemento dati:
%search result products%
- Gruppo di campi:
searchResponse
>id
- Identificatore univoco: Valore =
%search response ID%
- Gruppo di campi:
searchResponse
>value
- valore: Valore =
1
- Nome:
Regole
- Nome:
search response received
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
search-response-received
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
searchResponse
- Dati XDM:
%search response%
addToCart
Attivazione quando un prodotto viene aggiunto a un carrello o ogni volta che la quantità di un prodotto nel carrello viene incrementata.
Elementi dati
Crea i seguenti elementi dati:
-
Nome prodotto:
- Nome:
product name
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.name
- Nome:
-
SKU prodotto:
- Nome:
product sku
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.sku
- Nome:
-
Codice valuta:
- Nome:
currency code
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.pricing.currencyCode
- Nome:
-
Prezzo speciale del prodotto:
- Nome:
product special price
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.pricing.specialPrice
- Nome:
-
URL immagine prodotto:
- Nome:
product image
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.mainImageUrl
- Nome:
-
Prezzo normale del prodotto:
- Nome:
product regular price
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.pricing.regularPrice
- Nome:
-
Prodotto prezzo:
- Nome:
product price
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('product regular price') || _satellite.getVar('product special price')
- Nome:
-
Carrello:
- Nome:
cart
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
shoppingCartContext
- Nome:
-
ID carrello:
- Nome:
cart id
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('cart').id
- Nome:
-
Aggiungi al carrello:
- Nome:
add to cart
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
productListItems
. Selezionare Fornisci singoli elementi e fare clic sul pulsante Aggiungi elemento. Poiché questa vista è destinata a un PDP, è possibile compilare con un singolo elemento. - Gruppo di campi:
productListItems
>name
- Nome: Valore =
%product name%
- Gruppo di campi:
productListItems
>SKU
- SKU: Valore =
%product sku%
- Gruppo di campi:
productListItems
>priceTotal
- Prezzo totale: Valore =
%product price%
- Gruppo di campi:
productListItems
>currencyCode
- Gruppo di campi:
productListItems
>ProductImageUrl
- ProductImageUrl: Valore =
%product image%
- Codice valuta: Valore =
%currency code%
- Gruppo di campi:
commerce
>cart
>cartID
- ID carrello: Valore =
%cart id%
- Gruppo di campi:
commerce
>productListAdds
>value
- valore: Valore =
1
- Nome:
Regole
- Nome:
add to cart
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
add-to-cart
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
commerce.productListAdds
- Dati XDM:
%add to cart%
openCart
Attivazione quando viene creato un nuovo carrello, che si verifica quando un prodotto viene aggiunto a un carrello vuoto.
Elementi dati
Crea il seguente elemento dati:
-
Apri carrello:
- Nome:
open cart
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
commerce
>productListOpens
>value
- valore: Valore =
1
- Gruppo di campi:
commerce
>cart
>cartID
- ID carrello: Valore =
%cart id%
- Gruppo di campi:
productListItems
. PerproductListItems
, è possibile precalcolare più elementi. Selezionare productListItems > Fornire l'intero array.
- Nome:
Regole
- Nome:
open cart
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
open-cart
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
commerce.productListOpens
- Dati XDM:
%open cart%
viewCart
Attivazione al caricamento di qualsiasi pagina del carrello.
Elementi dati
Crea i seguenti elementi dati:
-
Vetrina:
- Nome:
storefront
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
storefrontInstanceContext
- Nome:
-
URL immagine prodotto:
-
Nome:
product image
-
Estensione:
Adobe Client Data Layer
-
Tipo di elemento dati:
Data Layer Computed State
-
[Percorso facoltativo]:
productContext.mainImageUrl
-
Carrello:
- Nome:
cart
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
shoppingCartContext
-
-
ID carrello:
- Nome:
cart id
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('cart').id
- Nome:
-
Elementi elenco prodotti:
- Nome:
product list items:
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash const storefrontContext = _satellite.getVar('storefront'); const cart = _satellite.getVar('cart'); const returnList = []; cart.items.forEach(item => { const selectedOptions = []; item.configurableOptions?.forEach(option => { selectedOptions.push({ attribute: option.optionLabel, value: option.valueLabel, }); }); const productListItem = { SKU: item.product.sku, name: item.product.name, quantity: item.quantity, priceTotal: item.prices.price.value * item.quantity, currencyCode: item.prices.price.currency ? item.prices.price.currency : storefrontContext.storeViewCurrencyCode, selectedOptions: selectedOptions, }; returnList.push(productListItem); }); return returnList;
- Nome:
-
Visualizza carrello:
- Nome:
view cart
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
productListItems
. PerproductListItems
, possono essere presenti più elementi precalcolati. Selezionare productListItems > Popolare l'intero array. - Elemento dati:
%product list items%
- Gruppo di campi:
productListItems
>ProductImageUrl
- ProductImageUrl: Valore =
%product image%
- Gruppo di campi:
commerce
>cart
>cartID
- ID carrello: Valore =
%cart id%
- Gruppo di campi:
commerce
>productListViews
>value
- valore: Valore =
1
- Nome:
Regole
- Nome:
view cart
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
shopping-cart-view
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
commerce.productListViews
- Dati XDM:
%view cart%
removeFromCart
Attivazione quando un prodotto viene rimosso da un carrello o ogni volta che la quantità di un prodotto nel carrello viene diminuita.
Elementi dati
Crea i seguenti elementi dati:
-
Nome prodotto:
- Nome:
product name
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.name
- Nome:
-
SKU prodotto:
- Nome:
product sku
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.sku
- Nome:
-
Codice valuta:
- Nome:
currency code
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.pricing.currencyCode
- Nome:
-
Prezzo speciale del prodotto:
- Nome:
product special price
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.pricing.specialPrice
- Nome:
-
Prezzo normale del prodotto:
- Nome:
product regular price
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.pricing.regularPrice
- Nome:
-
Prodotto prezzo:
- Nome:
product price
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('product regular price') || _satellite.getVar('product special price')
- Nome:
-
Carrello:
- Nome:
cart
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
shoppingCartContext
- Nome:
-
ID carrello:
- Nome:
cart id
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('cart').id
- Nome:
-
Rimuovi dal carrello:
- Nome:
remove from cart
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
productListItems
. Selezionare Fornisci singoli elementi e fare clic sul pulsante Aggiungi elemento. Poiché questa vista è destinata a un PDP, è possibile compilare con un singolo elemento. - Gruppo di campi:
productListItems
>name
- Nome: Valore =
%product name%
- Gruppo di campi:
productListItems
>SKU
- SKU: Valore =
%product sku%
- Gruppo di campi:
productListItems
>priceTotal
- Prezzo totale: Valore =
%product price%
- Gruppo di campi:
productListItems
>currencyCode
- Codice valuta: Valore =
%currency code%
- Gruppo di campi:
commerce
>cart
>cartID
- ID carrello: Valore =
%cart id%
- Gruppo di campi:
commerce
>productListRemovals
>value
- valore: Valore =
1
- Nome:
Regole
- Nome:
remove from cart
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
remove-from-cart
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
commerce.productListRemovals
- Dati XDM:
%remove from cart%
beginCheckout
Attivazione quando l'acquirente fa clic su un pulsante di pagamento.
Elementi dati
Crea i seguenti elementi dati:
-
Vetrina:
- Nome:
storefront
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
storefrontInstanceContext
- Nome:
-
URL immagine prodotto:
- Nome:
product image
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.mainImageUrl
- Nome:
-
Carrello:
- Nome:
cart
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
shoppingCartContext
- Nome:
-
ID carrello:
- Nome:
cart id
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('cart').id
- Nome:
-
Elementi elenco prodotti:
- Nome:
product list items
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash const storefrontContext = _satellite.getVar('storefront'); const cart = _satellite.getVar('cart'); const returnList = []; cart.items.forEach(item => { const selectedOptions = []; item.configurableOptions?.forEach(option => { selectedOptions.push({ attribute: option.optionLabel, value: option.valueLabel, }); }); const productListItem = { SKU: item.product.sku, name: item.product.name, quantity: item.quantity, priceTotal: item.prices.price.value * item.quantity, currencyCode: item.prices.price.currency ? item.prices.price.currency : storefrontContext.storeViewCurrencyCode, selectedOptions: selectedOptions, }; returnList.push(productListItem); }); return returnList;
- Nome:
-
Avvia estrazione:
- Nome:
initiate checkout
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
productListItems
. PerproductListItems
, possono essere presenti più elementi precalcolati. Selezionare productListItems > Popolare l'intero array. - Elemento dati:
%product list items%
- Gruppo di campi:
productListItems
>ProductImageUrl
- ProductImageUrl: Valore =
%product image%
- Gruppo di campi:
commerce
>cart
>cartID
- ID carrello: Valore =
%cart id%
- Gruppo di campi:
commerce
>checkouts
>value
- valore: Valore =
1
- Nome:
Regole
- Nome:
initiate checkout
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
initiate-checkout
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
commerce.checkouts
- Dati XDM:
%initiate checkout%
placeOrder
Attivazione quando l’acquirente effettua un ordine.
Elementi dati
Crea i seguenti elementi dati:
-
E-mail account:
- Nome:
account email
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
accountContext.emailAddress
- Nome:
-
Vetrina:
- Nome:
storefront
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
storefrontInstanceContext
- Nome:
-
URL immagine prodotto:
- Nome:
product image
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
productContext.mainImageUrl
- Nome:
-
Carrello:
- Nome:
cart
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
shoppingCartContext
- Nome:
-
ID carrello:
- Nome:
cart id
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('cart').id
- Nome:
-
Ordine:
- Nome:
order
- Estensione:
Adobe Client Data Layer
- Tipo di elemento dati:
Data Layer Computed State
- [Percorso facoltativo]:
orderContext
- Nome:
-
Ordine Commerce:
- Nome:
commerce order
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash const order = _satellite.getVar('order'); const storefront = _satellite.getVar('storefront'); if (order.payments && order.payments.length) { payments = order.payments.map(payment => { return { paymentAmount: payment.total, paymentType: payment.paymentMethodCode, transactionID: order.orderId.toString(), }; }); } else { payments = [ { paymentAmount: order.grandTotal, paymentType: order.paymentMethodCode, transactionID: order.orderId.toString(), }, ]; } return { purchaseID: order.orderId.toString(), currencyCode: storefront.storeViewCurrencyCode, payments, };
- Nome:
-
Spedizione ordine:
- Nome:
order shipping
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash const order = _satellite.getVar('order'); return { shippingMethod: order.shipping.shippingMethod, shippingAmount: order.shipping.shippingAmount || 0, }
- Nome:
-
ID promozione:
- Nome:
promotion id
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash return _satellite.getVar('order').appliedCouponCode
- Nome:
-
Elementi elenco prodotti:
- Nome:
product list items
- Estensione:
Core
- Tipo di elemento dati:
Custom Code
- Apri editor:
code language-bash const storefrontContext = _satellite.getVar('storefront'); const cart = _satellite.getVar('cart'); const returnList = []; cart.items.forEach(item => { const selectedOptions = []; item.configurableOptions?.forEach(option => { selectedOptions.push({ attribute: option.optionLabel, value: option.valueLabel, }); }); const productListItem = { SKU: item.product.sku, name: item.product.name, quantity: item.quantity, priceTotal: item.prices.price.value * item.quantity, currencyCode: item.prices.price.currency ? item.prices.price.currency : storefrontContext.storeViewCurrencyCode, selectedOptions: selectedOptions, }; returnList.push(productListItem); }); return returnList;
- Nome:
-
Ordinamento:
- Nome:
place order
- Estensione:
Adobe Experience Platform Web SDK
- Tipo di elemento dati:
XDM object
- Gruppo di campi:
productListItems
. PerproductListItems
, possono essere presenti più elementi precalcolati. Selezionare productListItems > Popolare l'intero array. - Elemento dati:
%product list items%
- Gruppo di campi:
productListItems
>ProductImageUrl
- ProductImageUrl: Valore =
%product image%
- Gruppo di campi:
commerce
>order
- Identificatore univoco: Valore =
%commerce order%
- Gruppo di campi:
commerce
>shipping
- Identificatore univoco: Valore =
%order shipping%
- Gruppo di campi:
commerce
>promotionID
- ID promozione: Valore =
%promotion id%
- Gruppo di campi:
commerce
>purchases
>value
- valore: Valore =
1
- Indirizzo e-mail personale: Valore =
%account email%
- Gruppo di campi:
personalEmail
>address
- Indirizzo: Valore =
%account email%
- Nome:
Regole
- Nome:
place order
- Estensione:
Adobe Client Data Layer
- Tipo evento:
Data Pushed
- Evento specifico:
place-order
Azioni
- Estensione:
Adobe Experience Platform Web SDK
- Tipo azione:
Send event
- Tipo:
commerce.order
- Dati XDM:
%place order%
Impostare l’identità negli eventi storefront
Gli eventi storefront contengono informazioni di profilo basate sui campi personalEmail
(per gli eventi account) e identityMap
(per tutti gli altri eventi storefront). L'estensione Data Connection si unisce e genera profili basati su questi due campi. Ogni campo, tuttavia, prevede diversi passaggi da seguire per creare i profili:
personalEmail
- Si applica solo agli eventi account. Segui i passaggi, le regole e le azioni descritti sopraidentityMap
- Si applica a tutti gli altri eventi storefront. Vedi l’esempio seguente.
Esempio
Nei passaggi seguenti viene illustrato come configurare un evento pageView
con identityMap
nell'estensione Data Connection:
-
Configura l’elemento dati con il codice personalizzato per ECID:
Configura elemento dati con codice personalizzato -
Selezionare Open Editor e aggiungere il seguente codice personalizzato:
code language-javascript return alloy("getIdentity").then((result) => { var identityMap = { ECID: [ { id: ecid, primary: true } ], email: [ { id: email, primary: false } ] }; _satelite.setVar("identityMap", identityMap); });
-
Aggiorna lo schema XDM con
identityMap
impostato come ECID:
Imposta identityMap come ECID -
Definisci le azioni della regola che recuperano l’ECID:
Recupera ECID
Impostare l'identità negli eventi di back office
A differenza degli eventi storefront che utilizzano ECID per identificare e collegare le informazioni del profilo, i dati degli eventi back office sono basati su SaaS e quindi non è disponibile alcun ECID. Per gli eventi di back office, è necessario utilizzare l'e-mail per identificare in modo univoco gli acquirenti. In questa sezione imparerai a collegare i dati di un evento di back office a un ECID utilizzando l’e-mail.
-
Crea un elemento di mappa delle identità.
Crea mappa identità back office -
Selezionare Open Editor e aggiungere il seguente codice personalizzato:
const IdentityMap = {
"ECID": [
{
id: _satellite.getVar('ECID'),
primary: true,
},
],
};
if (_satellite.getVar('account email')) {
IdentityMap.email = [
{
id: _satellite.getVar('account email'),
primary: false,
},
];
}
return IdentityMap;
-
Aggiungere questo nuovo elemento a ogni campo
identityMap
.
Aggiorna ogni identityMap
Impostazione del consenso
Quando installi l'estensione Data Connection in Adobe Commerce, il consenso per la raccolta dei dati è attivato per impostazione predefinita. La rinuncia viene gestita tramite il cookie mg_dnt
. Se scegli di utilizzare mg_dnt
per gestire il consenso, puoi seguire i passaggi qui descritti. La documentazione di Adobe Experience Platform Web SDK include diverse opzioni aggiuntive per la gestione del consenso.
-
Creare un elemento dati Core Custom Code (
%do not track cookie%
) per il cookiemg_dnt
:
Crea non tiene traccia dell'elemento dati -
Creare un elemento dati Core Custom Code (
%consent%
) che restituisceout
se il cookie è impostato ein
in caso contrario:
Crea elemento dati consenso -
Configurare l'estensione Adobe Experience Platform Web SDK con l'elemento dati
%consent%
:
Aggiorna SDK con consenso
Avvisi
- La mancata esecuzione della procedura per disattivare la raccolta di Experienci Platform comporta il doppio conteggio degli eventi
- La mancata configurazione di mappature/eventi come descritto in questo argomento può influire sulle bacheche di Adobe Analytics
- Impossibile impostare Target tramite l'estensione Data Connection se la raccolta dati è disabilitata