DokumentationHandelData Connection-tillägg för Adobe Commerce

Samla in Commerce-data med Adobe Experience Platform-taggar

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

Skapat för:

  • Administratör
  • Utvecklare

Du kan använda tillägget Data Connection för att publicera och prenumerera på butikshändelser, men vissa handlare kanske redan använder en datainsamlingslösning, till exempel Adobe Experience Platform-taggarna. För dessa handlare tillhandahåller Adobe Commerce ett alternativ för enbart publicering i tillägget Data Connection som använder Adobe Commerce Event SDK.

Data Connection-tilläggsdataflöde
Data ConnectionTilläggsdataflöde med taggar

I det här avsnittet får du lära dig att mappa storefront-händelsevärdena som tillhandahålls av tillägget Data Connection till den Adobe Experience Platform-tagglösning som du redan använder.

Samla in händelsedata från Adobe Commerce

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

  • Installera Adobe Commerce Events SDK. Information om PHP-butiker finns i avsnittet install. Mer information om PWA Studio-butiker finns i handboken PWA Studio.

    note note
    NOTE
    Konfigurera inte 🔗 organisations-ID och dataström-ID.

Mappa Commerce storefront-data 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 väljer du Tillägg och installerar och konfigurerar följande tillägg:

  3. Publish-tagg i din utvecklingsmiljö.

  4. Följ händelsemappningen 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 händelsen Adobe Commerce signOut i Adobe Experience Platform-taggar. Stegen som beskrivs nedan beskriver, förutom de specifika värden som du anger, hur du lägger till dataelement och regler som 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 dataelementtypen till XDM object.

  5. Markera sandlådan och schemat som du vill uppdatera.

  6. Under userAccount > logOut anger du value i Visitor-utloggning 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 Event/Key för registrering för till sign-out.

  13. Välj Behåll ändringar om du vill spara den nya regeln.

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

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

  16. Ange åtgärdstypen till Send Event.

  17. Ange Instans till Alloy.

  18. Ange Type till userAccount.logout.

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

  20. Klicka på Spara.

    Du skapade ett dataelement i ditt schema för händelsen signOut 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 från 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
    • [Valfri] sökväg: accountContext.emailAddress

  2. Kontotyp:

    • Namn: account type
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: accountContext.accountType

  3. Konto-ID:

    • Namn: account id
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg*: 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
    • [Valfri] sökväg: accountContext.emailAddress

  2. Kontotyp:

    • Namn: account type
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: accountContext.accountType

  3. Konto-ID:

    • Namn: account id
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: 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
    • [Valfri] sökväg: accountContext.emailAddress

  2. Kontotyp:

    • Namn: account type
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: accountContext.accountType

  3. Konto-ID:

    • Namn: account id
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: 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
    • [Valfri] sökväg: 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
    • [Valfri] sökväg: productContext.name

  2. SKU:

    • Namn: product sku
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.sku

  3. Produktbild-URL:

    • Namn: product image
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.mainImageUrl

  4. Produktvaluta:

    • Namn: product currency
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: 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
    • [Valfri] sökväg: productContext.pricing.specialPrice

  7. Ordinarie pris:

    • Namn: regular price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: 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å knappen Lägg till objekt . 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: Value = %product image%
    • Fältgrupp: commerce > productViews > value
    • värde: 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
    • [Valfri] sökväg: 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
    • värde: Inte tillgängligt än
    • 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
    • värde: 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
    • [Valfri] sökväg: 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
    • [Valfri] sökväg: 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
    • värde: %search result number of products%
    • Fältgrupp: productListItems. Välj Ange hela objektet.
    • Fältgrupp: productListItems > ProductImageUrl
    • ProductImageUrl: Value = %product image%
    • Dataelement: %search result products%
    • Fältgrupp: searchResponse > id
    • Unik identifierare: Värde = %search response ID%
    • Fältgrupp: searchResponse > value
    • värde: 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
    • [Valfri] sökväg: productContext.name

  2. Produkt-sku:

    • Namn: product sku
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.sku

  3. Valutakod:

    • Namn: currency code
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.pricing.currencyCode

  4. Specialpris:

    • Namn: product special price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.pricing.specialPrice

  5. Produktbild-URL:

    • Namn: product image
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.mainImageUrl

  6. Normalpris:

    • Namn: product regular price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.pricing.regularPrice

  7. Produkt  pris:

    • 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
    • [Valfri] sökväg: 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å knappen Lägg till objekt . 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: Value = %product image%
    • Valutakod: Värde = %currency code%
    • Fältgrupp: commerce > cart > cartID
    • Kund-ID: Värde = %cart id%
    • Fältgrupp: commerce > productListAdds > value
    • värde: 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
    • värde: Värde = 1
    • Fältgrupp: commerce > cart > cartID
    • Kund-ID: Värde = %cart id%
    • Fältgrupp: productListItems. För productListItems kan flera objekt förberäknas. Välj productListItems > Ange hela arrayen.

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
    • [Valfri] sökväg: storefrontInstanceContext

  2. Produktbild-URL:

    • Namn: product image

    • Tillägg: Adobe Client Data Layer

    • Dataelementtyp: Data Layer Computed State

    • [Valfri] sökväg: productContext.mainImageUrl

    1. Kort:

    • Namn: cart
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: 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 productListItems kan det finnas flera objekt som är förberäknade. Välj productListItems > Fyll hela arrayen.
    • Dataelement: %product list items%
    • Fältgrupp: productListItems > ProductImageUrl
    • ProductImageUrl: Value = %product image%
    • Fältgrupp: commerce > cart > cartID
    • Kund-ID: Värde = %cart id%
    • Fältgrupp: commerce > productListViews > value
    • värde: 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
    • [Valfri] sökväg: productContext.name

  2. Produkt-sku:

    • Namn: product sku
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.sku

  3. Valutakod:

    • Namn: currency code
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.pricing.currencyCode

  4. Specialpris:

    • Namn: product special price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.pricing.specialPrice

  5. Normalpris:

    • Namn: product regular price
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.pricing.regularPrice

  6. Produkt  pris:

    • 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
    • [Valfri] sökväg: 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å knappen Lägg till objekt . 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
    • Kund-ID: Värde = %cart id%
    • Fältgrupp: commerce > productListRemovals > value
    • värde: 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
    • [Valfri] sökväg: storefrontInstanceContext

  2. Produktbild-URL:

    • Namn: product image
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.mainImageUrl

  3. Kort:

    • Namn: cart
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: 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 productListItems kan det finnas flera objekt som är förberäknade. Välj productListItems > Fyll hela arrayen.
    • Dataelement: %product list items%
    • Fältgrupp: productListItems > ProductImageUrl
    • ProductImageUrl: Value = %product image%
    • Fältgrupp: commerce > cart > cartID
    • Kund-ID: Värde = %cart id%
    • Fältgrupp: commerce > checkouts > value
    • värde: 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
    • [Valfri] sökväg: accountContext.emailAddress

  2. Storefront:

    • Namn: storefront
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: storefrontInstanceContext

  3. Produktbild-URL:

    • Namn: product image
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: productContext.mainImageUrl

  4. Kort:

    • Namn: cart
    • Tillägg: Adobe Client Data Layer
    • Dataelementtyp: Data Layer Computed State
    • [Valfri] sökväg: 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
    • [Valfri] sökväg: orderContext

  7. Beställning från Commerce:

    • 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 productListItems kan det finnas flera objekt som är förberäknade. Välj productListItems > Fyll hela arrayen.
    • Dataelement: %product list items%
    • Fältgrupp: productListItems > ProductImageUrl
    • ProductImageUrl: Value = %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
    • värde: 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å fälten personalEmail (för kontohändelser) och identityMap (för alla andra butikshändelser). Tillägget Data Connection sammanfogar och genererar 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 för alla andra butikshändelser. Se följande exempel.

Exempel

I följande steg visas hur du konfigurerar en pageView-händelse med tillägget identityMap i Data Connection:

  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ägg till följande anpassade 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 angivet 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 bakomliggande kontor
    Skapa identitetskarta för backoffice

  2. Välj Open Editor och lägg till följande anpassade 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 här nya elementet i varje identityMap-fält.

    Uppdatera varje identityMap
    Uppdatera varje identityMap

Ange samtycke

När du installerar tillägget Data Connection i Adobe Commerce aktiveras datainsamlingsmedgivande som standard. Avanmäl dig hanteras via mg_dnt-cookien. Du kan följa stegen som beskrivs här om du väljer att använda mg_dnt för att hantera samtycke. Adobe Experience Platform Web SDK-dokumentationen har flera alternativ för att hantera samtycke.

  1. Skapa ett Core Custom Code-dataelement (%do not track cookie%) för mg_dnt-cookien:

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

  2. Skapa ett Core Custom Code-dataelement (%consent%) som returnerar out om cookie är inställd och in i annat fall:

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

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

    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 tillägget Data Connection om datainsamling är inaktiverad
recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840