Verbinden von Commerce-Daten mit Adobe Experience Platform

Wenn Sie die Data Connection Erweiterung, werden zwei neue Konfigurationsseiten im System Menü unter Dienste in der Commerce Admin.

  • Commerce Services Connector
  • Data Connection

Um Ihre Adobe Commerce-Instanz mit der Adobe Experience Platform zu verbinden, müssen Sie beide Connectoren konfigurieren, beginnend mit dem Commerce Services-Connector und schließlich mit dem Data Connection -Erweiterung.

Konfigurieren des Commerce Services-Connectors

Wenn Sie zuvor einen Adobe Commerce-Dienst installiert haben, haben Sie wahrscheinlich bereits den Commerce Services-Connector konfiguriert. Andernfalls müssen Sie die folgenden Aufgaben für die Commerce Services-Connector Seite:

  1. Melden Sie sich bei Ihrem Commerce-Konto bei Produktions- und Sandbox-API-Schlüssel abrufen.
  2. Wählen Sie eine SaaS-Datenraum.
  3. Melden Sie sich bei Ihrem Adobe-Konto bei Organisations-ID abrufen.

Nachdem Sie den Commerce Services-Connector konfiguriert haben, konfigurieren Sie die Data Connection -Erweiterung.

Konfigurieren Sie die Data Connection Erweiterung

In diesem Abschnitt erfahren Sie, wie Sie die Data Connection -Erweiterung.

Hinzufügen von Dienstkonto- und Berechtigungsdetails

Wenn Sie planen, historische Bestelldaten oder Kundenprofildatenmüssen Sie Dienstkonto- und Berechtigungsdetails hinzufügen. Wenn Sie die Audience Activation -Erweiterung hinzufügen, müssen Sie diese Schritte ausführen.

Wenn Sie nur Storefront- oder Backoffice-Daten erfassen und senden, können Sie zum Allgemein Abschnitt.

Schritt 1: Erstellen eines Projekts in der Adobe Developer Console

Erstellen Sie ein Projekt in der Adobe Developer Console, das Commerce authentifiziert, damit es Experience Platform-API-Aufrufe durchführen kann.

Um das Projekt zu erstellen, führen Sie die im Abschnitt Experience Platform-APIs authentifizieren und aufrufen Tutorial.

Wenn Sie das Tutorial durchlaufen, stellen Sie sicher, dass Ihr Projekt Folgendes enthält:

  • Zugriff auf Folgendes Produktprofile: Standardproduktion - Zugriff auf alle und AEP Standard - Zugriff auf alle.
  • Die richtige Rollen und Berechtigungen konfiguriert sind.
  • Wenn Sie JSON Web Tokens (JWT) als Authentifizierungsmethode für Server-zu-Server verwenden möchten, müssen Sie auch einen privaten Schlüssel hochladen.

Das Ergebnis dieses Schritts erstellt eine Konfigurationsdatei, die Sie im nächsten Schritt verwenden.

Schritt 2: Herunterladen der Konfigurationsdatei

Laden Sie die Konfigurationsdatei für Workspace. Kopieren Sie den Inhalt dieser Datei und fügen Sie ihn in das Details zu Dienstkonten/Berechtigungen Seite des Commerce-Administrators.

  1. Navigieren Sie in Commerce Admin zu Stores > Einstellungen > Konfiguration > Dienste > Data Connection.

  2. Wählen Sie die Server-zu-Server-Autorisierungsmethode aus, die Sie über die Adobe Developer-Autorisierungstyp Menü. Adobe empfiehlt die Verwendung von OAuth. JWT ist veraltet. Weitere Infos.

  3. (Nur JWT) Kopieren Sie den Inhalt Ihrer private.key in die Client Secret -Feld. Verwenden Sie den folgenden Befehl, um den Inhalt zu kopieren.

    code language-bash
    cat config/private.key | pbcopy
    

    Siehe Authentifizierung für Dienstkonten (JWT) Weitere Informationen zu private.key -Datei.

  4. Kopieren Sie den Inhalt der <workspace-name>.json in die Details zu Dienstkonten/Berechtigungen -Feld.

    Data Connection Administratorkonfiguration {width="700" modal="regular"}

  5. Klicks Konfiguration speichern.

Allgemein

  1. Navigieren Sie im Admin zu System > Dienste > Data Connection.

  2. Im Einstellungen Registerkarte unter Allgemein ​überprüfen Sie die mit Ihrem Adobe Experience Platform-Konto verknüpfte ID, wie in der Commerce Services Connector. Die Organisations-ID ist global. Pro Adobe Commerce-Instanz kann nur eine Organisations-ID zugeordnet werden.

  3. Im Anwendungsbereich Dropdown-Liste festlegen, setzen Sie den Kontext auf Webseite.

  4. (Optional) Wenn Sie bereits über eine AEP Web SDK (Legierung) auf Ihrer Site bereitgestellt, aktivieren Sie das Kontrollkästchen und fügen Sie den Namen Ihres AEP Web SDK hinzu. Andernfalls lassen Sie diese Felder leer und die Data Connection -Erweiterung stellt eine für Sie bereit.

    note note
    NOTE
    Wenn Sie Ihr eigenes AEP Web SDK angeben, wird die Data Connection -Erweiterung verwendet die mit diesem SDK verknüpfte Datastream-ID und nicht die auf dieser Seite angegebene Datastream-ID (sofern vorhanden).

Datenerfassung

In diesem Abschnitt geben Sie den Datentyp an, den Sie erfassen und an den Experience Platform-Edge senden möchten. Es gibt drei Datentypen:

  • Verhalten (Client-seitige Daten) sind Daten, die in der Storefront erfasst werden. Dazu gehören Interaktionen mit Käufern, z. B. View Page, View ProductAdd to Cart, und Anforderungsliste Informationen (für B2B-Händler).

  • Backoffice (Server-seitige Daten) sind Daten, die auf den Commerce-Servern erfasst werden. Dazu gehören Informationen über den Status einer Bestellung, z. B. ob eine Bestellung aufgegeben, storniert, rückerstattet, versandt oder abgeschlossen wurde. Er umfasst auch historische Bestelldaten.

  • Profil (Beta) sind Daten, die sich auf die Profilinformationen Ihres Käufers beziehen. Lernen more.

Um sicherzustellen, dass Ihre Adobe Commerce-Instanz mit der Datenerfassung beginnen kann, lesen Sie das Voraussetzungen.

Weitere Informationen finden Sie unter Ereignisthema . storefront, Backoffice, und profile -Ereignisse.

NOTE
Alle Felder im Datenerfassung -Abschnitt auf die Webseite Umfang oder höher.
  1. Auswählen Storefront-Ereignisse , wenn Sie Verhaltensdaten zur Storefront senden möchten.

  2. Auswählen Back-Office-Ereignisse wenn Sie Bestellstatusinformationen senden möchten, z. B. wenn eine Bestellung aufgegeben, storniert, rückerstattet oder versandt wurde.

    note note
    NOTE
    Wenn Sie Back-Office-Ereignisse, werden alle Backoffice-Daten an die Experience Platform-Edge gesendet. Wenn sich ein Kunde dafür entscheidet, die Datenerfassung abzuwählen, müssen Sie die Datenschutzeinstellung des Käufers explizit auf der Experience Platform festlegen. Dies unterscheidet sich von Storefront-Ereignissen, bei denen der Sammler die Zustimmung bereits auf der Grundlage der Kundeneinstellungen verarbeitet. Lernen more über die Festlegung der Datenschutzeinstellungen eines Käufers auf der Experience Platform.
  3. (Überspringen Sie diesen Schritt, wenn Sie Ihr eigenes AEP Web SDK verwenden.) Erstellen einen Datastream in der Adobe Experience Platform oder wählen Sie einen vorhandenen Datastream aus, den Sie für die Erfassung verwenden möchten. Geben Sie diese Datastream-ID in der Datenspeicher-ID -Feld.

  4. Geben Sie die Datensatz-ID , die Sie Ihre Commerce-Daten enthalten möchten. So suchen Sie die Datensatz-ID:

    1. Öffnen Sie die Experience Platform-Benutzeroberfläche und wählen Sie Datensätze im linken Navigationsbereich, um die Datensätze Dashboard. Das Dashboard listet alle verfügbaren Datensätze für Ihre Organisation auf. Details werden für jeden aufgelisteten Datensatz angezeigt, einschließlich seines Namens, des Schemas, dem der Datensatz entspricht, und des Status des letzten Erfassungslaufs.
    2. Öffnen Sie den Datensatz, der Ihrem Datastream zugeordnet ist.
    3. Zeigen Sie im rechten Bereich die Details zum Datensatz an. Kopieren Sie die Datensatz-ID.
  5. So stellen Sie sicher, dass Back-Office-Ereignisdaten anhand eines Zeitplans gemäß cron Auftrag, müssen Sie die Sales Orders Feed Index zu Update by Schedule.

    1. Im Admin Seitenleiste, navigieren Sie zu System > Tools>Index Management.

    2. Aktivieren Sie das Kontrollkästchen für die Sales Orders Feed Indexer.

    3. Satz Actions nach Update by Schedule.

    4. Wenn Sie zum ersten Mal Backoffice-Daten aktivieren, führen Sie die folgenden Befehle aus, um eine Neusynchronisierung neu zu indizieren und Trigger. Nachfolgende Neusynchronisierungen treten automatisch auf, solange die Variable cron Auftrag ordnungsgemäß eingerichtet ist.

      code language-bash
      bin/magento index:reindex sales_order_data_exporter_v2
      
      code language-bash
      bin/magento saas:resync --feed orders
      

Feldbeschreibungen

Feld
Beschreibung
Anwendungsbereich
Bestimmte Website, auf die die Konfigurationseinstellungen angewendet werden sollen.
Organisations-ID (global)
ID, die zu der Organisation gehört, die das Adobe DX-Produkt erworben hat. Diese ID verknüpft Ihre Adobe Commerce-Instanz mit Adobe Experience Platform.
Ist das AEP Web SDK bereits auf Ihrer Site bereitgestellt?
Aktivieren Sie dieses Kontrollkästchen, wenn Sie Ihr eigenes AEP Web SDK auf Ihrer Site bereitgestellt haben.
AEP Web SDK Name (global)
Wenn Sie bereits ein Experience Platform Web SDK auf Ihrer Site bereitgestellt haben, geben Sie den Namen dieses SDK in dieses Feld ein. Dadurch können Storefront Event Collector und Storefront Event SDK Ihr Experience Platform Web SDK anstelle der von der Data Connection -Erweiterung. Wenn auf Ihrer Site kein Experience Platform Web SDK bereitgestellt ist, lassen Sie dieses Feld leer, und die Variable Data Connection -Erweiterung stellt eine für Sie bereit.
Storefront-Ereignisse
Ist standardmäßig aktiviert, solange die Organisations-ID und die Datenspeicher-ID gültig sind. Storefront-Ereignisse erfassen anonymisierte Verhaltensdaten von Ihren Käufern beim Durchsuchen Ihrer Site.
Back-Office-Ereignisse
Wenn diese Option aktiviert ist, enthält die Ereignis-Payload anonymisierte Bestellstatusinformationen, z. B. ob eine Bestellung aufgegeben, storniert, zurückerstattet oder versandt wurde.
Datastream-ID (Website)
ID, die den Datenfluss von Adobe Experience Platform zu anderen Adobe DX-Produkten ermöglicht. Diese ID muss mit einer bestimmten Website in Ihrer jeweiligen Adobe Commerce-Instanz verknüpft sein. Wenn Sie Ihr eigenes Experience Platform Web SDK angeben, geben Sie in diesem Feld keine Datastream-ID an. Die Data Connection -Erweiterung verwendet die mit diesem SDK verknüpfte Datastream-ID und ignoriert alle in diesem Feld angegebenen Datastream-ID (sofern vorhanden).
Datensatz-ID (Website)
Kennung des Datensatzes, der Ihre Commerce-Daten enthält. Dieses Feld ist erforderlich, es sei denn, Sie haben die Option Storefront-Ereignisse oder Back-Office-Ereignisse Kontrollkästchen. Wenn Sie außerdem Ihr eigenes Experience Platform Web SDK verwenden und daher keine Datastream-ID angegeben haben, müssen Sie dennoch die Datensatz-ID hinzufügen, die Ihrem Datastream zugeordnet ist. Andernfalls können Sie dieses Formular nicht speichern.

Nach dem Onboarding fließen die Storefront-Daten an den Experience Platform-Edge. Es dauert etwa fünf Minuten, bis die Daten des Back Office am Rand angezeigt werden. Nachfolgende Aktualisierungen sind am Rand basierend auf dem Cron-Zeitplan sichtbar.

Senden von Kundenprofildaten

IMPORTANT
Diese Funktion befindet sich in der Beta-Phase.

Es gibt zwei Arten von Profildaten, die Sie an die Experience Platform senden können: Profildatensätze und Zeitreihenprofilereignisse.

Ein Profildatensatz enthält Daten, die gespeichert werden, wenn ein Käufer ein Profil in Ihrer Commerce-Instanz erstellt, z. B. den Namen des Käufers. Wann Ihr Schema und Ihr Datensatz ordnungsgemäß konfiguriert, wird ein Profildatensatz an die Experience Platform gesendet und an den Adobe Profil-Management- und Segmentierungsdienst weitergeleitet: Real-Time CDP.

Zeitreihenprofilereignisse enthalten Daten zu den Profilinformationen Ihres Käufers, z. B. ob er ein Konto auf Ihrer Site erstellt, bearbeitet oder löscht. Wenn Profilereignisdaten an die Experience Platform gesendet werden, befinden sie sich in einem Datensatz, in dem sie von anderen DX-Produkten verwendet werden können.

  1. Stellen Sie sicher, dass bereitgestellt Dienstkonto und Anmeldedaten.

  2. Stellen Sie sicher, dass Sie ein Schema und einen Datensatz für Erfassung von Profildatensätzen und Erfassung von Zeitreihenereignisdaten.

  3. Platzieren Sie ein Häkchen im Kundenprofile aktivieren, wenn Sie Profildaten an die Experience Platform senden möchten.

  4. Geben Sie die Profildatensatz-ID.

    Profildatensatzdaten müssen einen anderen Datensatz verwenden als den, den Sie derzeit für Verhaltens- und Back-Office-Ereignisdaten verwenden.

  5. Wenn Sie Profilereignisse nicht über dieselbe Datenspeicher-ID streamen möchten, die Sie für Verhaltens- und Backoffice-Daten verwenden, entfernen Sie das Häkchen aus dem Kundenprofile über dieselbe Datensatz-ID streamen und geben Sie die Datastream-ID ein, die Sie stattdessen verwenden möchten.

Es kann etwa 10 Minuten dauern, bis ein Profildatensatz in Real-Time CDP verfügbar ist. Profilereignisse beginnen sofort mit dem Streaming.

Feldbeschreibungen

Feld
Beschreibung
Kundenprofile
Aktivieren Sie dieses Kontrollkästchen, wenn Sie Kundenprofildatensätze erfassen und senden möchten.
Profildatensatz-ID
Ein Profildatensatz muss einen anderen Datensatz als den Datensatz verwenden, der für Verhaltens- und Back-Office-Ereignisse verwendet wird.
Kundenprofile über dieselbe Datensatz-ID streamen
Entscheiden Sie, ob Sie denselben Datastream verwenden möchten, der derzeit für Ihre Verhaltens- und Backoffice-Ereignisse verwendet wird oder nicht.
Datenspeicher für Kundenprofile
Geben Sie den Datensatz-spezifischen Kundenprofildatensatz an.

Verlaufsreihendaten senden

Adobe Commerce sammelt bis zu fünf Jahre historische Bestelldaten und -status. Sie können die Data Connection Erweiterung, um diese historischen Daten an die Experience Platform zu senden, um Ihre Kundenprofile anzureichern und die Kundenerlebnisse auf der Grundlage dieser früheren Bestellungen zu personalisieren. Die Daten werden in einem Datensatz innerhalb von Experience Platform gespeichert.

Commerce erfasst zwar bereits die historischen Bestelldaten, Sie müssen jedoch mehrere Schritte ausführen, um diese Daten an Experience Platform zu senden.

Sehen Sie sich dieses Video an, um mehr über historische Bestellungen zu erfahren, und führen Sie dann die folgenden Schritte aus, um die Erfassung historischer Bestellungen zu implementieren.

Einrichten des Auftragssynchronisierungsdienstes

Der Synchronisierungsdienst für Aufträge verwendet die Message Queue Framework und RabbitMQ. Nachdem Sie diese Schritte ausgeführt haben, können die Bestellstatusdaten mit SaaS synchronisiert werden, was erforderlich ist, bevor sie an Experience Platform gesendet werden.

  1. Stellen Sie sicher, dass bereitgestellt Dienstkonto und Anmeldedaten.

  2. Aktivieren RabbitMQ.

    note note
    NOTE
    RabbitMQ ist bereits für Commerce-Versionen 2.4.7 und höher eingerichtet, Sie müssen jedoch Verbraucher aktivieren.
  3. Aktivieren von Verbrauchern in der Nachrichtenwarteschlange durch Cron-Auftrag in .magento.env.yaml using CRON_CONSUMERS_RUNNER Umgebungsvariable.

    code language-yaml
       stage:
         deploy:
           CRON_CONSUMERS_RUNNER:
             cron_run: true
    
    note note
    NOTE
    Siehe Dokumentation zu Implementierungsvariablen , um mehr über alle verfügbaren Konfigurationsoptionen zu erfahren.

Wenn der Synchronisierungsdienst für Bestellungen aktiviert ist, können Sie dann den Datumsbereich für die historische Bestellung im Data Connection Seite.

Angeben des Datumsbereichs für den Auftragsverlauf

Geben Sie den Datumsbereich für die historischen Bestellungen an, die Sie an Experience Platform senden möchten.

  1. Navigieren Sie im Admin zu System > Dienste > Data Connection.

  2. Wählen Sie die Auftragsverlauf Registerkarte.

  3. under Bestellverlauf - Synchronisierung, die Datensatz-ID aus Einstellungen kopieren aktiviert ist. Dadurch wird sichergestellt, dass Sie denselben Datensatz verwenden, der im Einstellungen Registerkarte.

  4. Im Von und nach Geben Sie den Datumsbereich für die historischen Bestelldaten an, die Sie senden möchten. Sie können keinen Datumsbereich auswählen, der fünf Jahre überschreitet.

  5. Auswählen Start Sync , um die Synchronisierung Trigger, die gestartet werden soll. Historische Bestelldaten sind Batch-Daten im Gegensatz zu Storefront- und Backoffice-Daten, die Streaming-Daten darstellen. Es dauert etwa 45 Minuten, bis die Batch-Daten in Experience Platform ankommen.

Feldbeschreibungen
Feld
Beschreibung
Datensatz-ID aus Einstellungen kopieren
Kopiert die Datensatz-ID, die Sie in der Variablen Einstellungen Registerkarte.
Datensatz-ID (Website)
Kennung des Datensatzes, der Ihre Commerce-Daten enthält. Dieses Feld ist erforderlich, es sei denn, Sie haben die Option Storefront-Ereignisse oder Back-Office-Ereignisse Kontrollkästchen. Wenn Sie außerdem Ihr eigenes Experience Platform Web SDK verwenden und daher keine Datastream-ID angegeben haben, müssen Sie dennoch die Datensatz-ID hinzufügen, die Ihrem Datastream zugeordnet ist. Andernfalls können Sie dieses Formular nicht speichern.
Von
Datum, ab dem Sie mit der Erfassung von Auftragsverlaufsdaten beginnen möchten.
nach
Datum, ab dem die Erfassung von Auftragsverlaufsdaten beendet werden soll.
Synchronisierung starten
Beginnt die Synchronisierung der Auftragsverlaufsdaten mit dem Experience Platform Edge. Diese Schaltfläche ist deaktiviert, wenn die Dataset ID leer ist oder die Datensatz-ID ungültig ist.

Bestätigen der Erfassung von Ereignisdaten

Um sicherzustellen, dass Daten aus Ihrem Commerce-Store erfasst werden, verwenden Sie das Adobe Experience Platform Debugger , um Ihre Commerce-Site zu untersuchen. Nachdem Sie bestätigt haben, dass Daten erfasst werden, können Sie sicherstellen, dass Ihre Storefront- und Back-Office-Ereignisdaten am Edge angezeigt werden, indem Sie eine Abfrage ausführen, die Daten aus dem von Ihnen erstellter Datensatz.

  1. Auswählen Abfragen im linken Navigationsbereich von Experience Platform und klicken Sie auf Create Query.

    Abfrage-Editor

  2. Wenn der Abfrage-Editor geöffnet wird, geben Sie eine Abfrage ein, die Daten aus dem Datensatz auswählt.

    Abfrage erstellen

    Ihre Abfrage könnte beispielsweise wie folgt aussehen:

    code language-sql
    SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC
    
  3. Nach Ausführung der Abfrage werden die Ergebnisse im Ergebnisse neben dem Konsole Registerkarte. Diese Ansicht zeigt die tabellarische Ausgabe Ihrer Abfrage an.

    Abfrage-Editor

In diesem Beispiel werden Ereignisdaten aus der commerce.productListAdds, commerce.productViews, web.webpagedetails.pageViewsusw. Mit dieser Ansicht können Sie überprüfen, ob Ihre Commerce-Daten am -Edge angekommen sind.

Wenn die Ergebnisse nicht Ihren Erwartungen entsprechen, öffnen Sie den Datensatz und suchen Sie nach fehlgeschlagenen Batch-Importen. Weitere Informationen Fehlerbehebung bei Batch-Importen.

Nächste Schritte

Wenn Commerce-Daten an den Experience Platform-Edge gesendet werden, können andere Adobe Experience Cloud-Produkte wie Adobe Journey Optimizer diese Daten verwenden. Sie können beispielsweise Journey Optimizer so konfigurieren, dass bestimmte Ereignisse überwacht werden. Auf der Grundlage dieser Ereignisdaten können Sie eine E-Mail für einen Erstbenutzer oder einen Transaktionsabbruch erstellen. Erfahren Sie, wie Sie Ihre Commerce-Plattform erweitern Erstellen von Journey für Kunden in Journey Optimizer.

recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840