Configuratie naamruimte voor identiteit
Experience Platform gebruikt naamruimten om het type van specifieke identiteiten te beschrijven. Bijvoorbeeld, een identiteitsnaamruimte genoemd Email
geeft een vergelijkbare waarde aan name@email.com
als e-mailadres.
Houd, afhankelijk van het type doel dat u maakt (streaming of op bestand gebaseerd), rekening met de volgende vereisten voor naamruimte voor identiteiten:
-
Wanneer het creëren van (het stromen) bestemmingen in real time door Destination SDK, naast het vormen van een partnerschema waaraan gebruikers profielkenmerken en identiteiten kunnen toewijzen, moet u ook definiëren ten minste één naamruimten die worden ondersteund door het doelplatform. Als uw doelplatform bijvoorbeeld gehashte e-mails en IDFAmoet u deze twee identiteiten definiëren als nader beschreven in dit document.
note important IMPORTANT Wanneer het activeren van publiek aan het stromen bestemmingen, moeten de gebruikers ook in kaart brengen ten minste één doelidentiteit, naast de kenmerken van het doelprofiel. Anders wordt het publiek niet geactiveerd naar het doelplatform. -
Wanneer het creëren van op dossier-gebaseerde bestemmingen door Destination SDK, is de configuratie van identiteitsnamespaces optioneel.
Voor meer informatie over naamruimten in Experience Platform raadpleegt u de documentatie over naamruimten.
Wanneer het vormen van identiteitsnamespaces voor uw bestemming, kunt u de afbeelding van de doelidentiteit verfijnen die door uw bestemming wordt gesteund, zoals:
- Gebruikers toestaan XDM-kenmerken toe te wijzen aan naamruimten.
- Toestaan dat gebruikers een kaart maken standaardnaamruimten naar uw eigen naamruimten.
- Toestaan dat gebruikers een kaart maken aangepaste naamruimten naar uw eigen naamruimten.
Om te begrijpen waar deze component in een integratie past die met Destination SDK wordt gecreeerd, zie het diagram in configuratieopties documentatie of bekijk de gids over hoe te gebruik Destination SDK om een op dossier-gebaseerde bestemming te vormen.
U kunt uw ondersteunde naamruimten configureren via het dialoogvenster /authoring/destinations
eindpunt. Zie de volgende API verwijzingspagina's voor gedetailleerde API vraagvoorbeelden waar u de componenten kunt vormen die in deze pagina worden getoond.
In dit artikel worden alle ondersteunde configuratieopties voor naamruimten beschreven die u voor uw bestemming kunt gebruiken, en wordt getoond welke klanten in de interface van het platform zullen zien.
Ondersteunde integratietypen supported-integration-types
Raadpleeg de onderstaande tabel voor meer informatie over de integratietypen die de op deze pagina beschreven functionaliteit ondersteunen.
Ondersteunde parameters supported-parameters
Wanneer het bepalen van de doelidentiteiten die uw bestemming steunt, kunt u de parameters gebruiken die in de lijst worden beschreven hieronder om hun gedrag te vormen.
acceptsAttributes
acceptsCustomNamespaces
acceptedGlobalNamespaces
transformation
sha256(lower($))
.requiredTransformation
sha256(lower($))
."identityNamespaces":{
"external_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"acceptedGlobalNamespaces":{
"Email":{
}
}
},
"another_id":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true
}
}
U moet aangeven welke Platform id's die klanten kunnen exporteren naar uw bestemming. Enkele voorbeelden zijn Experience Cloud ID, gehashte e-mail, apparaat-id (IDFA, GAID). Deze waarden zijn Platform identiteitsnaamruimten die klanten vanaf uw bestemming kunnen toewijzen aan naamruimten.
Naamruimten vereisen geen 1-op-1-overeenkomst tussen Platform en uw bestemming.
Klanten kunnen bijvoorbeeld een Platform IDFA naamruimte naar een IDFA naamruimte vanaf uw bestemming, of ze kunnen hetzelfde toewijzen Platform IDFA naamruimte naar een Customer ID naamruimte in uw doel.
Meer informatie over identiteiten in het dialoogvenster Overzicht van naamruimte in identiteit.
Toewijzingsoverwegingen
Als klanten een naamruimte voor de bronidentiteit selecteren en geen doeltoewijzing selecteren, wordt de doeltoewijzing automatisch ingevuld met een kenmerk met dezelfde naam.
Optionele hashing voor bronvelden configureren
Klanten van Experience Platforms kunnen ervoor kiezen om gegevens in te voeren in Platform met hashing of in onbewerkte tekst. Als uw bestemmingsplatform zowel gehakt als unhashed gegevens goedkeurt, kunt u klanten de optie geven om te kiezen of Platform de waarden van brongebieden zou moeten hakken wanneer zij worden uitgevoerd naar uw bestemming.
De onderstaande configuratie maakt de optionele Transformatie toepassen in de UI van het Platform, in de stap van de Afbeelding.
"identityNamespaces":{
"Customer_contact":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"transformation": "sha256(lower($))",
"acceptedGlobalNamespaces":{
"Email":{
},
"Phone":{
}
}
}
}
Schakel deze optie in als u niet-gehashte bronvelden gebruikt, zodat Adobe Experience Platform deze automatisch verbergt bij activering.
Wanneer u ongehashte bronkenmerken toewijst aan doelkenmerken die de bestemming verwacht te worden gehasht (bijvoorbeeld: email_lc_sha256
of phone_sha256
), controleert u Transformatie toepassen als u wilt dat Adobe Experience Platform de bronkenmerken bij activering automatisch hasht.
Verplichte hash voor bronvelden configureren
Als uw bestemming slechts gehakte gegevens goedkeurt, kunt u de uitgevoerde attributen vormen om automatisch door Platform worden gehakt. De onderstaande configuratie controleert automatisch de Transformatie toepassen als de Email
en Phone
identiteiten worden toegewezen.
"identityNamespaces":{
"Customer_contact":{
"acceptsAttributes":true,
"acceptsCustomNamespaces":true,
"transformation": "sha256(lower($))",
"acceptedGlobalNamespaces":{
"Email":{
"requiredTransformation": "sha256(lower($))"
},
"Phone":{
"requiredTransformation": "sha256(lower($))"
}
}
}
}
Volgende stappen next-steps
Na het lezen van dit artikel, zou u een beter inzicht in moeten hebben hoe te om uw identiteit namespaces voor bestemmingen te vormen die met Destination SDK worden gebouwd.
Raadpleeg de volgende artikelen voor meer informatie over de andere doelcomponenten:
- Verificatie door klant
- OAuth2-vergunning
- Gegevensvelden van de klant
- UI-kenmerken
- Schema-configuratie
- Configuratie naamruimte voor identiteit
- Ondersteunde toewijzingsconfiguraties
- Levering bestemming
- Configuratie van metagegevens voor publiek
- Samenvoegingsbeleid
- Batchconfiguratie
- Historische profielkwalificaties