Dokumentation Commerce Optimizer Connector

[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

Letzte Aktualisierung: 1. Juni 2026

Erstellt für:

{"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

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

IMPORTANT

Verbinden Sie Sandbox Optimizer-Instanzen immer mit Nicht-Produktionsumgebungen und Produktionsinstanzen mit Produktionsumgebungen. Nicht übereinstimmende Umgebungen führen zu inkonsistenten Katalogdaten, Suchergebnissen und Empfehlungen.

Voraussetzungen für die Verwendung der Integration requirements-to-use-the-integration

Adobe Commerce 2.4.7+
- PHP 8.2, 8.3 oder 8.4
- Composer 2.x
Commerce Optimizer Lizenz mit einer bereitgestellten Sandbox-Instanz.
Authentifizierungsschlüssel zum Herunterladen des Connector-Metapakets mit Composer.
Administratorzugriff auf eine Commerce Optimizer Sandbox-Instanz.

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

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

Konfliktende Erweiterungen entfernen remove-conflicting-extensions

Wenn Sie eine der folgenden Erweiterungen installiert haben, deinstallieren Sie diese, bevor Sie die Adobe 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 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 Commerce Optimizer Admin-Benutzeroberfläche.

IMPORTANT

Wenn diese Erweiterungen vor dem Aktivieren des Connectors nicht entfernt werden, werden möglicherweise fehlerhafte Konfigurationsbildschirme, doppelte Daten in Commerce Optimizer angezeigt, da dieselben Daten sowohl aus dem Connector als auch aus den vorhandenen Erweiterungen exportiert werden, und 401- oder 403-Fehler in den Protokollen aufgrund von Konflikten bei der Authentifizierung der Erweiterungen und des Connectors bei den verbundenen Services.

style

shade-box

Konfigurationsschritte configuration-steps

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

Installieren Sie das Adobe Commerce Optimizer Connector -Paket mithilfe von Composer, um Ihre Adobe Commerce-Instanz mit Commerce Optimizer zu verbinden.
Anpassen der Exportkonfiguration für Commerce-Bereiche vom Administrator.
Aktivieren Sie die Commerce Optimizer -Integration.
Überprüfen Sie, ob die Datensynchronisation funktioniert.

Installieren des Adobe Commerce Optimizer Connector install-the-adobe-commerce-optimizer-connector-package

Das Adobe Commerce Optimizer Connector wird als Composer-Metapaket bereitgestellt, das für alle Commerce-Händler mit einer aktiven Lizenz für 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 Commerce Admin-Menü verfügbar. Wählen Sie Commerce Optimizer aus, um Ihre Commerce Optimizer-Instanz direkt über die Commerce-Admin zu öffnen.

NOTE

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

Installieren der Erweiterung in Adobe Commerce Cloud-Infrastruktur

Installieren einer Erweiterung Adobe Commerce On-Premise

Anpassen der Exportkonfiguration für Commerce-Bereiche customize-the-commerce-scopes-export-configuration

Standardmäßig ist die Synchronisierung von Katalogdaten für alle Commerce-Bereiche (Websites, Kundengruppen 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 über mehrere Store-Ansichten verfügen, die dieselbe Sprache verwenden, können Sie Daten für nur eine der Store-Ansichten exportieren und als Katalogquelle für mehrere Catalog-Ansichten in Commerce Optimizer verwenden.

IMPORTANT

Durch Ändern der Exporteinstellungen wird eine vollständige Neuindizierung Trigger, die je nach Kataloggröße längere Zeit in Anspruch nehmen kann. Adobe empfiehlt, die Commerce-Bereiche so zu konfigurieren, dass sie mit Commerce Optimizer synchronisiert werden, bevor die Integration aktiviert und die anfängliche Datensynchronisierung gestartet wird.

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

Umfang

Daten exportiert

Notizen

Website und Kundengruppe

Preise und Preisbücher

Jede Preisgruppe wird als „Preisbuch exportiert, wobei Namenskonvention <website>::<SHA1 of customer group ID> verwendet wird. Alle Kundengruppen für die Website sind enthalten.

Shop-Ansicht

Produkte und Produktattribute

Jede Shop-Ansicht erstellt eine separate Katalogquelle in Commerce Optimizer.

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

So ändern Sie die Exporteinstellungen für Bereiche

Wechseln Sie in 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 Commerce Optimizer- das Kontrollkästchen, um die Datensynchronisierung nach Bedarf zu aktivieren oder zu deaktivieren.

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

Aktivieren und Deaktivieren des Verhaltens

Aktion

Ergebnis

Shop-Ansicht deaktivieren

Durch Deaktivieren der Synchronisierung werden Katalogdaten aus Ihrer Storefront entfernt. Die Katalogquelle bleibt in Commerce Optimizer, aber alle synchronisierten Daten werden bei der nächsten Cron-Ausführung entfernt.

Deaktivieren und reaktivieren Sie eine Store-Ansicht

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

Commerce Optimizer aktivieren enable-the-adobe-commerce-optimizer-integration

Sie aktivieren die Integration und initiieren die Datensynchronisation, indem Sie den aco:config:init CLI-Befehl ausführen. Dieser Befehl führt die folgenden Schritte aus:

Ruft ein IMS-Zugriffstoken mit den als Befehlszeilenargumente bereitgestellten Anmeldeinformationen ab.
Ruft den Commerce Cloud Manager-Service (CCM) unter https://ccm.api.commerce.adobe.com/api/v1/tenants/{tenantId}/owner/{orgId} auf, um den Mandanten zu validieren und die Aufnahme-URL und die Commerce Optimizer Studio-URL zu extrahieren.
Speichert alle Konfigurationen (Client-Geheimnis verschlüsselt) in core_config_data.
Plant die anfängliche vollständige Synchronisierung durch Invalidierung aller Commerce Optimizer-Indexer.

IMPORTANT

Die Datensynchronisierungsverarbeitung beginnt im Hintergrund, sobald die Konfiguration abgeschlossen ist. Je nach Größe Ihres Katalogs kann der Datensynchronisierungsprozess einige Minuten bis mehrere Stunden dauern.

Erforderliche Verbindungsdetails abrufen

Erstellen Sie in der Adobe Developer Console ein neues Projekt, das für den 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.

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

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

Abrufen von Anmeldeinformationen von der Adobe Developer Console-Projektseite {width="500" modal="regular"}

Commerce Optimizer-Instanzdetails abrufen

Rufen Sie die Mandanten ID) aus dem Feld Instance Idauf der Commerce Optimizer-Instanz Instance details Seite oder aus der URL ab, die für den Zugriff auf die Instanz verwendet wird. Zum Beispiel in https://experience.adobe.com/#/@<your organization>/in:<tenant ID>/commerce-optimizer-studio/home.

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 Adobe Commerce Staging-Umgebung herzustellen.

Führen Sie den folgenden Adobe Commerce CLI-Befehl aus, um die Integration zu konfigurieren. Ersetzen Sie dabei die Platzhalterwerte durch die Werte für Ihr Commerce Optimizer:

code language-shell
`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 die Option auswählen, wird die Commerce Optimizer-Benutzeroberfläche auf einer neuen Registerkarte geöffnet.

Überprüfen, ob die Datensynchronisation funktioniert verify-that-the-data-sync-is-working

Vergewissern Sie sich, dass die Daten erfolgreich von Commerce Admin exportiert und erfolgreich an Commerce Optimizer übermittelt wurden. Beginnen Sie im Commerce-Admin mit dem Export und bestätigen Sie dann den Versand in Commerce Optimizer.

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

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

{width="700" 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 an Commerce Optimizer gesendet wurden:

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

{width="700" modal="regular"}

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

Wenn die Synchronisierung erwartungsgemäß funktioniert:

Data Feed Sync Status zeigt erfolgreich gesendete Datensätze für Connector-Feeds ohne nicht behobene Fehler auf Elementebene an.
Data Sync in Commerce Optimizer listet die erwarteten Katalogquellen, Produkte, Preise und Attribute auf.

TIP

Wenn Sie Probleme mit der Datensynchronisation haben, lesen Sie das Handbuch Fehlerbehebung.

Nächste Schritte

Konfigurieren Commerce Optimizer Katalogansichten und Richtlinien

Erstellen Sie Katalogansichten und Richtlinien in der Commerce Optimizer-Benutzeroberfläche. Beachten Sie, dass Preislisten automatisch aus Adobe Commerce Kundengruppen erstellt werden. Anweisungen finden Sie in der Katalogansichten und Richtlinien im Commerce Optimizer-Benutzerhandbuch.
Einrichten einer Commerce-Storefront aufEdge Delivery Services

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

recommendation-more-help

commerce-help-aco-connector