Inserire e utilizzare i dati in streaming

Questa guida introduttiva spiega come inserire dati in streaming in Adobe Experience Platform e utilizzarli in Customer Journey Analytics.

A questo scopo, è necessario:

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

  • Usare il connettore di origine API HTTP per inviare facilmente i dati nel set di dati configurato in Adobe Experience Platform.

  • 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 dati in streaming in Adobe Experience Platform 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 questa 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

Per questa introduzione, immagina di voler raccogliere alcuni dati relativi alla fidelizzazione, ad esempio ID di fidelizzazione, punti di fidelizzazione e stato di fidelizzazione.
Devi innanzitutto definire uno schema che modella questi dati.

Per configurare lo schema:

  1. Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Schemas (Schemi) all’interno di DATA MANAGEMENT (GESTIONE DATI).

  2. Selezionare Create schema.
    .

  3. Nel passaggio Selezionare una classe della procedura guidata Crea schema:

    1. Seleziona Individual Profile.

      Creare uno schema

      note info
      INFO
      Lo schema Experience Event viene utilizzato per modellare il comportamento di un profilo (come nome di scena, pulsante da aggiungere al carrello). Per modellare gli attributi del profilo (come nome, e-mail, genere) viene utilizzato uno schema Individual Profile.
    2. Seleziona Next.

  4. In Name and review step della procedura guidata Create schema:

    1. Immetti Schema display name per lo schema e (facoltativo) Description.

      Assegnare un nome allo schema

    2. Seleziona Finish.

  5. Nella scheda Struttura dello schema di esempio:

    1. Seleziona + Add (Aggiungi) in Field groups (Gruppi di campi).

      Aggiungere un gruppo di campi

      I gruppi di campi sono raccolte riutilizzabili di oggetti e attributi che consentono di estendere facilmente gli schemi.

    2. Nella finestra di dialogo Add fields groups (Aggiungi gruppi di campi) seleziona il gruppo di campi Loyalty Details dall’elenco.

      AEP Web SDK ExperienceEvent fieldgroup

      Puoi selezionare il pulsante di anteprima per visualizzare un’anteprima dei campi che fanno parte del gruppo di campi.

      Anteprima AEP Web SDK ExperienceEvent fieldgroup

      Seleziona Back (Indietro) per chiudere l’anteprima.

    3. Seleziona Add field groups (Aggiungi gruppi di campi).

  6. Seleziona + accanto al nome dello schema nel pannello Structure (Struttura).

    Pulsante per l’aggiunta di campi nello schema di esempio

  7. Nel pannello Field Properties (Proprietà campo), inserisci Identification come nome, Identification (Identificazione) come Display name (Nome di visualizzazione), seleziona Object (Oggetto) come Type (Tipo) e seleziona Profile Core v2 come Field Group (Gruppo di campo).

    Oggetto di identificazione

    Questo oggetto di identificazione aggiunge funzionalità di identificazione allo schema. Nel tuo caso, immagina di voler identificare le informazioni sulla fidelizzazione utilizzando l’indirizzo e-mail nei tuoi dati batch.

    Seleziona Apply (Applica) per aggiungere questo oggetto allo schema.

  8. Seleziona il campo email nell’oggetto di identificazione appena aggiunto e seleziona Identity (identità) e Email dall’elenco Identity namespace (Spazio dei nomi dell’identità) nel pannello Field Properties (Proprietà campo).

    Specificare l’e-mail come identità

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

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

  9. Seleziona il livello principale dello schema (con il nome dello schema), quindi seleziona il pulsante Profile (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

  10. Seleziona Save (Salva) per salvare lo schema.

Hai creato uno schema minimo che modella i dati di fidelizzazione che puoi inserire in Adobe Experience Platform. Lo schema consente l’identificazione dei profili tramite l’indirizzo e-mail. Attivando lo schema per il profilo, garantisci che i dati della tua origine di streaming vengano aggiunti a Real-Time Customer Profile.

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, che viene eseguito tramite set di dati.

Per configurare il set di dati:

  1. Nell’interfaccia utente di Adobe Experience Platform, nella barra a sinistra, seleziona Datasets (Set di dati) all’interno di DATA MANAGEMENT (GESTIONE DATI).

  2. Seleziona Create dataset (Crea set di dati).

    Creare un set di dati

  3. Seleziona Create dataset from schema (Crea set di dati da schema).

    Creare un set di dati da uno schema

  4. Seleziona lo schema creato in precedenza e seleziona Next (Avanti).

  5. Assegna un nome al set di dati e (facoltativamente) fornisci una descrizione.

    Assegnare un nome al set di dati

  6. Seleziona Finish (Fine).

  7. Seleziona il pulsante Profile (Profilo).

    Viene richiesto di abilitare il set di dati per il profilo. Una volta attivato, 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 una connessione streaming API HTTP

L’applicazione di origine invia in streaming i dati conformi allo schema creato e al relativo aspetto.

{
    ...
    "_demosystem4": {
        "identification": {
            "core": {
                "email": "abrocking0@blog.com",
                "loyaltyId": "793406",
            }
        }
    },
    "loyalty": {
        "loyaltyID": [
            "793406"
        ],
        "points": 82.16,
        "status": "Silver"
    }
    ...
}

Per inviare questi dati in streaming al set di dati creato, è necessario definire un endpoint di streaming per i dati da inviare a. Un endpoint di streaming viene creato utilizzando un connettore di origine API HTTP.

Per creare un connettore di origine API HTTP:

  1. Nell’interfaccia utente di Experience Platform, seleziona Sources (Origini) sotto CONNECTIONS (CONNESSIONI) nella barra a sinistra.

  2. Seleziona Streaming dall’elenco CATEGORIES (CATEGORIE).

  3. Seleziona Set up (Configura) nel riquadro HTTP API (API HTTP).

    Riquadro di configurazione dell’API HTTP

  4. Nel passaggio Authentication (Autenticazione) della schermata Add data (Aggiungi dati):

    Immetti un nome e una descrizione per la connessione API HTTP.

    Seleziona XDM compatible (Compatibile con XDM) per indicare che i dati in streaming sono compatibili con uno schema XDM esistente.

    Seleziona Connect to source (Connetti a origine). Se la connessione va a buon fine viene visualizzato Connected (Connessione riuscita).

    Autenticazione API HTTP

    Seleziona Next (Avanti) per continuare.

  5. Nel passaggio Dataflow detail (Dettagli del flusso di dati) della schermata Add data (Aggiungi dati):

    Seleziona Existing dataset (Set di dati esistente), seleziona il set di dati dall’elenco dei set di dati e assegna un nome a Dataflow name (Nome del flusso di dati).

    Dettaglio del flusso di dati

    Seleziona Next (Avanti).

  6. Il passaggio Review (Rivedi) nella schermata Add data (Aggiungi dati) fornisce una panoramica della connessione API HTTP.

    Dettaglio del flusso di dati

    Seleziona Finish (Fine).

  7. Viene visualizzata la definizione finale dell’endpoint di streaming API HTTP.

    Endpoint di streaming API HTTP

Puoi copiare l’URL dell’endpoint di streaming e usarlo per configurare la tua applicazione di fidelizzazione per lo streaming dei dati nel set di dati di fidelizzazione di Adobe Experience Platform.

Consulta Creare una connessione streaming API HTTP utilizzando l'interfaccia utente per un tutorial molto più completo che spiega:

  • come utilizzare l’autenticazione,
  • come mappare i dati quando i dati in arrivo non sono compatibili con lo schema XDM e
  • come creare un set di dati nell’ambito della configurazione del connettore di streaming.

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:

  1. Nell’interfaccia utente di Customer Journey Analytics, seleziona Connections (Connessioni) nel pannello di navigazione superiore.

  2. Seleziona Create new connection (Crea uova connessione).

  3. Nella schermata Untitled connection (Connessione senza titolo):

    Assegna un nome e una descrizione alla connessione in Connection Settings (Impostazioni della connessione).

    Seleziona la sandbox corretta dall’elenco Sandbox in Data settings (Impostazioni dati) e seleziona il numero di eventi giornalieri dall’elenco Average number of daily events (Numero medio di eventi giornalieri).

    Impostazioni della connessione

    Seleziona Add datasets (Aggiungi set di dati).

    Nel passaggio Select datasets (Seleziona set di dati) in Add datasets (Aggiungi set di dati):

    • Seleziona il set di dati creato in precedenza (Example Loyalty Dataset (Set di dati di fidelizzazione di esempio)) e qualsiasi altro set di dati da includere nella connessione.

      Aggiungere set di dati

    • Seleziona Next (Avanti).

    Nel passaggio Datasets settings (Impostazioni set di dati) in Add datasets (Aggiungi set di dati):

    • Per ogni set di dati:

      • Seleziona un Person ID (ID persona) tra le identità disponibili definite negli schemi di set di dati in Adobe Experience Platform.

      • Seleziona l’origine dati corretta dall’elenco Data source type (Tipo di origine dati). Se specifichi Other (Altro), aggiungi una descrizione per l’origine dati.

      • Imposta Import all new data (Importa tutti i nuovi dati) e Dataset backfill existing data (Dati esistenti di backfill del set di dati) secondo le tue preferenze.

      Configurare i set di dati

    • Seleziona Add datasets (Aggiungi set di dati).

    Seleziona Save (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:

  1. Nell’interfaccia utente di Customer Journey Analytics, seleziona Data views (Visualizzazioni dati) nel pannello di navigazione superiore.

  2. Seleziona Create new data view (Crea nuova visualizzazione dati).

  3. Nel passaggio Configure (Configura):

    Seleziona la connessione dall’elenco Connection (Connessioni).

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

    Configurare la visualizzazione dati

    Seleziona Save and continue (Salva e continua).

  4. Nel passaggio Components (Componenti):

    Aggiungi qualsiasi campo dello schema e/o componente standard che desideri includere nelle caselle dei componenti METRICS (METRICHE) o DIMENSIONS (DIMENSIONI).

    Componenti della visualizzazione dati

    Seleziona Save and continue (Salva e continua).

  5. Nel passaggio Settings (Impostazioni):

    Impostazioni della visualizzazione dati

    Lascia le impostazioni così come sono e seleziona Save and finish (Salva e fine).

Per ulteriori informazioni su come creare e modificare una visualizzazione dati, quali componenti sono disponibili per la visualizzazione dati e come utilizzare le impostazioni di filtro e sessioni, consulta la sezione Panoramica delle visualizzazioni dati.

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:

  1. Nell’interfaccia utente di Customer Journey Analytics, seleziona Projects (Progetti) nel pannello di navigazione superiore.

  2. Seleziona Projects (Progetti) nel pannello di navigazione a sinistra.

  3. Seleziona Create project (Crea progetto).

    Progetto Workspace

    Seleziona Blank project (Progetto vuoto).

    Workspace - Progetto vuoto

  4. Seleziona la visualizzazione dati dall’elenco.

    Visualizzazione Select Data (Seleziona dati) di Workspace .

  5. Per creare il primo rapporto, inizia a trascinare dimensioni e metriche su Freeform table in Panel. Ad esempio, trascina Program Points Balance e Page View come metriche e email come dimensione per ottenere una panoramica rapida dei profili che hanno visitato il tuo sito Web e che fanno parte del programma di fidelizzazione per la raccolta di punti di fidelizzazione.

    Workspace - Primo rapporto

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. Partendo dalla definizione dei dati di fidelizzazione da raccogliere (schema) e di dove memorizzarli (set di dati) in Adobe Experience Platform, hai configurato un connettore di origine API HTTP per lo streaming dei dati di fidelizzazione direttamente nel set di dati. La definizione della visualizzazione dati ti consente di specificare la dimensione e le metriche da utilizzare e infine hai creato il tuo primo progetto per la visualizzazione e l’analisi dei dati.
recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79