Konfiguration av namnutrymme för identitet
Experience Platform använder ID-namnutrymmen för att beskriva typen av specifika identiteter. Ett ID-namnområde med namnet Email
identifierar till exempel ett värde som name@email.com
som en e-postadress.
Beroende på vilken typ av mål du skapar (direktuppspelning eller filbaserad) bör du tänka på följande krav för identitetsnamnutrymme:
-
När du skapar realtidsmål (direktuppspelning) via Destination SDK måste du, förutom att konfigurera ett partnerschema som användare kan mappa profilattribut och identiteter, även definiera minst en identitetsnamnrymd som stöds av målplattformen. Om målplattformen t.ex. accepterar hash-kodade e-postmeddelanden och IDFA måste du definiera dessa två identiteter enligt beskrivningen längre ned i det här dokumentet.
note important IMPORTANT När målgrupper aktiveras för direktuppspelningsmål måste användarna även mappa minst en målidentitet, förutom målprofilsattribut. Annars aktiveras inte målgrupperna till målplattformen. -
När du skapar filbaserade mål via Destination SDK är konfigurationen för identitetsnamnutrymmen valfri.
Mer information om identitetsnamnutrymmen i Experience Platform finns i dokumentationen om identitetsnamnutrymmen.
När du konfigurerar identitetsnamnutrymmen för målet kan du finjustera den målidentitetsmappning som stöds av målet, till exempel:
- Användare kan mappa XDM-attribut till identitetsnamnutrymmen.
- Tillåter användare att mappa standardnamnutrymmen för identiteter till dina egna namnutrymmen för identiteter.
- Tillåter användare att mappa anpassade identitetsnamnutrymmen till dina egna identitetsnamnutrymmen.
Mer information om var den här komponenten passar in i en integrering som skapats med Destination SDK finns i diagrammet i dokumentationen för konfigurationsalternativ eller i guiden om hur du använder Destination SDK för att konfigurera ett filbaserat mål.
Du kan konfigurera identitetsnamnutrymmen som stöds via slutpunkten /authoring/destinations
. På följande API-referenssidor finns detaljerade API-anropsexempel där du kan konfigurera komponenterna som visas på den här sidan.
I den här artikeln beskrivs alla konfigurationsalternativ för identitetsnamn som stöds och som du kan använda för ditt mål. Dessutom visas vad kunderna kommer att se i plattformsgränssnittet.
Integrationstyper som stöds supported-integration-types
Se tabellen nedan för mer ingående information om vilka typer av integreringar som stöder de funktioner som beskrivs på den här sidan.
parametrar som stöds supported-parameters
När du definierar de målidentiteter som målet stöder kan du använda parametrarna som beskrivs i tabellen nedan för att konfigurera deras beteende.
acceptsAttributes
acceptsCustomNamespaces
acceptedGlobalNamespaces
transformation
sha256(lower($))
.requiredTransformation
sha256(lower($))
."identityNamespaces":{
"external_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"Email":{
}
}
},
"another_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
}
}
Du måste ange vilka Platform identiteter som kunderna kan exportera till ditt mål. Några exempel är Experience Cloud ID, hashad e-post, enhets-ID (IDFA, GAID). Dessa värden är Platform ID-namnutrymmen som kunderna kan mappa till identitetsnamnutrymmen från ditt mål.
Identitetsnamnutrymmen kräver ingen 1-till-1-korrespondens mellan Platform och ditt mål.
Kunder kan till exempel mappa ett Platform IDFA-namnutrymme till ett IDFA-namnutrymme från målet, eller så kan de mappa samma Platform IDFA-namnutrymme till ett Customer ID-namnutrymme i målet.
Läs mer om identiteter i översikten över identitetsnamnområdet.
Mappningsöverväganden
Om kunderna väljer ett namnutrymme för källidentiteten och inte väljer någon målmappning, fyller Platform automatiskt i målmappningen med ett attribut med samma namn.
Konfigurera hash för valfritt källfält
Experience Platform-kunder kan välja att importera data till plattformen i hash-format eller i vanlig text. Om målplattformen godkänner både hash-kodade och ohashade data kan du ge kunderna möjlighet att välja om Platform ska hash-koda källfältets värden när de exporteras till destinationen.
Med konfigurationen nedan aktiveras det valfria alternativet Använd omvandling i plattformsgränssnittet i mappningssteget.
"identityNamespaces":{
"Customer_contact":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"transformation": "sha256(lower($))",
"acceptedGlobalNamespaces":{
"Email":{
},
"Phone":{
}
}
}
}
Markera det här alternativet om du vill att Adobe Experience Platform automatiskt ska hash-koda dem vid aktiveringen när du använder ohashed-källfält.
När du mappar ohash-kodade källattribut till målattribut som målet förväntar ska hash-kodas (till exempel: email_lc_sha256
eller phone_sha256
), kontrollerar du alternativet Använd omformning så att Adobe Experience Platform automatiskt hash-kodar källattributen vid aktiveringen.
Konfigurera hash för obligatoriskt källfält
Om målet bara godtar hash-kodade data kan du konfigurera de exporterade attributen så att de hashas automatiskt av Platform. Konfigurationen nedan kontrollerar automatiskt alternativet Använd omformning när identiteterna Email
och Phone
mappas.
"identityNamespaces":{
"Customer_contact":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"transformation": "sha256(lower($))",
"acceptedGlobalNamespaces":{
"Email":{
"requiredTransformation": "sha256(lower($))"
},
"Phone":{
"requiredTransformation": "sha256(lower($))"
}
}
}
}
Nästa steg next-steps
När du har läst den här artikeln bör du ha en bättre förståelse för hur du konfigurerar identitetsnamnutrymmen för mål som skapats med Destination SDK.
Mer information om de andra målkomponenterna finns i följande artiklar: