Documentazione Customer Journey Analytics Guida di Customer Journey Analytics

Acquisire dati tramite API server di Edge Network

Ultimo aggiornamento: 29 settembre 2026

Creato per:

Amministratore

Questa guida rapida spiega come acquisire i dati di tracciamento da dispositivi come dispositivi IoT, set-top box, console di gioco e applicazioni desktop direttamente in Adobe Experience Platform utilizzando l’API server di Adobe Experience Platform Edge Network e Edge Network. Quindi utilizza tali dati in Customer Journey Analytics.

A questo scopo, devi:

Configurare uno schema e un set di dati in Adobe Experience Platform per definire il modello (schema) dei dati da raccogliere e dove raccogliere effettivamente i dati (set di dati).
Configurare un flusso di dati per configurare la rete Edge di Adobe Experience Platform in modo che i dati raccolti vengano indirizzati al set di dati configurato in Adobe Experience Platform.
Utilizza l’API server per inviare dati direttamente dall’applicazione o dal gioco in esecuzione su un desktop, una console di gioco, un dispositivo IoT o un set-top box allo stream di dati.
Distribuire e convalidare. Crea un ambiente in cui puoi eseguire iterazioni sullo sviluppo; una volta convalidato tutto, pubblicalo live nell’ambiente di produzione.
Impostare una connessione in Customer Journey Analytics. Questa connessione deve includere almeno il set di dati di Adobe Experience Platform.
Configurare una visualizzazione dati in Customer Journey Analytics per definire le metriche e le dimensioni da utilizzare in Analysis Workspace.
Configurare un progetto in Customer Journey Analytics per generare rapporti e visualizzazioni.

NOTE

Questa guida rapida è una guida semplificata su come acquisire in Adobe Experience Platform i dati raccolti da un’applicazione o un gioco in esecuzione su un dispositivo IoT, un set-top box, una console di gioco o un desktop e utilizzarli in Customer Journey Analytics. Ti consigliamo vivamente di esaminare le informazioni aggiuntive quando vi fai riferimento.

Configurare uno schema e un set di dati

Per acquisire i dati in Adobe Experience Platform, devi innanzitutto definire quali dati desideri raccogliere. Tutti i dati inseriti in Adobe Experience Platform devono essere conformi a una struttura standard e denormalizzata affinché vengano riconosciuti e utilizzati dalle capacità e funzionalità a valle. Experience Data Model (XDM) è il framework standard che fornisce una struttura sotto forma di schemi.

Una volta definito uno schema, utilizza uno o più set di dati per memorizzare e gestire la raccolta di dati. Un set di dati è un costrutto di archiviazione e gestione per una raccolta di dati (in genere una tabella) che contiene uno schema (colonne) e dei campi (righe).

Tutti i dati inseriti in Adobe Experience Platform devono essere conformi a uno schema predefinito prima di poter essere memorizzati come set di dati.

Configurare uno schema

Desideri tenere traccia di alcuni dati minimi dai profili che giocano al tuo gioco su una console, ad esempio identificazione, punteggi, avanzamento e altre informazioni.
Devi innanzitutto definire uno schema che modella questi dati.

Per configurare lo schema:

Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Schemi in GESTIONE DATI.
Seleziona Crea schema.
.

Nel passaggio Selezionare una classe della procedura guidata Crea schema:

Seleziona Evento esperienza.

Creare uno schema

note info
INFO
Per modellare il comportamento di un profilo (come nome di scena, premere il pulsante per aggiungere al carrello) viene utilizzato uno schema evento esperienza. Per modellare gli attributi del profilo (come nome, e-mail, genere) viene utilizzato uno schema Individual Profile.

Seleziona Avanti.

Nel passaggio Nome e revisione della procedura guidata Crea schema:
1. Immetti un nome visualizzato dello schema per lo schema e (facoltativo) una Descrizione.
2. Seleziona Fine.
Nella scheda Struttura dello schema di esempio:
1. Selezionare + Aggiungi in Gruppi di campi.
  
  I gruppi di campi sono raccolte riutilizzabili di oggetti e attributi che consentono di estendere facilmente lo schema.
2. Nella finestra di dialogo Aggiungi gruppi di campi, seleziona il gruppo di campi Luce accecante dall’elenco. Questo gruppo di campi è stato creato per tenere traccia dei progressi degli utenti durante l’esecuzione di un gioco fittizio intitolato Blinding Light su una console.
  
  Puoi selezionare il pulsante di anteprima per visualizzare un’anteprima dei campi che fanno parte del gruppo di campi, ad esempio scores > afterMatch.
  
  Seleziona Indietro per chiudere l’anteprima.
3. Seleziona Aggiungi gruppi di campi.
Seleziona + accanto al nome schema.

Nel pannello Proprietà campo, immetti identification come Nome campo, Identificazione come Nome visualizzato, seleziona Oggetto come Tipo e seleziona Core ExperienceEvent v2.1 come Gruppo campi.

note
NOTE
Se tale gruppo di campi non è disponibile, cercane un altro contenente campi di identità. Oppure crea un nuovo gruppo di campi e aggiungi nuovi campi di identità (come `ecid`, `crmId` e altri di cui hai bisogno) al gruppo di campi e seleziona il nuovo gruppo di campi.

Oggetto di identificazione

L’oggetto di identificazione aggiunge funzionalità di individuazione dello schema. Nel tuo caso, vuoi identificare i profili che giocano al tuo gioco utilizzando l’Experience Cloud Id e l’indirizzo e-mail che utilizzano per accedere alla loro console di gioco. Sono disponibili molti altri attributi per tenere traccia dell’identificazione della persona.

Seleziona Applica per aggiungere questo oggetto allo schema.

Seleziona il campo ecid nell’oggetto di identificazione appena aggiunto, quindi seleziona Identità e Identità primaria e ECID dall’elenco Spazio dei nomi identità nel pannello di destra.

Stai specificando l’Experience Cloud Identity come identità principale che il servizio Adobe Experience Platform Identity può utilizzare per combinare (unire) il comportamento dei profili con lo stesso ECID.

Seleziona Applica. Nell’attributo ecid viene visualizzata l’icona di un’impronta digitale.
Seleziona il campo email nell’oggetto di identificazione appena aggiunto, quindi seleziona Identity e Email dall’elenco Identity namespace nel pannello Field Properties.

Stai specificando l’indirizzo e-mail come un’altra identità che il servizio Adobe Experience Platform Identity può utilizzare per combinare (unire) il comportamento dei profili.

Seleziona Applica. Nell’attributo e-mail viene visualizzata l’icona di un’impronta digitale.

Seleziona Salva.

Seleziona l’elemento principale dello schema con il nome dello schema, quindi seleziona l’opzione Profilo.

Viene richiesto di abilitare lo schema per il profilo. Una volta abilitato, quando i dati vengono inseriti in set di dati basati su questo schema, tali dati vengono uniti su Real-Time Customer Profile.

Per ulteriori informazioni, consulta la sezione Abilitare lo schema per l’utilizzo in Real-Time Customer Profile.

note important
IMPORTANT
Una volta salvato uno schema abilitato per il profilo, non è più possibile disattivarlo per il profilo.

Abilitare lo schema per il profilo

Seleziona Salva per salvare lo schema.

Hai creato uno schema minimo che modella i dati che puoi acquisire dal gioco. Lo schema consente di identificare i profili utilizzando Experience Cloud Identity e l’indirizzo e-mail. Attivando lo schema per il profilo, puoi garantire che i dati acquisiti dal gioco da console vengano aggiunti al Profilo cliente in tempo reale.

Oltre ai dati sul comportamento, puoi anche acquisire i dati degli attributi del profilo dalla console (ad esempio i dettagli dei profili connessi alla console).

Per acquisire i dati del profilo:

Crea uno schema basato sulla classe di profilo individuale XDM.
Aggiungi il gruppo di campi Profile Core v2 allo schema.
Aggiungi un oggetto di identificazione basato sul gruppo di campi Profile Core v2.
Definisci l’ID Experience Cloud come identificatore principale e l’e-mail come identificatore.
Abilitare lo schema per il profilo

Per ulteriori informazioni sull’aggiunta e la rimozione di gruppi di campi e singoli campi a uno schema, consulta la sezione Creare e modificare schemi nell’interfaccia utente.

Configurare un set di dati

Con lo schema, hai definito il modello dati. Ora devi definire il costrutto per memorizzare e gestire tali dati utilizzando i set di dati.

Per configurare il set di dati:

Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Set di dati in GESTIONE DATI.
Seleziona Crea set di dati.
Seleziona Crea set di dati dallo schema.
Seleziona lo schema creato in precedenza e seleziona Successivo.
Assegna un nome al set di dati e (facoltativamente) fornisci una descrizione.
Seleziona Fine.

Selezionare l’opzione Profilo.

Viene richiesto di abilitare il set di dati per il profilo. Una volta abilitato, il set di dati arricchisce i profili dei clienti in tempo reale con i relativi dati inseriti.

note important
IMPORTANT
Puoi abilitare un set di dati per il profilo solo quando lo schema a cui aderisce il set di dati è abilitato anche per il profilo.

Abilitare lo schema per il profilo

Per ulteriori informazioni su come visualizzare, visualizzare in anteprima, creare, eliminare un set di dati, consulta la sezione Guida all’interfaccia utente dei set di dati. E come abilitare un set di dati per Real-Time Customer Profile.

Configurare un flusso di dati

Un flusso di dati rappresenta la configurazione lato server durante l’implementazione degli SDK Adobe Experience Platform Web e Mobile e dell’API server di Adobe Experience Platform Edge Network. Durante la raccolta dei dati con gli SDK di Adobe Experience Platform e le API server di Edge Network, i dati vengono inviati a Adobe Experience Platform Edge Network. È il flusso di dati che determina a quali servizi vengono inoltrati i dati.

Nella configurazione, desideri che i dati raccolti dal gioco vengano inviati al set di dati in Adobe Experience Platform.

Per impostare il flusso di dati:

Nell’interfaccia utente di Adobe Experience Platform, seleziona Datastreams da DATA COLLECTION nella barra a sinistra.
Seleziona Nuovo flusso di dati.
Assegna un nome e una descrizione al tuo flusso di dati. Seleziona lo schema dall’elenco Schema evento.
Seleziona Salva.
Selezionare Aggiungi servizio.
Nella schermata Aggiungi servizio:
1. Selezionare Adobe Experience Platform dall’elenco Service.
2. Assicurarsi che Enabled sia selezionato.
3. Seleziona il set di dati dall’elenco Set di dati evento.
4. Lascia le altre impostazioni e seleziona Salva per salvare lo stream di dati.

Il flusso di dati è ora configurato per inoltrare i dati raccolti dal gioco al set di dati in Adobe Experience Platform.

Per ulteriori informazioni su come configurare un flusso di dati e come gestire i dati sensibili consulta la sezione Panoramica dei flussi di dati.

Utilizzare l’API server di Edge Network

Durante lo sviluppo del gioco, puoi aggiungere chiamate pertinenti all’API server di Adobe Experience Platform Edge Network, se necessario.

Ad esempio, per aggiornare il punteggio del lettore, puoi utilizzare:

curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
   "event": {
      "xdm": {
         "identityMap": {
            "Email_LC_SHA256": [
               {
                  "id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
                  "primary": true
               }
            ]
         },
         "eventType": "game.scoreUpdate",
         "{sandbox}": {
            "scores": {
               "afterMatch": 132391",
            }
         },
         "timestamp": "2021-08-09T14:09:20.859Z"
      }
   }
}'

Nell’esempio di richiesta POST, {DATASTREAM_ID} punta all’identificatore dello stream di dati di esempio configurato in precedenza. {sandbox} è il nome univoco della sandbox che identifica il percorso del gruppo di campi Luce accecante personalizzato.

Per ulteriori informazioni sull’utilizzo dell’API server di Edge Network, vedere Raccolta dati interattiva e Raccolta dati non interattiva.

Configurare una connessione

Per utilizzare i dati di Adobe Experience Platform in Customer Journey Analytics, crea una connessione che include i dati risultanti dalla configurazione dello schema, del set di dati e del flusso di lavoro.

Una connessione consente di integrare set di dati da Adobe Experience Platform in Workspace. Per creare rapporti su questi set di dati, devi prima stabilire una connessione tra i set di dati in Adobe Experience Platform e Workspace.

Per creare la connessione:

Nell’interfaccia utente di Customer Journey Analytics, seleziona Connessioni, facoltativamente da Gestione dati, nel menu principale.
Seleziona Crea nuova connessione.
Nella schermata Connessione senza titolo:

Denomina e descrivi la connessione in Impostazioni connessione.

Selezionare la sandbox corretta dall’elenco Sandbox in Impostazioni dati e selezionare il numero di eventi giornalieri dall’elenco Numero medio di eventi giornalieri.

Seleziona Aggiungi set di dati.

Nel passaggio Seleziona set di dati in Aggiungi set di dati:
- Seleziona i set di dati creati in precedenza e/o altri set di dati rilevanti che desideri includere nella connessione
- Seleziona Avanti.
Nel passaggio Impostazioni set di dati in Aggiungi set di dati:
- Per ogni set di dati:
  - Seleziona un ID persona dalle identità disponibili definite negli schemi di set di dati in Adobe Experience Platform.
  - Selezionare l’origine dati corretta dall’elenco Tipo origine dati. Se si specifica Altro, aggiungere una descrizione per l’origine dati.
  - Imposta Importa tutti i nuovi dati e Recupera i dati esistenti del set di dati in base alle tue preferenze.
- Seleziona Aggiungi set di dati.
Seleziona Salva.

Per ulteriori informazioni su come creare e gestire una connessione e come selezionare e combinare i set di dati, consulta la sezione Panoramica delle connessioni.

Configurare una visualizzazione dati

Una visualizzazione dati è un contenitore specifico di Customer Journey Analytics che consente di determinare come interpretare i dati da una connessione. Specifica tutte le dimensioni e le metriche disponibili in Analysis Workspace, e da quali colonne tali dimensioni e metriche ottengono i loro dati. Le visualizzazioni dati sono definite in preparazione alle attività di reporting in Analysis Workspace.

Per creare la visualizzazione dati:

Nell’interfaccia utente di Customer Journey Analytics, seleziona Visualizzazioni dati, facoltativamente da Gestione dati, nel menu principale.
Selezionare Crea nuova visualizzazione dati.
Nel passaggio Configura:

Selezionare la connessione dall’elenco Connessione.

Assegna un nome e (facoltativamente) una descrizione alla connessione.

Seleziona Salva e continua.
Nel passaggio Componenti:

Aggiungi qualsiasi campo schema e/o componente standard da includere nelle caselle dei componenti METRICS o DIMENSIONS.

Seleziona Salva e continua.
Nel passaggio Impostazioni:

Lasciare le impostazioni immutate e selezionare Salva e termina.

Consulta Panoramica delle visualizzazioni dati per ulteriori informazioni su come creare e modificare una visualizzazione dati, quali componenti sono disponibili per l’utilizzo nella visualizzazione dati e come utilizzare le impostazioni di segmenti e sessioni.

Configurare un progetto

Analysis Workspace è uno strumento basato su browser flessibile che consente di creare rapidamente le analisi e condividere i dati rilevati sulla base dei tuoi dati. Usa i progetti Workspace per combinare componenti dati, tabelle e visualizzazioni per sviluppare analisi da condividere con altri nella tua organizzazione.

Per creare il progetto:

Nell’interfaccia utente di Customer Journey Analytics, seleziona Progetti nel menu principale.
Seleziona Progetti nel menu di navigazione a sinistra.
Seleziona Crea progetto.

Seleziona Progetto vuoto.
Seleziona la visualizzazione dati dall’elenco.

.
Per creare il primo rapporto, inizia a trascinare dimensioni e metriche sulla tabella a forma libera nel pannello.

Per ulteriori informazioni su come creare progetti e generare analisi utilizzando componenti, visualizzazioni e pannelli, consulta la sezione Panoramica di Analysis Workspace.

SUCCESS

Hai completato tutti i passaggi. A partire dalla definizione dei dati da raccogliere (schema) e della posizione in cui memorizzarli (set di dati) in Adobe Experience Platform. Hai configurato un flusso di dati in Edge Network per garantire che i dati possano essere inoltrati a tale set di dati. Poi hai utilizzato l’API server di Edge Network per inviare tali dati allo stream di dati. Hai definito una connessione in Customer Journey Analytics per utilizzare i tuoi dati di gioco e altri dati. La definizione della visualizzazione dati ti consente di specificare la dimensione e le metriche da utilizzare; infine, hai creato il tuo primo progetto per visualizzare e analizzare i dati del gioco.

recommendation-more-help

analytics-platform-help-main