Acquisire e utilizzare i tipi di pubblico di Experience Platform
Questo caso d’uso descrive una soluzione provvisoria per acquisire il pubblico di Experience Platform in Customer Journey Analytics. Questi tipi di pubblico possono essere stati creati nel Generatore di segmenti di Experience Platform, o in Adobe Audience Manager, o in altri strumenti e sono memorizzati nel Profilo cliente in tempo reale. I tipi di pubblico sono costituiti da un set di ID profilo, insieme a tutti gli attributi, gli eventi e altro ancora applicabili. Desideri inserire i dati sul pubblico in Customer Journey Analytics per ulteriori analisi.
Prerequisiti
- Accesso a Experience Platform, in particolare al profilo cliente in tempo reale.
- Accesso per creare e gestire schemi e set di dati di Experience Platform.
- Accesso a Experience Platform Query Service (e possibilità di scrivere codice SQL).
- Accesso a uno strumento in grado di eseguire alcune trasformazioni di dati.
- Accesso a Customer Journey Analytics. Devi essere un amministratore di prodotto Customer Journey Analytics per creare e modificare connessioni e visualizzazioni dati di Customer Journey Analytics.
- Autenticazione e accesso alle API di Experience Platform (API Catalog Service e API Segmentation Service). Devi creare un progetto nella Console per sviluppatori dell’organizzazione e nella sandbox e assicurarti di disporre delle informazioni necessarie per inviare correttamente le chiamate API.
Passaggi
La soluzione provvisoria prevede i seguenti passaggi:
- Seleziona tipi di pubblico (interfaccia utente di Experience Platform).
- Crea un set di dati abilitato per il profilo (API Experience Platform).
- Esporta tipi di pubblico (API di Experience Platform).
- Trasforma l'output (Experience Platform UI e altro).
- Creare uno schema e un set di dati (interfaccia utente di Experience Platform).
- Aggiungere o modificare una connessione (interfaccia utente di Customer Journey Analytics).
- Configurare una visualizzazione dati (interfaccia utente di Customer Journey Analytics).
- Report and analyze (Interfaccia utente di Customer Journey Analytics).
Seleziona i tipi di pubblico
La soluzione inizia con l’identificazione dei tipi di pubblico che desideri acquisire in Customer Journey Analytics.
Nell’interfaccia utente di Experience Platform:
-
Selezionare Customer >
-
Selezionare Browse e cercare i tipi di pubblico da acquisire e utilizzare in Customer Journey Analytics. Prendi nota di Audience Id per ciascuno dei tipi di pubblico per un utilizzo successivo.
Creare un set di dati abilitato per il profilo
È necessario creare un set di dati basato sullo schema XDM Individual Profile basato su core. Non è possibile selezionare tale profilo individuale XDM basato su core come schema quando si crea un set di dati nell’interfaccia utente di Experience Platform. Utilizza invece l'API Catalog Service per creare un set di dati basato sullo schema _xdm.context.profile__union
.
Richiesta
code language-shell |
---|
|
Dove:
DATASET_NAME
è il nome descrittivo del set di dati. Ad esempio:Segment Export Job Dataset for CJA
.
Risposta
code language-json |
---|
|
Dove:
DATASET_ID
è l'identificatore del set di dati creato.
Esporta tipi di pubblico
Esporta il pubblico selezionato nel set di dati appena creato. Utilizza l'API del servizio di segmentazione per creare un processo di esportazione che invia i tipi di pubblico al set di dati.
code language-shell |
---|
|
Dove
COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES
potrebbe essere_demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName
. Assicurati di includere almeno i campi rilevanti (come personID (e-mail)) che desideri utilizzare nell’analisi del Percorso di clienti.AUDIENCE_ID_x
sono gli identificatori dei tipi di pubblico che desideri esportare.DATASET_ID
è il set di dati creato.
Risposta
code language-json |
---|
|
Dove
EXPORT_JOB_ID
è l'identificatore del processo di esportazione.
Utilizza l'API del servizio di segmentazione per controllare lo stato del processo di esportazione.
Richiesta
code language-shell |
---|
|
Risposta
code language-json |
---|
|
Dopo il completamento del processo di esportazione, verifica se il set di dati contiene batch correttamente acquisiti.
Nell’interfaccia utente di Experience Platform:
-
Selezionare Data Management >
-
Selezionare il set di dati creato, ad esempio: Segment Export Job Dataset for CJA.
-
Verifica i batch acquisiti. Se il set di dati contiene batch non riusciti, utilizzare Data Management >
-
Copia il Table name del set di dati. Esempio: segment_export_job_dataset_for_cja. Usa questo nome nel passaggio successivo.
Trasforma l’output
Il formato dei dati nel set di dati non è corretto per Customer Journey Analytics. Per trasformare i dati, utilizza Experience Platform Query Service per recuperarli.
Utilizza un client PSQL che si connette a Experience Platform Query Service.
Nell’interfaccia utente di Experience Platform:
- Selezionare Data Management >
- Selezionare
Utilizzare le credenziali per configurare il client PSQL per la connessione a Customer Journey Analytics Query Service.
Query
Esegui questa query per recuperare i dati del pubblico dal set di dati:
code language-sql |
---|
|
Dove:
IDENTITY_TO_USE_AS_PERSON_ID
è uno dei campi definiti come parte del processo di esportazione. Ad esempio:_demoemea.identification.core.email
.DATASET_TABLE_NAME
è il nome della tabella del set di dati.AUDIENCE_ID_x
sono i tipi di pubblico definiti come parte del processo di esportazione. È necessario specificare questi tipi di pubblico ancora una volta, in quanto la specifica nel processo di esportazione è un filtro a livello di riga. Tale filtro a livello di riga restituisce profili per i segmenti specificati con tutte le appartenenze al segmento per ciascuno dei profili.
Risultati
Il risultato della query, in formato JSON, dovrebbe essere simile al seguente:
code language-json |
---|
|
Dove:
PERSON_ID_x
sono i valori dell'identificatore da utilizzare come ID persona. Ad esempio,john.doe@gmail.com
quando si utilizza la posta elettronica.AUDIENCE_ID_x
sono gli identificatori del pubblico.
È necessario trasformare questi dati JSON per aggiungere il nome tenant dell’ambiente e fornire un nome più semplice per il pubblico.
Il JSON finale sarà simile al seguente:
code language-json |
---|
|
Dove:
TENANT_NAME
è il nome del tenant. Ad esempio:_demoemea
.PERSON_ID_x
sono i valori dell'identificatore che si desidera utilizzare come ID persona. Ad esempio,john.doe@gmail.com
quando si utilizza la posta elettronica.AUDIENCE_ID_x
sono gli identificatori del pubblico.AUDIENCE_FRIENDLY_NAME_x
sono nomi descrittivi di pubblico per gli ID pubblico. Ad esempio:Luma - Blue+ Members
.
Utilizza lo strumento preferito per trasformare il JSON originale in questo formato.
Creare uno schema e un set di dati
Per utilizzare il JSON trasformato come dati del pubblico esportati in Customer Journey Analytics, è necessario creare uno schema dedicato.
Per creare lo schema:
Nell’interfaccia utente di Experience Platform:
-
Selezionare Data Management >
-
Selezionare
-
Selezionare Manual nella finestra di dialogo Create a schema e utilizzare Select per continuare.
-
Nella procedura guidata Create schema, nel passaggio Select a class:
- Seleziona Individual Profile (Aggiungi set di dati).
- Seleziona Next (Salva).
-
Nella procedura guidata Create schema, nel passaggio Name and review:
- Immetti Schema display name. Ad esempio:
Audience Export for CJA Schema
. - (facoltativo) Immettere Description.
- Seleziona Finish.
- Immetti Schema display name. Ad esempio:
-
Impostare lo schema in modo che contenga un gruppo di campi personalizzato, denominato ad esempio Audience Membership, contenente due campi denominati audienceMembershipId e audienceMembershipName.
-
Assicurarsi che il campo personID sia un Identity, Primary Identity e che abbia Email come Identity namespace.
-
Apply tutte le modifiche. Selezionare Save per salvare lo schema.
Crea un set di dati e utilizzalo per acquisire i dati JSON trasformati.
Nell’interfaccia utente di Experience Platform:
-
Selezionare Data Management >
-
Selezionare
-
Seleziona Create dataset from schema.
-
Nella procedura guidata Create dataset from schema, nel passaggio Select schema:
- Seleziona lo schema appena creato. Ad esempio: Audience Export for CJA Schema.
- Seleziona Next.
-
Nella procedura guidata Create dataset from schema, nel passaggio Configure dataset:
- Immetti Name per il set di dati.
- (facoltativo) Immetti Description per il set di dati.
- Seleziona Finish.
-
In Datasets > nome del set di dati, trascina il file di dati JSON trasformato e rilascia il file in Drag and drop files. Questa azione avvia l’acquisizione dei dati JSON esportati nel set di dati.
-
Verifica i batch acquisiti. Se il set di dati contiene batch non riusciti, utilizzare Data Management >
Aggiungere o modificare una connessione
Una volta acquisiti correttamente i dati JSON trasformati che contengono i dati sul pubblico da Experience Platform, puoi aggiungere il set di dati a una connessione nuova o esistente in Customer Journey Analytics.
Nell’interfaccia utente di Customer Journey Analytics:
-
Seleziona Data Management > Connections.
-
Crea una nuova connessione/ Definisci Connection settings e Data settings. In alternativa, selezionare una connessione esistente e utilizzare
-
Selezionare
-
Seleziona il set di dati creato e in cui sono stati acquisiti i dati JSON trasformati.
-
Configura il set di dati. Ad esempio:
-
Save connessione.
Configurare una visualizzazione dati
Configura una visualizzazione dati per la connessione appena creata o modificata.
-
Seleziona Data Management > Data views.
-
Modificare una visualizzazione dati esistente o crearne una nuova.
-
Nella scheda Components della visualizzazione dati, accertati che Audience Membership Id e Audience Membership Name siano aggiunti come componenti dimensione.
-
Selezionare Save and Continue per salvare la visualizzazione dati.
Report e analisi
Infine, utilizza Analysis Workspace per creare rapporti sui dati del pubblico di Experience Platform in uno o più pannelli che utilizzano la visualizzazione dati con i componenti di appartenenza al pubblico come audienceMembershipId
, audienceMembershipIdName
e personID
.
Note aggiuntive
-
Esegui questo processo a cadenza regolare, in modo che i dati del pubblico vengano costantemente aggiornati in Customer Journey Analytics.
-
Puoi importare più tipi di pubblico all’interno di una singola connessione Customer Journey Analytics. Il processo sarà un po’ più complesso, ma è possibile. Dovrai apportare alcune modifiche al processo di cui sopra:
- Esegui questo processo per ogni pubblico desiderato nella raccolta di tipi di pubblico in RTCP.
- Customer Journey Analytics supporta array/array di oggetti nei set di dati profilo. L'utilizzo di un array di oggetti per
audienceMembershipId
oaudienceMembershipIdName
è l'opzione migliore. - Nella visualizzazione dati, crea una nuova dimensione utilizzando la trasformazione Substring (Sottostringa) nel campo
audienceMembershipId
per convertire la stringa di valori separati da virgola in un array. NOTA: attualmente un array può contenere un massimo di 10 valori. - È ora possibile creare rapporti sulla nuova dimensione
audienceMembershipIds
in Customer Journey Analytics Workspace.