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:
-
Accesso amministratore all’amministrazione di Adobe Commerce.
-
Accesso alla riga di comando al server applicazioni Adobe Commerce.
-
Accesso per sviluppatori all'organizzazione IMS in cui è stato eseguito il provisioning del progetto Adobe Commerce Optimizer.
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.
-
Installa il pacchetto Commerce Optimizer Connector utilizzando Composer per connettere l'istanza Commerce a Adobe Commerce Optimizer.
-
Rivedi e personalizza la configurazione di esportazione dei dati dall'amministratore.
-
Ottieni le credenziali API necessarie per stabilire la connessione tra Commerce e 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
-
Aggiungi il modulo
adobe-commerce/commerce-data-export-aco-adaptertramite Compositore:code language-shell composer require adobe-commerce/commerce-data-export-aco-adapter -
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.
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.
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.
Esportazione dati per ambito
Nella tabella seguente vengono descritti i dati esportati a ogni livello di ambito:
website::customergroupcode. Sono inclusi tutti i gruppi di clienti per il sito Web.Attivare e disattivare il comportamento
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.
Per modificare le impostazioni di una visualizzazione sito Web o archivio:
-
In Amministrazione Commerce, passa a Stores > Settings > All Stores.
-
Seleziona la visualizzazione del sito web o store che desideri configurare.
-
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.
{width="500" modal="regular"}
-
Salva le modifiche.
Abilita l'integrazione di Adobe Commerce Optimizer
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.
-
Dall'amministratore di Commerce, selezionare Adobe Commerce Optimizer per visualizzare la pagina di configurazione con le istruzioni.
{width="500" modal="regular"}
-
Dalla riga di comando, utilizzare SSH per connettersi all'ambiente di staging di Commerce.
-
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
-
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.
-
Verifica lo stato di sincronizzazione nell'amministratore di Commerce:
Vai a System > Data Transfer > Data Feed Sync Status.
{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.
-
Dati di conferma arrivati in Commerce Optimizer:
Dal menu Adobe Commerce Optimizer, selezionare Data Sync.
{width="500" modal="regular"}
Verifica che vengano visualizzati i prodotti, i prezzi e gli attributi previsti.
Passaggi successivi
-
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.
-
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.