U bent hier:
Aangepaste samenwerkingssjabloon Identiteitsverbetering
De aangepaste samenwerkingssjabloon Identiteitsverbetering is een JSON-configuratie die gebruikscases voor identiteitsverrijking ondersteunt in Data 360 Clean Rooms. Gebruik deze sjabloon om uw eigen gegevens te verrijken met externe identiteitskenmerken, zoals echte ID's van aanbieders van identiteitsoplossing, in een privacyveilige omgeving.
Sjabloonoverzicht
De aangepaste samenwerkingssjabloon Identiteitsboost omvat deze velden.
| Veldnaam | Gegevenstype | Vereiste | Beschrijving |
|---|---|---|---|
name |
tekenreeks | Verplicht | De naam van de samenwerkingssjabloon. Voor identiteitsboost is de waarde MatchBoost. |
description |
tekenreeks | Optioneel | Een korte beschrijving van de samenwerkingssjabloon. |
tables |
object | Verplicht | De invoertabellen die worden gebruikt in de samenwerkingsquery. Bevat de configuratie van de FirstPartyDataSet. |
queries |
object | Verplicht | De query's die worden uitgevoerd in de cleanroomsamenwerking om de gebruikscase te ondersteunen. |
useCaseConfigs |
object | Verplicht | De gebruikscasespecifieke configuraties die ondersteunde aanspreekpunten en toewijzingen van uitvoerobjecten definiëren voor identiteitsverrijking. |
Tabelconfiguraties
Elke invoertabel die door de query wordt gebruikt, moet worden gedefinieerd in het veld tables. De eigenschap tableConfigs is een array die meerdere tabeldefinities kan bevatten.
tableConfigs(array, verplicht) – Een lijst van tabeldefinities. Elk item vertegenwoordigt één tabelconfiguratie. De identiteitsboostsjabloon omvat één tabelconfiguratie, maar u kunt naar behoefte extra tabellen toevoegen.
| Veldnaam | Gegevenstype | Vereiste | Aanvaardde waarden | Beschrijving |
|---|---|---|---|---|
name |
tekenreeks | Verplicht | N.v.t. | De naam van de tabel. Waarde: FirstPartyDataSet. |
description |
tekenreeks | Optioneel | N.v.t. | Een korte beschrijving van de tabel. Waarde: Gegevensset met informatie uit eerste hand. |
role |
tekenreeks | Verplicht | Aanbieder of consument | De rol die de tabel deelt in de samenwerking. Waarde: Consument. |
columns |
array | Verplicht | N.v.t. | Het schema van de tabel. Elk kolomobject definieert een veld in de tabel. |
Queryconfiguraties
De sectie Query's definieert alle query's die zijn toegestaan voor de gecombineerde gegevensset in de cleanroom. De identiteitsboostsjabloon omvat één query via de eigenschap queryConfigs.
queryConfigs(array, verplicht) – Een lijst van queryconfiguraties. De identiteitsboostsjabloon omvat één queryconfiguratie.
| Veldnaam | Gegevenstype | Vereiste | Aanvaardde waarden | Beschrijving |
|---|---|---|---|---|
name |
tekenreeks | Verplicht | N.v.t. | De naam van de query. Waarde: MatchBoost. |
useCase |
tekenreeks | Verplicht | MatchBoost | De gebruikscase die deze query ondersteunt. Waarde: MatchBoost. |
description |
tekenreeks | Optioneel | N.v.t. | Een korte beschrijving van de query. Waarde: Verrijk de gegevensset van de eerste partij met behulp van externe gegevens. |
type |
tekenreeks | Verplicht | SQL | Het type query. Waarde: null (bepaald tijdens run-time). |
source |
tekenreeks | Verplicht | N.v.t. | De feitelijke SQL-querytekst. Waarde: null (bepaald tijdens run-time). |
queryParameters |
object | Optioneel | N.v.t. | De dynamische parameters die in de query worden gebruikt. Waarde: null. |
referencedTables |
array van tekenreeksen | Verplicht | N.v.t. | Een lijst van alle tabellen waarnaar de query verwijst. Waarde: ["FirstPartyDataSet"]. |
MatchBoost-gebruikscaseconfiguraties
De sectie useCaseConfigs definieert de gebruikscasespecifieke instellingen voor identiteitsverrijking, inclusief ondersteunde aanspreekpunten en toewijzingen van uitvoerobjecten.
| Veldnaam | Gegevenstype | Vereiste | Beschrijving |
|---|---|---|---|
useCaseType |
tekenreeks | Verplicht | Het type gebruikscase. Waarde: MatchBoost. |
supportedContactPoints |
array van tekenreeksen | Verplicht | De typen aanspreekpunten die worden gebruikt om uw gegevens te vergelijken en te verrijken. De identiteitsboostsjabloon ondersteunt E-mail en PhoneNumber. |
outputObjects |
object | Verplicht | Definieert waar Data 360 de verrijkte gegevens in uw organisatie schrijft. |
Uitvoerobjecten
De sectie outputObjects vertelt Data 360 waar de verrijkte identiteitsgegevens naartoe moeten worden geschreven. Wanneer de cleanroomquery wordt uitgevoerd, worden er drie typen uitvoer gemaakt:
- Een brugtabel die uw oorspronkelijke klant-ID's verbindt met de verrijkte echte ID's van de identiteitsleverancier
- Verrijkte afzonderlijke records die de echte ID's koppelen aan uw Data 360 Individual-objecten
- Uitgebreide aanspreekpuntrecords die de Real ID's koppelen aan uw Data 360 ContactPointEmail-objecten
De sjabloon definieert drie uitvoerobjecten die samenwerken om deze verrijkte gegevens op te slaan.
outputObjectConfigs(array, verplicht) – Een lijst van uitvoerobjectconfiguraties. Elk item definieert waar Data 360 één type verrijkte gegevens opslaat.
| Veldnaam | Gegevenstype | Vereiste | Beschrijving |
|---|---|---|---|
objectName |
tekenreeks | Verplicht | De naam van het aangepaste object dat in uw Data 360-organisatie is gemaakt om de uitvoer op te slaan. |
bridgeTable |
object | Optioneel | Gebruikt voor de toewijzingstabel die uw bron-ID's verbindt met echte ID's. Bevat de eigenschap sourceIdFieldName. |
relatedTable |
object | Optioneel | Gebruikt voor tabellen met verrijkte gegevens die koppelen naar standaardobjecten van Data 360. Bevat de sourceObjectName (aan welk Data 360-object moet worden gekoppeld) en pathFromBridgeTable (hoe de tabellen moeten worden samengevoegd). |
SAMPLE_BRIDGE_TABLE
Deze uitvoer maakt een toewijzingstabel tussen uw klant-ID's en de echte ID's van de identiteitsleverancier.
| Veld | Waarde | Beschrijving |
|---|---|---|
objectName |
SAMPLE_BRIDGE_TABLE |
De naam van het bridgetabelobject in uw organisatie. |
bridgeTable.sourceIdFieldName |
SourceId__c |
Het veld waarin uw oorspronkelijke klant-ID is opgeslagen. |
relatedTable |
null |
Dit is een bridgetabel, niet gekoppeld aan een Data 360-object. |
SAMPLE_INDV_BOOSTED
Deze uitvoer maakt verrijkte afzonderlijke records en koppelt deze aan uw Data 360 Individual-objecten.
| Veld | Waarde | Beschrijving |
|---|---|---|
objectName |
SAMPLE_INDV_BOOSTED |
De naam van het verrijkte individuele object in uw organisatie. |
bridgeTable |
null |
Geen brugtafel. |
relatedTable.sourceObjectName |
ssot__Individual__dlm |
Koppelt de verrijkte gegevens aan het gegevensmodelobject Individu in Data 360. |
relatedTable.pathFromBridgeTable |
Relatiepad | Gebruikt de Real ID om verrijkte individuele gegevens te verbinden met uw Data 360 individuen. |
CONTACTEMAIL_BOOSTED
Deze uitvoer maakt verrijkte e-mailrecords voor contactpersonen en koppelt deze aan uw Data 360 ContactPointEmail.
| Veld | Waarde | Beschrijving |
|---|---|---|
objectName |
CONTACTEMAIL_BOOSTED |
De naam van het verrijkte e-mailobject voor contactpersonen in uw organisatie. |
bridgeTable |
null |
Geen brugtafel. |
relatedTable.sourceObjectName |
ssot__ContactPointEmail__dlm |
Koppelt de verrijkte gegevens aan het DMO ContactPointEmail in Data 360. |
relatedTable.pathFromBridgeTable |
Relatiepad | Gebruikt de echte ID en partij-ID om verrijkte e-mailgegevens te verbinden met uw Data 360 ContactPointEmail. |
pathFromBridgeTable definieert hoe de tabellen met verrijkte gegevens moeten worden samengevoegd met de objecten bridgetabel en Data 360. Het geeft aan welke velden als sleutels moeten worden gebruikt bij het verbinden van de records.Voorbeeldscenario
Toewijzing van brugtabel: Als uw klant-ID CUST12345 is, maakt de bridgetabel een record die CUST12345 verbindt met de verrijkte Real ID REAL98765.
Verrijkte afzonderlijke records: De verrijkte individuele record voor Real ID REAL98765 wordt gekoppeld aan uw bestaande record Individu in Data 360.
E-mailrecords van verrijkte contactpersonen: De verrijkte e-mailrecord voor Real ID REAL98765 is gekoppeld aan het overeenkomende e-mailadres in uw Data 360 ContactPointEmail.
- Voorbeeld van aangepaste sjabloon Identiteitsboost JSON
Kopieer de onderstaande sjablooncode of download deze rechtstreeks in Data 360 om te beginnen met het maken van uw aangepaste sjabloon voor de gebruikscase Identiteitsverbetering. Vul de verplichte en optionele velden in met de juiste waarden.
