Samla in handelsdata med Adobe Experience Platform-taggar

Du kan använda Data Connection för att publicera och prenumerera på butikshändelser. Vissa handlare kanske redan använder en datainsamlingslösning, som Adobe Experience Platform-taggar. För dessa handlare har Adobe Commerce ett alternativ för publicering i Data Connection som använder Adobe Commerce Event SDK.

Data Connection Dataflöde för tillägg
Data ConnectionTilläggsdataflöde med taggar

I det här avsnittet får du lära dig att mappa värdena för händelsen storefront som finns i Data Connection till den tagg för Adobe Experience Platform som du redan använder.

Samla in händelsedata från Adobe Commerce

Så här samlar du in händelsedata för Commerce:

Mappa Commerce-butiksdata till Adobe Experience Platform

Om du vill mappa Commerce storefront-data till Adobe Experience Platform konfigurerar och installerar du följande inifrån Adobe Experience Platform-taggar:

  1. Konfigurera en taggegenskap i Adobe Experience Platform Data Collection.

  2. Under Redigering, markera Tillägg och installera och konfigurera följande tillägg:

  3. Publiceringstagg i er utvecklingsmiljö.

  4. Följ Händelsemappning steg nedan för att konfigurera dataelement och regler för specifika händelser.

Händelsemappning

Eftersom datainsamling med hjälp av taggar skiljer sig från användning av Adobe Commerce Event SDK är det viktigt att förstå de likvärdiga termer som används i båda ramverken.

Adobe Experience Platform tagg term
Adobe Commerce Event SDK term
dataelement
kontext
regler
event
regelvillkor - händelseavlyssnare (från ACDL)

regelåtgärder - händelsehanterare (skicka till Adobe Experience Platform)

När du uppdaterar dataelementen och reglerna i Adobe Experience Platform-taggar med Adobe Commerce-specifika händelsedata, finns det några vanliga åtgärder som du kommer att vidta.

Låt oss till exempel lägga till Adobe Commerce signOut till Adobe Experience Platform-taggar. Stegen som beskrivs nedan, förutom de värden du anger, beskriver hur du lägger till dataelement och reglersom gäller för alla Adobe Commerce-händelser som du lägger till i -taggar.

  1. Skapa ett dataelement:

    Skapa nytt dataelement
    Skapa nytt dataelement

  2. Ange Namn till sign out.

  3. Ange Tillägg till Adobe Experience Platform Web SDK.

  4. Ange Dataelementtyp till XDM object.

  5. Välj Sandbox och Schema som du vill uppdatera.

  6. Under userAccount > utloggning, ange value in Logga ut som besökare till 1.

    Uppdatera utloggningsvärde
    Uppdatera utloggningsvärde

  7. Välj Spara.

  8. Skapa en regel:

    Skapa ny regel
    Skapa ny regel

  9. Välj Lägg till under HÄNDELSER.

  10. Ange Tillägg till Adobe Client Data Layer.

  11. Ange Händelsetyp till Data Pushed.

  12. Välj Specifik händelse och ange Händelse/nyckel att registrera för till sign-out.

  13. Välj Behåll ändringar för att spara den nya regeln.

  14. Lägg till en åtgärd.

  15. Ange Tillägg till Adobe Experience Platform Web SDK.

  16. Ange Åtgärdstyp till Send Event.

  17. Ange Instance till Alloy.

  18. Ange Typ till userAccount.logout.

  19. Ange XDM-data till %sign out%.

  20. Klicka Spara.

    Du skapade ett dataelement i ditt schema för signOut event från Adobe Commerce. Du har också skapat en regel med en specifik åtgärd som ska utföras när händelsen utlöses från Adobe Commerce store.

Upprepa stegen ovan i taggar för var och en av de Adobe Commerce-händelser som beskrivs nedan.

Tillgängliga händelser

För var och en av följande händelser mappar du Adobe Commerce-händelserna till din XDM genom att följa stegen ovan.

signOut

Utlöses när en kund försöker logga ut.

Dataelement

Skapa följande dataelement:

  1. Logga ut:

    • Namn: Sign out
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: userAccount > logout
    • Logga ut som besökare: Värde = 1

Regler

  • Namn: Sign out
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: sign-out
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: userAccount.logout
  • XDM-data: %sign-out%

signIn

Utlöses när en kund försöker logga in.

Dataelement

Skapa följande dataelement:

  1. E-postadress för konto:

    • Namn: account email
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: accountContext.emailAddress
  2. Kontotyp:

    • Namn: account type
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: accountContext.accountType
  3. Konto-ID:

    • Namn: account id
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana*: accountContext.accountId
  4. Logga in:

    • Namn: sign in
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: person > accountID
    • Konto-ID: Värde = %account id%
    • Fältgrupp: person > accountType
    • Kontotyp: Värde = %account type%
    • Fältgrupp: person > personalEmailID
    • Personlig e-postadress: Värde = %account email%
    • Fältgrupp: personalEmail > address
    • Adress: Värde = %account email%
    • Fältgrupp: userAccount > login
    • Besökarinloggning: Värde = 1

Regler

  • Namn: sign in
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: sign-in
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: userAccount.login
  • XDM-data: %sign in%

createAccount

Utlöses när en kund försöker skapa ett konto.

Dataelement

Skapa följande dataelement:

  1. E-postadress för konto:

    • Namn: account email
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: accountContext.emailAddress
  2. Kontotyp:

    • Namn: account type
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: accountContext.accountType
  3. Konto-ID:

    • Namn: account id
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: accountContext.accountId
  4. Skapa konto:

    • Namn: Create account
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: person > accountID
    • Konto-ID: Värde = %account id%
    • Fältgrupp: person > accountType
    • Kontotyp: Värde = %account type%
    • Fältgrupp: person > personalEmailID
    • Personlig e-postadress: Värde = %account email%
    • Fältgrupp: personalEmail > address
    • Adress: Värde = %account email%
    • Fältgrupp: userAccount > createProfile
    • Skapa kontoprofil: Värde = 1

Regler

  • Namn: Create account
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: create-account
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: userAccount.createProfile
  • XDM-data: %create account%

editAccount

Utlöses när en kund försöker redigera ett konto.

Dataelement

Skapa följande dataelement:

  1. E-postadress för konto:

    • Namn: account email
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: accountContext.emailAddress
  2. Kontotyp:

    • Namn: account type
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: accountContext.accountType
  3. Konto-ID:

    • Namn: account id
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: accountContext.accountId
  4. Redigera konto:

    • Namn: Edit account
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: person > accountID
    • Konto-ID: Värde = %account id%
    • Fältgrupp: person > accountType
    • Kontotyp: Värde = %account type%
    • Fältgrupp: person > personalEmailID
    • Personlig e-postadress: Värde = %account email%
    • Fältgrupp: personalEmail > address
    • Adress: Värde = %account email%
    • Fältgrupp: userAccount > updateProfile
    • Skapa kontoprofil: Värde = 1

Regler

  • Namn: Edit account
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: edit-account
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: userAccount.updateProfile
  • XDM-data: %edit account%

pageView

Utlöses när någon sida läses in.

Dataelement

Skapa följande dataelement:

  1. Sidnamn:

    • Namn: page name
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: pageContext.pageName

Regler

  • Namn: page view
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: page-view
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: web.webPageDetails.pageViews
  • XDM-data: %page view%

productView

Utlöses när någon produktsida läses in.

Dataelement

Skapa följande dataelement:

  1. Produktnamn:

    • Namn: product name
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.name
  2. SKU:

    • Namn: product sku
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.sku
  3. Produktbild-URL:

    • Namn: product image
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.mainImageUrl
  4. Produktvaluta:

    • Namn: product currency
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.pricing.currencyCode
  5. Valutakod:

    • Namn: currency code
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('product currency') || _satellite.getVar('storefront').storeViewCurrencyCode
    
  6. Specialpris:

    • Namn: special price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.pricing.specialPrice
  7. Ordinarie pris:

    • Namn: regular price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.pricing.regularPrice
  8. Produktpris:

    • Namn: product price
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('product regular price') || _satellite.getVar('product special price')
    
  9. Produktvy:

    • Namn: product view
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: productListItems. Välj Ange enskilda objekt och klicka på Lägg till objekt -knappen. Eftersom den här vyn är för en PDP-fil kan du fylla med ett enstaka objekt.
    • Fältgrupp: productListItems > name
    • Namn: Värde = %product name%
    • Fältgrupp: productListItems > SKU
    • SKU: Värde = %product sku%
    • Fältgrupp: productListItems > priceTotal
    • Prissumma: Värde = %product price%
    • Fältgrupp: productListItems > currencyCode
    • Valutakod: Värde = %currency code%
    • Fältgrupp: productListItems > ProductImageUrl
    • ProductImageUrl: Värde = %product image%
    • Fältgrupp: commerce > productViews > value
    • value: Värde = 1

Regler

  • Namn: product view
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: product-page-view
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: commerce.productViews
  • XDM-data: %product view%

searchRequestSent

Utlöses av händelser i"sökningen när du skriver" och av händelser på sökresultatsidorna.

Dataelement

Skapa följande dataelement:

  1. Sök indata

    • Namn: search input
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: searchInputContext.units[0]
  2. Sök inmatningsfras

    • Namn: search input phrase
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('search input').phrase;
    
  3. Sortera indata

    • Namn: search input sort
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    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. Indatafilter för sökning

    • Namn: search input filters
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    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. Sökbegäran:

    • Namn: search request
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: siteSearch > phrase
    • value: Inte tillgängligt ännu
    • Fältgrupp: siteSearch > sort. Välj Ange hela objektet.
    • Fältgrupp: siteSearch > filter. Välj Ange hela objektet.
    • Fältgrupp: searchRequest > id
    • Unik identifierare: Värde = %search request ID%
    • Fältgrupp: searchRequest > value
    • value: Värde = 1

Regler

  • Namn: search request sent
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: search-request-sent
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: searchRequest
  • XDM-data: %search request%

searchResponseReceived

Utlöses när Live Search returnerar resultat för"sökningen när du skriver"-povern eller sökresultatsidan.

Dataelement

Skapa följande dataelement:

  1. Sökresultat:

    • Namn: search results
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: searchResultsContext.units[0]
  2. Resultatnummer för sökning:

    • Namn: search result number of products
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('search result').products.length;
    
  3. Resultatprodukter för sökning:

    • Namn: search result products
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    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. Sökresultatförslag:

    • Namn: search result products
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    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. Produktbild-URL:

    • Namn: product image
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.mainImageUrl
  6. Söksvar:

    • Namn: search response
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: siteSearch > suggestions. Välj Ange hela objektet.
    • Dataelement: %search result suggestions%
    • Fältgrupp: siteSearch > numberOfResults
    • value: %search result number of products%
    • Fältgrupp: productListItems. Välj Ange hela objektet.
    • Fältgrupp: productListItems > ProductImageUrl
    • ProductImageUrl: Värde = %product image%
    • Dataelement: %search result products%
    • Fältgrupp: searchResponse > id
    • Unik identifierare: Värde = %search response ID%
    • Fältgrupp: searchResponse > value
    • value: Värde = 1

Regler

  • Namn: search response received
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: search-response-received
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: searchResponse
  • XDM-data: %search response%

addToCart

Utlöses när en produkt läggs till i en varukorg eller varje gång som kvantiteten av en produkt i varukorgen ökas.

Dataelement

Skapa följande dataelement:

  1. Produktnamn:

    • Namn: product name
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.name
  2. Produkt-sku:

    • Namn: product sku
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.sku
  3. Valutakod:

    • Namn: currency code
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.pricing.currencyCode
  4. Specialpris:

    • Namn: product special price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.pricing.specialPrice
  5. Produktbild-URL:

    • Namn: product image
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.mainImageUrl
  6. Normalpris:

    • Namn: product regular price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.pricing.regularPrice
  7. Produktpris:

    • Namn: product price
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('product regular price') || _satellite.getVar('product special price')
    
  8. Kort:

    • Namn: cart
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: shoppingCartContext
  9. Kundvagn-id:

    • Namn: cart id
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('cart').id
    
  10. Lägg i kundvagnen:

    • Namn: add to cart
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: productListItems. Välj Ange enskilda objekt och klicka på Lägg till objekt -knappen. Eftersom den här vyn är för en PDP-fil kan du fylla med ett enstaka objekt.
    • Fältgrupp: productListItems > name
    • Namn: Värde = %product name%
    • Fältgrupp: productListItems > SKU
    • SKU: Värde = %product sku%
    • Fältgrupp: productListItems > priceTotal
    • Prissumma: Värde = %product price%
    • Fältgrupp: productListItems > currencyCode
    • Fältgrupp: productListItems > ProductImageUrl
    • ProductImageUrl: Värde = %product image%
    • Valutakod: Värde = %currency code%
    • Fältgrupp: commerce > cart > cartID
    • Kundvagn-ID: Värde = %cart id%
    • Fältgrupp: commerce > productListAdds > value
    • value: Värde = 1

Regler

  • Namn: add to cart
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: add-to-cart
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: commerce.productListAdds
  • XDM-data: %add to cart%

openCart

Utlöses när en ny kundvagn skapas, vilket inträffar när en produkt läggs till i en tom kundvagn.

Dataelement

Skapa följande dataelement:

  1. Öppen varukorg:

    • Namn: open cart
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: commerce > productListOpens > value
    • value: Värde = 1
    • Fältgrupp: commerce > cart > cartID
    • Kundvagn-ID: Värde = %cart id%
    • Fältgrupp: productListItems. För productListItems, kan flera artiklar förberäknas. Välj productListItems > Ange hela matrisen.

Regler

  • Namn: open cart
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: open-cart
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: commerce.productListOpens
  • XDM-data: %open cart%

viewCart

Utlöses när en kundvagnssida läses in.

Dataelement

Skapa följande dataelement:

  1. Storefront:

    • Namn: storefront
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: storefrontInstanceContext
  2. Produktbild-URL:

    • Namn: product image

    • Tillägg: Adobe Client Data Layer

    • Dataelementtyp: Data Layer Computed State

    • [Valfritt] bana: productContext.mainImageUrl

    1. Kort:

    • Namn: cart
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: shoppingCartContext
  3. Kundvagn-id:

    • Namn: cart id
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('cart').id
    
  4. Produktlisteposter:

    • Namn: product list items:
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    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. Visa kundvagn:

    • Namn: view cart
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: productListItems. För productListItemskan det finnas flera artiklar som är förberäknade. Välj productListItems > Fyll hela arrayen.
    • Dataelement: %product list items%
    • Fältgrupp: productListItems > ProductImageUrl
    • ProductImageUrl: Värde = %product image%
    • Fältgrupp: commerce > cart > cartID
    • Kundvagn-ID: Värde = %cart id%
    • Fältgrupp: commerce > productListViews > value
    • value: Värde = 1

Regler

  • Namn: view cart
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: shopping-cart-view
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: commerce.productListViews
  • XDM-data: %view cart%

removeFromCart

Utlöses när en produkt tas bort från en varukorg eller varje gång som kvantiteten av en produkt i varukorgen minskas.

Dataelement

Skapa följande dataelement:

  1. Produktnamn:

    • Namn: product name
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.name
  2. Produkt-sku:

    • Namn: product sku
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.sku
  3. Valutakod:

    • Namn: currency code
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.pricing.currencyCode
  4. Specialpris:

    • Namn: product special price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.pricing.specialPrice
  5. Normalpris:

    • Namn: product regular price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.pricing.regularPrice
  6. Produktpris:

    • Namn: product price
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('product regular price') || _satellite.getVar('product special price')
    
  7. Kort:

    • Namn: cart
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: shoppingCartContext
  8. Kundvagn-id:

    • Namn: cart id
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('cart').id
    
  9. Ta bort från kundvagn:

    • Namn: remove from cart
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: productListItems. Välj Ange enskilda objekt och klicka på Lägg till objekt -knappen. Eftersom den här vyn är för en PDP-fil kan du fylla med ett enstaka objekt.
    • Fältgrupp: productListItems > name
    • Namn: Värde = %product name%
    • Fältgrupp: productListItems > SKU
    • SKU: Värde = %product sku%
    • Fältgrupp: productListItems > priceTotal
    • Prissumma: Värde = %product price%
    • Fältgrupp: productListItems > currencyCode
    • Valutakod: Värde = %currency code%
    • Fältgrupp: commerce > cart > cartID
    • Kundvagn-ID: Värde = %cart id%
    • Fältgrupp: commerce > productListRemovals > value
    • value: Värde = 1

Regler

  • Namn: remove from cart
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: remove-from-cart
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: commerce.productListRemovals
  • XDM-data: %remove from cart%

initialCheckout

Utlöses när kunden klickar på en utcheckningsknapp.

Dataelement

Skapa följande dataelement:

  1. Storefront:

    • Namn: storefront
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: storefrontInstanceContext
  2. Produktbild-URL:

    • Namn: product image
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.mainImageUrl
  3. Kort:

    • Namn: cart
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: shoppingCartContext
  4. Kundvagn-id:

    • Namn: cart id
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('cart').id
    
  5. Produktlisteposter:

    • Namn: product list items
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    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. Starta utcheckning:

    • Namn: initiate checkout
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: productListItems. För productListItemskan det finnas flera artiklar som är förberäknade. Välj productListItems > Fyll hela arrayen.
    • Dataelement: %product list items%
    • Fältgrupp: productListItems > ProductImageUrl
    • ProductImageUrl: Värde = %product image%
    • Fältgrupp: commerce > cart > cartID
    • Kundvagn-ID: Värde = %cart id%
    • Fältgrupp: commerce > checkouts > value
    • value: Värde = 1

Regler

  • Namn: initiate checkout
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: initiate-checkout
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: commerce.checkouts
  • XDM-data: %initiate checkout%

placeOrder

Utlöses när kunden lägger en order.

Dataelement

Skapa följande dataelement:

  1. E-postadress för konto:

    • Namn: account email
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: accountContext.emailAddress
  2. Storefront:

    • Namn: storefront
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: storefrontInstanceContext
  3. Produktbild-URL:

    • Namn: product image
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: productContext.mainImageUrl
  4. Kort:

    • Namn: cart
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: shoppingCartContext
  5. Kundvagn-id:

    • Namn: cart id
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('cart').id
    
  6. Ordning:

    • Namn: order
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfritt] bana: orderContext
  7. Handelsorder:

    • Namn: commerce order
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    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. Orderleverans:

    • Namn: order shipping
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    const order = _satellite.getVar('order');
    return {
        shippingMethod: order.shipping.shippingMethod,
        shippingAmount: order.shipping.shippingAmount || 0,
    }
    
  9. Kampanj-ID:

    • Namn: promotion id
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    code language-bash
    return _satellite.getVar('order').appliedCouponCode
    
  10. Produktlisteposter:

    • Namn: product list items
    • Tillägg: Core
    • Dataelementtyp: Custom Code
    • Öppna redigeraren:
    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. Monteringsordning:

    • Namn: place order
    • Tillägg: Adobe Experience Platform Web SDK
    • Dataelementtyp: XDM object
    • Fältgrupp: productListItems. För productListItemskan det finnas flera artiklar som är förberäknade. Välj productListItems > Fyll hela arrayen.
    • Dataelement: %product list items%
    • Fältgrupp: productListItems > ProductImageUrl
    • ProductImageUrl: Värde = %product image%
    • Fältgrupp: commerce > order
    • Unik identifierare: Värde = %commerce order%
    • Fältgrupp: commerce > shipping
    • Unik identifierare: Värde = %order shipping%
    • Fältgrupp: commerce > promotionID
    • Kampanj-ID: Värde = %promotion id%
    • Fältgrupp: commerce > purchases > value
    • value: Värde = 1
    • Personlig e-postadress: Värde = %account email%
    • Fältgrupp: personalEmail > address
    • Adress: Värde = %account email%

Regler

  • Namn: place order
  • Tillägg: Adobe Client Data Layer
  • Händelsetyp: Data Pushed
  • Specifik händelse: place-order
Åtgärder
  • Tillägg: Adobe Experience Platform Web SDK
  • Åtgärdstyp: Send event
  • Typ: commerce.order
  • XDM-data: %place order%

Ange identitet för händelser i butiker

Storefront-händelser innehåller profilinformation som baseras på personalEmail (för kontohändelser) och identityMap (för alla andra butikshändelser). The Data Connection läggs samman och genereras profiler baserat på dessa två fält. Varje fält har dock olika steg att följa för att skapa profiler:

NOTE
Om du har en tidigare konfiguration som är beroende av olika fält kan du fortsätta att använda dessa.
  • personalEmail - Gäller endast kontohändelser. Följ de steg, regler och åtgärder som beskrivs ovan
  • identityMap - Gäller alla andra händelser i butiken. Se följande exempel.

Exempel

Följande steg visar hur du konfigurerar en pageView händelse med identityMap in Data Connection tillägg:

  1. Konfigurera dataelement med anpassad kod för ECID:

    Konfigurera dataelement med anpassad kod
    Konfigurera dataelement med anpassad kod

  2. Välj Open Editor och lägga till följande egen kod:

    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. Uppdatera XDM-schema med identityMap anges som ECID:

    Ange identityMap som ECID
    Ange identityMap som ECID

  4. Definiera regelåtgärder som hämtar ECID:

    Hämta ECID
    Hämta ECID

Ange identitet i back office-händelser

Till skillnad från butikshändelser där ECID används för att identifiera och länka profilinformation är data för back office-händelser SaaS-baserade och därför finns inget ECID tillgängligt. För back office-event måste ni använda e-post för att unikt identifiera kunderna. I det här avsnittet får du lära dig hur du länkar tillbaka Office-händelsedata till ett ECID med hjälp av e-post.

  1. Skapa ett element för identitetskarta.

    Identitetskarta för bakgrunder
    Skapa identitetskarta för backoffice

  2. Välj Open Editor och lägga till följande egen kod:

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. Lägg till det nya elementet i varje identityMap fält.

    Uppdatera varje identityMap
    Uppdatera varje identityMap

Ange samtycke

När du installerar Data Connection i Adobe Commerce är datainsamlingsmedgivande aktiverat som standard. Avanmäl dig hanteras via mg_dnt cookie. Du kan följa instruktionerna här om du väljer att använda mg_dnt för att hantera samtycke. The Adobe Experience Platform Web SDK-dokumentation har flera alternativ för att hantera samtycke.

  1. Skapa en Anpassad kärnkod dataelement (%do not track cookie%) för mg_dnt cookie:

    Skapa spårar inte dataelement
    Skapa spårar inte dataelement

  2. Skapa en Anpassad kärnkod dataelement (%consent%) som returnerar out om cookie är inställd och in annars:

    Skapa dataelement för samtycke
    Skapa dataelement för samtycke

  3. Konfigurera Adobe Experience Platform Web SDK-tillägg med %consent% dataelement:

    Uppdatera SDK med samtycke
    Uppdatera SDK med samtycke

Varningar

  • Om du inte följer stegen för att stänga av Experience Platform-samlingen räknas händelser som dubbelt
  • Om du inte konfigurerar mappningar/händelser enligt beskrivningen i det här avsnittet kan det påverka Adobe Analytics-ritningar
  • Du kan inte konfigurera Target via Data Connection tillägg om datainsamling har inaktiverats
recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840