Raccogliere dati di Commerce tramite tag Adobe Experience Platform

Mentre è possibile utilizzare il Data Connection per pubblicare e iscriverti a eventi storefront, alcuni commercianti potrebbero già utilizzare una soluzione di raccolta dati, ad esempio Tag Adobe Experience Platform. Per questi commercianti, Adobe Commerce fornisce un’opzione di sola pubblicazione nel Data Connection estensione che utilizza l’SDK Adobe Commerce Event.

Data Connection Flusso di dati per le estensioni
Data ConnectionFlusso di dati per le estensioni con tag

In questo argomento, imparerai a mappare i valori dell’evento storefront fornito da Data Connection estensione della soluzione di tag Adobe Experience Platform già in uso.

Raccogliere dati evento da Adobe Commerce

Per raccogliere i dati dell’evento Commerce:

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:

  1. Impostare una proprietà tag in Raccolta dati di Adobe Experience Platform.

  2. Sotto Authoring, seleziona Estensioni e installare e configurare le seguenti estensioni:

  3. Pubblica tag nell'ambiente di sviluppo.

  4. Segui le Mappatura degli eventi I passaggi 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.

Termine dei tag Adobe Experience Platform
Termine Adobe Commerce Event SDK
elementi dati
contesto
regole
evento
condizioni di regola - listener di eventi (da ACDL)

azioni di regola - gestori di eventi (invia 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.

Ad esempio, aggiungiamo l’Adobe Commerce signOut ai tag di 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 stai aggiungendo ai tag.

  1. Creare un elemento dati:

    Creare un nuovo elemento dati
    Creare un nuovo elemento dati

  2. Imposta Nome a sign out.

  3. Imposta Estensione a Adobe Experience Platform Web SDK.

  4. Imposta Tipo di elemento dati a XDM object.

  5. Seleziona la Sandbox e Schema che desideri aggiornare.

  6. Sotto userAccount > logout, imposta valore in Disconnessione visitatore a 1.

    Aggiorna valore disconnessione
    Aggiorna valore disconnessione

  7. Seleziona Salva.

  8. Crea una regola:

    Crea nuova regola
    Crea nuova regola

  9. Seleziona Aggiungi in EVENTI.

  10. Imposta Estensione a Adobe Client Data Layer.

  11. Imposta Tipo di evento a Data Pushed.

  12. Seleziona Evento specifico e imposta Evento/Chiave per cui registrarsi a sign-out.

  13. Seleziona Mantieni modifiche per salvare la nuova regola.

  14. Aggiungi un’azione.

  15. Imposta Estensione a Adobe Experience Platform Web SDK.

  16. Imposta Tipo di azione a Send Event.

  17. Imposta Istanza a Alloy.

  18. Imposta Tipo a userAccount.logout.

  19. Imposta Dati XDM a %sign out%.

  20. Clic Salva.

    Hai creato un elemento dati nello schema per il 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:

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

Regole

  • Nome: Sign out
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: sign-out
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. E-mail account:

    • Nome: account email
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: accountContext.emailAddress
  2. Tipo di account:

    • Nome: account type
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: accountContext.accountType
  3. ID account:

    • Nome: account id
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso*: accountContext.accountId
  4. 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

Regole

  • Nome: sign in
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: sign-in
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. E-mail account:

    • Nome: account email
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: accountContext.emailAddress
  2. Tipo di account:

    • Nome: account type
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: accountContext.accountType
  3. ID account:

    • Nome: account id
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: accountContext.accountId
  4. 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

Regole

  • Nome: Create account
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: create-account
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. E-mail account:

    • Nome: account email
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: accountContext.emailAddress
  2. Tipo di account:

    • Nome: account type
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: accountContext.accountType
  3. ID account:

    • Nome: account id
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: accountContext.accountId
  4. 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

Regole

  • Nome: Edit account
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: edit-account
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di azione: Send event
  • Tipo: userAccount.updateProfile
  • Dati XDM: %edit account%

pageView

Attivazione al caricamento di qualsiasi pagina.

Elementi dati

Crea i seguenti elementi dati:

  1. Nome pagina:

    • Nome: page name
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: pageContext.pageName

Regole

  • Nome: page view
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: page-view
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. Nome prodotto:

    • Nome: product name
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.name
  2. SKU prodotto:

    • Nome: product sku
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.sku
  3. URL immagine prodotto:

    • Nome: product image
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.mainImageUrl
  4. Valuta prodotto:

    • Nome: product currency
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.pricing.currencyCode
  5. 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
    
  6. Prezzo speciale:

    • Nome: special price
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.pricing.specialPrice
  7. Prezzo normale:

    • Nome: regular price
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.pricing.regularPrice
  8. 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')
    
  9. Visualizzazione prodotto:

    • Nome: product view
    • Estensione: Adobe Experience Platform Web SDK
    • Tipo di elemento dati: XDM object
    • Gruppo di campi: productListItems. Seleziona Fornisci singoli elementi e fai clic su Aggiungi elemento pulsante. 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

Regole

  • Nome: product view
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: product-page-view
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. Cerca input

    • Nome: search input
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: searchInputContext.units[0]
  2. 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;
    
  3. 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;
    
  4. 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;
    
  5. Richiesta di ricerca:

    • Nome: search request
    • Estensione: Adobe Experience Platform Web SDK
    • Tipo di elemento dati: XDM object
    • Gruppo di campi: siteSearch > phrase
    • valore: non ancora disponibile
    • Gruppo di campi: siteSearch > sort. Seleziona Fornisci l'intero oggetto.
    • Gruppo di campi: siteSearch > filter. Seleziona Fornisci l'intero oggetto.
    • Gruppo di campi: searchRequest > id
    • Identificatore univoco: Valore = %search request ID%
    • Gruppo di campi: searchRequest > value
    • valore: Valore = 1

Regole

  • Nome: search request sent
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: search-request-sent
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. Risultati ricerca:

    • Nome: search results
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: searchResultsContext.units[0]
  2. 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;
    
  3. 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;
    
  4. 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;
    
  5. URL immagine prodotto:

    • Nome: product image
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.mainImageUrl
  6. Risposta di ricerca:

    • Nome: search response
    • Estensione: Adobe Experience Platform Web SDK
    • Tipo di elemento dati: XDM object
    • Gruppo di campi: siteSearch > suggestions. Seleziona Fornisci l'intero oggetto.
    • Elemento dati: %search result suggestions%
    • Gruppo di campi: siteSearch > numberOfResults
    • valore: %search result number of products%
    • Gruppo di campi: productListItems. Seleziona Fornisci 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

Regole

  • Nome: search response received
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: search-response-received
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. Nome prodotto:

    • Nome: product name
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.name
  2. SKU prodotto:

    • Nome: product sku
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.sku
  3. Codice valuta:

    • Nome: currency code
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.pricing.currencyCode
  4. Prezzo speciale del prodotto:

    • Nome: product special price
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.pricing.specialPrice
  5. URL immagine prodotto:

    • Nome: product image
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.mainImageUrl
  6. Prezzo normale del prodotto:

    • Nome: product regular price
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.pricing.regularPrice
  7. 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')
    
  8. Carrello:

    • Nome: cart
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: shoppingCartContext
  9. ID carrello:

    • Nome: cart id
    • Estensione: Core
    • Tipo di elemento dati: Custom Code
    • Apri editor:
    code language-bash
    return _satellite.getVar('cart').id
    
  10. Aggiungi al carrello:

    • Nome: add to cart
    • Estensione: Adobe Experience Platform Web SDK
    • Tipo di elemento dati: XDM object
    • Gruppo di campi: productListItems. Seleziona Fornisci singoli elementi e fai clic su Aggiungi elemento pulsante. 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

Regole

  • Nome: add to cart
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: add-to-cart
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. 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. Per productListItems, è possibile precalcolare più elementi. Seleziona productListItems > Fornire l'intero array.

Regole

  • Nome: open cart
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: open-cart
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. Vetrina:

    • Nome: storefront
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: storefrontInstanceContext
  2. URL immagine prodotto:

    • Nome: product image

    • Estensione: Adobe Client Data Layer

    • Tipo di elemento dati: Data Layer Computed State

    • [Facoltativo] percorso: productContext.mainImageUrl

    1. Carrello:

    • Nome: cart
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: shoppingCartContext
  3. ID carrello:

    • Nome: cart id
    • Estensione: Core
    • Tipo di elemento dati: Custom Code
    • Apri editor:
    code language-bash
    return _satellite.getVar('cart').id
    
  4. 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;
    
  5. Visualizza carrello:

    • Nome: view cart
    • Estensione: Adobe Experience Platform Web SDK
    • Tipo di elemento dati: XDM object
    • Gruppo di campi: productListItems. Per productListItems, possono essere presenti più elementi precalcolati. Seleziona 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

Regole

  • Nome: view cart
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: shopping-cart-view
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. Nome prodotto:

    • Nome: product name
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.name
  2. SKU prodotto:

    • Nome: product sku
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.sku
  3. Codice valuta:

    • Nome: currency code
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.pricing.currencyCode
  4. Prezzo speciale del prodotto:

    • Nome: product special price
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.pricing.specialPrice
  5. Prezzo normale del prodotto:

    • Nome: product regular price
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.pricing.regularPrice
  6. 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')
    
  7. Carrello:

    • Nome: cart
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: shoppingCartContext
  8. ID carrello:

    • Nome: cart id
    • Estensione: Core
    • Tipo di elemento dati: Custom Code
    • Apri editor:
    code language-bash
    return _satellite.getVar('cart').id
    
  9. Rimuovi dal carrello:

    • Nome: remove from cart
    • Estensione: Adobe Experience Platform Web SDK
    • Tipo di elemento dati: XDM object
    • Gruppo di campi: productListItems. Seleziona Fornisci singoli elementi e fai clic su Aggiungi elemento pulsante. 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

Regole

  • Nome: remove from cart
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: remove-from-cart
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. Vetrina:

    • Nome: storefront
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: storefrontInstanceContext
  2. URL immagine prodotto:

    • Nome: product image
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.mainImageUrl
  3. Carrello:

    • Nome: cart
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: shoppingCartContext
  4. ID carrello:

    • Nome: cart id
    • Estensione: Core
    • Tipo di elemento dati: Custom Code
    • Apri editor:
    code language-bash
    return _satellite.getVar('cart').id
    
  5. 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;
    
  6. Avvia estrazione:

    • Nome: initiate checkout
    • Estensione: Adobe Experience Platform Web SDK
    • Tipo di elemento dati: XDM object
    • Gruppo di campi: productListItems. Per productListItems, possono essere presenti più elementi precalcolati. Seleziona 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

Regole

  • Nome: initiate checkout
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: initiate-checkout
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di 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:

  1. E-mail account:

    • Nome: account email
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: accountContext.emailAddress
  2. Vetrina:

    • Nome: storefront
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: storefrontInstanceContext
  3. URL immagine prodotto:

    • Nome: product image
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: productContext.mainImageUrl
  4. Carrello:

    • Nome: cart
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: shoppingCartContext
  5. ID carrello:

    • Nome: cart id
    • Estensione: Core
    • Tipo di elemento dati: Custom Code
    • Apri editor:
    code language-bash
    return _satellite.getVar('cart').id
    
  6. Ordine:

    • Nome: order
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Facoltativo] percorso: orderContext
  7. 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,
    };
    
  8. 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,
    }
    
  9. ID promozione:

    • Nome: promotion id
    • Estensione: Core
    • Tipo di elemento dati: Custom Code
    • Apri editor:
    code language-bash
    return _satellite.getVar('order').appliedCouponCode
    
  10. 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;
    
  11. Ordinamento:

    • Nome: place order
    • Estensione: Adobe Experience Platform Web SDK
    • Tipo di elemento dati: XDM object
    • Gruppo di campi: productListItems. Per productListItems, possono essere presenti più elementi precalcolati. Seleziona 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%

Regole

  • Nome: place order
  • Estensione: Adobe Client Data Layer
  • Tipo di evento: Data Pushed
  • Evento specifico: place-order
Azioni
  • Estensione: Adobe Experience Platform Web SDK
  • Tipo di azione: Send event
  • Tipo: commerce.order
  • Dati XDM: %place order%

Impostare l’identità negli eventi storefront

Gli eventi storefront contengono informazioni sul profilo in base al personalEmail (per eventi account) e identityMap (per tutti gli altri eventi storefront). Il Data Connection L'estensione unisce e genera profili basati su questi due campi. Ogni campo, tuttavia, prevede diversi passaggi da seguire per creare i profili:

NOTE
Se disponi di una configurazione precedente che si basa su campi diversi, puoi continuare a utilizzarli.
  • personalEmail : si applica solo agli eventi dell’account. Segui i passaggi, le regole e le azioni descritti sopra
  • identityMap : si applica a tutti gli altri eventi storefront. Vedi l’esempio seguente.

Esempio

I passaggi seguenti mostrano come configurare un pageView evento con identityMap in Data Connection estensione:

  1. Configura l’elemento dati con il codice personalizzato per ECID:

    Configurare l’elemento dati con il codice personalizzato
    Configurare l’elemento dati con il codice personalizzato

  2. Seleziona Open Editor e aggiungi 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);
    });
    
  3. Aggiornare lo schema XDM con identityMap impostato come ECID:

    Imposta identityMap come ECID
    Imposta identityMap come ECID

  4. Definisci le azioni della regola che recuperano l’ECID:

    Recuperare ECID
    Recuperare 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.

  1. Crea un elemento di mappa delle identità.

    Mappa delle identità del back office
    Crea mappa identità back office

  2. Seleziona Open Editor e aggiungi 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;
  1. Aggiungi questo nuovo elemento a ogni identityMap campo.

    Aggiornare ogni identityMap
    Aggiornare ogni identityMap

Impostazione del consenso

Quando si installa Data Connection in Adobe Commerce, il consenso per la raccolta dei dati è abilitato per impostazione predefinita. La rinuncia viene gestita tramite mg_dnt cookie. Se scegli di utilizzare, segui i passaggi qui descritti mg_dnt per gestire il consenso. Il Documentazione di Adobe Experience Platform Web SDK dispone di diverse opzioni aggiuntive per la gestione del consenso.

  1. Creare un Codice personalizzato core elemento dati (%do not track cookie%) per mg_dnt cookie:

    Crea, non tenere traccia dell’elemento dati
    Crea, non tenere traccia dell’elemento dati

  2. Creare un Codice personalizzato core elemento dati (%consent%) che restituisce out se il cookie è impostato e in altrimenti:

    Creare un elemento di dati di consenso
    Creare un elemento di dati di consenso

  3. Configurare l’estensione Adobe Experience Platform Web SDK con %consent% data element:

    Aggiornare l’SDK con il consenso
    Aggiornare l’SDK con il 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
  • Non è possibile impostare Target tramite Data Connection estensione se la raccolta dati è disabilitata
recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840