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:

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.

IMPORTANT
Alla parameternamn och värden som stöds av Destinationen SDK är skiftlägeskänsliga. Undvik skiftlägeskänslighetsfel genom att använda parameternamn och värden exakt som de visas i dokumentationen.

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.

Integrationstyp
Stöder funktioner
Integrering i realtid (direktuppspelning)
Ja (obligatoriskt)
Filbaserade (batch) integreringar
Ja (valfritt)

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.

Parameter
Typ
Obligatoriskt/valfritt
Beskrivning
acceptsAttributes
Boolean
Valfritt
Anger om kunder kan mappa standardprofilattribut till identiteten som du konfigurerar.
acceptsCustomNamespaces
Boolean
Valfritt
Anger om kunderna kan mappa anpassade ID-namnutrymmen till det ID-namnutrymme som du konfigurerar.
acceptedGlobalNamespaces
Valfritt
Anger vilka standardidentitetsnamnutrymmen (till exempel IDFA) som kunder kan mappa till identiteten som du konfigurerar.
transformation
Sträng
Valfritt
Visar kryssrutan Apply transformation i plattformsgränssnittet när källfältet är antingen ett XDM-attribut eller ett anpassat identitetsnamnområde. Använd det här alternativet om du vill att användare ska kunna hash-koda källattribut vid export. Om du vill aktivera det här alternativet anger du värdet till sha256(lower($)).
requiredTransformation
Sträng
Valfritt
När kunderna väljer det här namnområdet för källidentiteten används kryssrutan Apply transformation automatiskt på mappningen och kunderna kan inte inaktivera den. Om du vill aktivera det här alternativet anger du värdet till 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:

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