Verbinden von Commerce-Daten mit Adobe Experience Platform
Wenn Sie die Erweiterung Data Connection installieren, werden im Menü System unter Dienste in der Commerce Admin zwei neue Konfigurationsseiten angezeigt.
- 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 der Erweiterung Data Connection .
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 auf der Seite Commerce Services Connector ausführen:
- Melden Sie sich bei Ihrem Commerce-Konto an, um Ihre Produktions- und Sandbox-API-Schlüssel abzurufen.
- Wählen Sie einen SaaS-Datenraum aus.
- Melden Sie sich bei Ihrem Adobe-Konto an, um Ihre Organisations-ID abzurufen.
Nachdem Sie den Commerce Services-Connector konfiguriert haben, konfigurieren Sie die Erweiterung "Data Connection".
Konfigurieren der Erweiterung Data Connection
In diesem Abschnitt erfahren Sie, wie Sie die Erweiterung Data Connection konfigurieren.
Hinzufügen von Dienstkonto- und Berechtigungsdetails
Wenn Sie planen, historische Bestelldaten oder Kundenprofildaten zu erfassen und zu senden, müssen Sie Dienstkonto- und Berechtigungsdetails hinzufügen. Wenn Sie die Erweiterung Audience Activation konfigurieren, müssen Sie diese Schritte ausführen.
Wenn Sie nur Storefront- oder Backoffice-Daten erfassen und senden, können Sie zum Abschnitt general springen.
Schritt 1: Erstellen eines Projekts in 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 Tutorial Authentifizierung und Zugriff auf Experience Platform-APIs beschriebenen Schritte aus.
Wenn Sie das Tutorial durchlaufen, stellen Sie sicher, dass Ihr Projekt Folgendes enthält:
- Zugriff auf die folgenden Produktprofile: Standardproduktion für alle Zugriffe auf und AEP Standard für alle Zugriffe.
- Die richtigen Rollen und Berechtigungen sindkonfiguriert.
- 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 Workspace-Konfigurationsdatei herunter. Kopieren Sie den Inhalt dieser Datei und fügen Sie ihn in die Seite Dienstkonto/Berechtigungsdetails des Commerce-Administrators ein.
-
Navigieren Sie in Commerce Admin zu "Stores"> "Einstellungen"> "Konfiguration"> "Dienste"> "Data Connection".
-
Wählen Sie im Menü Adobe Developer-Autorisierungstyp die von Ihnen implementierte Server-zu-Server-Autorisierungsmethode aus. Adobe empfiehlt die Verwendung von OAuth. JWT ist veraltet. Weitere Infos.
-
(Nur JWT) Kopieren Sie den Inhalt Ihrer
private.key
-Datei und fügen Sie ihn in das Feld Geheimer Client-Schlüssel ein. Verwenden Sie den folgenden Befehl, um den Inhalt zu kopieren.code language-bash cat config/private.key | pbcopy
Weitere Informationen zur Datei
private.key
finden Sie unter JWT-Authentifizierung (Service Account) . -
Kopieren Sie den Inhalt der Datei
<workspace-name>.json
in das Feld Details zu Dienstkonten/Berechtigungen .{width="700" modal="regular"}
-
Klicken Sie auf Konfiguration speichern.
-
Klicken Sie auf die Schaltfläche Test connection , um sicherzustellen, dass das von Ihnen eingegebene Dienstkonto und die eingegebenen Anmeldeinformationen korrekt sind.
Allgemein
-
Wechseln Sie im Admin zu System > Dienste > Data Connection.
{width="700" modal="regular"}
-
Überprüfen Sie auf der Registerkarte Einstellungen unter Allgemein die Ihrem Adobe Experience Platform-Konto zugeordnete ID, wie im Abschnitt Commerce Services Connector konfiguriert. Die Organisations-ID ist global. Pro Adobe Commerce-Instanz kann nur eine Organisations-ID zugeordnet werden.
-
Legen Sie in der Dropdown-Liste Umfang den Kontext auf Website fest.
-
(Optional) Wenn Sie bereits ein AEP Web SDK (Legierung) für Ihre Site bereitgestellt haben, aktivieren Sie das Kontrollkästchen und fügen Sie den Namen Ihres AEP Web SDK hinzu. Lassen Sie diese Felder andernfalls leer, und die Erweiterung Data Connection stellt eines für Sie bereit.
note note NOTE Wenn Sie Ihr eigenes AEP Web SDK angeben, verwendet die Erweiterung Data Connection die mit diesem SDK verknüpfte Datastraam-ID und nicht die auf dieser Seite angegebene Datastraam-ID (falls 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:
-
Verhaltensdaten (clientseitige Daten) sind Daten, die in der Storefront erfasst werden. Dazu gehören Interaktionen mit Käufern wie
View Page
,View Product
,Add to Cart
und Beschreibungsliste (für B2B-Händler). -
Back Office (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. Sie enthält auch historische Bestelldaten.
-
Profil sind Daten, die sich auf die Profilinformationen Ihres Käufers beziehen. Lernen Sie mehr.
Um sicherzustellen, dass Ihre Adobe Commerce-Instanz mit der Datenerfassung beginnen kann, überprüfen Sie die Voraussetzungen.
Weitere Informationen zu den Ereignissen storefront, back office und profile finden Sie im Ereignisthema .
-
Wählen Sie Storefront-Ereignisse aus, wenn Sie Storefront-Verhaltensdaten senden möchten.
-
Wählen Sie Backoffice-Ereignisse aus, wenn Sie Bestellstatusinformationen senden möchten, z. B. wenn eine Bestellung aufgegeben, storniert, zurückerstattet oder versandt wurde.
note note NOTE Wenn Sie Backoffice-Ereignisse auswählen, werden alle Back-Office-Daten an die Experience Platform-Kante 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. Erfahren Sie mehr darüber, wie Sie die Datenschutzeinstellungen eines Käufers auf der Experience Platform festlegen. -
(Überspringen Sie diesen Schritt, wenn Sie Ihr eigenes AEP Web SDK verwenden.) Erstellen Sie 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 das Feld Datastream-ID ein.
-
Geben Sie die Datensatz-ID ein, die Ihre Commerce-Daten enthalten soll. So suchen Sie die Datensatz-ID:
- Öffnen Sie die Experience Platform-Benutzeroberfläche und wählen Sie im linken Navigationsbereich Datensätze aus, um das Dashboard Datensätze zu öffnen. 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.
- Öffnen Sie den Datensatz, der Ihrem Datastream zugeordnet ist.
- Zeigen Sie im rechten Bereich die Details zum Datensatz an. Kopieren Sie die Datensatz-ID.
-
Um sicherzustellen, dass Back-Office-Ereignisdaten basierend auf einem Zeitplan gemäß einem cron -Auftrag aktualisiert werden, müssen Sie den
Sales Orders Feed
-Index inUpdate by Schedule
ändern.-
Wechseln Sie in der Seitenleiste Admin zu System > Tools>Index Management.
-
Aktivieren Sie das Kontrollkästchen für den
Sales Orders Feed
-Indexer. -
Setzen Sie Actions auf
Update by Schedule
. -
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 der 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
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
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. Wenn Ihr Schema und Ihr Datensatz ordnungsgemäß konfiguriert sind, wird ein Profildatensatz an die Experience Platform gesendet und an den Adobe-Profilverwaltungsdienst und den 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.
-
Vergewissern Sie sich, dass Sie über das Dienstkonto und die Anmeldeinformationen für bereitgestellt haben.
-
Stellen Sie sicher, dass Sie ein Schema und einen Datensatz für die Erfassung von Profildatensatzdaten und Erfassung von Zeitreihenereignisdaten angegeben haben.
-
Aktivieren Sie das Kontrollkästchen Kundenprofile , wenn Sie Profildaten an die Experience Platform senden möchten.
-
Geben Sie die Profildatensatz-ID ein.
Profildatensatzdaten müssen einen anderen Datensatz verwenden als den, den Sie derzeit für Verhaltens- und Back-Office-Ereignisdaten verwenden.
-
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 den Stream-Kundenprofilen über dieselbe Datastream-ID 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
Verlaufsreihendaten senden
Adobe Commerce erfasst bis zu fünf Jahre historische Bestelldaten und -status. Sie können die Erweiterung Data Connection verwenden, um diese historischen Daten an die Experience Platform zu senden, um Ihre Kundenprofile anzureichern und die Kundenerlebnisse anhand 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 das 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.
-
Vergewissern Sie sich, dass Sie über das Dienstkonto und die Anmeldeinformationen für bereitgestellt haben.
-
Aktivieren SieRabbitMQ.
note note NOTE RabbitMQ ist bereits für Commerce-Versionen 2.4.7 und höher eingerichtet, Sie müssen jedoch Verbraucher aktivieren. -
Aktivieren Sie die Verbraucher in der Nachrichtenwarteschlange durch Cron-Auftrag in
.magento.env.yaml
mithilfe der UmgebungsvariablenCRON_CONSUMERS_RUNNER
.code language-yaml stage: deploy: CRON_CONSUMERS_RUNNER: cron_run: true
note note NOTE Weitere Informationen zu allen verfügbaren Konfigurationsoptionen finden Sie in der Dokumentation zu Variablen bereitstellen .
Wenn der Synchronisierungsdienst für Bestellungen aktiviert ist, können Sie dann den Datumsbereich für die historische Bestellung auf der Seite Data Connection angeben.
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.
-
Wechseln Sie im Admin zu System > Dienste > Data Connection.
-
Wählen Sie die Registerkarte Auftragsverlauf aus.
{width="700" modal="regular"}
-
Unter Auftragsverlauf-Synchronisation ist das Kontrollkästchen Datensatz-ID aus Einstellungen kopieren bereits aktiviert. Dadurch wird sichergestellt, dass Sie denselben Datensatz verwenden, der auf der Registerkarte Einstellungen angegeben ist.
-
Geben Sie in den Feldern Von und bis 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.
-
Wählen Sie Start Sync aus, 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
Datenanpassung
Auf der Registerkarte Datenanpassung können Sie alle benutzerdefinierten Attribute anzeigen, die in Commerce konfiguriert und an Experience Platform gesendet wurden.
{width="700" modal="regular"}
Beim Erstellen benutzerdefinierter Attribute für Bestellungen und Senden an die Experience Platform müssen die Attributnamen in Commerce mit denen im Schema Commerce auf der Experience Platform übereinstimmen. Wenn sie nicht übereinstimmen, kann es schwierig sein, die Unterschiede zu ermitteln. Wenn Sie nicht übereinstimmende Namen haben, kann die Tabelle Benutzerdefinierte Bestellattribute dazu beitragen, das Problem zu lösen.
Die Tabelle Benutzerdefinierte Bestellattribute bietet Einblick in die Konfiguration und Zuordnung von benutzerdefinierten Bestellattributen zwischen dem Commerce Back Office und dem Commerce-Schema im Experience Platform. Diese Tabelle ermöglicht es Ihnen, benutzerdefinierte Attribute auf Bestellebene und Bestellartikelebene über verschiedene Quellen hinweg anzuzeigen, um die Identifizierung fehlender oder falsch ausgerichteter Attribute zu erleichtern. Außerdem werden Datensatz-IDs angezeigt, um zwischen Live- und historischen Datensätzen zu unterscheiden, da jeder Datensatz über eigene benutzerdefinierte Attribute verfügen kann.
Wenn neben einem benutzerdefinierten Attributnamen in der Tabelle kein grünes Häkchen angezeigt wird, deutet dies auf eine Diskrepanz zwischen den Attributnamen in den Quellen hin. Korrigieren Sie den Attributnamen in einer Quelle, und ein grünes Häkchen wird angezeigt, das angibt, dass die Namen nun übereinstimmen.
- Wenn der Attributname im Schema auf Experience Platform aktualisiert wird, müssen Sie die Konfiguration auf der Registerkarte Datenanpassung speichern, um die Experience Platform-Schemaänderung Trigger. Diese Änderung wird in der Tabelle Benutzerdefinierte Bestellattribute angezeigt, wenn Sie auf die Schaltfläche Refresh klicken.
- Wenn der Attributname in Commerce aktualisiert wird, muss ein Bestellereignis generiert werden, um den Namen in der Tabelle Benutzerdefinierte Bestellattribute zu aktualisieren. Die Änderung wird sich in etwa 60 Minuten widerspiegeln.
Erfahren Sie mehr darüber, wie Sie benutzerdefinierte Attribute einrichten.
Feldbeschreibungen
Bestätigen der Erfassung von Ereignisdaten
Um sicherzustellen, dass Daten aus Ihrem Commerce-Store erfasst werden, verwenden Sie den 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 erstellten Datensatz zurückgibt.
-
Wählen Sie Abfragen im linken Navigationsbereich von Experience Platform aus und klicken Sie auf Create Query.
-
Wenn der Abfrage-Editor geöffnet wird, geben Sie eine Abfrage ein, die Daten aus dem Datensatz auswählt.
Ihre Abfrage könnte beispielsweise wie folgt aussehen:
code language-sql SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC
-
Nachdem die Abfrage ausgeführt wurde, werden die Ergebnisse auf der Registerkarte Ergebnisse neben der Registerkarte Konsole angezeigt. Diese Ansicht zeigt die tabellarische Ausgabe Ihrer Abfrage an.
In diesem Beispiel werden Ereignisdaten aus den commerce.productListAdds
, commerce.productViews
, web.webpagedetails.pageViews
usw. angezeigt. 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. Erfahren Sie mehr über Fehlerbehebung bei Batch-Importen.
Überprüfen, ob die Profildaten auf der Experience Platform angezeigt werden
Wenn keine Profildaten auf der Experience Platform angezeigt werden, finden Sie in der Commerce KnowledgeBase Empfehlungen zur Fehlerbehebung.
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 können, indem Sie in Journey Optimizer Kunden-Journey erstellen.