DocumentazioneCommerceData Connection estensione per Adobe Commerce

Connettere i dati Commerce a Adobe Experience Platform

Last update: Mon Oct 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore

Quando installi l'estensione Data Connection, nel menu System di Services in Commerce Admin vengono visualizzate due nuove pagine di configurazione.

  • Connettore servizi Commerce
  • Data Connection

Per connettere l'istanza Adobe Commerce a Adobe Experience Platform, è necessario configurare entrambi i connettori, partendo dal connettore Commerce Services e terminando con l'estensione Data Connection.

Configurare il connettore dei servizi Commerce

Se in precedenza hai installato un servizio Adobe Commerce, probabilmente hai già configurato il connettore dei servizi Commerce. In caso contrario, è necessario completare le seguenti attività nella pagina Connettore servizi Commerce:

  1. Accedi al tuo account Commerce per recuperare le chiavi API di produzione e sandbox.
  2. Selezionare uno spazio dati SaaS.
  3. Accedi al tuo account Adobe per recuperare l'ID organizzazione.

Dopo aver configurato il connettore Commerce Services, configurare l'estensione Data Connection.

Configura l'estensione Data Connection

In questa sezione imparerai a configurare l'estensione Data Connection.

Aggiungi dettagli account servizio e credenziali

Se si prevede di raccogliere e inviare dati cronologici degli ordini o dati del profilo cliente, è necessario aggiungere i dettagli dell'account del servizio e delle credenziali. Inoltre, se stai configurando l'estensione Audience Activation, devi completare questi passaggi.

Se raccogli e invii solo dati di vetrina o di back office, puoi passare alla sezione generale.

Passaggio 1: creare un progetto in Adobe Developer Console

Crea un progetto in Adobe Developer Console che autentica Commerce in modo che possa effettuare chiamate API Experience Platform.

Per creare il progetto, segui i passaggi descritti nell'esercitazione Autentica e accedi alle API di Experience Platform.

Durante l’esercitazione, assicurati che il progetto presenti quanto segue:

  • Accesso ai profili di prodotto seguenti: Accesso predefinito a tutti i prodotti e Accesso predefinito a tutti i prodotti AEP.
  • ruoli e autorizzazioni corretti configurati.
  • Se hai deciso di utilizzare i token web JSON (JWT) come metodo di autenticazione server-to-server, devi caricare anche una chiave privata.

Il risultato di questo passaggio crea un file di configurazione da utilizzare nel passaggio successivo.

Passaggio 2: scarica il file di configurazione

Scarica il file di configurazione dell'area di lavoro. Copiare e incollare il contenuto del file nella pagina Dettagli account di servizio/credenziali dell'amministratore di Commerce.

  1. In Amministrazione Commerce, passa a Archivi > Impostazioni > Configurazione > Servizi > Data Connection.

  2. Selezionare il metodo di autorizzazione server-to-server implementato dal menu Tipo di autorizzazione Adobe Developer. Adobe consiglia di utilizzare OAuth. Il codice JWT è stato dichiarato obsoleto. Ulteriori informazioni.

  3. (Solo JWT) Copia e incolla il contenuto del file private.key nel campo Segreto client. Utilizza il seguente comando per copiare il contenuto.

    code language-bash 
    cat config/private.key | pbcopy

    Per ulteriori informazioni sul file private.key, vedere Autenticazione dell'account di servizio 🔗.

  4. Copiare il contenuto del file <workspace-name>.json nel campo Dettagli account/credenziali servizio.

    Configurazione amministratore Data Connection {width="700" modal="regular"}

  5. Fai clic su Salva configurazione.

  6. Fare clic sul pulsante Test connection per verificare che le informazioni sull'account del servizio e sulle credenziali immesse siano corrette.

Generale

  1. In Amministrazione, passa a Sistema > Servizi > Data Connection.

    Impostazioni Data Connection {width="700" modal="regular"}

  2. Nella scheda Impostazioni in Generale, verifica l'ID associato al tuo account Adobe Experience Platform, come configurato in Connettore servizi Commerce. L’ID organizzazione è globale. È possibile associare un solo ID organizzazione per istanza di Adobe Commerce.

  3. Nel menu a discesa Ambito, impostare il contesto su Sito Web.

  4. (Facoltativo) Se hai già distribuito un AEP Web SDK (lega) nel tuo sito, abilita la casella di controllo e aggiungi il nome del tuo AEP Web SDK. In caso contrario, lasciare vuoti questi campi e l'estensione Data Connection ne distribuisce uno.

    note note
    NOTE
    Se specifichi un tuo AEP Web SDK, l'estensione Data Connection utilizza l'ID dello stream di dati associato a tale SDK e non l'ID dello stream di dati specificato in questa pagina (se presente).

Raccolta dati

In questa sezione si specifica il tipo di dati che si desidera raccogliere e inviare al server Edge di Experience Platform. Esistono tre tipi di dati:

  • Comportamentale (dati lato client) sono dati acquisiti nella vetrina. Sono incluse le interazioni con gli acquirenti, ad esempio View Page, View Product, Add to Cart e informazioni sull'elenco richieste (per gli esercenti B2B).

  • Back office (dati lato server) sono dati acquisiti nei server Commerce. Ciò include informazioni sullo stato di un ordine, ad esempio se un ordine è stato effettuato, annullato, rimborsato, spedito o completato. Include anche dati cronologici dell'ordine.

  • Il profilo è costituito da dati relativi alle informazioni del profilo dell'acquirente. Ulteriori informazioni su.

Per garantire che l'istanza di Adobe Commerce possa iniziare la raccolta dati, controlla i prerequisiti.

Per ulteriori informazioni sugli eventi storefront, back office e profile, vedere l'argomento eventi.

NOTE
Tutti i campi nella sezione Raccolta dati si applicano all'ambito Sito Web o versione successiva.

  1. Seleziona Eventi storefront se desideri inviare dati comportamentali storefront.

  2. Selezionare Eventi back office per inviare informazioni sullo stato dell'ordine, ad esempio se un ordine è stato effettuato, annullato, rimborsato o spedito.

    note note
    NOTE
    Se si seleziona Eventi di back office, tutti i dati di back office vengono inviati al server Edge di Experience Platform. Se un acquirente sceglie di rinunciare alla raccolta dei dati, devi impostare esplicitamente la preferenza relativa alla privacy dell'acquirente nell'Experience Platform. Questo è diverso dagli eventi di vetrina in cui l’agente di raccolta gestisce già il consenso in base alle preferenze dell’acquirente. Ulteriori informazioni ulteriori sull'impostazione delle preferenze di privacy di un acquirente nell'Experience Platform.

  3. (Ignora questo passaggio se utilizzi un tuo AEP Web SDK personale.) Creare uno stream di dati in Adobe Experience Platform o selezionare uno stream di dati esistente da utilizzare per la raccolta. Immetti l'ID dello stream di dati nel campo ID dello stream di dati.

  4. Immettere il ID set di dati che si desidera includere nei dati di Commerce. Per trovare l’ID del set di dati:

    1. Apri l'interfaccia utente di Experience Platform e seleziona Set di dati nella navigazione a sinistra per aprire il dashboard Set di dati. Il dashboard elenca tutti i set di dati disponibili per l’organizzazione. Vengono visualizzati i dettagli di ciascun set di dati elencato, tra cui il nome, lo schema a cui il set di dati aderisce e lo stato dell’esecuzione dell’acquisizione più recente.
    2. Apri il set di dati associato allo stream di dati.
    3. Nel riquadro di destra, visualizzare i dettagli sul set di dati. Copia l’ID del set di dati.

  5. Per garantire gli aggiornamenti dei dati degli eventi di back office in base a una pianificazione in base a un processo cron, è necessario modificare l'indice Sales Orders Feed in Update by Schedule.

    1. Nella barra laterale Admin, passa a System > Tools>Index Management.

    2. Selezionare la casella di controllo per l'indicizzatore Sales Orders Feed.

    3. Imposta Actions su Update by Schedule.

    4. Se si abilitano i dati di back office per la prima volta, eseguire i seguenti comandi per reindicizzare e attivare una risincronizzazione. Le successive risincronizzazioni si verificano automaticamente se il processo cron è configurato correttamente.

      code language-bash 
      bin/magento index:reindex sales_order_data_exporter_v2
      code language-bash 
      bin/magento saas:resync --feed orders

Descrizioni dei campi

Campo
Descrizione
Ambito
Sito Web specifico in cui desideri applicare le impostazioni di configurazione.
ID organizzazione (globale)
ID che appartiene all'organizzazione che ha acquistato il prodotto Adobe DX. Questo ID collega l’istanza di Adobe Commerce a Adobe Experience Platform.
AEP Web SDK è già distribuito sul tuo sito?
Seleziona questa casella di controllo se hai implementato il tuo AEP Web SDK sul tuo sito
Nome AEP Web SDK (globale)
Se hai già distribuito un Experience Platform Web SDK sul tuo sito, specifica il nome di tale SDK in questo campo. Questo consente a Storefront Event Collector e Storefront Event SDK di utilizzare l'Experience Platform Web SDK anziché la versione distribuita dall'estensione Data Connection. Se non hai distribuito un Experience Platform Web SDK sul tuo sito, lascia vuoto questo campo e l'estensione Data Connection ne distribuisce uno.
Eventi vetrina
È selezionato per impostazione predefinita, purché l’ID organizzazione e l’ID dello stream di dati siano validi. Gli eventi di vetrina raccolgono dati comportamentali anonimi dai tuoi acquirenti durante la navigazione sul tuo sito.
Eventi back office
Se selezionato, il payload dell’evento contiene informazioni anonime sullo stato dell’ordine, ad esempio se un ordine è stato effettuato, annullato, rimborsato o spedito.
ID flusso di dati (sito web)
ID che consente il flusso di dati da Adobe Experience Platform ad altri prodotti Adobe DX. Questo ID deve essere associato a un sito web specifico all’interno della tua istanza Adobe Commerce specifica. Se specifichi un Experience Platform Web SDK personalizzato, non specificare un ID dello stream di dati in questo campo. L'estensione Data Connection utilizza l'ID dello stream di dati associato a tale SDK e ignora qualsiasi ID dello stream di dati specificato in questo campo (se presente).
ID set di dati (sito web)
ID del set di dati che contiene i dati di Commerce. Questo campo è obbligatorio a meno che non siano state deselezionate le caselle di controllo Storefront events o Back office events. Inoltre, se utilizzi il tuo Experience Platform Web SDK e pertanto non hai specificato un ID dello stream di dati, devi comunque aggiungere l’ID del set di dati associato allo stream di dati. In caso contrario, non è possibile salvare il modulo.

Dopo l’onboarding, i dati della vetrina iniziano a fluire verso il server Edge di Experience Platform. I dati di back office richiedono circa cinque minuti per essere visualizzati ai margini. Gli aggiornamenti successivi sono visibili sul server Edge in base alla pianificazione cron.

Inviare dati del profilo cliente

Esistono due tipi di dati di profilo che puoi inviare all’Experience Platform: i record di profilo e gli eventi di profilo della serie temporale.

Un record di profilo contiene dati salvati quando un acquirente crea un profilo nell’istanza Commerce, ad esempio il nome dell’acquirente. Quando lo schema e il set di dati sono configurati correttamente, viene inviato un record di profilo all'Experience Platform e inoltrato al servizio di segmentazione e gestione dei profili di Adobe: Real-Time CDP.

Gli eventi di profilo della serie temporale contengono dati sulle informazioni del profilo dell’acquirente, ad esempio se creano, modificano o eliminano un account sul sito. Quando i dati dell’evento profilo vengono inviati all’Experience Platform, risiedono in un set di dati in cui possono essere utilizzati da altri prodotti DX.

  1. Assicurati di aver fornito i dettagli dell'account del servizio e delle credenziali.

  2. Assicurati di avere uno schema e un set di dati specificati per l'acquisizione dei dati dell'evento del profilo 🔗 e per l'acquisizione dei dati dell'evento del profilo della serie temporale.

  3. Se desideri inviare i dati del profilo all'Experience Platform, seleziona la casella di controllo Profili cliente.

  4. Immettere l'ID Set di dati profilo.

    I dati del record profilo devono utilizzare un set di dati diverso da quello attualmente in uso per i dati comportamentali e di back office.

  5. Se non desideri inviare in streaming gli eventi di profilo attraverso lo stesso ID dello stream di dati utilizzato per i dati comportamentali e di back office, rimuovi il segno di spunta da Trasmetti profili cliente attraverso lo stesso ID dello stream di dati e immetti l'ID dello stream di dati che desideri utilizzare al suo posto.

La disponibilità di un record di profilo in Real-Time CDP può richiedere circa 10 minuti. Lo streaming degli eventi del profilo inizia immediatamente.

TIP
Se nell'Experience Platform non vengono visualizzati i dati del profilo, consultare Commerce KnowledgeBase per suggerimenti sulla risoluzione dei problemi.

Descrizioni dei campi

Campo
Descrizione
Profili cliente
Selezionare questa casella di controllo se si desidera raccogliere e inviare i record del profilo cliente.
ID del set di dati profilo
Un record di profilo deve utilizzare un set di dati diverso da quello utilizzato per eventi comportamentali e di back office.
Trasmetti i profili cliente attraverso lo stesso ID dello stream di dati
Decidi se utilizzare o meno lo stesso flusso di dati attualmente utilizzato per gli eventi comportamentali e di back office.
Stream di dati per i profili cliente
Specifica lo stream di dati specifico per il record del profilo cliente.

Inviare dati cronologici degli ordini

Adobe Commerce raccoglie fino a cinque anni di dati storici sugli ordini e stato. Puoi utilizzare l'estensione Data Connection per inviare i dati storici all'Experience Platform per arricchire i profili dei clienti e personalizzare le esperienze dei clienti in base a tali ordini passati. I dati vengono memorizzati in un set di dati in Experience Platform.

Anche se Commerce raccoglie già i dati storici dell’ordine, è necessario completare diversi passaggi per inviare tali dati a Experience Platform.

Guarda questo video per ulteriori informazioni sugli ordini storici, quindi completa i seguenti passaggi per implementare la raccolta degli ordini storici.

https://video.tv.adobe.com/v/3424672

Impostare il servizio di sincronizzazione ordini

Il servizio di sincronizzazione degli ordini utilizza Message Queue Framework e RabbitMQ. Dopo aver completato questi passaggi, i dati sullo stato dell’ordine possono essere sincronizzati con SaaS, operazione necessaria prima dell’invio all’Experience Platform.

  1. Assicurati di aver fornito i dettagli dell'account del servizio e delle credenziali.

  2. Abilita RabbitMQ.

    note note
    NOTE
    RabbitMQ è già configurato per Commerce versione 2.4.7 e successive, ma è necessario abilitare i consumatori.

  3. Abilitare i consumer della coda messaggi tramite il processo cron in .magento.env.yaml utilizzando la variabile di ambiente CRON_CONSUMERS_RUNNER.

    code language-yaml 
       stage:
     deploy:
       CRON_CONSUMERS_RUNNER:
         cron_run: true
    note note
    NOTE
    Per informazioni su tutte le opzioni di configurazione disponibili, consulta la documentazione sulle variabili di distribuzione.

Se il servizio di sincronizzazione ordini è abilitato, è possibile specificare l'intervallo di date dell'ordine cronologico nella pagina Data Connection.

Specifica intervallo date cronologia ordini

Specifica l’intervallo di date per gli ordini storici da inviare all’Experience Platform.

  1. In Amministrazione, passa a Sistema > Servizi > Data Connection.

  2. Selezionare la scheda Cronologia ordini.

    Data Connection cronologia ordini {width="700" modal="regular"}

  3. In Sincronizzazione cronologia ordini, la casella di controllo Copia ID set di dati dalle impostazioni è già abilitata. In questo modo si utilizza lo stesso set di dati specificato nella scheda Impostazioni.

  4. Nei campi Da e A, specifica l'intervallo di date per i dati dell'ordine cronologico che desideri inviare. Non puoi selezionare un intervallo di date superiore a cinque anni.

  5. Selezionare Start Sync per avviare la sincronizzazione. I dati storici dell’ordine sono dati in batch, anziché dati di vetrina e di back office che sono dati in streaming. L’invio dei dati in batch in Experience Platform richiede circa 45 minuti.

Descrizioni dei campi
Campo
Descrizione
Copia ID set di dati dalle impostazioni
Copia l'ID del set di dati immesso nella scheda Impostazioni.
ID set di dati (sito web)
ID del set di dati che contiene i dati di Commerce. Questo campo è obbligatorio a meno che non siano state deselezionate le caselle di controllo Storefront events o Back office events. Inoltre, se utilizzi il tuo Experience Platform Web SDK e pertanto non hai specificato un ID dello stream di dati, devi comunque aggiungere l’ID del set di dati associato allo stream di dati. In caso contrario, non è possibile salvare il modulo.
Da
Data a partire dalla quale si desidera iniziare la raccolta dei dati della cronologia degli ordini.
A
Data a partire dalla quale si desidera terminare la raccolta dei dati della cronologia degli ordini.
Avvia sincronizzazione
Avvia il processo di sincronizzazione dei dati della cronologia dell'ordine con il server perimetrale Experience Platform. Questo pulsante è disabilitato se il campo Dataset ID è vuoto o se l'ID del set di dati non è valido.

Personalizzazione dei dati

Nella scheda Personalizzazione dati è possibile visualizzare tutti gli attributi personalizzati configurati in Commerce e inviati all'Experience Platform.

Personalizzazione dei dati Data Connection {width="700" modal="regular"}

IMPORTANT
Assicurati che l'ID dello stream di dati specificato nella scheda Raccolta dati corrisponda all'ID collegato allo schema per l'acquisizione degli attributi personalizzati.

Quando si creano attributi personalizzati per gli ordini e li si invia all'Experience Platform, i nomi degli attributi in Commerce devono corrispondere a quelli nello schema Commerce dell'Experience Platform. Se non corrispondono, può essere difficile identificare le differenze. Se i nomi non corrispondono, la tabella Attributi ordine personalizzati può aiutare a risolvere il problema.

La tabella Attributi ordine personalizzati fornisce visibilità sulla configurazione e sul mapping degli attributi ordine personalizzati tra il back office Commerce e lo schema Commerce in Experience Platform. Questa tabella consente di visualizzare gli attributi personalizzati del livello dell'ordine e del livello dell'articolo dell'ordine in origini diverse, semplificando l'identificazione degli attributi mancanti o non allineati. Inoltre, visualizza gli ID dei set di dati per distinguere tra set di dati live e storici, in quanto ciascuno può avere i propri attributi personalizzati.

Se nella tabella non viene visualizzato un segno di spunta verde accanto al nome di un attributo personalizzato, significa che non vi è corrispondenza tra i nomi degli attributi nelle origini. Correggere il nome dell'attributo in un'origine. Verrà visualizzato un segno di spunta verde per indicare che i nomi ora corrispondono.

  • Se il nome dell'attributo viene aggiornato nello schema in Experience Platform, è necessario salvare la configurazione nella scheda Personalizzazione dati per attivare la modifica dello schema di Experience Platform. Questa modifica verrà applicata alla tabella Attributi ordine personalizzati quando si fa clic sul pulsante Refresh.
  • Se il nome dell'attributo viene aggiornato in Commerce, è necessario generare un evento ordine per aggiornare il nome nella tabella Attributi ordine personalizzati. La modifica si rifletterà in circa 60 minuti.

Ulteriori informazioni su come impostare attributi personalizzati.

Descrizioni dei campi

Campo
Descrizione
Set di dati
Visualizza i set di dati che contengono gli attributi personalizzati. I set di dati live e storici possono avere i propri attributi personalizzati.
Adobe Commerce
Visualizza tutti gli attributi personalizzati creati nel back office Commerce.
Experience Platform
Visualizza tutti gli attributi personalizzati specificati nello schema Commerce in Experience Platform.
Aggiorna
Recupera eventuali nomi di attributi personalizzati dallo schema Commerce in Experience Platform.

Conferma la raccolta dei dati dell’evento

Per verificare che i dati vengano raccolti dall'archivio Commerce, utilizzare Adobe Experience Platform debugger per esaminare il sito Commerce. Dopo aver confermato che i dati vengono raccolti, è possibile verificare che i dati dell'evento storefront e back office vengano visualizzati nel perimetro eseguendo una query che restituisce i dati dal set di dati creato.

  1. Selezionare Query nell'area di navigazione a sinistra di Experience Platform e fare clic su Create Query.

    Editor query

  2. All’apertura dell’editor delle query, immetti una query che selezioni i dati dal set di dati.

    Crea query

    Ad esempio, la query potrebbe essere simile alla seguente:

    code language-sql 
    SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC

  3. Dopo l'esecuzione della query, i risultati vengono visualizzati nella scheda Risultati, accanto alla scheda Console. Questa vista mostra l’output tabulare della query.

    Editor query

In questo esempio vengono visualizzati i dati evento di commerce.productListAdds, commerce.productViews, web.webpagedetails.pageViews e così via. Questa vista ti consente di verificare che i dati Commerce siano arrivati al server Edge di.

Se i risultati non sono quelli previsti, apri il set di dati e cerca eventuali importazioni batch non riuscite. Ulteriori informazioni su risoluzione dei problemi relativi alle importazioni batch.

Verifica che i dati del profilo vengano visualizzati nell’Experience Platform

Se nell'Experience Platform non vengono visualizzati i dati del profilo, consultare Commerce KnowledgeBase per suggerimenti sulla risoluzione dei problemi.

Passaggi successivi

Quando i dati di Commerce vengono inviati al server Edge di Experience Platform, altri prodotti Adobe Experience Cloud, come Adobe Journey Optimizer, possono utilizzarli. Ad esempio, puoi configurare Journey Optimizer per l’ascolto di determinati eventi e, in base a tali dati, attivare un’e-mail per il primo utente o se viene abbandonato un carrello. Scopri come estendere la piattaforma Commerce creando percorsi di clienti in Journey Optimizer.

recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840