[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

Installa e configura il connettore Commerce Optimizer 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.

Requisiti per l’utilizzo dell’integrazione

  • Adobe Commerce 2.4.7+

    • PHP 8.2, 8.3 o 8.4
    • Compositore 2.x
  • Licenza Adobe Commerce Optimizer con istanza sandbox predisposta.

  • Accedi a repo.magento.com per scaricare il metapacchetto del connettore Commerce tramite Composer.

  • Accesso amministratore a un'istanza sandbox Adobe Commerce Optimizer.

L’utente di Adobe Commerce che configura l’integrazione deve disporre di:

recommendation-more-help

Prerequisiti

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

  • Adobe Commerce Live Search (magento/live-search)
  • Consigli di prodotto di Adobe Commerce (magento/product-recommendations)
  • Servizio catalogo Adobe Commerce (magento/catalog-service, magento/catalog-service-installer)
  • Dashboard di gestione dati (magento-catalog-sync-admin)

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

Passaggi di configurazione

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

Installare il pacchetto Commerce Optimizer Connector

Il connettore Adobe Commerce Optimizer viene fornito come metapacchetto Compositore disponibile per tutti i commercianti Commerce con una licenza attiva per Adobe 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. Implementa le modifiche nell’ambiente di staging Adobe Commerce.

Al termine dell’implementazione, l’opzione Commerce Optimizer è disponibile nel menu Amministrazione di Commerce. Fai clic su Commerce Optimizer per aprire l'istanza di Commerce Optimizer direttamente dall'amministratore Commerce.

NOTE
Per istruzioni dettagliate sull’installazione dell’estensione, consulta le seguenti guide:
Installa estensione su Adobe Commerce su infrastruttura cloud
Installa l'estensione in Adobe Commerce locale

Ottieni i dettagli di connessione richiesti

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

TIP
Se disponi già di un progetto per sviluppatori configurato con l’API di acquisizione dati nella stessa organizzazione IMS dell’istanza di Commerce Optimizer, puoi riutilizzare le credenziali server-to-server OAuth esistenti.

Salva i seguenti valori dalla pagina delle credenziali:

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

Ottieni dettagli istanza Adobe Commerce Optimizer

Salva l'ID istanza (detto anche ID tenant) dall'istanza Adobe Commerce Optimizer. Puoi trovarli nell’URL utilizzato per accedere all’istanza. Ad esempio, in https://experience.adobe.com/#/@<project-id>/in:TToyu73daQRn66KAYaq8YZ/commerce-optimizer-studio/home, l'ID istanza è TToyu73daQRn66KAYaq8YZ.

Personalizzare la configurazione di esportazione dei dati di Commerce

Per impostazione predefinita, la sincronizzazione dei dati del catalogo è abilitata per tutti gli ambiti di Commerce (siti Web e visualizzazioni dello store). È possibile personalizzare le impostazioni di esportazione per sincronizzare i dati solo per ambiti specifici in base alle esigenze aziendali. Ad esempio, se si dispone di più visualizzazioni dello store ma si desidera esportare solo i dati per una di esse, è possibile disattivare la funzione di esportazione per le altre visualizzazioni dello store.

IMPORTANT
La modifica delle impostazioni di esportazione attiva una reindicizzazione completa, che può richiedere molto tempo a seconda delle dimensioni del catalogo. Pianifica queste modifiche durante i periodi di traffico ridotto per ridurre al minimo l’impatto sulle prestazioni.

Esportazione dati per ambito

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

Ambito
Dati esportati
Note
Sito Web
Prezzi e listini prezzi
Ogni set di prezzi viene esportato come listino prezzi utilizzando la convenzione di denominazione website::customergroupcode. Sono inclusi tutti i gruppi di clienti per il sito Web.
Visualizzazione store
Prodotti e attributi del prodotto
Ogni visualizzazione archivio crea un'origine catalogo separata in Adobe Commerce Optimizer.

Attivare e disattivare il comportamento

Azione
Risultato
Disattiva una visualizzazione store
L'origine del catalogo rimane in Adobe Commerce Optimizer, ma tutti i dati vengono rimossi.
Disattiva e riattiva la visualizzazione dello store
La stessa origine del catalogo viene ripopolata con una risincronizzazione completa dei dati.

Aggiornare la configurazione di esportazione

Dopo aver installato il pacchetto Connector, la griglia Store in Admin ora mostra le impostazioni di configurazione dell’esportazione per Commerce Optimizer.

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

Per modificare le impostazioni di una visualizzazione sito Web o archivio:

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

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

  3. Nelle impostazioni dell'utilità di esportazione Adobe 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.

Abilita l'integrazione di Adobe Commerce Optimizer

IMPORTANT
L'elaborazione della sincronizzazione dati viene avviata non appena si esegue il comando di configurazione. Per impostazione predefinita, la sincronizzazione dei dati del catalogo è abilitata per tutti gli ambiti di Commerce (siti Web e visualizzazioni dello store). A seconda delle dimensioni del catalogo, il processo di sincronizzazione dei dati può richiedere da alcuni minuti a diverse ore.

Utilizzando le credenziali API e i dettagli dell'istanza raccolti nei passaggi precedenti, ora puoi configurare l'integrazione tra le istanze Commerce e Adobe Commerce Optimizer.

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

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

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

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

bin/magento aco:config:init --org_id=your-org --tenant_id=your-tenant --client_id=your-client-id --client_secret=your-secret
  1. Verificare la connessione tornando all'amministratore di Commerce e selezionando l'opzione Adobe Commerce Optimizer.

    Quando si fa clic sull'opzione, viene aperta l'interfaccia utente Adobe Commerce Optimizer in una nuova scheda.

Verifica che la sincronizzazione dei dati funzioni

Dopo aver abilitato l’integrazione, la sincronizzazione dei dati inizia automaticamente. A seconda delle dimensioni del catalogo, la sincronizzazione iniziale può richiedere da alcuni minuti a diverse ore.

  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="500" 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. Dati di conferma arrivati in Commerce Optimizer:

    Dal menu Adobe Commerce Optimizer, selezionare Data Sync.

    Sincronizzazione dati {width="500" modal="regular"}

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

TIP
In caso di problemi con la sincronizzazione dei dati, consulta la sezione Risoluzione dei problemi nella Esportazione dati SaaS.

Passaggi successivi

  1. Configura Adobe Commerce Optimizer visualizzazioni catalogo e criteri

    Creare visualizzazioni e criteri del catalogo nella Guida di Adobe Commerce Optimizer. I listini prezzi vengono creati automaticamente dai gruppi di clienti Adobe Commerce.

  2. Configura una vetrina Commerce in Edge Delivery Services

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

729567c4-2b17-4f52-b183-66ed6c678da6