Vous êtes ici :
Modèle de collaboration personnalisé Identity Boost
Le modèle de collaboration personnalisé Identity boost est une configuration JSON qui prend en charge les cas d'utilisation d'enrichissement de l'identité dans Data 360 Clean Rooms. Utilisez ce modèle pour enrichir vos données individuelles tierces avec des attributs d'identité tiers, tels que des ID réels de fournisseurs de résolution de l'identité, dans un environnement sécurisé.
Vue d'ensemble du modèle
Le modèle de collaboration personnalisé Identity boost inclut les champs ci-dessous.
| Nom du champ | Type de données | Exigence | Description |
|---|---|---|---|
name |
chaîne | Obligatoire | Le nom du modèle de collaboration. Pour booster l'identité, la valeur est MatchBoost. |
description |
chaîne | Facultatif | Une courte description du modèle de collaboration. |
tables |
object | Obligatoire | Les tableaux d'entrée utilisés dans la requête de collaboration. Contient la configuration du tableau de FirstPartyDataSet. |
queries |
object | Obligatoire | Les requêtes exécutées dans la collaboration en salle blanche pour prendre en charge le cas d'utilisation. |
useCaseConfigs |
object | Obligatoire | Les configurations spécifiques au cas d'utilisation qui définissent les points de contact pris en charge et les mappages d'objets de sortie pour l'enrichissement de l'identité. |
Configurations de tableau
Chaque tableau d'entrée utilisé par la requête doit être défini dans le champ tables. La propriété tableConfigs est un tableau qui peut contenir plusieurs définitions de tableau.
tableConfigs(tableau, obligatoire) : une liste de définitions de tableau. Chaque entrée représente une configuration de tableau. Le modèle Identity boost inclut une configuration de tableau, mais vous pouvez ajouter des tableaux supplémentaires si nécessaire.
| Nom du champ | Type de données | Exigence | Valeurs acceptées | Description |
|---|---|---|---|---|
name |
chaîne | Obligatoire | n.a. | Le nom du tableau. Valeur : FirstPartyDataSet. |
description |
chaîne | Facultatif | n.a. | Une courte description du tableau. Valeur : Jeu de données contenant des informations de première partie |
role |
chaîne | Obligatoire | Fournisseur ou consommateur | Le rôle qui partage le tableau dans la collaboration. Valeur : Consommateur. |
columns |
array | Obligatoire | n.a. | Le schéma du tableau. Chaque objet colonne définit un champ dans le tableau. |
Configurations de requête
La section Requêtes définit toutes les requêtes autorisées dans le jeu de données combiné en salle blanche. Le modèle Identity boost inclut une requête via la propriété queryConfigs.
queryConfigs(tableau, obligatoire) : une liste de configurations de requête. Le modèle Identity boost inclut une configuration de requête.
| Nom du champ | Type de données | Exigence | Valeurs acceptées | Description |
|---|---|---|---|---|
name |
chaîne | Obligatoire | n.a. | Le nom de la requête. Valeur : MatchBoost. |
useCase |
chaîne | Obligatoire | MatchBoost | Le cas d'utilisation pris en charge par cette requête. Valeur : MatchBoost. |
description |
chaîne | Facultatif | n.a. | Une courte description de la requête. Valeur : Enrichissez le jeu de données tiers en utilisant des données tierces. |
type |
chaîne | Obligatoire | SQL | Le type de requête. Valeur : null (déterminé à l'exécution). |
source |
chaîne | Obligatoire | n.a. | Le texte réel de la requête SQL. Valeur : null (déterminé à l'exécution). |
queryParameters |
object | Facultatif | n.a. | Les paramètres dynamiques utilisés dans la requête. Valeur : null. |
referencedTables |
tableau de chaînes | Obligatoire | n.a. | Une liste de tous les tableaux que la requête référence. Valeur : ["FirstPartyDataSet"]. |
Configurations de cas d'utilisation MatchBoost
La section useCaseConfigs définit les paramètres spécifiques au cas d'utilisation pour l'enrichissement de l'identité, notamment les points de contact pris en charge et les mappages d'objets de sortie.
| Nom du champ | Type de données | Exigence | Description |
|---|---|---|---|
useCaseType |
chaîne | Obligatoire | Le type de cas d'utilisation. Valeur : MatchBoost. |
supportedContactPoints |
tableau de chaînes | Obligatoire | Les types de point de contact utilisés pour mapper et enrichir vos données. Le modèle Identity boost prend en charge Email et PhoneNumber. |
outputObjects |
object | Obligatoire | Définit où Data 360 écrit les données enrichies dans votre organisation. |
Objets de sortie
La section outputObjects indique à Data 360 où écrire les données d'identité enrichies. Lorsque la requête en salle blanche est exécutée, elle crée trois types de sortie :
- Un tableau de pont qui connecte vos ID de client d'origine aux ID réels enrichis du fournisseur d'identité
- Enregistrements Individu enrichi qui lient les ID réels à vos objets Individu Data 360
- Enregistrements de point de contact enrichis qui lient les ID réels à vos objets ContactPointEmail Data 360
Le modèle définit trois objets de sortie qui fonctionnent ensemble pour stocker ces données enrichies.
outputObjectConfigs(tableau, obligatoire) : une liste de configurations d'objet de sortie. Chaque entrée définit l'emplacement où Data 360 stocke un type de données enrichies.
| Nom du champ | Type de données | Exigence | Description |
|---|---|---|---|
objectName |
chaîne | Obligatoire | Le nom de l'objet personnalisé créé dans votre organisation Data 360 pour stocker la sortie. |
bridgeTable |
object | Facultatif | Utilisé pour le tableau de mappage qui connecte vos ID sources à des ID réels. Contient la propriété sourceIdFieldName. |
relatedTable |
object | Facultatif | Utilisé pour les tableaux de données enrichis qui pointent vers des objets Data 360 standard. Contient les sourceObjectName (objet Data 360 vers lequel lier) et les pathFromBridgeTable (comment joindre les tableaux). |
SAMPLE_BRIDGE_TABLE
Cette sortie crée un tableau de mappage entre vos identifiants clients et les ID réels du fournisseur d'identité.
| Champ | Valeur | Description |
|---|---|---|
objectName |
SAMPLE_BRIDGE_TABLE |
Le nom de l'objet Tableau de pont dans votre organisation. |
bridgeTable.sourceIdFieldName |
SourceId__c |
Le champ qui stocke votre ID de client d'origine. |
relatedTable |
null |
Il s'agit d'un tableau de pont, non lié à un objet Data 360. |
SAMPLE_INDV_BOOSTED
Cette sortie crée des enregistrements Individu enrichis et les lie à vos objets Individu Data 360.
| Champ | Valeur | Description |
|---|---|---|
objectName |
SAMPLE_INDV_BOOSTED |
Le nom de l'objet Individu enrichi dans votre organisation. |
bridgeTable |
null |
Pas une table de bridge. |
relatedTable.sourceObjectName |
ssot__Individual__dlm |
Lie les données enrichies à l'objet modèle de données Individu dans Data 360. |
relatedTable.pathFromBridgeTable |
Chemin des relations | Utilise l'ID réel pour connecter des données individuelles enrichies à vos individus Data 360. |
CONTACTEMAIL_BOOSTED
Cette sortie crée des enregistrements d'e-mail de contact enrichis et les lie à vos objets ContactPointEmail Data 360.
| Champ | Valeur | Description |
|---|---|---|
objectName |
CONTACTEMAIL_BOOSTED |
Le nom de l'objet E-mail de contact enrichi dans votre organisation. |
bridgeTable |
null |
Pas une table de bridge. |
relatedTable.sourceObjectName |
ssot__ContactPointEmail__dlm |
Lie les données enrichies au DMO ContactPointEmail dans Data 360. |
relatedTable.pathFromBridgeTable |
Chemin des relations | Utilise l'ID réel et l'ID de partie pour connecter des données d'e-mail enrichies à vos enregistrements ContactPointEmail Data 360. |
pathFromBridgeTable définit comment joindre les tableaux de données enrichis aux objets tableau de pont et Data 360. Il spécifie les champs à utiliser en tant que clés lors de la connexion des enregistrements.Exemple de scénario
Mappage de tableau de pont : Si votre ID de client est CUST12345, le tableau de pont crée un enregistrement qui connecte CUST12345 à l'ID réel REAL98765 enrichi.
Enregistrements Individu enrichi : L'enregistrement Individu enrichi pour Real ID REAL98765 est lié à votre enregistrement Individu existant dans Data 360.
Enregistrements d'e-mail de contact enrichis : L'enregistrement d'e-mail enrichi pour Real ID REAL98765 est lié à l'adresse e-mail correspondante dans votre objet ContactPointEmail Data 360.
- Exemple de JSON de modèle personnalisé Identity Boost
Copiez le code du modèle ci-dessous ou téléchargez-le directement dans Data 360 pour commencer à créer votre modèle personnalisé pour le cas d'utilisation Identity boost. Complétez les champs obligatoires et facultatifs avec les valeurs appropriées.
