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 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:
Architektur
Auf hoher Ebene besteht der Commerce Services Connector aus den folgenden Kernelementen:
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.
Generieren 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 die Option API-Portal aus.
-
Wählen Sie im Menü Umgebung die Option Produktion oder Sandbox aus.
-
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, die Sie benötigen, um Ihre Schlüssel zu kopieren oder herunterzuladen. -
Klicken Sie auf Herunterladen und dann auf Abbrechen.
-
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 alle vier Schlüssel (sowohl die Produktions- als auch die Sandbox-Schlüssel, Öffentlich+Privat), wenn Sie ein SaaS-Projekt auswählen oder erstellen in einer der mit der Lizenz verknüpften Umgebungen/Installationen.
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.
Sollte dies der Fall sein, senden eine Support-Anfrage, um eine Datenbereinigung anzufordern.
SaaS-Datenspeicherbereitstellung
Alle Adobe Commerce-Händler können pro SaaS-Projekt auf einen Produktionsdatenraum und zwei Testdatenbereiche zugreifen.
Sie können die Testdatenräume in jeder Nicht-Produktionsumgebung verwenden, sofern Sie nicht denselben Datenraum in mehreren Umgebungen gleichzeitig verwenden. Um den Testdatenraum in einer anderen Umgebung zu verwenden, führen Sie eine Datenbereinigung durch, bevor Sie den Datenraum 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 eine Staging-Umgebung haben und zusätzliche Testdatenräume benötigen, haben Sie die folgenden Optionen:
- Wenden Sie sich an das Customer Success-Team oder Ihren benannten Customer Success Manager, um eine zusätzliche Staging-Umgebung anzufordern. Es entstehen zusätzliche Kosten.
- Senden Sie eine Support-Anfrage für einen zusätzlichen Testdatenraum und geben Sie die geschäftliche Begründung für den zusätzlichen Datenbereich an. Diese Anfrage muss genehmigt 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:
-
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-idinstalliert 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 und schließen Sie die Werte in die Konfiguration ein.
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 auf 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 den Datenraum aus, der für die aktuelle Konfiguration Ihres Commerce-Stores verwendet werden soll.
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.