Commerce Services Connector
Einige Adobe Commerce- und Magento Open Source-Funktionen basieren auf Commerce Services und werden als SaaS (Software as a Service) bereitgestellt. Um diese Services zu verwenden, müssen Sie Ihre Commerce mithilfe von Produktions- und Sandbox-API-Schlüsseln verbinden und den Datenspeicher in der Konfiguration“. Sie müssen die Verbindung nur einmal für jede Instanz konfigurieren.
Verfügbare Services availableservices
Im Folgenden sind die Commerce Funktionen aufgeführt, auf die Sie über die Commerce Services Connector zugreifen können:
Architektur
Im Großen und Ganzen besteht die Commerce Services Connector aus den folgenden Kernelementen:
In den folgenden Abschnitten werden diese Elemente ausführlicher behandelt.
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 Services wie Produkt-Recommendations oder Live Search generieren, solange das Konto gut aufgestellt ist.
Die Schlüssel können auf einer „Need-to-know“-Basis mit dem Systemintegrator oder dem Entwicklungsteam geteilt werden, das Projekte und Umgebungen im Namen des Lizenzinhabers verwaltet. Entwickler, denen vom Lizenzinhaber Shared Access erteilt wurde, 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 die API-Schlüssel generieren.
Erzeugen der Produktions- und Sandbox-API-Schlüssel genapikey
-
Melden Sie sich bei Ihrem Commerce Konto unter https://account.magento.com an.
-
Wählen Sie auf der Registerkarte {}Magento in der Seitenleiste API-Portal“ aus.
-
Wählen Sie im Umgebung die Option Produktion oder Sandbox.
note note NOTE Produktion und Sandbox beziehen sich auf die Datenspeicherumgebungen, in denen Daten in Adobe SaaS-Backend-Systemen gespeichert werden. Es bezieht sich nicht auf Commerce-Umgebung(en), in der Sie die Schlüssel verwenden werden. -
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.
note warning WARNING Dieses Dialogfeld bietet die einzige Möglichkeit, dass Sie Ihre Schlüssel kopieren oder herunterladen müssen. -
Klicken Sie Herunterladen und anschließend auf Abbrechen.
-
Wiederholen Sie die obigen Schritte für jede Umgebung (Produktion und Sandbox).
Im Abschnitt API-Schlüssel werden nun Ihre API-Schlüssel (öffentliche Schlüssel) angezeigt. Sie benötigen alle vier Schlüssel (Produktions- und Sandbox-Schlüssel, öffentlich+privat), wenn Sie ein SaaS-Projekt auswählen oder erstellen in einer der Umgebungen oder Installationen ausführen, die mit der Lizenz verbunden sind.
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 können. Ein SaaS-Projekt gruppiert alle SaaS-Datenräume. Die SaaS-Datenräume dienen zur Erfassung und Speicherung von Daten, die Commerce Services eine reibungslose Arbeit ermöglichen. Einige dieser Daten werden möglicherweise aus der Commerce-Instanz exportiert und einige werden aus dem Käuferverhalten in der Storefront erfasst. Diese Daten werden dann im sicheren Cloud-Speicher aufbewahrt.
Product Recommendations enthält der SaaS-Datenbereich Katalog- und Verhaltensdaten. Sie können eine Commerce-Instanz auf einen SaaS-Datenbereich verweisen, indem sieder Commerce-Konfiguration auswählen.
In diesem Fall können Sie eine Support-Anfrage senden um eine Datenbereinigung anzufordern.
SaaS-Datenspeicherbereitstellung
Alle Adobe Commerce-Händler können pro SaaS-Projekt auf einen Produktionsdatenbereich und zwei Testdatenbereiche zugreifen.
Sie können die Testdatenräume in jeder Nicht-Produktionsumgebung verwenden, solange Sie nicht denselben Datenraum in mehreren Umgebungen gleichzeitig verwenden. Um den Testdatenspeicher in einer anderen Umgebung zu verwenden, führen Sie eine Datenbereinigung durch, bevor Sie den Datenspeicher in dieser Umgebung auswählen und konfigurieren.
Bei Adobe Commerce Cloud Pro-Projekten mit mehreren Staging-Umgebungen können Sie zusätzliche Testdatenbereiche für jede Staging-Umgebung anfordern, indem Sie eine Support-Anfrage senden. Wenn Sie jedoch nur über eine Staging-Umgebung verfügen und zusätzliche Testdatenbereiche benötigen, haben Sie die folgenden Optionen:
- Wenden Sie sich an das Customer Success-Team oder Ihren Customer Success Manager, um eine zusätzliche Staging-Umgebung anzufordern.
- Senden einer Support-Anfrage , um den zusätzlichen Testdatenbereich anzufordern und die geschäftliche Begründung für den zusätzlichen Datenbereich anzugeben. Diese Anfrage muss genehmigt werden.
Magento Open Source-Kunden, die Adobe Payment Services verwenden, können auch einen zusätzlichen Datenspeicher anfordern. Wenden Sie sich an das Zahlungs-Team, um die zusätzlichen Datenräume zu genehmigen, bevor Sie eine Support-Anfrage einreichen, um den Testdatenraum anzufordern.
SaaS-Projekt auswählen oder erstellen createsaasenv
Um ein SaaS-Projekt auszuwählen oder zu erstellen, fordern Sie den Commerce API-Schlüssel vom Commerce Lizenzinhaber für Ihren Store an:
-
Navigieren Sie in der Admin-Seitenleiste zu System > Services > Commerce Services Connector.
Wenn der Abschnitt Commerce Services Connector in der Commerce nicht angezeigt wird, installieren Sie die Commerce für Ihren gewünschten Commerce Dienst. Vergewissern Sie sich außerdem, dass das
magento/module-services-id-Paket installiert ist. -
Fügen Sie in den Abschnitten Sandbox API Keys und Production API Keys Ihre Schlüsselwerte ein.
- Private Schlüssel müssen
----BEGIN PRIVATE KEY---am Anfang des Schlüssels und----END PRIVATE KEY----am Ende des Schlüssels enthalten. - Wenn Sie keine Kopie der tatsächlichen Schlüssel haben, fragen Sie den Kontoinhaber nach diesen Schlüsseln und schließen Sie die Werte an die Konfiguration an.
note warning WARNING Wenn Sie Schlüsselwerte hinzufügen, indem Sie eine Datenbanksicherung oder einen Schnappschuss abfragen und die Werte in die Konfiguration einfügen, wird eine zusätzliche Verschlüsselungsschicht angewendet und die Schlüssel funktionieren nicht. - Private Schlüssel müssen
-
Klicken Sie Speichern.
Alle SaaS-Projekte, die mit Ihren Schlüsseln verknüpft sind, werden im Feld Projekt im Abschnitt SaaS-Kennung angezeigt.
- 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.
- Wählen Sie Datenspeicher aus, der für die aktuelle Konfiguration Ihres Commerce verwendet werden soll.
Um die Namen Ihres SaaS-Projekts oder Datenraums zu ändern, klicken Sie neben einem auf Umbenennen. Das Ändern des Namens wirkt sich nicht auf Ihren Service aus, da der Name nur eine Bezeichnung ist, die Ihnen dabei hilft, Projekte und Datenräume zu identifizieren und zwischen ihnen zu unterscheiden.
IMS-Organisation (optional) organizationid
Um Ihre Adobe Commerce-Instanz mit der Adobe Experience Platform zu verbinden, melden Sie sich mit Ihrer Adobe ID bei Ihrem Adobe-Konto an. Nach der Anmeldung wird in diesem Abschnitt die IMS-Organisation angezeigt, die Ihrem Adobe-Konto zugeordnet ist.
SaaS-Datenexport
Wenn Ihre Commerce-Instanz erfolgreich eine Verbindung mit 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-Bereich können Sie den Synchronisierungsstatus mithilfe des Daten-Management-Dashboards“. Weitere Informationen finden Sie im SaaS-Datenexporthandbuch.