Commerce Services Connector
Einige Funktionen von Adobe Commerce und Magento Open Source 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.
Nur der Commerce Lizenzinhaber kann diese API-Schlüssel generieren. Wenn Sie nicht der Lizenzinhaber sind, fordern Sie die Schlüssel von der Person oder dem Team an, der bzw. dem die Commerce-Lizenz für Ihren Store gehört.
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 Produktempfehlungen 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 im Namen des Lizenzinhabers 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 berechtigt, Commerce Services zu verwenden. Wenn Sie Lösungsintegrator sind, sollte der Unterzeichner des Commerce die API-Schlüssel generieren.
Die Schlüsselkennungen Produktion und Sandbox beziehen sich auf SaaS-Datenspeicherumgebungen, in denen Commerce Services Daten speichern (nicht auf Ihre Adobe Commerce-Umgebungen). Sie können denselben Satz von API-Schlüsseln in Ihren lokalen, Entwicklungs-, Staging- und Produktions-Adobe Commerce-Umgebungen verwenden. Entscheidend ist, das richtige Schlüsselpaar für den von Ihnen konfigurierten Datenbereich einzufügen.
Der Lizenzinhaber ist in der Regel der Primäre Ansprechpartner im Adobe Commerce-Konto und nicht immer derselbe wie der Projektbesitzer des Adobe Commerce on Cloud Infrastructure-Projekts.
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 die Option „API-Portal“ aus.
-
Wählen Sie im Umgebung die Option Produktion oder Sandbox.
-
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 Sie können den privaten Schlüssel nur einmal kopieren oder herunterladen. Bewahren Sie sie sicher auf. -
Klicken Sie Herunterladen, um den privaten Schlüssel zu speichern, und schließen Sie dann das Dialogfeld.
-
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.
Für Product Recommendations und Live Search enthält der SaaS-Datenraum Katalog- und Verhaltensdaten. Sie können eine Commerce-Instanz auf einen SaaS-Datenbereich verweisen, indem sie der Commerce-Konfiguration auswählen.
Wenn Sie Live Search-Konfigurationsfelder im Admin-Bereich nicht finden können, überprüfen Sie, ob Sie das richtige API-Schlüsselpaar für den ausgewählten Datenbereich eingegeben haben (Produktionsdatenbereiche verwenden Produktionsschlüssel; Testdatenbereiche verwenden Sandbox-Schlüssel). Wenn Sie falsche Schlüssel konfigurieren, sind SaaS-Services wie die Live-Suche in dieser Adobe Commerce-Umgebung nicht verfügbar.
API-Schlüssel löschen delapikey
Generieren und speichern Sie einen Ersatzschlüssel sicher, bevor Sie einen API-Schlüssel löschen. Aktualisieren Sie alle Integrationen, um den neuen Schlüssel zu verwenden, und bestätigen Sie, dass die abhängigen Services erwartungsgemäß funktionieren.
Wenn Live Search Konfigurationsfelder im Admin Panel nicht angezeigt werden, überprüfen Sie, ob Sie den richtigen SaaS-API-Schlüssel für diese Umgebung eingegeben haben. Verwenden Sie den Produktions-SaaS-Schlüssel für den Produktionsdatenspeicher und den Staging-Schlüssel für den Staging-Datenspeicher. Wenn der falsche Schlüssel konfiguriert ist, sind SaaS-Services (einschließlich Live Search) in Ihrer Adobe Commerce-Umgebung nicht verfügbar.
Klicken Sie auf dem zu entfernenden API-Schlüssel auf Delete. Bestätigen Sie bei Aufforderung den Vorgang, um den Schlüssel dauerhaft zu entfernen.
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 Nicht-Produktionsumgebungen verwenden, vermeiden jedoch, denselben Datenraum in mehreren Umgebungen gleichzeitig zu verwenden. Wenn Sie einen Testdatenbereich in eine andere Umgebung verschieben möchten, führen Sie eine Datenbereinigung durch, bevor Sie ihn in der neuen 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.
Kunden, die mehrere Cloud-Projekte oder lokale (Live-/Produktions-)Installationen besitzen, können auch zusätzliche Produktions- und Testdatenbereiche für jedes Projekt oder jede Instanz anfordern, indem sie eine Support-Anfrage stellen.
SaaS-Projekt auswählen oder erstellen createsaasenv
Um ein SaaS-Projekt auszuwählen oder zu erstellen, fordern Sie die 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 nicht angezeigt wird, installieren Sie die Commerce für Ihren gewünschten Commerce Dienst und stellen Sie sicher, dass das
magento/module-services-idinstalliert ist. -
Fügen Sie in den Abschnitten Sandbox API KeysundProduction 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 Lizenzinhaber nach diesen Schlüsseln und schließen Sie die Werte an die Konfiguration an.
Fügen Sie keine Schlüsselwerte ein, die aus einer Datenbanksicherung oder einem Schnappschuss kopiert wurden. Wenn die Konfiguration gespeichert wird, 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.
Um Verwirrung zu vermeiden, verwenden Sie keinen bestimmten Commerce-Service als Namen für Ihr Projekt (z. B. Live Search, Product Recommendations oder Datenverbindung). Sofern Ihre Lizenz nicht für mehrere SaaS-Projekte bereitgestellt wurde, können Sie dasselbe SaaS-Projekt für mehrere Services verwenden.
-
Wählen Sie Datenspeicher aus, der für die aktuelle Konfiguration Ihres Commerce verwendet werden soll.
Wenn Sie über separate Instanzen verfügen, die in Commerce Services integriert werden können, Sie ein Support-Ticket , um für jede weitere Instanz ein neues SaaS-Projekt anzufordern. Nachdem der Support das SaaS-Projekt erstellt hat, konfigurieren Sie die Integration für die Instanz mit denselben API-Schlüsseln und wählen Sie das neue SaaS-Projekt für den Datenspeicher aus.
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.