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.

IMPORTANT
Alle parameternamen en -waarden die door Destination SDK worden ondersteund, zijn hoofdlettergevoelig. 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
Geeft aan welke standaardnaamruimten (bijvoorbeeld IDFA) kunnen klanten toewijzen aan de identiteit die u configureert.
transformation
String
Optioneel
Hiermee geeft u het dialoogvenster Apply transformation Schakel het selectievakje in in de interface 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, Apply transformation schakelt u deze optie automatisch in op de toewijzing en klanten kunnen deze 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 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:

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