DokumentationCommerceIntegreringshandbok för Adobe Commerce Optimizer Connector

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

Kom igång

Last update: Tue Mar 03 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Användare

Installera och konfigurera 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.

Krav för att använda integreringen

  • Adobe Commerce 2.4.7+

    • PHP 8.2, 8.3 eller 8.4
    • Disposition 2.x

  • Adobe Commerce Optimizer-licens med en tilldelad sandlådeinstans.

  • Åtkomst till repo.magento.com för att hämta Commerce Connector-metapaketet med Composer.

  • Administratörsåtkomst till en Adobe Commerce Optimizer-sandlådeinstans.

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

recommendation-more-help

Förutsättningar

Om du har något av följande tillägg installerat avinstallerar du dem innan du installerar 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.

style
shade-box

Konfigurationssteg

  1. Konfigurera integreringen

    1. Installera Commerce Optimizer Connector-paketet med Composer för att ansluta din Commerce-instans till Adobe Commerce Optimizer.

    2. Granska och anpassa dataexportkonfigurationen från administratören.

    3. Hämta API-autentiseringsuppgifter som krävs för att upprätta anslutningen mellan Commerce och Commerce Optimizer.

    4. Aktivera Adobe Commerce Optimizer integreringen.

    5. Verifiera att datasynkroniseringen fungerar.

Installera Commerce Optimizer Connector-paketet

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

Hämta nödvändig anslutningsinformation

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

TIP
Om du redan har ett utvecklarprojekt konfigurerat med API:t för datainmatning i samma IMS-organisation som din Commerce Optimizer-instans kan du återanvända de befintliga autentiseringsuppgifterna för OAuth Server-till-Server.

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

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

Hämta Adobe Commerce Optimizer instansinformation

Spara instans-ID:t (kallas även klient-ID) från din Adobe Commerce Optimizer-instans. Du hittar den i den URL som används för att komma åt instansen. I https://experience.adobe.com/#/@<project-id>/in:TToyu73daQRn66KAYaq8YZ/commerce-optimizer-studio/home är till exempel instans-ID TToyu73daQRn66KAYaq8YZ.

Anpassa dataexportkonfigurationen för Commerce

Som standard är synkronisering av katalogdata aktiverat för alla Commerce-scope (webbplatser 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 men bara vill exportera data för en av dem, kan du inaktivera exporteraren för de andra butiksvyerna.

IMPORTANT
Om du ändrar exportinställningarna utlöses en fullständig omindexering, vilket kan ta lång tid beroende på katalogstorleken. Planera dessa ändringar under lågtrafikperioder för att minimera prestandapåverkan.

Dataexport efter omfång

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

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

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.

Uppdatera exportkonfigurationen

När du har installerat Connector-paketet visas exportkonfigurationsinställningarna för Commerce Optimizer i Store-stödrastret i Admin.

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 integreringen av Adobe Commerce Optimizer

IMPORTANT
Datasynkroniseringsbearbetningen startar så snart du kör konfigurationskommandot. Som standard är synkronisering av katalogdata aktiverat för alla Commerce-scope (webbplatser och butiksvyer). Beroende på storleken på katalogen kan datasynkroniseringsprocessen ta från några minuter till flera timmar.

Med API-autentiseringsuppgifterna och instansinformationen som du samlade in i föregående steg kan du nu konfigurera integreringen mellan dina Commerce- och Adobe Commerce Optimizer-instanser.

  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

När du har aktiverat integreringen startar datasynkroniseringen automatiskt. Beroende på katalogstorleken kan den inledande synkroniseringen ta från några minuter till flera timmar.

  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 Adobe Commerce Optimizer på menyn Data Sync.

    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 Adobe Commerce Optimizer-handboken. Observera att prisböcker skapas automatiskt av Adobe Commerce kundgrupper.

  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.

20bc9938-bbc9-401f-a797-a495f2048cc7