DokumentationCommerceData Connection für Adobe Commerce

[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur) und lokale Projekte."}

Erfassen von Commerce-Daten mithilfe von Adobe Experience Platform Tags

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Admin
  • Entwickler

Sie können die Data Connection-Erweiterung zwar verwenden, um Storefront-Ereignisse zu veröffentlichen und zu abonnieren, einige Händler verwenden jedoch möglicherweise bereits eine Datenerfassungslösung, z. B. die Adobe Experience Platform-Tags. Für diese Händler bietet Adobe Commerce in der Data Connection-Erweiterung eine Veröffentlichungsoption, die die Adobe Commerce Event SDK verwendet.

Datenfluss Data Connection Erweiterung
Datenfluss der Data Connectionmit Tags

In diesem Abschnitt erfahren Sie, wie Sie die von der Data Connection bereitgestellten Storefront-Ereigniswerte der bereits verwendeten Adobe Experience Platform Tags-Lösung zuordnen.

Erfassen von Ereignisdaten aus Adobe Commerce

So erfassen Sie Commerce-Ereignisdaten:

Zuordnen von Commerce-Storefront-Daten zu Adobe Experience Platform

Um Daten einer Commerce-Storefront Adobe Experience Platform zuzuordnen, konfigurieren und installieren Sie Folgendes in Adobe Experience Platform Tags:

  1. Richten Sie eine Tag-Eigenschaft ​ der Datenerfassung in Adobe Experience Platform ein.

  2. Wählen unter die Option Erweiterungen aus und installieren und konfigurieren Sie die folgenden Erweiterungen:

  3. Tag veröffentlichen in Ihrer Entwicklungsumgebung.

  4. Gehen Sie wie folgt vor um Datenelemente und Regeln für bestimmte Ereignisse zu konfigurieren.

Ereignis-Mapping

Da sich die Datenerfassung mithilfe von Tags von der Verwendung der Adobe Commerce Event SDK unterscheidet, ist es wichtig, die in beiden Frameworks verwendeten entsprechenden Begriffe zu verstehen.

Adobe Experience Platform Tags-Begriff
Adobe Commerce Event SDK Begriff
Datenelemente
Kontext
Regeln
Ereignis
Regelbedingungen - Ereignis-Listener (von ACDL)

Regelaktionen - Ereignis-Handler (an Adobe Experience Platform senden)

Wenn Sie die Datenelemente und Regeln in Adobe Experience Platform Tags mit Adobe Commerce-spezifischen Ereignisdaten aktualisieren, werden Sie einige allgemeine Schritte ausführen.

Fügen wir beispielsweise das Adobe Commerce-signOut-Ereignis zu Adobe Experience Platform-Tags hinzu. Die folgenden Schritte beschreiben mit Ausnahme der von Ihnen festgelegten spezifischen Werte, wie Datenelemente und Regeln hinzugefügt werden. Diese gelten für alle Adobe Commerce-Ereignisse, die Sie Tags hinzufügen.

  1. Erstellen Sie ein Datenelement:

    Neues Datenelement erstellen
    Neues Datenelement erstellen

  2. Legen Sie Name auf sign out fest.

  3. Legen Erweiterung auf Adobe Experience Platform Web SDK fest.

  4. Setzen Datenelementtyp auf XDM object.

  5. Wählen Sie die Sandbox und Schema aus, die Sie aktualisieren möchten.

  6. Legen unter > abmelden den Wert in Besucher-Abmeldung auf 1 fest.

    Abmeldewert aktualisieren
    Abmeldewert aktualisieren

  7. Wählen Sie Speichern aus.

  8. Erstellen Sie eine Regel:

    Neue Regel erstellen
    Neue Regel erstellen

  9. Wählen Hinzufügen unter EREIGNISSE aus.

  10. Legen Erweiterung auf Adobe Client Data Layer fest.

  11. Legen Sie Ereignistyp auf Data Pushed fest.

  12. Wählen Sie Spezifisches Ereignis aus und setzen Sie den Ereignis/Schlüssel für die Registrierung auf sign-out.

  13. Wählen Änderungen beibehalten, um die neue Regel zu speichern.

  14. Fügen Sie eine Aktion hinzu.

  15. Legen Erweiterung auf Adobe Experience Platform Web SDK fest.

  16. Legen Sie Aktionstyp auf Send Event fest.

  17. Legen Sie instance auf Alloy fest.

  18. Legen Sie type auf userAccount.logout fest.

  19. Legen Sie XDM-Daten auf %sign out% fest.

  20. Klicken Sie Speichern.

    Sie haben ein Datenelement in Ihrem Schema für das signOut von Adobe Commerce erstellt. Außerdem haben Sie eine Regel mit einer bestimmten Aktion erstellt, die auftreten soll, wenn dieses Ereignis in der Adobe Commerce-Storefront ausgelöst wird.

Wiederholen Sie die obigen Schritte in Tags für jedes der unten beschriebenen Adobe Commerce-Ereignisse.

Verfügbare Ereignisse

Ordnen Sie die Adobe Commerce-Ereignisse jedem der folgenden Ereignisse Ihrem XDM zu, indem Sie die oben genannten Schritte ausführen.

Abmelden

Wird ausgelöst, wenn ein Käufer versucht, sich abzumelden.

Datenelemente

Erstellen Sie das folgende Datenelement:

  1. Abmelden:

    • Name: Sign out
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: userAccount > logout
    • Besucher-Abmeldung: Wert = 1

Regeln

  • Name: Sign out
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: sign-out
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: userAccount.logout
  • XDM-Daten: %sign-out%

Anmelden

Wird ausgelöst, wenn ein Käufer versucht, sich anzumelden.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Konto-E-Mail:

    • Name: account email
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: accountContext.emailAddress

  2. Kontotyp:

    • Name: account type
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: accountContext.accountType

  3. Konto-ID:

    • Name: account id
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path*: accountContext.accountId

  4. Anmelden:

    • Name: sign in
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: person > accountID
    • Konto-ID: Wert = %account id%
    • Feldergruppe: person > accountType
    • Kontotyp: value = %account type%
    • Feldergruppe: person > personalEmailID
    • Persönliche E-Mail: Wert = %account email%
    • Feldergruppe: personalEmail > address
    • Adresse: Wert = %account email%
    • Feldergruppe: userAccount > login
    • Besucheranmeldung: Wert = 1

Regeln

  • Name: sign in
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: sign-in
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: userAccount.login
  • XDM-Daten: %sign in%

createAccount

Wird ausgelöst, wenn ein Käufer versucht, ein Konto zu erstellen.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Konto-E-Mail:

    • Name: account email
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: accountContext.emailAddress

  2. Kontotyp:

    • Name: account type
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: accountContext.accountType

  3. Konto-ID:

    • Name: account id
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: accountContext.accountId

  4. Konto erstellen:

    • Name: Create account
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: person > accountID
    • Konto-ID: Wert = %account id%
    • Feldergruppe: person > accountType
    • Kontotyp: value = %account type%
    • Feldergruppe: person > personalEmailID
    • Persönliche E-Mail: Wert = %account email%
    • Feldergruppe: personalEmail > address
    • Adresse: Wert = %account email%
    • Feldergruppe: userAccount > createProfile
    • Kontoprofil erstellen: Wert = 1

Regeln

  • Name: Create account
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: create-account
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: userAccount.createProfile
  • XDM-Daten: %create account%

Konto bearbeiten

Wird ausgelöst, wenn ein Käufer versucht, ein Konto zu bearbeiten.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Konto-E-Mail:

    • Name: account email
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: accountContext.emailAddress

  2. Kontotyp:

    • Name: account type
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: accountContext.accountType

  3. Konto-ID:

    • Name: account id
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: accountContext.accountId

  4. Konto bearbeiten:

    • Name: Edit account
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: person > accountID
    • Konto-ID: Wert = %account id%
    • Feldergruppe: person > accountType
    • Kontotyp: value = %account type%
    • Feldergruppe: person > personalEmailID
    • Persönliche E-Mail: Wert = %account email%
    • Feldergruppe: personalEmail > address
    • Adresse: Wert = %account email%
    • Feldergruppe: userAccount > updateProfile
    • Kontoprofil erstellen: Wert = 1

Regeln

  • Name: Edit account
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: edit-account
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: userAccount.updateProfile
  • XDM-Daten: %edit account%

pageView

Wird ausgelöst, wenn eine beliebige Seite geladen wird.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Seitenname:

    • Name: page name
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: pageContext.pageName

Regeln

  • Name: page view
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: page-view
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: web.webPageDetails.pageViews
  • XDM-Daten: %page view%

productView

Wird ausgelöst, wenn eine Produktseite geladen wird.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Produktname:

    • Name: product name
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.name

  2. Produkt-SKU:

    • Name: product sku
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.sku

  3. Produktbild-URL:

    • Name: product image
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.mainImageUrl

  4. Währung des Produkts:

    • Name: product currency
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.pricing.currencyCode

  5. Währungscode:

    • Name: currency code
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('product currency') || _satellite.getVar('storefront').storeViewCurrencyCode

  6. Sonderpreis:

    • Name: special price
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.pricing.specialPrice

  7. Regulärer Preis:

    • Name: regular price
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.pricing.regularPrice

  8. Produktpreis:

    • Name: product price
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('product regular price') || _satellite.getVar('product special price')

  9. Produktansicht:

    • Name: product view
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: productListItems. Wählen Einzelne Elemente angeben und klicken Sie auf die Schaltfläche Element hinzufügen. Da es sich bei dieser Ansicht um eine PDP handelt, können Sie sie mit einem einzelnen Element füllen.
    • Feldergruppe: productListItems > name
    • name: value = %product name%
    • Feldergruppe: productListItems > SKU
    • SKU: value = %product sku%
    • Feldergruppe: productListItems > priceTotal
    • Gesamtpreis: Wert = %product price%
    • Feldergruppe: productListItems > currencyCode
    • Währungscode: Wert = %currency code%
    • Feldergruppe: productListItems > ProductImageUrl
    • ProductImageUrl: value = %product image%
    • Feldergruppe: commerce > productViews > value
    • value: value = 1

Regeln

  • Name: product view
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: product-page-view
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: commerce.productViews
  • XDM-Daten: %product view%

searchRequestSent

Ausgelöst durch Ereignisse im Pop-up „Suche während der Eingabe“ und durch Ereignisse auf Suchergebnisseiten.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Eingabe suchen

    • Name: search input
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: searchInputContext.units[0]

  2. Eingabephrase suchen

    • Name: search input phrase
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('search input').phrase;

  3. Eingabesortierung suchen

    • Name: search input sort
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    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. Eingabefilter suchen

    • Name: search input filters
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    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. Suchanfrage:

    • Name: search request
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: siteSearch > phrase
    • value: Noch nicht verfügbar
    • Feldergruppe: siteSearch > sort. Wählen Sie Gesamtes Objekt bereitstellen aus.
    • Feldergruppe: siteSearch > filter. Wählen Sie Gesamtes Objekt bereitstellen aus.
    • Feldergruppe: searchRequest > id
    • Eindeutige Kennung: Wert = %search request ID%
    • Feldergruppe: searchRequest > value
    • value: value = 1

Regeln

  • Name: search request sent
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: search-request-sent
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: searchRequest
  • XDM-Daten: %search request%

searchResponseReceived

Wird ausgelöst, wenn die Live-Suche Ergebnisse für das Pop-up „Suche während der Eingabe“ oder die Suchergebnisseite zurückgibt.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Suchergebnisse:

    • Name: search results
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: searchResultsContext.units[0]

  2. Anzahl der Produkte im Suchergebnis:

    • Name: search result number of products
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('search result').products.length;

  3. Produkte für Suchergebnisse:

    • Name: search result products
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    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. Vorschläge für Suchergebnisse:

    • Name: search result products
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    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:

    • Name: product image
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.mainImageUrl

  6. Suchantwort:

    • Name: search response
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: siteSearch > suggestions. Wählen Sie Gesamtes Objekt bereitstellen aus.
    • Datenelement: %search result suggestions%
    • Feldergruppe: siteSearch > numberOfResults
    • value: %search result number of products%
    • Feldergruppe: productListItems. Wählen Sie Gesamtes Objekt bereitstellen aus.
    • Feldergruppe: productListItems > ProductImageUrl
    • ProductImageUrl: value = %product image%
    • Datenelement: %search result products%
    • Feldergruppe: searchResponse > id
    • Eindeutige Kennung: Wert = %search response ID%
    • Feldergruppe: searchResponse > value
    • value: value = 1

Regeln

  • Name: search response received
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: search-response-received
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: searchResponse
  • XDM-Daten: %search response%

addToCart

Wird ausgelöst, wenn ein Produkt zum Warenkorb hinzugefügt wird oder jedes Mal, wenn die Menge eines Produkts im Warenkorb erhöht wird.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Produktname:

    • Name: product name
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.name

  2. Produkt-SKU:

    • Name: product sku
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.sku

  3. Währungscode:

    • Name: currency code
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.pricing.currencyCode

  4. Sonderpreis für das Produkt:

    • Name: product special price
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.pricing.specialPrice

  5. Produktbild-URL:

    • Name: product image
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.mainImageUrl

  6. Regulärer Produktpreis:

    • Name: product regular price
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.pricing.regularPrice

  7. Produkt  Preis:

    • Name: product price
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('product regular price') || _satellite.getVar('product special price')

  8. Warenkorb:

    • Name: cart
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: shoppingCartContext

  9. Warenkorb-ID:

    • Name: cart id
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('cart').id

  10. Zum Warenkorb hinzufügen:

    • Name: add to cart
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: productListItems. Wählen Einzelne Elemente angeben und klicken Sie auf die Schaltfläche Element hinzufügen. Da es sich bei dieser Ansicht um eine PDP handelt, können Sie sie mit einem einzelnen Element füllen.
    • Feldergruppe: productListItems > name
    • name: value = %product name%
    • Feldergruppe: productListItems > SKU
    • SKU: value = %product sku%
    • Feldergruppe: productListItems > priceTotal
    • Gesamtpreis: Wert = %product price%
    • Feldergruppe: productListItems > currencyCode
    • Feldergruppe: productListItems > ProductImageUrl
    • ProductImageUrl: value = %product image%
    • Währungscode: Wert = %currency code%
    • Feldergruppe: commerce > cart > cartID
    • Warenkorb-ID: Wert = %cart id%
    • Feldergruppe: commerce > productListAdds > value
    • value: value = 1

Regeln

  • Name: add to cart
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: add-to-cart
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: commerce.productListAdds
  • XDM-Daten: %add to cart%

openCart

Wird ausgelöst, wenn ein neuer Warenkorb erstellt wird, was passiert, wenn ein Produkt zu einem leeren Warenkorb hinzugefügt wird.

Datenelemente

Erstellen Sie das folgende Datenelement:

  1. Warenkorb öffnen:

    • Name: open cart
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: commerce > productListOpens > value
    • value: value = 1
    • Feldergruppe: commerce > cart > cartID
    • Warenkorb-ID: Wert = %cart id%
    • Feldergruppe: productListItems. productListItems können mehrere Elemente vorab berechnet werden. Wählen Sie productListItems > Gesamtes Array bereitstellen aus.

Regeln

  • Name: open cart
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: open-cart
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: commerce.productListOpens
  • XDM-Daten: %open cart%

Warenkorb anzeigen

Wird ausgelöst, wenn eine beliebige Warenkorbseite geladen wird.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Storefront:

    • Name: storefront
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: storefrontInstanceContext

  2. Produktbild-URL:

    • Name: product image
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.mainImageUrl
    1. Warenkorb:
    • Name: cart
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: shoppingCartContext

  3. Warenkorb-ID:

    • Name: cart id
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('cart').id

  4. Elemente der Produktliste:

    • Name: product list items:
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    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. Warenkorb anzeigen:

    • Name: view cart
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: productListItems. productListItems kann es mehrere Elemente geben, die vorberechnet werden. Wählen Sie productListItems > Gesamtes Array füllen aus.
    • Datenelement: %product list items%
    • Feldergruppe: productListItems > ProductImageUrl
    • ProductImageUrl: value = %product image%
    • Feldergruppe: commerce > cart > cartID
    • Warenkorb-ID: Wert = %cart id%
    • Feldergruppe: commerce > productListViews > value
    • value: value = 1

Regeln

  • Name: view cart
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: shopping-cart-view
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: commerce.productListViews
  • XDM-Daten: %view cart%

removeFromCart

Wird ausgelöst, wenn ein Produkt aus einem Warenkorb entfernt wird oder jedes Mal, wenn die Menge eines Produkts im Warenkorb verringert wird.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Produktname:

    • Name: product name
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.name

  2. Produkt-SKU:

    • Name: product sku
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.sku

  3. Währungscode:

    • Name: currency code
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.pricing.currencyCode

  4. Sonderpreis für das Produkt:

    • Name: product special price
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.pricing.specialPrice

  5. Regulärer Produktpreis:

    • Name: product regular price
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.pricing.regularPrice

  6. Produkt  Preis:

    • Name: product price
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('product regular price') || _satellite.getVar('product special price')

  7. Warenkorb:

    • Name: cart
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: shoppingCartContext

  8. Warenkorb-ID:

    • Name: cart id
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('cart').id

  9. Aus dem Warenkorb entfernen:

    • Name: remove from cart
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: productListItems. Wählen Einzelne Elemente angeben und klicken Sie auf die Schaltfläche Element hinzufügen. Da es sich bei dieser Ansicht um eine PDP handelt, können Sie sie mit einem einzelnen Element füllen.
    • Feldergruppe: productListItems > name
    • name: value = %product name%
    • Feldergruppe: productListItems > SKU
    • SKU: value = %product sku%
    • Feldergruppe: productListItems > priceTotal
    • Gesamtpreis: Wert = %product price%
    • Feldergruppe: productListItems > currencyCode
    • Währungscode: Wert = %currency code%
    • Feldergruppe: commerce > cart > cartID
    • Warenkorb-ID: Wert = %cart id%
    • Feldergruppe: commerce > productListRemovals > value
    • value: value = 1

Regeln

  • Name: remove from cart
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: remove-from-cart
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: commerce.productListRemovals
  • XDM-Daten: %remove from cart%

initiateCheckout

Wird ausgelöst, wenn der Käufer auf eine Checkout-Schaltfläche klickt.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Storefront:

    • Name: storefront
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: storefrontInstanceContext

  2. Produktbild-URL:

    • Name: product image
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.mainImageUrl

  3. Warenkorb:

    • Name: cart
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: shoppingCartContext

  4. Warenkorb-ID:

    • Name: cart id
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('cart').id

  5. Elemente der Produktliste:

    • Name: product list items
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    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. Checkout starten:

    • Name: initiate checkout
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: productListItems. productListItems kann es mehrere Elemente geben, die vorberechnet werden. Wählen Sie productListItems > Gesamtes Array füllen aus.
    • Datenelement: %product list items%
    • Feldergruppe: productListItems > ProductImageUrl
    • ProductImageUrl: value = %product image%
    • Feldergruppe: commerce > cart > cartID
    • Warenkorb-ID: Wert = %cart id%
    • Feldergruppe: commerce > checkouts > value
    • value: value = 1

Regeln

  • Name: initiate checkout
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: initiate-checkout
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: commerce.checkouts
  • XDM-Daten: %initiate checkout%

placeOrder

Wird ausgelöst, wenn der Käufer eine Bestellung aufgibt.

Datenelemente

Erstellen Sie die folgenden Datenelemente:

  1. Konto-E-Mail:

    • Name: account email
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: accountContext.emailAddress

  2. Storefront:

    • Name: storefront
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: storefrontInstanceContext

  3. Produktbild-URL:

    • Name: product image
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: productContext.mainImageUrl

  4. Warenkorb:

    • Name: cart
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: shoppingCartContext

  5. Warenkorb-ID:

    • Name: cart id
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('cart').id

  6. Bestellung:

    • Name: order
    • Erweiterung: Adobe Client Data Layer
    • Datenelementtyp: Data Layer Computed State
    • [Optional] path: orderContext

  7. Commerce-Bestellung:

    • Name: commerce order
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    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. Bestellversand:

    • Name: order shipping
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    const order = _satellite.getVar('order');
return {
    shippingMethod: order.shipping.shippingMethod,
    shippingAmount: order.shipping.shippingAmount || 0,
}

  9. Promotion-ID:

    • Name: promotion id
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    code language-bash 
    return _satellite.getVar('order').appliedCouponCode

  10. Elemente der Produktliste:

    • Name: product list items
    • Erweiterung: Core
    • Datenelementtyp: Custom Code
    • Editor öffnen:
    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. Bestellung aufgeben

    • Name: place order
    • Erweiterung: Adobe Experience Platform Web SDK
    • Datenelementtyp: XDM object
    • Feldergruppe: productListItems. productListItems kann es mehrere Elemente geben, die vorberechnet werden. Wählen Sie productListItems > Gesamtes Array füllen aus.
    • Datenelement: %product list items%
    • Feldergruppe: productListItems > ProductImageUrl
    • ProductImageUrl: value = %product image%
    • Feldergruppe: commerce > order
    • Eindeutige Kennung: Wert = %commerce order%
    • Feldergruppe: commerce > shipping
    • Eindeutige Kennung: Wert = %order shipping%
    • Feldergruppe: commerce > promotionID
    • Promotion-ID: value = %promotion id%
    • Feldergruppe: commerce > purchases > value
    • value: value = 1
    • Persönliche E-Mail: Wert = %account email%
    • Feldergruppe: personalEmail > address
    • Adresse: Wert = %account email%

Regeln

  • Name: place order
  • Erweiterung: Adobe Client Data Layer
  • Ereignistyp: Data Pushed
  • Spezifisches Ereignis: place-order
Aktionen
  • Erweiterung: Adobe Experience Platform Web SDK
  • Aktionstyp: Send event
  • Typ: commerce.order
  • XDM-Daten: %place order%

Festlegen der Identität in Storefront-Ereignissen

Storefront-Ereignisse enthalten Profilinformationen, die auf den Feldern personalEmail (für Kontoereignisse) und identityMap (für alle anderen Storefront-Ereignisse) basieren. Die Data Connection-Erweiterung verknüpft und generiert Profile, die auf diesen beiden Feldern basieren. Für jedes Feld sind jedoch verschiedene Schritte zum Erstellen von Profilen erforderlich:

NOTE
Wenn Sie eine frühere Einrichtung haben, die sich auf verschiedene Felder stützt, können Sie diese weiterhin verwenden.
  • personalEmail - Gilt nur für Kontoereignisse. Führen Sie die oben beschriebenen Schritte, Regeln und ​ aus
  • identityMap - Gilt für alle anderen Storefront-Ereignisse. Siehe folgendes Beispiel.

Beispiel

Die folgenden Schritte zeigen, wie Sie ein pageView-Ereignis mit identityMap in Data Connection Erweiterung konfigurieren:

  1. Konfigurieren des Datenelements mit benutzerdefiniertem Code für ECID:

    Konfigurieren des Datenelements mit benutzerdefiniertem Code
    Konfigurieren des Datenelements mit benutzerdefiniertem Code

  2. Wählen Sie Open Editor aus und fügen Sie den folgenden benutzerdefinierten Code hinzu:

    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. Aktualisieren Sie das XDM-Schema mit identityMap als ECID:

    identityMap als ECID festlegen
    identityMap als ECID festlegen

  4. Definieren Sie Regelaktionen, die ECID abrufen:

    ECID abrufen
    ECID abrufen

Festlegen der Identität in Back-Office-Ereignissen

Im Gegensatz zu Storefront-Ereignissen, die ECID verwenden, um Profilinformationen zu identifizieren und zu verknüpfen, sind Backoffice-Ereignisdaten SaaS-basiert und daher ist keine ECID verfügbar. Bei Back-Office-Ereignissen müssen Sie E-Mails verwenden, um Käufer eindeutig zu identifizieren. In diesem Abschnitt erfahren Sie, wie Sie Backoffice-Ereignisdaten per E-Mail mit einer ECID verknüpfen.

  1. Erstellen Sie ein Identitätszuordnungselement.

    Identitätszuordnung für Backoffice
    Back-Office-Identitätszuordnung erstellen

  2. Wählen Sie Open Editor aus und fügen Sie den folgenden benutzerdefinierten Code hinzu:

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. Fügen Sie jedes identityMap Feld dieses neue Element hinzu.

    Aktualisieren jeder identityMap
    Aktualisieren jeder identityMap

Einverständnis wird festgelegt

Wenn Sie die Data Connection-Erweiterung in Adobe Commerce installieren, ist das Einverständnis zur Datenerfassung standardmäßig aktiviert. Das Opt-out wird über das mg_dnt-Cookie verwaltet. Sie können die hier beschriebenen Schritte ausführen, wenn Sie mg_dnt zur Einverständnisverwaltung verwenden. Die Dokumentation zu Adobe Experience Platform Web SDK bietet mehrere zusätzliche Optionen zum Verwalten des Einverständnisses.

  1. Erstellen Sie ein Core Custom Code-Datenelement (%do not track cookie%) für das mg_dnt Cookie:

    Erstellen verfolgt kein Datenelement
    Erstellen verfolgt kein Datenelement

  2. Erstellen Sie ein Core Custom Code-Datenelement (%consent%), das out zurückgibt, wenn das Cookie gesetzt ist, und andernfalls in:

    Einverständnisdatenelement erstellen
    Einverständnisdatenelement erstellen

  3. Konfigurieren der Adobe Experience Platform Web SDK-Erweiterung mit %consent% Datenelement:

    Aktualisieren von SDK mit Einverständnis
    Aktualisieren von SDK mit Einverständnis

Warnungen

  • Wenn Sie zum Deaktivieren der Experience Platform-Erfassung keine Schritte ausführen, werden Ereignisse doppelt gezählt
  • Das Nicht-Einrichten von Zuordnungen/Ereignissen wie in diesem Thema beschrieben kann Auswirkungen auf Adobe Analytics Boards haben
  • Sie können Target nicht über die Data Connection-Erweiterung einrichten, wenn die Datenerfassung deaktiviert ist
recommendation-more-help
1dd1eb92-da61-46c0-8ff9-3831f21eb23e