[Endast PaaS]{class="badge informative" title="Gäller endast Adobe Commerce i molnprojekt (Adobe-hanterad PaaS-infrastruktur) och lokala projekt."}

Kom igång

Installera och konfigurera Adobe Commerce Optimizer Connector för att synkronisera dina Adobe Commerce-katalogdata med Adobe Commerce Optimizer och övervaka sedan datasynkroniseringsstatusen för att se till att din butik är uppdaterad.

IMPORTANT
Anslut alltid sandlådeoptimeringsinstanser till icke-produktionsmiljöer och produktionsinstanser till produktionsmiljöer. Omatchade miljöer orsakar inkonsekventa katalogdata, sökresultat och rekommendationer.

Krav för att använda integreringen

Adobe Commerce-användaren som konfigurerar integreringen måste ha:

Förutsättningar

Om du har något av följande tillägg installerat avinstallerar du dem innan du installerar Adobe Commerce Optimizer Connector:

  • Adobe Commerce Live Search (magento/live-search)
  • Adobe Commerce produktrekommendationer (magento/product-recommendations)
  • Adobe Commerce Catalog Service (magento/catalog-service, magento/catalog-service-installer)
  • Instrumentpanel för datahantering (magento-catalog-sync-admin)

Data som är kopplade till dessa tillägg är fortfarande tillgängliga i Commerce-databasen. Den exporteras dock inte till Adobe Commerce Optimizer när anslutningen är aktiverad. Om du vill implementera de sök- och säljfunktioner som ingår i dessa tillägg efter att du har aktiverat Connector konfigurerar du dem från Adobe Commerce Optimizer administratörsgränssnittet.

IMPORTANT
Om dessa tillägg inte tas bort innan du aktiverar anslutningsprogrammet kan du se skadade konfigurationsskärmar, duplicerade data i Adobe Commerce Optimizer eftersom samma data exporteras både från anslutningsprogrammet och befintliga tillägg och 401- eller 403-fel i loggarna på grund av konflikter i hur tilläggen och anslutningsprogrammet autentiseras med de anslutna tjänsterna.

Konfigurationssteg

Följ de här stegen för att aktivera kopplingen och börja synkronisera data från Commerce till din Adobe Commerce Optimizer-instans.

Installera Adobe Commerce Optimizer Connector-paketet install-the-adobe-commerce-optimizer-connector-package

Adobe Commerce Optimizer Connector levereras som ett Composer-metapaket tillgängligt för alla Commerce-handlare med en aktiv licens för Adobe Commerce Optimizer.

Installationssteg

  1. Lägg till modulen adobe-commerce/commerce-data-export-aco-adapter med Composer:

    code language-shell
    composer require adobe-commerce/commerce-data-export-aco-adapter
    
  2. Distribuera ändringarna i Adobe Commerce staging-miljö.

När distributionen är klar är Commerce Optimizer-alternativet tillgängligt på Commerce Admin-menyn. Klicka på Commerce Optimizer för att öppna din Commerce Optimizer-instans direkt från Commerce Admin.

NOTE
Detaljerade installationsanvisningar för tillägg finns i följande handböcker:
Installera tillägg på Adobe Commerce i molninfrastrukturen
Installera tillägg på Adobe Commerce lokalt

Anpassa exportkonfigurationen för Commerce scopes

Som standard är synkronisering av katalogdata aktiverat för alla Commerce-scope (webbplatser, kundgrupper och butiksvyer). Du kan anpassa exportinställningarna för att synkronisera data endast för specifika omfattningar baserat på ditt företags behov. Om du till exempel har flera butiksvyer som delar samma språk kan du välja att exportera data för endast en av butiksvyerna och använda den som katalogkälla för flera katalogvyer i Adobe Commerce Optimizer.

IMPORTANT
Om du ändrar exportinställningarna utlöses en fullständig omindexering, vilket kan ta lång tid beroende på katalogstorleken. Adobe rekommenderar att du konfigurerar Commerce-scope så att de synkroniseras med Commerce Optimizer innan du aktiverar integreringen och startar den första datasynkroniseringen.

I följande tabell beskrivs vilka data som exporteras på varje omfångsnivå:

Omfång
Exporterade data
Anteckningar
Webbplats och kundgrupp
Priser och prislistor
Varje prisuppsättning exporteras som en prisbok med namnkonventionen <website>::<SHA1 of customer group ID>. Alla kundgrupper för webbplatsen ingår.
Butiksvy
Produkter och produktattribut
I varje butiksvy skapas en separat katalogkälla i Adobe Commerce Optimizer.

Lagra stödraster med synkroniseringsinställningar för Commerce Optimizer {width="600" modal="regular"}

Så här ändrar du inställningarna för en webbplats- eller butiksvy:

  1. Gå till Stores > Settings > All Stores i Commerce Admin.

  2. Välj webbplatsen eller butiksvyn som du vill konfigurera.

  3. I Adobe Commerce Optimizer-exportinställningarna använder du kryssrutan för att aktivera eller inaktivera datasynkronisering efter behov.

    Uppdatera datasynkroniseringskonfiguration {width="500" modal="regular"}

  4. Spara ändringarna.

Aktivera och inaktivera beteende

Åtgärd
Resultat
Inaktivera en butiksvy
Katalogkällan finns kvar i Adobe Commerce Optimizer, men alla data tas bort.
Inaktivera och återaktivera sedan en butiksvy
Samma katalogkälla fylls i igen med en fullständig omsynkronisering av data.

Aktivera integreringen av Adobe Commerce Optimizer

IMPORTANT
Datasynkroniseringsbearbetningen startar i bakgrunden så snart du har slutfört konfigurationen. Beroende på storleken på katalogen kan datasynkroniseringsprocessen ta från några minuter till flera timmar.

Hämta nödvändig anslutningsinformation

Från Adobe Developer Console skapar du ett nytt projekt som är aktiverat för Adobe Commerce Optimizer Ingesändningstjänsten och genererar autentiseringsuppgifter för OAuth Server-till-Server. Detaljerade instruktioner finns i Hämta IMS-autentiseringsuppgifter i Handboken för marknadsföringsutvecklare.

Spara följande värden från inloggningssidan:

  • Organisations-ID (org_id)
  • Klient-ID (client_id)
  • Klienthemlighet (client_secret)

Hämta autentiseringsuppgifter {width="500" modal="regular"}

Hämta Adobe Commerce Optimizer instansinformation

Hämta klientorganisations-ID från fältet Instance Id​på sidan Adobe Commerce Optimizer instance Instance details page eller från den URL som användes för att komma åt instansen. Till exempel i https://experience.adobe.com/#/@<your organization>/in:<tenant ID>/commerce-optimizer-studio/home.

  1. I Commerce Admin väljer du Adobe Commerce Optimizer för att visa konfigurationssidan med instruktioner.

    Adobe Commerce Optimizer konfigurationssida ​ {width="500" modal="regular"}

  2. Från kommandoraden använder du SSH för att ansluta till Commerce mellanlagringsmiljö.

  3. Kör följande Commerce CLI-kommando för att konfigurera integreringen och ersätt platshållarvärdena med värdena för ditt Commerce Optimizer-projekt:

bin/magento aco:config:init --org_id=your-org --tenant_id=your-tenant --client_id=your-client-id --client_secret=your-secret
  1. Kontrollera anslutningen genom att gå tillbaka till Commerce Admin och välja alternativet Adobe Commerce Optimizer.

    När du klickar på alternativet öppnas användargränssnittet för Adobe Commerce Optimizer på en ny flik.

Verifiera att datasynkroniseringen fungerar

Du kan övervaka och verifiera att synkroniseringen fungerar från sidan Synkroniseringsstatus för datafeed som är tillgänglig i Admin.

  1. Kontrollera synkroniseringsstatus i Commerce Admin:

    Gå till System > Data Transfer > Data Feed Sync Status.

    Statussida för synkronisering av dataflöden med statusrapportering för feed-objekt {width="500" modal="regular"}

    När synkroniseringen körs visas poster som skickats. Välj en feed om du vill visa information eller felsöka synkroniseringsproblem.

  2. Bekräfta data som har tagits emot i Commerce Optimizer:

    Välj Data Sync på menyn Adobe Commerce Optimizer.

    Datasynkronisering {width="500" modal="regular"}

    Kontrollera att förväntade produkter, priser och attribut visas.

TIP
Om du har problem med datasynkroniseringen kan du läsa avsnittet Felsökning i dokumentationen för SaaS-dataexport .

Nästa steg

  1. Konfigurera Adobe Commerce Optimizer katalogvyer och principer

    Skapa katalogvyer och principer i användargränssnittet för Adobe Commerce Optimizer. Observera att prisböcker skapas automatiskt av Adobe Commerce kundgrupper. Instruktioner finns i dokumentationen för katalogvyer och profiler i Commerce Optimizer användarhandbok.

  2. Konfigurera en Commerce Storefront på Edge Delivery Services

    Följ Storefront-installationsdokumentationen för att ansluta din butik till instansen Adobe Commerce Optimizer och börja leverera personaliserade e-handelsupplevelser.

recommendation-more-help
commerce-help-aco-connector