Adobe Experience Platform supporta la possibilità di importare tipi di pubblico esterni, che possono essere successivamente utilizzati come componenti per una nuova definizione di segmento. Questo documento fornisce un’esercitazione per configurare Experience Platform per importare e utilizzare tipi di pubblico esterni.
Questa esercitazione richiede una comprensione approfondita dei vari Adobe Experience Platform servizi coinvolti nella creazione di segmenti di pubblico. Prima di iniziare questa esercitazione, consulta la documentazione relativa ai seguenti servizi:
Prima di iniziare a importare e utilizzare tipi di pubblico esterni, è importante comprendere la differenza tra i dati dei segmenti e i metadati dei segmenti.
I dati dei segmenti si riferiscono ai profili che soddisfano i criteri di qualificazione dei segmenti e quindi fanno parte del pubblico.
I metadati del segmento sono informazioni sul segmento stesso, che includono nome, descrizione, espressione (se applicabile), data di creazione, data dell’ultima modifica e un ID. L’ID collega i metadati del segmento ai singoli profili che soddisfano la qualifica del segmento e fanno parte del pubblico risultante.
Dati del segmento | Metadati del segmento |
---|---|
Profili che soddisfano la qualifica dei segmenti | Informazioni sul segmento stesso |
Il primo passaggio per l’utilizzo di tipi di pubblico esterni consiste nella creazione di uno spazio dei nomi di identità. I namespace di identità consentono a Platform di associare la posizione di origine di un segmento.
Per creare uno spazio dei nomi di identità, segui le istruzioni contenute in guida allo spazio dei nomi identità. Durante la creazione dello spazio dei nomi di identità, aggiungi i dettagli di origine allo spazio dei nomi di identità e contrassegnali Tipo come Identificatore non personale.
Per iniziare a utilizzare namespace personalizzati con tipi di pubblico esterni, dovrai creare un ticket di supporto. Per ulteriori informazioni, contatta il tuo rappresentante Adobe.
Dopo aver creato uno spazio dei nomi di identità, devi creare un nuovo schema per il segmento che creerai.
Per iniziare a comporre uno schema, seleziona prima Schemi sulla barra di navigazione a sinistra, seguita dalla Creare uno schema nell’angolo in alto a destra dell’area di lavoro Schemi. Da qui, seleziona Sfoglia per visualizzare una selezione completa dei tipi di schema disponibili.
Poiché stai creando una definizione di segmento, che è una classe predefinita, seleziona Usa classe esistente. Ora, seleziona la Definizione del segmento classe, seguita da Assegna classe.
Dopo la creazione dello schema, dovrai specificare quale campo conterrà l’ID del segmento. Questo campo deve essere contrassegnato come identità principale e assegnato agli spazi dei nomi creati in precedenza.
Dopo la marcatura _id
come identità principale, seleziona il titolo dello schema, seguito dall’interruttore etichettato Profilo. Seleziona Abilita per abilitare lo schema per Real-time Customer Profile.
Ora, questo schema è abilitato per Profilo, con l’identificazione principale assegnata allo spazio dei nomi dell’identità non persona creato. Di conseguenza, i metadati del segmento importati in Platform utilizzando questo schema verranno acquisiti in Profilo senza essere uniti ad altri dati di profilo relativi alle persone.
Dopo aver configurato lo schema, dovrai creare un set di dati per i metadati del segmento.
Per creare un set di dati, segui le istruzioni nella sezione guida utente del set di dati. Dovresti seguire la Creare un set di dati dallo schema utilizzando lo schema creato in precedenza.
Dopo aver creato il set di dati, continua a seguire le istruzioni in guida utente del set di dati per abilitare questo set di dati per il profilo cliente in tempo reale.
Con il set di dati abilitato, i dati possono ora essere inviati in Platform tramite l’interfaccia utente o utilizzando le API di Experience Platform. Puoi acquisire questi dati tramite una connessione batch o in streaming.
Per creare una connessione batch, è possibile seguire le istruzioni contenute nel modello generico guida all’interfaccia utente per il caricamento locale dei file. Per un elenco completo delle sorgenti disponibili con cui è possibile utilizzare i dati di acquisizione, consulta la sezione panoramica di origini.
Per creare una connessione in streaming, puoi seguire le istruzioni contenute in Esercitazione API o Esercitazione sull’interfaccia utente.
Una volta creata la connessione streaming, avrai accesso all'endpoint streaming univoco a cui puoi inviare i tuoi dati. Per informazioni su come inviare dati a questi endpoint, consulta la sezione esercitazione sullo streaming dei dati di record.
Dopo aver creato una connessione, ora puoi inserire i dati in Platform.
Di seguito è riportato un esempio dei metadati del payload per il pubblico esterno:
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{SEGMENT_ID}",
"description": "Sample description",
"identityMap": {
"{IDENTITY_NAMESPACE}": [{
"id": "{}"
}]
},
"segmentName" : "{SEGMENT_NAME}",
"segmentStatus": "ACTIVE",
"version": "1.0"
}
}
}
Proprietà | Descrizione |
---|---|
schemaRef |
Lo schema deve fai riferimento allo schema creato in precedenza per i metadati del segmento. |
datasetId |
ID set di dati deve fai riferimento al set di dati creato in precedenza per lo schema appena creato. |
xdmEntity._id |
ID deve fai riferimento allo stesso ID segmento utilizzato come pubblico esterno. |
xdmEntity.identityMap |
Questa sezione deve contiene l’etichetta di identità utilizzata per creare lo spazio dei nomi creato in precedenza. |
{IDENTITY_NAMESPACE} |
Etichetta dello spazio dei nomi di identità creato in precedenza. Ad esempio, se hai chiamato il namespace Identity "externalAudience", lo utilizzerai come chiave dell’array. |
segmentName |
Nome del segmento per il quale desideri segmentare il pubblico esterno. |
Una volta configurati i tipi di pubblico importati, possono essere utilizzati come parte del processo di segmentazione. Per trovare tipi di pubblico esterni, vai al Generatore di segmenti e seleziona Tipi di pubblico nella scheda Campi sezione .
Ora che puoi utilizzare tipi di pubblico esterni nei segmenti, puoi utilizzare il Generatore di segmenti per creare segmenti. Per scoprire come creare i segmenti, leggi la sezione esercitazione sulla creazione di segmenti.
Oltre a utilizzare i metadati del pubblico esterno importati e utilizzarli per creare segmenti, puoi anche importare appartenenze di segmenti esterne in Platform.
Per iniziare a comporre uno schema, seleziona prima Schemi sulla barra di navigazione a sinistra, seguita dalla Creare uno schema nell’angolo in alto a destra dell’area di lavoro Schemi. Da qui, seleziona Profilo individuale XDM.
Una volta creato lo schema, è necessario aggiungere il gruppo di campi di appartenenza al segmento come parte dello schema. A questo scopo, seleziona Dettagli di appartenenza al segmento, seguita da Aggiungi gruppi di campi.
Inoltre, assicurati che lo schema sia contrassegnato per Profilo. A questo scopo, è necessario contrassegnare un campo come identità principale.
Dopo aver creato lo schema, dovrai creare un set di dati.
Per creare un set di dati, segui le istruzioni nella sezione guida utente del set di dati. Dovresti seguire la Creare un set di dati dallo schema utilizzando lo schema creato in precedenza.
Dopo aver creato il set di dati, continua a seguire le istruzioni in guida utente del set di dati per abilitare questo set di dati per il profilo cliente in tempo reale.
Con il set di dati abilitato, i dati possono ora essere inviati in Platform tramite l’interfaccia utente o utilizzando le API di Experience Platform. Puoi acquisire questi dati tramite una connessione batch o in streaming.
Per creare una connessione batch, è possibile seguire le istruzioni contenute nel modello generico guida all’interfaccia utente per il caricamento locale dei file. Per un elenco completo delle sorgenti disponibili con cui è possibile utilizzare i dati di acquisizione, consulta la sezione panoramica di origini.
Per creare una connessione in streaming, puoi seguire le istruzioni contenute in Esercitazione API o Esercitazione sull’interfaccia utente.
Una volta creata la connessione streaming, avrai accesso all'endpoint streaming univoco a cui puoi inviare i tuoi dati. Per informazioni su come inviare dati a questi endpoint, consulta la sezione esercitazione sullo streaming dei dati di record.
Dopo aver creato una connessione, ora puoi inserire i dati in Platform.
Di seguito è riportato un esempio del payload per l’appartenenza all’audience esterna:
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience Membership"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{UNIQUE_ID}",
"description": "Sample description",
"{TENANT_NAME}": {
"identities": {
"{SCHEMA_IDENTITY}": "sample-id"
}
},
"personId" : "sample-name",
"segmentMembership": {
"{IDENTITY_NAMESPACE}": {
"{EXTERNAL_IDENTITY}": {
"status": "realized",
"lastQualificationTime": "2022-03-14T:00:00:00Z"
}
}
}
}
}
}
Proprietà | Descrizione |
---|---|
schemaRef |
Lo schema deve fare riferimento allo schema creato in precedenza per i dati di appartenenza al segmento. |
datasetId |
ID set di dati deve fare riferimento al set di dati creato in precedenza per lo schema di appartenenza appena creato. |
xdmEntity._id |
Un ID adatto utilizzato per identificare in modo univoco il record all’interno del set di dati. |
{TENANT_NAME}.identities |
Questa sezione viene utilizzata per collegare il gruppo di campi delle identità personalizzate con gli utenti precedentemente importati. |
segmentMembership.{IDENTITY_NAMESPACE} |
Etichetta dello spazio dei nomi di identità personalizzato creato in precedenza. Ad esempio, se hai chiamato il namespace Identity "externalAudience", lo utilizzerai come chiave dell’array. |