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:

Service
Verfügbarkeit
Product Recommendations mit Adobe Sensei
Adobe Commerce
Live Search mit 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

Im Großen und Ganzen besteht die Commerce Services Connector aus den folgenden Kernelementen:

Connector-Architektur für Commerce Services

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.

NOTE
Die Schlüsselkennungen Produktion und Sandbox beziehen sich nicht auf Ihre Umgebung. Sie verwenden dieselben API-Schlüssel für jede Ihrer Umgebungen, z. B. lokale, Entwicklungs-, Staging- oder Produktionsumgebungen.
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

  1. Melden Sie sich bei Ihrem Commerce Konto unter https://account.magento.com an.

  2. Wählen Sie auf der Registerkarte {}Magento in der Seitenleiste API-Portal“ aus.

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

  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, dass Sie Ihre Schlüssel kopieren oder herunterladen müssen.
  5. Klicken Sie Herunterladen und anschließend auf Abbrechen.

  6. 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/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.

WARNING
Verwenden Sie Ihren Produktions-SaaS Datenspeicher nur in Ihrer Produktions- Commerce -Installation, um Datenkollisionen zu vermeiden. Andernfalls riskieren Sie, die Daten Ihrer Produktions-Website mit Testdaten zu belasten, was zu Bereitstellungsverzögerungen führt. Beispielsweise könnten Ihre Produktionsproduktdaten versehentlich aus Staging-Daten wie Staging-URLs überschrieben werden.
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. Es fallen zusätzliche Kosten an.
  • Senden einer Support-Anfrage für einen zusätzlichen Testdatenbereich und geben Sie die geschäftliche Begründung für den zusätzlichen Datenbereich an. Diese Anfrage muss genehmigt werden.

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:

NOTE
Wenn der Abschnitt Commerce Services Connector in der Commerce nicht angezeigt wird, müssen Sie die Commerce für Ihren gewünschten Commerce Dienst installieren.
  1. 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.

  2. 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.
  3. Klicken Sie 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.
NOTE
Um Verwirrung zu vermeiden, verwenden Sie keinen bestimmten Commerce-Service als Namen für Ihr Projekt, z. B. Live Search, Product Recommendations oder Data Connection. Sofern Ihre Lizenz nicht für mehrere SaaS-Projekte bereitgestellt wurde, können Sie dasselbe SaaS-Projekt für mehrere Services verwenden.
  1. Wählen Sie Datenspeicher aus, der für die aktuelle Konfiguration Ihres Commerce verwendet werden soll.
NOTE
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 das SaaS-Projekt vom Support erstellt wurde, 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 Datenspeicher aus.
WARNING
Wenn Sie im Abschnitt „API-Portal“ von Mein Konto neue Schlüssel generieren, aktualisieren Sie die API-Schlüssel in der Admin-Konfiguration sofort. Wenn Sie neue Schlüssel generieren und im Admin nicht aktualisieren, funktionieren Ihre SaaS-Erweiterungen nicht mehr und Sie verlieren wertvolle Daten.

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.

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