DocumentazioneCommerceData Connection estensione per Adobe Commerce

Raccogliere dati Commerce tramite tag Adobe Experience Platform

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Amministratore
  • Sviluppatore

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 Data Connection
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:

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. In Authoring, seleziona Estensioni e installa e configura le seguenti estensioni:

  3. Tag Publish per l'ambiente di sviluppo.

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

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

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.

  1. Creare un elemento dati:

    Crea nuovo elemento dati
    Crea nuovo elemento dati

  2. Imposta Name su sign out.

  3. Imposta Estensione su Adobe Experience Platform Web SDK.

  4. Imposta Data Element Type su XDM object.

  5. Seleziona la Sandbox e lo Schema che desideri aggiornare.

  6. In userAccount > logout, imposta il valore in Logout visitatore su 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 su Adobe Client Data Layer.

  11. Imposta Tipo evento su Data Pushed.

  12. Seleziona Evento specifico e imposta Evento/Chiave da registrare per su sign-out.

  13. Seleziona Mantieni modifiche per salvare la nuova regola.

  14. Aggiungi un’azione.

  15. Imposta Estensione su Adobe Experience Platform Web SDK.

  16. Imposta Tipo azione su Send Event.

  17. Imposta Istanza su Alloy.

  18. Imposta Type su userAccount.logout.

  19. Imposta dati XDM su %sign out%.

  20. 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:

  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 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:

  1. E-mail account:

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

  2. Tipo di account:

    • Nome: account type
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: accountContext.accountType

  3. ID account:

    • Nome: account id
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]*: 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 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:

  1. E-mail account:

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

  2. Tipo di account:

    • Nome: account type
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: accountContext.accountType

  3. ID account:

    • Nome: account id
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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 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:

  1. E-mail account:

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

  2. Tipo di account:

    • Nome: account type
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: accountContext.accountType

  3. ID account:

    • Nome: account id
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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 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:

  1. Nome pagina:

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

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:

  1. Nome prodotto:

    • Nome: product name
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: productContext.name

  2. SKU prodotto:

    • Nome: product sku
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: productContext.sku

  3. URL immagine prodotto:

    • Nome: product image
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: productContext.mainImageUrl

  4. Valuta prodotto:

    • Nome: product currency
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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
    • [Percorso facoltativo]: productContext.pricing.specialPrice

  7. Prezzo normale:

    • Nome: regular price
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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. 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

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:

  1. Cerca input

    • Nome: search input
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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
    • 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

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:

  1. Risultati ricerca:

    • Nome: search results
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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
    • [Percorso facoltativo]: 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. 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

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:

  1. Nome prodotto:

    • Nome: product name
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: productContext.name

  2. SKU prodotto:

    • Nome: product sku
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: productContext.sku

  3. Codice valuta:

    • Nome: currency code
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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
    • [Percorso facoltativo]: productContext.pricing.specialPrice

  5. URL immagine prodotto:

    • Nome: product image
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: productContext.mainImageUrl

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

  7. 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')

  8. Carrello:

    • Nome: cart
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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. 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

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:

  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. Selezionare productListItems > Fornire l'intero array.

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:

  1. Vetrina:

    • Nome: storefront
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: storefrontInstanceContext

  2. URL immagine prodotto:

    • Nome: product image

    • Estensione: Adobe Client Data Layer

    • Tipo di elemento dati: Data Layer Computed State

    • [Percorso facoltativo]: productContext.mainImageUrl

    1. Carrello:

    • Nome: cart
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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. 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

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:

  1. Nome prodotto:

    • Nome: product name
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: productContext.name

  2. SKU prodotto:

    • Nome: product sku
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: productContext.sku

  3. Codice valuta:

    • Nome: currency code
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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
    • [Percorso facoltativo]: 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
    • [Percorso facoltativo]: productContext.pricing.regularPrice

  6. 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')

  7. Carrello:

    • Nome: cart
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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. 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

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:

  1. Vetrina:

    • Nome: storefront
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: storefrontInstanceContext

  2. URL immagine prodotto:

    • Nome: product image
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: productContext.mainImageUrl

  3. Carrello:

    • Nome: cart
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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. 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

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:

  1. E-mail account:

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

  2. Vetrina:

    • Nome: storefront
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: storefrontInstanceContext

  3. URL immagine prodotto:

    • Nome: product image
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: productContext.mainImageUrl

  4. Carrello:

    • Nome: cart
    • Estensione: Adobe Client Data Layer
    • Tipo di elemento dati: Data Layer Computed State
    • [Percorso facoltativo]: 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
    • [Percorso facoltativo]: 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. 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%

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:

NOTE
Se disponi di una configurazione precedente che si basa su campi diversi, puoi continuare a utilizzarli.
  • personalEmail - Si applica solo agli eventi 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

Nei passaggi seguenti viene illustrato come configurare un evento pageView con identityMap nell'estensione Data Connection:

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

    Configura elemento dati con codice personalizzato
    Configura elemento dati con codice personalizzato

  2. 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);
});

  3. Aggiorna 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:

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

  1. Crea un elemento di mappa delle identità.

    Mappa identità back office
    Crea mappa identità back office

  2. 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;

  1. Aggiungere questo nuovo elemento a ogni campo identityMap.

    Aggiorna ogni 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.

  1. Creare un elemento dati Core Custom Code (%do not track cookie%) per il cookie mg_dnt:

    Crea non tiene traccia dellelemento dati
    Crea non tiene traccia dell'elemento dati

  2. Creare un elemento dati Core Custom Code (%consent%) che restituisce out se il cookie è impostato e in in caso contrario:

    Crea elemento dati consenso
    Crea elemento dati consenso

  3. Configurare l'estensione Adobe Experience Platform Web SDK con l'elemento dati %consent%:

    Aggiorna SDK con consenso
    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
recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840