Commerce Services Connector

Einige Adobe Commerce- und Magento Open Source-Funktionen werden von Commerce Services unterstützt und als SaaS (Software as a service) bereitgestellt. Um diese Dienste zu verwenden, müssen Sie Ihre Commerce -Instanz mithilfe der Produktions- und Sandbox-API-Schlüssel verbinden und den Datenraum in der Konfiguration angeben. Sie müssen die Verbindung nur einmal für jede Commerce-Instanz konfigurieren.

Verfügbare Dienste availableservices

In der folgenden Liste sind die Commerce-Funktionen aufgeführt, auf die Sie über die Commerce Services Connector zugreifen können:

Dienst
Verfügbarkeit
Product Recommendations powered by Adobe Sensei
Adobe Commerce
Live Search powered by Adobe Sensei
Adobe Commerce
Payment Services
Adobe Commerce und Magento Open Source
Site-Wide Analysis Tool
Adobe Commerce
Catalog Service
Adobe Commerce
Data Connection
Adobe Commerce

Architektur

Auf hoher Ebene besteht der Commerce Services Connector aus den folgenden Kernelementen:

Commerce Services Connector-Architektur

In den folgenden Abschnitten werden die einzelnen Elemente ausführlicher erläutert.

Anmeldeinformationen apikey

Die Produktions- und Sandbox-API-Schlüssel werden aus dem Commerce-Konto des Lizenzinhabers generiert. Das Commerce-Konto wird durch eine eindeutige Commerce ID (MageID) identifiziert. Der Lizenzinhaber für die Organisation des Händlers kann API-Schlüssel für Dienste wie Product Recommendations oder Live Search generieren, sofern das Konto gut aufgestellt ist.

Die Schlüssel können "bedarfsorientiert"an den Systemintegrator oder das Entwicklungsteam weitergegeben werden, der im Auftrag des Lizenzinhabers Projekte und Umgebungen verwaltet. Entwickler, denen der Lizenzinhaber Shared Access gewährt hat, können die Schlüssel nicht in ihrem Namen generieren, selbst wenn die Organisation des Händlers in der Dropdown-Liste Switch Accounts auf ihrem Konto vorhanden ist.

Darüber hinaus sind Lösungsintegratoren auch berechtigt, Commerce Services zu verwenden. Wenn Sie Lösungsintegrator sind, sollte der Unterzeichner des Commerce -Partnervertrags die API-Schlüssel generieren.

NOTE
Der Lizenzinhaber ist in der Regel der Primäre Ansprechpartner für das Adobe Commerce-Konto und nicht immer derselbe wie der Projekteigentümer des Adobe Commerce-Projekts für Cloud-Infrastruktur.

Generieren der Produktions- und Sandbox-API-Schlüssel genapikey

  1. Melden Sie sich bei Ihrem Commerce-Konto unter https://account.magento.com{:target="_blank"} an.

  2. Wählen Sie auf der Registerkarte Magento in der Seitenleiste die Option API-Portal aus.

  3. Wählen Sie im Menü Umgebung die Option Produktion oder Sandbox aus.

  4. Geben Sie im Abschnitt API-Schlüssel einen Namen ein und klicken Sie auf Neu hinzufügen , um das Dialogfeld zum Herunterladen des neuen Schlüssels zu öffnen.

    Privaten Schlüssel herunterladen

    note warning
    WARNING
    Dieses Dialogfeld bietet die einzige Möglichkeit, die Sie benötigen, um Ihre Schlüssel zu kopieren oder herunterzuladen.
  5. Klicken Sie auf Herunterladen und dann auf Abbrechen.

  6. Wiederholen Sie die obigen Schritte für jede Umgebung (Produktion und Sandbox).

    Im Abschnitt API-Schlüssel werden jetzt Ihre API-Schlüssel (öffentlichen) angezeigt. Sie benötigen sowohl die Produktions- als auch die Sandbox-Schlüssel (öffentlich+privat), wenn Sie ein SaaS-Projekt auswählen oder erstellen.

SaaS-Konfiguration saasenv

Commerce -Instanzen müssen mit einem SaaS-Projekt und einem SaaS-Datenraum konfiguriert werden, damit Commerce Services Daten an den richtigen Speicherort senden kann. Ein SaaS-Projekt gruppiert alle SaaS-Datenräume. Die SaaS-Datenräume werden verwendet, um Daten zu erfassen und zu speichern, die das Funktionieren von Commerce Services ermöglichen. Einige dieser Daten können aus der Commerce -Instanz exportiert werden, andere aus dem Kaufverhalten in der Storefront. Diese Daten werden dann beibehalten, um den Cloud-Speicher zu sichern.

Für Product Recommendations enthält der SaaS-Datenraum Katalog- und Verhaltensdaten. Sie können eine Commerce -Instanz auf einen SaaS-Datenraum verweisen, indem Sie sie in der Commerce -Konfiguration auswählen.

WARNING
Verwenden Sie Ihren Produktions-SaaS-Datenraum nur in Ihrer Produktions- Commerce-Installation, um Datenkollisionen zu vermeiden. Andernfalls riskieren Sie, Ihre Produktionsstandortdaten mit Testdaten zu verschmutzen, was zu Bereitstellungsverzögerungen führt. Beispielsweise können Ihre Produktionsproduktdaten fälschlicherweise aus Staging-Daten wie Staging-URLs überschrieben werden.

Auswählen oder Erstellen eines SaaS-Projekts createsaasenv

Um ein SaaS-Projekt auszuwählen oder zu erstellen, fordern Sie den API-Schlüssel Commerce vom Inhaber der Commerce-Lizenz für Ihren Store an:

NOTE
Wenn der Abschnitt Commerce Services Connector nicht in der Commerce -Konfiguration angezeigt wird, müssen Sie die Commerce -Module für den gewünschten Commerce Dienst installieren.
  1. Wechseln Sie in der Seitenleiste Admin zu System > Dienste > Commerce Services Connector.

    Wenn der Abschnitt Commerce Services Connector nicht in der Commerce -Konfiguration angezeigt wird, installieren Sie die Commerce -Module für den gewünschten Commerce Dienst. Stellen Sie außerdem sicher, dass das Paket magento/module-services-id installiert ist.

  2. Fügen Sie in den Abschnitten Sandbox-API-Schlüssel und Produktions-API-Schlüssel Ihre Schlüsselwerte ein.

    Private Schlüssel müssen "----BEGIN PRIVATE KEY---" am Anfang des Schlüssels und "----END PRIVATE KEY----" am Ende des privaten Schlüssels enthalten.

  3. Klicken Sie auf Speichern.

Alle SaaS-Projekte, die mit Ihren Schlüsseln verknüpft sind, werden im Feld Projekt im Abschnitt SaaS-Kennung angezeigt.

  1. Wenn keine SaaS-Projekte vorhanden sind, klicken Sie auf Projekt erstellen. Geben Sie dann im Feld Projekt einen Namen für Ihr SaaS-Projekt ein.

    Alle Händler können pro SaaS-Projekt auf einen Produktionsdatenraum und zwei Testdatenbereiche zugreifen. Bei On Cloud Pro-Projekten mit mehreren Staging-Umgebungen können Sie zusätzliche Testdatenräume für jede Staging-Umgebung anfordern, indem Sie eine Support-Anfrage senden.

  2. Wählen Sie den Datenraum aus, der für die aktuelle Konfiguration Ihres Commerce-Stores verwendet werden soll.

NOTE
Wenn Sie separate Instanzen zur Integration mit Commerce Services haben, senden Sie ein Support-Ticket, um ein neues SaaS-Projekt für jede zusätzliche Instanz anzufordern. Nachdem der Support das SaaS-Projekt erstellt hat, konfigurieren Sie die Commerce Services-Integration für die Instanz mit demselben API-Schlüssel und wählen Sie das neue SaaS-Projekt für den Datenraum aus.
WARNING
Wenn Sie im Abschnitt "Mein Konto"im API-Portal neue Schlüssel generieren, aktualisieren Sie sofort die API-Schlüssel in der Admin-Konfiguration. Wenn Sie neue Schlüssel generieren und diese nicht im Admin aktualisieren, funktionieren Ihre SaaS-Erweiterungen nicht mehr und Sie verlieren wertvolle Daten.

Um die Namen Ihres SaaS-Projekts oder Ihres Datenraums zu ändern, klicken Sie neben einem der beiden Elemente auf Umbenennen . Das Ändern des Namens wirkt sich nicht auf Ihren Dienst aus, da der Name nur eine Bezeichnung ist, mit der Sie Projekte und Datenräume identifizieren und unterscheiden können.

IMS-Organisation (optional) organizationid

Um Ihre Adobe Commerce-Instanz mit Adobe Experience Platform zu verbinden, melden Sie sich mit Ihrem Adobe-Konto bei Ihrem Adobe ID an. Nach der Anmeldung wird die mit Ihrem Adobe-Konto verknüpfte IMS-Organisation in diesem Abschnitt angezeigt.

SaaS-Datenexport

Wenn Ihre Commerce -Instanz erfolgreich eine Verbindung zu Commerce Services herstellt, exportiert der SaaS-Datenexportprozess Commerce-Daten von Ihrem Commerce -Server nach Commerce SaaS Services, damit sie mit verbundenen Commerce-Services synchronisiert werden können. Im Admin können Sie den Synchronisierungsstatus mithilfe des Daten-Management-Dashboards überprüfen. Weitere Informationen finden Sie im SAAS-Datenexport-Handbuch.

recommendation-more-help
3d5a1200-3287-4b90-a075-6c594f65d80e