Ti trovi qui:
Modello di collaborazione personalizzato Identity Boost
Il modello di collaborazione personalizzato Identity Boost è una configurazione JSON che supporta i casi d'uso di arricchimento dell'identità nelle Clean Room di Data 360. Utilizzare questo modello per arricchire i dati personali first party con attributi di identità di terze parti, ad esempio ID reali di provider di risoluzione dell'identità, in un ambiente sicuro per la privacy.
Panoramica sui modelli
Il modello di collaborazione personalizzato Identity Boost include questi campi.
| Nome campo | Tipo di dati | Requisito | Descrizione |
|---|---|---|---|
name |
stringa | Obbligatorio | Nome del modello di collaborazione. Per il potenziamento dell'identità, il valore è MatchBoost. |
description |
stringa | Facoltativo | Breve descrizione del modello di collaborazione. |
tables |
object | Obbligatorio | Tabelle di input utilizzate nella query di collaborazione. Contiene la configurazione della tabella di FirstPartyDataSet. |
queries |
object | Obbligatorio | Le query eseguite nella collaborazione nella camera bianca a supporto del caso d'uso. |
useCaseConfigs |
object | Obbligatorio | Le configurazioni specifiche dei casi d'uso che definiscono i punti di contatto supportati e le mappature degli oggetti di output per l'arricchimento dell'identità. |
Configurazioni delle tabelle
Ogni tabella di input utilizzata dalla query deve essere definita nel campo tables. La proprietà tableConfigs è una matrice che può contenere più definizioni di tabella.
tableConfigs(matrice, obbligatoria): elenco di definizioni di tabella. Ogni voce rappresenta una configurazione di tabella. Il modello Identity Boost include una configurazione di tabella, ma è possibile aggiungere altre tabelle in base alle esigenze.
| Nome campo | Tipo di dati | Requisito | Valori ammessi | Descrizione |
|---|---|---|---|---|
name |
stringa | Obbligatorio | N/D | Nome della tabella. Valore: FirstPartyDataSet. |
description |
stringa | Facoltativo | N/D | Breve descrizione della tabella. Valore: Serie di dati contenente informazioni first party. |
role |
stringa | Obbligatorio | Fornitore o consumatore | Il ruolo che condivide la tabella nella collaborazione. Valore: Consumatore. |
columns |
array | Obbligatorio | N/D | Schema della tabella. Ogni oggetto colonna definisce un campo nella tabella. |
Configurazioni delle query
La sezione delle query definisce tutte le query consentite sulla serie di dati combinata nella camera bianca. Il modello Identity Boost include una query tramite la proprietà queryConfigs.
queryConfigs(array, obbligatorio): elenco di configurazioni di query. Il modello Identity Boost include una configurazione di query.
| Nome campo | Tipo di dati | Requisito | Valori ammessi | Descrizione |
|---|---|---|---|---|
name |
stringa | Obbligatorio | N/D | Nome della query. Valore: MatchBoost. |
useCase |
stringa | Obbligatorio | MatchBoost | Caso d'uso supportato da questa query. Valore: MatchBoost. |
description |
stringa | Facoltativo | N/D | Breve descrizione della query. Valore: Arricchire le serie di dati first party utilizzando dati di terze parti. |
type |
stringa | Obbligatorio | SQL | Tipo di query. Valore: null (determinato in fase di esecuzione). |
source |
stringa | Obbligatorio | N/D | Il testo effettivo della query SQL. Valore: null (determinato in fase di esecuzione). |
queryParameters |
object | Facoltativo | N/D | Parametri dinamici utilizzati nella query. Valore: null. |
referencedTables |
matrice di stringhe | Obbligatorio | N/D | Elenco di tutte le tabelle a cui fa riferimento la query. Valore: ["FirstPartyDataSet"]. |
Configurazioni casi d'uso MatchBoost
La sezione useCaseConfigs definisce le impostazioni specifiche del caso d'uso per l'arricchimento dell'identità, inclusi i punti di contatto supportati e le mappature degli oggetti di output.
| Nome campo | Tipo di dati | Requisito | Descrizione |
|---|---|---|---|
useCaseType |
stringa | Obbligatorio | Tipo di caso d'uso. Valore: MatchBoost. |
supportedContactPoints |
matrice di stringhe | Obbligatorio | Tipi di punto di contatto utilizzati per abbinare e arricchire i dati. Il modello Identity Boost supporta Email e PhoneNumber. |
outputObjects |
object | Obbligatorio | Definisce dove Data 360 scrive i dati arricchiti nell'organizzazione. |
Oggetti di output
La sezione outputObjects indica a Data 360 dove scrivere i dati dell'identità arricchita. Quando viene eseguita la query nella camera bianca, vengono creati tre tipi di output:
- Tabella ponte che collega gli ID cliente originali agli ID reali arricchiti del provider di identità
- Record Persona arricchiti che collegano ID reali agli oggetti Persona Data 360
- Record punto di contatto arricchiti che collegano ID reali agli oggetti ContactPointEmail di Data 360
Il modello definisce tre oggetti di output che funzionano insieme per memorizzare questi dati arricchiti.
outputObjectConfigs(array, obbligatorio): elenco delle configurazioni degli oggetti di output. Ogni voce definisce la posizione in cui Data 360 archivia un tipo di dati arricchiti.
| Nome campo | Tipo di dati | Requisito | Descrizione |
|---|---|---|---|
objectName |
stringa | Obbligatorio | Nome dell'oggetto personalizzato creato nell'organizzazione Data 360 per memorizzare l'output. |
bridgeTable |
object | Facoltativo | Utilizzato per la tabella di mappatura che collega gli ID di origine agli ID reali. Contiene la proprietà sourceIdFieldName. |
relatedTable |
object | Facoltativo | Utilizzato per tabelle di dati arricchite che si collegano a oggetti Data 360 standard. Contiene il sourceObjectName (l'oggetto Data 360 a cui collegarsi) e il pathFromBridgeTable (come unire le tabelle). |
TABELLA_PONTE_ESEMPIO
Questo output crea una tabella di mappatura tra gli identificativi cliente e gli ID reali del provider di identità.
| Campo | Valore | Descrizione |
|---|---|---|
objectName |
SAMPLE_BRIDGE_TABLE |
Nome dell'oggetto tabella ponte nell'organizzazione. |
bridgeTable.sourceIdFieldName |
SourceId__c |
Campo in cui è memorizzato l'ID cliente originale. |
relatedTable |
null |
Si tratta di una tabella ponte, non collegata a un oggetto Data 360. |
SAMPLE_INDV_BOOSTED
Questo output crea record Persona arricchiti e li collega agli oggetti Persona Data 360.
| Campo | Valore | Descrizione |
|---|---|---|
objectName |
SAMPLE_INDV_BOOSTED |
Nome dell'oggetto Persona arricchita nell'organizzazione. |
bridgeTable |
null |
Non un tavolo da ponte. |
relatedTable.sourceObjectName |
ssot__Individual__dlm |
Collega i dati arricchiti all'oggetto modello di dati Persona in Data 360. |
relatedTable.pathFromBridgeTable |
Percorso di relazione | Utilizza Real ID per connettere i dati delle persone arricchite alle persone Data 360. |
CONTACTEMAIL_BOOSTED
Questo output crea record email referente arricchiti e li collega agli oggetti ContactPointEmail di Data 360.
| Campo | Valore | Descrizione |
|---|---|---|
objectName |
CONTACTEMAIL_BOOSTED |
Nome dell'oggetto email referente arricchito nell'organizzazione. |
bridgeTable |
null |
Non un tavolo da ponte. |
relatedTable.sourceObjectName |
ssot__ContactPointEmail__dlm |
Collega i dati arricchiti al DMO ContactPointEmail in Data 360. |
relatedTable.pathFromBridgeTable |
Percorso di relazione | Utilizza Real ID e Party ID per connettere i dati email arricchiti ai record ContactPointEmail Data 360. |
pathFromBridgeTable definisce come unire le tabelle di dati arricchite con la tabella bridge e gli oggetti Data 360. Specifica quali campi utilizzare come chiavi quando si collegano i record.Esempio di scenario
Mappatura tabella ponte: Se l'ID cliente è CUST12345, la tabella bridge crea un record che collega CUST12345 all'ID reale arricchito REAL98765.
Record singoli arricchiti: Il record Persona arricchito per ID reale REAL98765 è collegato al record Persona esistente in Data 360.
Record email referente arricchiti: Il record email arricchito per ID reale REAL98765 è collegato all'indirizzo email corrispondente nell'oggetto ContactPointEmail Data 360.
- Esempio di modello personalizzato Identity Boost JSON
Copiare il codice del modello riportato di seguito o scaricarlo direttamente in Data 360 per iniziare a creare il modello personalizzato per il caso d'uso Identity Boost. Compilare i campi obbligatori e facoltativi con i valori appropriati.
