DocumentatieCommerceOptimizer Connector

[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Aan de slag

Laatst bijgewerkt: 1 juni 2026

Gemaakt voor:

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Installeer en configureer de Adobe Commerce Optimizer Connector voor synchronisatie van de Adobe Commerce catalogusgegevens met Adobe Commerce Optimizer en controleer vervolgens de status voor gegevenssynchronisatie om te controleren of de winkel up-to-date is.

IMPORTANT
Sluit sandbox Optimizer-instanties altijd aan op niet-productieomgevingen en productie-instanties. Niet-overeenkomende omgevingen veroorzaken inconsistente catalogusgegevens, zoekresultaten en aanbevelingen.

Vereisten voor het gebruik van de integratie requirements-to-use-the-integration

De Adobe Commerce -gebruiker die de integratie configureert, moet beschikken over:

  • Beheerderstoegang tot de Commerce Admin.

  • {de lijntoegang van 0} Bevel tot de Adobe Commerce toepassingsserver 🔗.

  • De toegang van de ontwikkelaar tot de ​ IMS Organisatie ​ waar het Adobe Commerce Optimizer project provisioned is.

Vereisten

Als u een van de volgende extensies hebt geïnstalleerd, verwijdert u deze voordat u Adobe Commerce Optimizer Connector installeert:

  • Adobe Commerce Live Search (magento/live-search)
  • Adobe Commerce Product Recommendations (magento/product-recommendations)
  • Adobe Commerce Catalog Service (magento/catalog-service, magento/catalog-service-installer)
  • Data Management Dashboard (magento-catalog-sync-admin)

Gegevens die aan deze extensies zijn gekoppeld, zijn nog steeds beschikbaar in de Commerce-database. Het wordt echter niet naar Adobe Commerce Optimizer geëxporteerd wanneer de connector is ingeschakeld. Om het onderzoek en het merchandising mogelijkheden uit te voeren die door deze uitbreidingen na het toelaten van de schakelaar worden verstrekt, vorm hen van Adobe Commerce Optimizer Admin UI ​.

IMPORTANT
Als deze extensies niet worden verwijderd voordat de connector wordt ingeschakeld, ziet u mogelijk gebroken configuratievensters, dubbele gegevens in Adobe Commerce Optimizer omdat dezelfde gegevens worden geëxporteerd uit zowel de connector als de bestaande extensies en 401 of 403 fouten in de logboeken als gevolg van conflicten in de manier waarop de extensies en de connector worden geverifieerd met de verbonden services.
style
shade-box

Configuratiestappen

Voer de volgende stappen uit om Commerce Optimizer Connector in te schakelen en gegevens van Adobe Commerce naar uw Commerce Optimizer -instantie te synchroniseren.

  1. installeer het Commerce Optimizer Connector pakket gebruikend Composer om uw Adobe Commerce instantie aan Adobe Commerce Optimizer te verbinden.

  2. pas de configuratie van de gegevensuitvoer van Admin aan.

  3. laat de Adobe Commerce Optimizer integratie toe.

  4. verifieer dat de gegevenssynchronisatie werkt.

Het pakket Commerce Optimizer Connector installeren install-the-adobe-commerce-optimizer-connector-package

Commerce Optimizer Connector wordt geleverd als een Composer-metapakket dat beschikbaar is voor alle Commerce-handelaren met een actieve licentie voor Adobe Commerce Optimizer .

Installatiestappen

  1. Voeg de module adobe-commerce/commerce-data-export-aco-adapter toe met behulp van Composer:

    code language-shell 
    composer require adobe-commerce/commerce-data-export-aco-adapter

  2. Implementeer de wijzigingen in uw Adobe Commerce -testomgeving.

    Nadat de implementatie is voltooid, is de optie Commerce Optimizer beschikbaar in het menu Commerce Admin. Selecteer Commerce Optimizer om uw Adobe Commerce Optimizer -instantie rechtstreeks te openen via Commerce Admin.

NOTE
Raadpleeg de volgende handleidingen voor gedetailleerde installatie-instructies voor extensies:
​ installeer uitbreiding op Adobe Commerce op de Infrastructuur van de Wolk ​
​ installeer uitbreiding op Adobe Commerce op-gebouw ​

De Commerce-configuratie voor het exporteren van het bereik aanpassen customize-the-commerce-scopes-export-configuration

Synchronisatie van catalogusgegevens wordt standaard ingeschakeld voor alle Commerce-bereiken (websites, klantengroepen en winkelweergaven). U kunt de exportinstellingen aanpassen om alleen gegevens voor specifieke toepassingen te synchroniseren op basis van uw bedrijfsbehoeften. Bijvoorbeeld, als u veelvoudige opslagmeningen hebt die de zelfde taal delen kunt u verkiezen om gegevens voor slechts één van de opslagmeningen uit te voeren en het als ​ catalogusbron ​ voor veelvoudige catalogusmeningen in Adobe Commerce Optimizer te gebruiken.

IMPORTANT
Als u de exportinstellingen wijzigt, wordt de index volledig opnieuw geïndexeerd. Dit kan veel tijd in beslag nemen, afhankelijk van de grootte van de catalogus. Adobe raadt aan het Commerce-bereik zodanig te configureren dat het wordt gesynchroniseerd met Adobe Commerce Optimizer voordat de integratie wordt ingeschakeld en de eerste gegevenssynchronisatie wordt gestart.

In de volgende tabel wordt beschreven welke gegevens op elk bereikniveau worden geëxporteerd:

Bereik
Gegevens geëxporteerd
Notities
Website en klantengroep
Prijzen en prijsboeken
Elke reeks prijzen wordt uitgevoerd als a ​ prijsboek ​ gebruikend de noemende overeenkomst <website>::<SHA1 of customer group ID>. Alle klantengroepen voor de website worden inbegrepen.
Winkelweergave
Producten en productkenmerken
Elke opslagmening leidt tot een afzonderlijke ​ catalogusbron ​ in Adobe Commerce Optimizer.

​ Net van de opslag met de synchronisatiemontages van Commerce Optimizer ​ {width="600" modal="regular"}

om de montages voor een website of opslagmening te veranderen:

  1. Navigeer in Commerce Admin naar Stores > Settings > All Stores .

  2. Selecteer de website- of opslagweergave die u wilt configureren.

  3. In de Adobe Commerce Optimizermontages van de Exporteur, gebruik checkbox om de gegevenssynchronisatie toe te laten of onbruikbaar te maken zoals nodig.

    ​ de configuratie van de de gegevenssynchronisatie van de Update ​ {width="500" modal="regular"}

  4. Sla uw wijzigingen op.

Gedrag in- en uitschakelen

Actie
Resultaat
Een winkelweergave uitschakelen
De catalogusbron blijft in Adobe Commerce Optimizer staan, maar alle gegevens worden verwijderd.
Een winkelweergave uitschakelen en opnieuw inschakelen
Dezelfde catalogusbron wordt opnieuw gevuld met volledige gegevensresynchronisatie.

De integratie met Adobe Commerce Optimizer inschakelen

U schakelt de integratie in en start de gegevenssynchronisatie met de opdracht aco:config:init CLI. Met deze opdracht voert u de volgende stappen uit:

  1. Verkrijgt een IMS toegangstoken gebruikend geloofsbrieven die als argumenten van de bevellijn worden geleverd.
  2. Roept de dienst van de Manager van Commerce Cloud (CCM) bij https://ccm.api.commerce.adobe.com/api/v1/tenants/{tenantId}/owner/{orgId} aan om de huurder te bevestigen en de opname URL en Adobe Commerce Optimizer Studio URL te halen.
  3. Hiermee slaat u alle configuratie (clientgeheim gecodeerd) op in core_config_data .
  4. Plannt de eerste volledige synchronisatie door alle Commerce Optimizer feed-indexen ongeldig te maken.
IMPORTANT
De verwerking van gegevenssynchronisatie wordt op de achtergrond gestart zodra u de configuratie hebt voltooid. Afhankelijk van de grootte van de catalogus kan het synchronisatieproces van de gegevens enkele minuten tot enkele uren duren.

Vereiste verbindingsgegevens ophalen

Van ​ Adobe Developer Console ​, creeer een nieuw project dat voor de Adobe Commerce Optimizer dienst van de Ingestie wordt toegelaten en produceer Server-aan-Server geloofsbrieven OAuth. Voor gedetailleerde instructies, zie ​ de Geloofsbrieven IMS ​ in de Handleiding van de Ontwikkelaar Merchandising verkrijgen.

Sla de volgende waarden op vanaf de pagina met referenties:

  • identiteitskaart van de Organisatie (org_id)
  • identiteitskaart van de Cliënt (client_id)
  • Geheim van de Cliënt (client_secret)

​ verkrijg credentiedetails van de het projectpagina van Adobe Developer Console ​ {width="500" modal="regular"}

Instantiedetails Adobe Commerce Optimizer ophalen

Krijg huurdersidentiteitskaart van het Instance Id​gebied op de Adobe Commerce Optimizer instantie Instance details pagina ​, of van URL die wordt gebruikt om tot de instantie toegang te hebben. Bijvoorbeeld in https://experience.adobe.com/#/@<your organization>/in:<tenant ID>/commerce-optimizer-studio/home .

  1. Selecteer in Commerce Admin Adobe Commerce Optimizer om de configuratiepagina met instructies weer te geven.

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

  2. Van de bevellijn, ​ gebruik SSH ​ om met het Adobe Commerce het opvoeren milieu te verbinden.

  3. Voer het volgende Adobe Commerce CLI bevel in om de integratie te vormen, die de placeholder waarden met de waarden voor uw Commerce Optimizer project vervangt:

    code language-terminal 
    bin/magento aco:config:init --org_id=your-org --tenant_id=your-tenant --client_id=your-client-id --client_secret=your-secret

  4. Controleer de verbinding door terug te keren naar Commerce Admin en de optie Adobe Commerce Optimizer te selecteren.

    Wanneer u de optie selecteert, wordt de gebruikersinterface van Adobe Commerce Optimizer op een nieuw tabblad geopend.

Controleren of de gegevenssync werkt

U kunt controleren en verifiëren dat de synchronisatie werkt vanaf de pagina Data Feed Sync Status ​ in Admin.

  1. de synchronisatiestatus van de Controle in Commerce Admin:

    Ga naar System > Data Transfer > Data Feed Sync Status .

    ​ de pagina van de Status van de Synchronisatie van het Gegeven van Gegevens met de status van het voederpunt rapporterend ​ {width="500" modal="regular"}

    Wanneer de synchronisatie wordt uitgevoerd, worden records verzonden in de feed-gegevens. Selecteer een feed om details weer te geven of synchronisatieproblemen op te lossen.

  2. Bevestig gegevens die in Commerce Optimizer worden aangekomen:

    Selecteer Data Sync in het menu Adobe Commerce Optimizer .

    ​ de pagina van de Synchronisatie van Gegevens in Adobe Commerce Optimizer die gesynchroniseerde catalogusgegevens tonen ​ {width="500" modal="regular"}

    Controleer of de verwachte producten, prijzen en kenmerken worden weergegeven.

TIP
Als u om het even welke kwesties met de gegevenssynchronisatie hebt, zie de ​ gids van het Oplossen van problemen ​.

Volgende stappen

  1. vorm Adobe Commerce Optimizer catalogusmeningen en beleid

    Maak catalogusweergaven en -beleid in de gebruikersinterface van Adobe Commerce Optimizer . Prijsboeken worden automatisch gemaakt op basis van klantgroepen van Adobe Commerce . Voor instructies, zie de ​ meningen van de Catalogus ​ en ​ documentatie van het Beleid ​ in de Adobe Commerce OptimizerGids van de Gebruiker.

  2. opstelling een Storefront van Commerce opEdge Delivery Services

    Volg de ​ documentatie van de Opstelling van de Storefront ​ om uw storefront aan de Adobe Commerce Optimizer instantie te verbinden en beginnen gepersonaliseerde handelservaringen te leveren.

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