Commerce Services Connector

Vissa Adobe Commerce- och Magento Open Source-funktioner drivs av Commerce Services och distribueras som SaaS (programvara som tjänst). Om du vill använda de här tjänsterna måste du ansluta Commerce-instansen med API-nycklar för produktion och sandlåda och ange datautrymmet i konfigurationen. Du behöver bara konfigurera anslutningen en gång för varje instans.

Tillgängliga tjänster availableservices

I följande lista visas de Commerce-funktioner som du kan komma åt via Commerce Services Connector:

Tjänst
Tillgänglighet
Product Recommendations med Adobe Sensei
Adobe Commerce
Live Search med Adobe Sensei
Adobe Commerce
Payment Services
Adobe Commerce och Magento Open Source
Site-Wide Analysis Tool
Adobe Commerce
Catalog Service
Adobe Commerce
Data Connection
Adobe Commerce

Arkitektur

På en hög nivå består Commerce Services Connector av följande kärnelement:

Commerce Services Connector Architecture

I följande avsnitt beskrivs dessa element mer ingående.

Referenser apikey

Produktions- och sandbox-API-nycklarna genereras från Commerce-kontot för licensägaren. Commerce-kontot identifieras av ett unikt Commerce-ID (MageID). Licensägaren för handlarens organisation kan generera API-nycklar för tjänster som Recommendations eller Live Search så länge som kontot är i gott skick.

Nycklarna kan delas på behovsbasis med systemintegratören eller utvecklingsteamet som hanterar projekt och miljöer för licenshavarens räkning. Utvecklare som har beviljats Shared Access av licensägaren kan inte generera nycklarna för deras räkning, även om handlarens organisation finns i listrutan Switch Accounts för deras konto.

Dessutom är lösningsintegratörer även berättigade att använda Commerce Services. Om du är en lösningsintegratör bör signeraren av partnerkontraktet Commerce generera API-nycklarna.

NOTE
Nyckelidentifierarna Production och Sandbox refererar inte till din miljö. Du använder samma uppsättning API-nycklar för var och en av dina miljöer, till exempel lokala miljöer, utvecklings-, mellanlagrings- eller produktionsmiljöer.
Licensägaren är vanligtvis den primära kontakten på Adobe Commerce-kontot och är inte alltid densamma som Adobe Commerce projektägare i molninfrastrukturprojektet.

Generera API-nycklar för produktion och sandlåda genapikey

  1. Logga in på ditt Commerce-konto på https://account.magento.com.

  2. Under fliken Magento väljer du API-portal i sidofältet.

  3. Välj Produktion eller Sandbox på menyn Miljö.

  4. Ange ett namn i avsnittet API-nycklar och klicka på Lägg till ny för att öppna dialogrutan för att hämta den nya nyckeln.

    Hämta privat nyckel

    note warning
    WARNING
    Den här dialogrutan är den enda möjligheten att kopiera eller hämta dina nycklar.
  5. Klicka på Hämta och sedan på Avbryt.

  6. Upprepa stegen ovan för varje miljö (produktion och sandlåda).

    Avsnittet API-nycklar visar nu dina API-nycklar (offentliga). Du behöver alla fyra nycklarna (både produktions- och sandlådenycklar, Public+Private) när du väljer eller skapar ett SaaS-projekt i någon av de miljöer/installationer som är associerade med licensen.

SaaS-konfiguration saasenv

Commerce instanser måste konfigureras med ett SaaS-projekt och ett SaaS-datautrymme så att Commerce Services kan skicka data till rätt plats. Ett SaaS-projekt grupperar alla SaaS-datautrymmen. SaaS-datamallarna används för att samla in och lagra data som gör att Commerce Services kan arbeta. Vissa av dessa data kan exporteras från instansen Commerce och vissa kan samlas in från shoppingbeteendet i butiken. Dessa data lagras sedan för att skydda molnlagringen.

För Product Recommendations innehåller SaaS-datautrymmet katalog- och beteendedata. Du kan peka en Commerce-instans mot ett SaaS-datautrymme genom att markera den i Commerce-konfigurationen.

WARNING
Använd SaaS-datautrymmet för produktion endast i din Commerce-produktionsinstallation för att undvika datakollisioner. Annars riskerar du att förorena data från produktionsplatsen med testdata, vilket orsakar förseningar i driftsättningen. Produktionsproduktdata kan till exempel skrivas över av misstag från mellanlagringsdata, som mellanlagrings-URL:er.
Om detta skulle inträffa skickaren supportförfrågan för att begära datarensning.

Etablering av SaaS-datautrymme

Alla Adobe Commerce-handlare har tillgång till ett produktionsdatautrymme och två testdatamallar per SaaS-projekt.

Du kan använda testdatautrymmen i alla icke-produktionsmiljöer så länge du inte använder samma datautrymme i flera miljöer samtidigt. Om du vill använda testdataområdet i en annan miljö utför du en rensning av data innan du markerar och konfigurerar dataområdet i den miljön.

För Adobe Commerce Cloud Pro-projekt med flera mellanlagringsmiljöer kan du begära ytterligare testdatamallar för varje mellanlagringsmiljö genom att skicka en supportförfrågan. Om du bara har en mellanlagringsmiljö och behöver ytterligare testdatamallar har du följande alternativ:

  • Kontakta Customer Success-teamet eller en utsedd Customer Success Manager för att begära en extra mellanlagringsmiljö. Det handlar om en extra kostnad.
  • Skicka en supportförfrågan om ytterligare ett testdatautrymme och ange affärsjustering för det extra datautseendet. Denna begäran måste godkännas.

Välja eller skapa ett SaaS-projekt createsaasenv

Om du vill välja eller skapa ett SaaS-projekt begär du API-nyckeln Commerce från Commerce-licensägaren för din butik:

NOTE
Om du inte ser avsnittet Commerce Services Connector i konfigurationen Commerce måste du installera modulerna Commerce för den Commerce tjänst du vill använda.
  1. Gå till System > Tjänster > Commerce Services Connector på sidofältet Admin.

    Om du inte ser avsnittet Commerce Services Connector i Commerce-konfigurationen installerar du Commerce-modulerna för den Commerce tjänst du vill använda. Kontrollera även att paketet magento/module-services-id är installerat.

  2. Klistra in dina nyckelvärden i avsnitten Sandbox API Keys ​och​ Production API Keys.

    • Privata nycklar måste innehålla ----BEGIN PRIVATE KEY--- i början av nyckeln och ----END PRIVATE KEY---- i slutet av nyckeln.
    • Om du inte har någon kopia av de faktiska nycklarna ber du kontoägaren om dem och kopplar sedan värdena till konfigurationen.
    note warning
    WARNING
    Om du lägger till nyckelvärden genom att fråga en säkerhetskopia eller ögonblicksbild av en databas och klistra in värdena i konfigurationen, tillämpas ytterligare ett krypteringslager och nycklarna fungerar inte.
  3. Klicka på Spara.

Alla SaaS-projekt som är associerade med dina nycklar visas i fältet Projekt i avsnittet SaaS-identifierare .

  1. Om det inte finns några SaaS-projekt klickar du på Skapa projekt. Ange sedan ett namn för SaaS-projektet i fältet Projekt .
NOTE
För att undvika missförstånd ska du inte använda en specifik Commerce-tjänst som namn för ditt projekt, till exempel Live Search, Product Recommendations eller Data Connection. Om din licens inte har etablerats för flera SaaS-projekt kan du använda samma SaaS-projekt för flera tjänster.
  1. Välj det datautrymme som ska användas för den aktuella konfigurationen av Commerce-arkivet.
NOTE
Om du har olika instanser att integrera med Commerce Services skickar du en supportanmälan för att begära ett nytt SaaS-projekt för varje ytterligare instans. När stödet har skapat SaaS-projektet konfigurerar du integreringen av Commerce Services för instansen med samma API-nyckel och väljer det nya SaaS-projektet för datamängden.
WARNING
Om du genererar nya nycklar i API-portalavsnittet för Mitt konto ska du omedelbart uppdatera API-nycklarna i Admin-konfigurationen. Om du genererar nya nycklar och inte uppdaterar dem i Admin, fungerar inte längre dina SaaS-tillägg och du förlorar värdefulla data.

Om du vill ändra namn på ditt SaaS-projekt eller din datautrymme klickar du på Byt namn bredvid ett av dem. Om du ändrar namnet påverkas inte tjänsten eftersom namnet bara är en etikett som hjälper dig att identifiera och skilja mellan projekt och datautrymme.

IMS-organisation (valfritt) organizationid

Om du vill ansluta din Adobe Commerce-instans till Adobe Experience Platform loggar du in på ditt Adobe-konto med din Adobe ID. När du har loggat in visas den IMS-organisation som är kopplad till ditt Adobe-konto i det här avsnittet.

SaaS-dataexport

När din Commerce-instans har anslutit till Commerce Services exporterar SaaS-dataexportprocessen Commerce-data från din Commerce-server till Commerce SaaS Services så att den kan synkroniseras med anslutna Commerce-tjänster. I Admin kan du kontrollera synkroniseringsstatus med kontrollpanelen för datahantering. Mer information finns i Exportguiden för SaaS-data.

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