Dokumentation Commerce Adobe Commerce Optimizer Connector Integrationshandbuch

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

Erste Schritte

Last update: Thu Mar 19 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

Benutzende

Installieren und konfigurieren Sie den Commerce Optimizer-Connector, um Ihre Adobe Commerce-Katalogdaten mit Adobe Commerce Optimizer zu synchronisieren, und überwachen Sie dann den Datensynchronisierungsstatus, um sicherzustellen, dass Ihre Storefront auf dem neuesten Stand ist.

Voraussetzungen für die Verwendung der Integration

Adobe Commerce 2.4.7+
- PHP 8.2, 8.3 oder 8.4
- Composer 2.x
Adobe Commerce Optimizer Lizenz mit einer bereitgestellten Sandbox-Instanz.
Zugriff auf repo.magento.com, um das Commerce Connector-Metapaket mit Composer herunterzuladen.
Administratorzugriff auf eine Adobe Commerce Optimizer Sandbox-Instanz.

Der Adobe Commerce-Benutzer, der die Integration konfiguriert, muss über Folgendes verfügen:

Administratorzugriff auf den Adobe Commerce Admin.
Befehlszeilenzugriff auf den Adobe Commerce-Anwendungsserver.
Entwicklerzugriff auf die IMS-Organisation, in der das Adobe Commerce Optimizer bereitgestellt wird.

recommendation-more-help

Voraussetzungen

Wenn Sie eine der folgenden Erweiterungen installiert haben, deinstallieren Sie diese, bevor Sie den Commerce Optimizer-Connector installieren:

Adobe Commerce Live Search (magento/live-search)
Adobe Commerce Product Recommendations (magento/product-recommendations)
Adobe Commerce Catalog Service (magento/catalog-service, magento/catalog-service-installer)
Data Management Dashboard (magento-catalog-sync-admin)

Daten, die mit diesen Erweiterungen verknüpft sind, sind weiterhin in der Commerce-Datenbank verfügbar. Er wird jedoch nicht nach Adobe Commerce Optimizer exportiert, wenn der Connector aktiviert ist. Um die Such- und Merchandising-Funktionen zu implementieren, die diese Erweiterungen nach der Aktivierung des Connectors bieten, konfigurieren Sie sie über die Adobe Commerce Optimizer Admin-Benutzeroberfläche.

style

shade-box

Konfigurationsschritte

Führen Sie die folgenden Schritte aus, um den Connector zu aktivieren und mit der Synchronisierung von Daten aus Commerce mit Ihrer Adobe Commerce Optimizer-Instanz zu beginnen.

Installieren Sie das Commerce Optimizer Connector-Paket verwenden Sie Composer, um Ihre Commerce-Instanz mit Adobe Commerce Optimizer zu verbinden.
Überprüfen und passen Sie die Datenexportkonfiguration Admin an.
Zum Herstellen der Verbindung zwischen Commerce und Commerce Optimizer sind API-Anmeldeinformationen erforderlich.
Aktivieren Sie die Adobe Commerce Optimizer -Integration.
Überprüfen Sie, ob die Datensynchronisation funktioniert.

Installieren des Commerce Optimizer Connector-Pakets

Der Adobe Commerce Optimizer-Connector wird als Composer-Metapaket bereitgestellt, das für alle Commerce-Händler mit einer aktiven Lizenz für Adobe Commerce Optimizer verfügbar ist.

Installationsschritte

Fügen Sie das Modul adobe-commerce/commerce-data-export-aco-adapter mit dem Composer hinzu:

code language-shell
`composer require adobe-commerce/commerce-data-export-aco-adapter`

Stellen Sie die Änderungen in Ihrer Adobe Commerce-Staging-Umgebung bereit.

Nach Abschluss der Bereitstellung ist die Option Commerce Optimizer im Menü Commerce Admin verfügbar. Klicken Sie auf Commerce Optimizer , um Ihre Commerce Optimizer-Instanz direkt über den Commerce-Administrator zu öffnen.

NOTE

Detaillierte Installationsanweisungen für Erweiterungen finden Sie in den folgenden Handbüchern:

Installieren der Erweiterung auf Adobe Commerce in der Cloud-Infrastruktur

Installieren der Erweiterung auf Adobe Commerce On-Premise

Erforderliche Verbindungsdetails abrufen

Erstellen Sie in der Adobe Developer Console ein Entwicklerprojekt, das für den Adobe Commerce Optimizer-Aufnahme-Service aktiviert ist, und generieren Sie OAuth-Server-zu-Server-Anmeldeinformationen. Detaillierte Anweisungen finden Sie unter Abrufen von IMS im Merchandising-Entwicklerhandbuch.

TIP

Wenn Sie bereits ein Entwicklerprojekt mit der Datenaufnahme-API in derselben IMS-Organisation wie Ihre Commerce Optimizer-Instanz konfiguriert haben, können Sie die vorhandenen OAuth-Server-zu-Server-Anmeldedaten wiederverwenden.

Speichern Sie die folgenden Werte auf der Seite mit den Anmeldedaten:

Organisations-ID (org_id)
Client-ID (client_id)
Client-Geheimnis (client_secret)

Adobe Commerce Optimizer-Instanzdetails abrufen

Speichern Sie die Instanz-ID (auch als Mandanten-ID bezeichnet) aus Ihrer Adobe Commerce Optimizer. Sie finden sie in der URL, die für den Zugriff auf die Instanz verwendet wird. In https://experience.adobe.com/#/@<project-id>/in:TToyu73daQRn66KAYaq8YZ/commerce-optimizer-studio/home ist die Instanz-ID beispielsweise TToyu73daQRn66KAYaq8YZ.

Anpassen der Konfiguration für den Commerce-Datenexport

Standardmäßig ist die Synchronisierung von Katalogdaten für alle Commerce-Bereiche (Websites und Store-Ansichten) aktiviert. Sie können die Exporteinstellungen so anpassen, dass Daten nur für bestimmte Bereiche entsprechend Ihren Geschäftsanforderungen synchronisiert werden. Wenn Sie beispielsweise mehrere Store-Ansichten haben, aber nur Daten für eine dieser Ansichten exportieren möchten, können Sie für die anderen Store-Ansichten den Exporter deaktivieren.

IMPORTANT

Durch Ändern der Exporteinstellungen wird eine vollständige Neuindizierung Trigger, die je nach Kataloggröße längere Zeit in Anspruch nehmen kann. Planen Sie diese Änderungen in Zeiten geringen Traffics, um Leistungseinbußen zu minimieren.

Datenexport nach Umfang

In der folgenden Tabelle wird beschrieben, welche Daten auf jeder Bereichsebene exportiert werden:

Umfang

Daten exportiert

Notizen

Website

Preise und Preisbücher

Jede Preisgruppe wird als „Preisbuch exportiert, wobei Namenskonvention website::customergroupcode verwendet wird. Alle Kundengruppen für die Website sind enthalten.

Shop-Ansicht

Produkte und Produktattribute

Jede Store-Ansicht erstellt eine separate Katalogquelle in Adobe Commerce Optimizer.

Aktivieren und Deaktivieren des Verhaltens

Aktion

Ergebnis

Shop-Ansicht deaktivieren

Die Katalogquelle bleibt in Adobe Commerce Optimizer, aber alle Daten werden entfernt.

Deaktivieren und reaktivieren Sie eine Store-Ansicht

Dieselbe Katalogquelle wird erneut mit einer vollständigen Datensynchronisation aufgefüllt.

Aktualisieren der Exportkonfiguration

Nach der Installation des Connector-Pakets zeigt das Speichergitter in Admin jetzt die Exportkonfigurationseinstellungen für Commerce Optimizer an.

Raster mit Commerce Optimizer-Synchronisierungseinstellungen speichern {width="600" modal="regular"}

So ändern Sie die Einstellungen für eine Website- oder Store-Ansicht:

Navigieren Sie im Commerce Admin zu Stores > Settings > All Stores.
Wählen Sie die Website- oder Store-Ansicht aus, die Sie konfigurieren möchten.
Aktivieren Sie in den Adobe Commerce Optimizer- das Kontrollkästchen, um die Datensynchronisierung nach Bedarf zu aktivieren oder zu deaktivieren.

{width="500" modal="regular"}
Speichern Sie Ihre Änderungen.

Adobe Commerce Optimizer aktivieren

IMPORTANT

Die Datensynchronisierungsverarbeitung beginnt, sobald Sie den Konfigurationsbefehl ausführen. Standardmäßig ist die Synchronisierung von Katalogdaten für alle Commerce-Bereiche (Websites und Store-Ansichten) aktiviert. Je nach Größe Ihres Katalogs kann der Datensynchronisierungsprozess einige Minuten bis mehrere Stunden dauern.

Mithilfe der API-Anmeldeinformationen und Instanzdetails, die Sie in den vorherigen Schritten gesammelt haben, können Sie jetzt die Integration zwischen Ihrer Commerce- und Adobe Commerce Optimizer-Instanz konfigurieren.

Wählen Sie in Commerce Admin die Option Adobe Commerce Optimizer aus, um die Konfigurationsseite mit Anweisungen anzuzeigen.

{width="500" modal="regular"}
Verwenden Sie in der Befehlszeile SSH, um eine Verbindung zur Commerce-Staging-Umgebung herzustellen.
Führen Sie den folgenden Commerce-CLI-Befehl aus, um die Integration zu konfigurieren. Ersetzen Sie dabei die Platzhalterwerte durch die Werte für Ihr Commerce Optimizer-Projekt:

bin/magento aco:config:init --org_id=your-org --tenant_id=your-tenant --client_id=your-client-id --client_secret=your-secret

Überprüfen Sie die Verbindung, indem Sie zum Commerce-Administrator zurückkehren und die Option Adobe Commerce Optimizer auswählen.

Wenn Sie auf die Option klicken, wird die Adobe Commerce Optimizer-Benutzeroberfläche auf einer neuen Registerkarte geöffnet.

Überprüfen, ob die Datensynchronisation funktioniert

Nach Aktivierung der Integration beginnt die Datensynchronisation automatisch. Je nach Kataloggröße kann die erste Synchronisierung einige Minuten bis mehrere Stunden dauern.

Überprüfen Sie den Synchronisierungsstatus im Commerce Admin-:

Navigieren Sie zu System > Data Transfer > Data Feed Sync Status.

{width="500" modal="regular"}

Wenn die Synchronisierung ausgeführt wird, zeigen die Feed-Daten erfolgreich gesendete Datensätze an. Feed auswählen, um Details anzuzeigen oder Synchronisierungsprobleme zu beheben.
Bestätigen Sie, dass Daten in Commerce Optimizer eingegangen sind:

Wählen Sie im Adobe Commerce Optimizer Menü Data Sync aus.

{width="500" modal="regular"}

Überprüfen Sie, ob die erwarteten Produkte, Preise und Attribute angezeigt werden.

TIP

Wenn Sie Probleme mit der Datensynchronisation haben, lesen Sie den Abschnitt Fehlerbehebung in der Dokumentation zum SaaS-.

Nächste Schritte

Konfigurieren Adobe Commerce Optimizer Katalogansichten und -richtlinien

Erstellen Sie Katalogansichten und Richtlinien im Adobe Commerce Optimizer. Beachten Sie, dass Preisverzeichnisse automatisch von Adobe Commerce-Kundengruppen erstellt werden.
Einrichten einer Commerce-Storefront auf Edge Delivery Services

Befolgen Sie die Dokumentation zur Einrichtung von Storefronts, um Ihre Storefront mit der Adobe Commerce Optimizer-Instanz zu verbinden und mit der Bereitstellung personalisierter Commerce-Erlebnisse zu beginnen.

c7d6abe6-2b55-4417-996b-63e61a70243c