DocumentazioneCommerceOptimizer Connector

[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe) e ai progetti on-premise."}

Introduzione

Ultimo aggiornamento: 1 giugno 2026

Creato per:

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

Installa e configura Adobe Commerce Optimizer Connector per sincronizzare i dati del catalogo Adobe Commerce con Adobe Commerce Optimizer, quindi monitora lo stato di sincronizzazione dei dati per garantire che la vetrina sia aggiornata.

IMPORTANT
Collega sempre le istanze Sandbox Optimizer agli ambienti non di produzione e le istanze di produzione agli ambienti di produzione. Gli ambienti non corrispondenti causano incoerenza nei dati di catalogo, nei risultati di ricerca e nei consigli.

Requisiti per l’utilizzo dell’integrazione requirements-to-use-the-integration

  • Adobe Commerce 2.4.7+

    • PHP 8.2, 8.3 o 8.4
    • Compositore 2.x

  • Licenza Commerce Optimizer con istanza sandbox predisposta.

  • Chiavi di autenticazione per scaricare il metapacchetto del connettore tramite Compositore.

  • Accesso amministratore a un’istanza Commerce Optimizer sandbox.

L’utente Adobe Commerce che configura l’integrazione deve avere:

Rimuovere le estensioni in conflitto remove-conflicting-extensions

Se è installata una delle seguenti estensioni, disinstallarle prima di installare Adobe Commerce Optimizer Connector:

  • 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)

I dati associati a queste estensioni sono ancora disponibili nel database di Commerce. Tuttavia, non viene esportato in Commerce Optimizer quando il connettore è abilitato. Per implementare le funzionalità di ricerca e merchandising fornite da queste estensioni dopo l’abilitazione del connettore, configurale dall’Commerce Optimizer interfaccia utente amministratore.

IMPORTANT
Se queste estensioni non vengono rimosse prima di abilitare il connettore, è possibile che vengano visualizzate schermate di configurazione interrotte, dati duplicati in Commerce Optimizer perché gli stessi dati vengono esportati sia dal connettore che dalle estensioni esistenti ed errori 401 o 403 nei registri a causa di conflitti nel modo in cui le estensioni e il connettore si autenticano con i servizi connessi.
style
shade-box

Passaggi di configurazione configuration-steps

Segui questi passaggi per abilitare Adobe Commerce Optimizer Connector e iniziare a sincronizzare i dati da Adobe Commerce all’istanza Commerce Optimizer.

  1. Installa il Adobe Commerce Optimizer Connector pacchetto utilizzando Composer per connettere l’istanza Adobe Commerce a Commerce Optimizer.

  2. Personalizzare la configurazione di esportazione degli ambiti di Commerce dall’amministratore.

  3. Abilita l’integrazione Commerce Optimizer ​.

  4. Verificare che la sincronizzazione dei dati funzioni.

Installa il pacchetto Adobe Commerce Optimizer Connector install-the-adobe-commerce-optimizer-connector-package

Adobe Commerce Optimizer Connector viene consegnato come metapacchetto Compositore disponibile per tutti i commercianti Commerce con una licenza attiva per Commerce Optimizer.

Passaggi per l’installazione

  1. Aggiungi il modulo adobe-commerce/commerce-data-export-aco-adapter tramite Compositore:

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

  2. Distribuire le modifiche nell’ambiente di staging Adobe Commerce.

    Al termine della distribuzione, l’opzione Commerce Optimizer è disponibile nel menu di amministrazione di Commerce. Seleziona Commerce Optimizer per aprire l’istanza di Commerce Optimizer direttamente dall’amministratore di Commerce.

NOTE
Per istruzioni dettagliate sull’installazione dell’estensione, consulta le seguenti guide:
Installa estensione su Adobe Commerce in Cloud Infrastructure
Installa estensione in Adobe Commerce locale

Personalizzare la configurazione di esportazione degli ambiti di Commerce customize-the-commerce-scopes-export-configuration

Per impostazione predefinita, la sincronizzazione dei dati del catalogo è abilitata per tutti gli ambiti di Commerce (siti Web, gruppi di clienti e visualizzazioni archivio). È possibile personalizzare le impostazioni di esportazione per sincronizzare i dati solo per ambiti specifici in base alle esigenze aziendali. Se ad esempio sono presenti più visualizzazioni archivio che condividono la stessa lingua, è possibile scegliere di esportare i dati per una sola delle visualizzazioni archivio e utilizzarli come origine catalogo per più visualizzazioni catalogo in Commerce Optimizer.

IMPORTANT
La modifica delle impostazioni di esportazione attiva una reindicizzazione completa, che può richiedere molto tempo a seconda delle dimensioni del catalogo. Adobe consiglia di configurare gli ambiti Commerce da sincronizzare con Commerce Optimizer prima di abilitare l'integrazione e avviare la sincronizzazione dati iniziale.

Nella tabella seguente vengono descritti i dati esportati a ogni livello di ambito:

Ambito
Dati esportati
Note
Sito web e gruppo di clienti
Prezzi e listini prezzi
Ogni set di prezzi viene esportato come listino prezzi utilizzando la convenzione di denominazione <website>::<SHA1 of customer group ID>. Sono inclusi tutti i gruppi di clienti per il sito Web.
Visualizzazione store
Prodotti e attributi del prodotto
Ogni visualizzazione archivio crea una origine catalogo separata in Commerce Optimizer.

Archivia griglia con impostazioni di sincronizzazione Commerce Optimizer {width="600" modal="regular"}

Per modificare le impostazioni di esportazione dell’ambito

  1. In Amministrazione Commerce, vai a Stores > Settings > All Stores.

  2. Seleziona la visualizzazione del sito web o store che desideri configurare.

  3. Nelle impostazioni dell’utilità di esportazione Commerce Optimizer, utilizzare la casella di controllo per abilitare o disabilitare la sincronizzazione dei dati in base alle esigenze.

    Aggiorna configurazione sincronizzazione dati {width="500" modal="regular"}

  4. Salva le modifiche.

Attivare e disattivare il comportamento

Azione
Risultato
Disattiva una visualizzazione store
La disabilitazione della sincronizzazione rimuove i dati del catalogo dalla vetrina. L’origine del catalogo rimane in Commerce Optimizer, ma tutti i dati sincronizzati vengono rimossi alla successiva esecuzione cron.
Disattiva e riattiva la visualizzazione dello store
La stessa origine del catalogo viene ripopolata con una risincronizzazione completa dei dati.

Abilita l’integrazione di Commerce Optimizer enable-the-adobe-commerce-optimizer-integration

Abilitare l’integrazione e avviare la sincronizzazione dei dati eseguendo il comando CLI aco:config:init. Questo comando completa i passaggi seguenti:

  1. Ottiene un token di accesso IMS utilizzando le credenziali fornite come argomenti della riga di comando.
  2. Chiama il servizio Commerce Cloud Manager (CCM) in https://ccm.api.commerce.adobe.com/api/v1/tenants/{tenantId}/owner/{orgId} per convalidare il tenant ed estrarre l’URL di acquisizione e l’URL di Commerce Optimizer Studio.
  3. Salva tutta la configurazione (segreto client crittografato) in core_config_data.
  4. Pianifica la sincronizzazione completa iniziale invalidando tutti gli indicizzatori di feed Commerce Optimizer.
IMPORTANT
L’elaborazione della sincronizzazione dati viene avviata in background non appena viene completata la configurazione. A seconda delle dimensioni del catalogo, il processo di sincronizzazione dei dati può richiedere da alcuni minuti a diverse ore.

Ottieni i dettagli di connessione richiesti

Da Adobe Developer Console, crea un nuovo progetto abilitato per il servizio di acquisizione Commerce Optimizer e genera le credenziali da server a server OAuth. Per istruzioni dettagliate, consulta Ottenere le credenziali IMS nella Guida per gli sviluppatori di merchandising.

Salva i seguenti valori dalla pagina delle credenziali:

  • ID organizzazione (org_id)
  • ID client (client_id)
  • Segreto client (client_secret)

Ottieni dettagli sulle credenziali dalla pagina del progetto Adobe Developer Console {width="500" modal="regular"}

Ottieni dettagli istanza Commerce Optimizer

Ottieni l’ID tenant dal campo Instance Id​nell’istanza Instance details page di Commerce Optimizer o dall’URL utilizzato per accedere all’istanza. Ad esempio, in https://experience.adobe.com/#/@<your organization>/in:<tenant ID>/commerce-optimizer-studio/home.

  1. Dall’amministratore di Commerce, selezionare Adobe Commerce Optimizer per visualizzare la pagina di configurazione con le istruzioni.

    Commerce Optimizer pagina di configurazione {width="500" modal="regular"}

  2. Dalla riga di comando, utilizzare SSH per connettersi all’ambiente di staging Adobe Commerce.

  3. Esegui il seguente comando CLI Adobe Commerce per configurare l’integrazione, sostituendo i valori segnaposto con i valori per il progetto Commerce Optimizer:

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

  4. Verificare la connessione tornando all’amministratore di Commerce e selezionando l’opzione Adobe Commerce Optimizer.

    Quando selezioni l’opzione, viene aperta l’interfaccia utente Commerce Optimizer in una nuova scheda.

Verifica che la sincronizzazione dei dati funzioni verify-that-the-data-sync-is-working

Verificare che i dati siano stati esportati correttamente dall’amministratore di Commerce e che siano stati consegnati correttamente a Commerce Optimizer. Inizia con l’esportazione in Commerce Admin, quindi conferma la consegna in Commerce Optimizer.

  1. Verifica lo stato di sincronizzazione nell’amministratore di Commerce:

    Vai a System > Data Transfer > Data Feed Sync Status.

    Pagina Stato sincronizzazione feed dati con report sullo stato degli elementi del feed {width="700" modal="regular"}

    Quando la sincronizzazione è in esecuzione, i dati del feed mostrano i record inviati correttamente. Seleziona un feed per visualizzare i dettagli o risolvere i problemi di sincronizzazione.

  2. Conferma recapito dati a Commerce Optimizer:

    Dal menu Commerce Optimizer, selezionare Data Sync.

    Pagina di sincronizzazione dati in Adobe Commerce Optimizer con i dati del catalogo sincronizzati {width="700" modal="regular"}

    Verifica che vengano visualizzati i prodotti, i prezzi e gli attributi previsti.

Quando la sincronizzazione funziona come previsto:

  • Data Feed Sync Status mostra i record inviati correttamente per i feed del connettore, senza errori a livello di elemento non risolti.
  • Data Sync in Commerce Optimizer elenca le origini di catalogo, i prodotti, i prezzi e gli attributi previsti.
TIP
In caso di problemi con la sincronizzazione dei dati, consulta la guida alla risoluzione dei problemi.

Passaggi successivi

  1. Configura Commerce Optimizer visualizzazioni catalogo e criteri

    Creare visualizzazioni e criteri catalogo nell’interfaccia utente Commerce Optimizer. I listini prezzi vengono creati automaticamente da Adobe Commerce gruppi di clienti. Per istruzioni, vedere la documentazione Visualizzazioni catalogo e Criteri nella Guida utente Commerce Optimizer.

  2. Configura una vetrina Commerce suEdge Delivery Services

    Segui la documentazione di configurazione di Storefront per connettere la tua vetrina all’istanza Commerce Optimizer e iniziare a distribuire esperienze di e-commerce personalizzate.

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