Configuratie naamruimte voor identiteit

Experience Platform gebruikt naamruimten om het type van specifieke identiteiten te beschrijven. Een naamruimte voor identiteiten met de naam Email identificeert bijvoorbeeld een waarde zoals name@email.com als een 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 bestemmingen in real time (het stromen) door Destination SDK, naast vormend een partnerschemawaaraan de gebruikers profielattributen en identiteiten kunnen in kaart brengen, moet u minstens één identiteitsnamespaces ook bepalen die door uw bestemmingsplatform worden gesteund. Bijvoorbeeld, als uw bestemmingsplatform gehakt e-mail en IDFA goedkeurt, moet u deze twee identiteiten bepalen zoals verder in dit documentwordt beschreven.

    note important
    IMPORTANT
    Wanneer het activeren van publiek aan het stromen bestemmingen, moeten de gebruikers minstens één doelidentiteit, naast de attributen van het doelprofiel ook in kaart brengen. 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 identiteit namespaces facultatief __.

Meer over identiteit namespaces in Experience Platform leren, zie de documentatie van identiteitsnaamruimten.

Wanneer het vormen van identiteitsnamespaces voor uw bestemming, kunt u de afbeelding van de doelidentiteit verfijnen die door uw bestemming wordt gesteund, zoals:

Om te begrijpen waar deze component in een integratie past die met Destination SDK wordt gecreeerd, zie het diagram in de configuratieoptiesdocumentatie of zie de gids op hoe te gebruiken Destination SDK om een op dossier-gebaseerde bestemmingte vormen.

U kunt ondersteunde naamruimten configureren via het /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.

IMPORTANT
Alle parameternamen en waarden die door Destination SDK worden gesteund zijn gevoelig geval. Om fouten in hoofdlettergevoeligheid te voorkomen, gebruikt u de namen en waarden van parameters exact zoals in de documentatie wordt getoond.

Ondersteunde integratietypen supported-integration-types

Raadpleeg de onderstaande tabel voor meer informatie over de integratietypen die de op deze pagina beschreven functionaliteit ondersteunen.

Type integratie
Ondersteunt functionaliteit
Integraties in realtime (streaming)
Ja (vereist)
Op bestanden gebaseerde (batch) integratie
Ja (optioneel)

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.

Parameter
Type
Vereist/optioneel
Beschrijving
acceptsAttributes
Boolean
Optioneel
Geeft aan of klanten standaardprofielkenmerken kunnen toewijzen aan de identiteit die u configureert.
acceptsCustomNamespaces
Boolean
Optioneel
Geeft aan of klanten aangepaste naamruimten kunnen toewijzen aan de naamruimte van de identiteit die u configureert.
acceptedGlobalNamespaces
-
Optioneel
Wijst op welke standaardidentiteitsnamespaces(bijvoorbeeld, IDFA) klanten aan de identiteit kunnen in kaart brengen die u vormt.
transformation
String
Optioneel
Hiermee wordt het selectievakje Apply transformation weergegeven in de gebruikersinterface van het platform wanneer het bronveld een XDM-kenmerk of een naamruimte voor een aangepaste identiteit is. Gebruik deze optie om gebruikers de mogelijkheid te geven bronkenmerken bij het exporteren te hashen. Als u deze optie wilt inschakelen, stelt u de waarde in op sha256(lower($)) .
requiredTransformation
String
Optioneel
Wanneer klanten deze naamruimte voor de bronidentiteit selecteren, wordt het selectievakje Apply transformation automatisch toegepast op de toewijzing en kunnen klanten deze naamruimte niet uitschakelen. Als u deze optie wilt inschakelen, stelt u de waarde in op sha256(lower($)) .
"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

U moet aangeven welke Platform -identiteiten klanten kunnen exporteren naar uw doel. Enkele voorbeelden zijn Experience Cloud ID , gehashte e-mail, apparaat-id (IDFA, GAID ). Deze waarden zijn Platform naamruimten die klanten vanaf hun bestemming kunnen toewijzen aan naamruimten.

Naamruimten vereisen geen 1-op-1 overeenkomst tussen Platform en uw doel.
Klanten kunnen bijvoorbeeld een naamruimte Platform IDFA aan een naamruimte IDFA toewijzen vanuit uw doel, of ze kunnen dezelfde naamruimte Platform IDFA toewijzen aan een naamruimte Customer ID in uw doel.

Lees meer over identiteiten in het overzicht van identiteitskaart namespace.

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 configuratie hieronder laat facultatieve toe past transformatieoptie in Platform UI, in de stap van de Afbeelding toe.

"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 ongehakte bronattributen aan doelattributen in kaart brengt die de bestemming (bijvoorbeeld: email_lc_sha256 of phone_sha256) verwacht worden gehakt, controleer transformatie optie toepassen om Adobe Experience Platform automatisch te hebben de bronattributen bij activering hakt.

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 configuratie hieronder controleert automatisch transformatie optie toepassen wanneer de Email en Phone identiteiten in kaart worden gebracht.

"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:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6