Configurazione dello spazio dei nomi dell’identità

In questo Experience Platform vengono utilizzati gli spazi dei nomi delle identità per descrivere il tipo di identità specifiche. Ad esempio, uno spazio dei nomi delle identità denominato Email identifica un valore come name@email.com come indirizzo e-mail.

Durante la creazione di una destinazione tramite Destination SDK, oltre a configurazione di uno schema partner Affinché gli utenti possano mappare gli attributi e le identità del profilo su, puoi anche definire gli spazi dei nomi delle identità supportati dalla piattaforma di destinazione.

Dopo una tale azione, gli utenti potranno scegliere anche di selezionare le identità di destinazione, oltre agli attributi del profilo di destinazione.

Per ulteriori informazioni sugli spazi dei nomi delle identità in Experienci Platform, consulta documentazione sugli spazi dei nomi di identità.

Quando configuri gli spazi dei nomi di identità per la destinazione, puoi ottimizzare la mappatura identità di destinazione supportata dalla destinazione, ad esempio:

Per capire dove questo componente si inserisce in un’integrazione creata con Destination SDK, consulta il diagramma riportato di seguito. opzioni di configurazione o consulta la guida su come utilizzare Destination SDK per configurare una destinazione basata su file.

Puoi configurare gli spazi dei nomi di identità supportati tramite /authoring/destinations endpoint. Consulta le seguenti pagine di riferimento API per esempi dettagliati di chiamate API, in cui puoi configurare i componenti mostrati in questa pagina.

Questo articolo descrive tutte le opzioni di configurazione degli spazi dei nomi delle identità supportate che puoi utilizzare per la tua destinazione e mostra cosa vedranno i clienti nell’interfaccia utente di Platform.

IMPORTANT
Tutti i nomi e i valori dei parametri supportati da Destination SDK sono distinzione maiuscole/minuscole. Per evitare errori di distinzione tra maiuscole e minuscole, utilizza i nomi e i valori dei parametri esattamente come mostrato nella documentazione.

Tipi di integrazione supportati supported-integration-types

Consulta la tabella seguente per informazioni dettagliate sui tipi di integrazioni che supportano le funzionalità descritte in questa pagina.

Tipo di integrazione
Supporta la funzionalità
Integrazioni in tempo reale (streaming)
Integrazioni basate su file (batch)

Parametri supportati supported-parameters

Quando definisci le identità di destinazione supportate dalla destinazione, puoi utilizzare i parametri descritti nella tabella seguente per configurarne il comportamento.

Parametro
Tipo
Obbligatorio/facoltativo
Descrizione
acceptsAttributes
Booleano
Facoltativo
Indica se i clienti possono mappare gli attributi di profilo standard all’identità che stai configurando.
acceptsCustomNamespaces
Booleano
Facoltativo
Indica se i clienti possono mappare gli spazi dei nomi di identità personalizzati allo spazio dei nomi di identità che stai configurando.
acceptedGlobalNamespaces
-
Facoltativo
Indica quale spazi dei nomi di identità standard (ad esempio, IDFA) i clienti possono eseguire il mapping all'identità che stai configurando.
transformation
Stringa
Facoltativo
Visualizza la Applica trasformazione nell’interfaccia utente di Platform, quando il campo di origine è un attributo XDM o uno spazio dei nomi di identità personalizzato. Utilizza questa opzione per consentire agli utenti di aggiungere hash agli attributi sorgente durante l’esportazione. Per abilitare questa opzione, imposta il valore su sha256(lower($)).
requiredTransformation
Stringa
Facoltativo
Quando i clienti selezionano questo spazio dei nomi dell’identità di origine, il Applica trasformazione La casella di controllo viene applicata automaticamente alla mappatura e i clienti non possono disattivarla. Per abilitare questa opzione, imposta il valore su sha256(lower($)).
"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

Indicare quale Platform identità che i clienti possono esportare nella tua destinazione. Alcuni esempi sono Experience Cloud ID, e-mail con hash, ID dispositivo (IDFA, GAID). Questi valori sono Platform spazi dei nomi di identità che i clienti possono mappare su spazi dei nomi di identità dalla tua destinazione.

Gli spazi dei nomi delle identità non richiedono una corrispondenza da 1 a 1 tra Platform e la tua destinazione.
Ad esempio, i clienti possono mappare una Platform IDFA spazio dei nomi in un IDFA dalla destinazione, oppure possono mappare lo stesso Platform IDFA spazio dei nomi in un Customer ID dello spazio dei nomi nella destinazione.

Ulteriori informazioni sulle identità in panoramica dello spazio dei nomi delle identità.

Considerazioni sulla mappatura

Se i clienti selezionano uno spazio dei nomi dell’identità di origine e non una mappatura di destinazione, Platform inserisce automaticamente nella mappatura di destinazione un attributo con lo stesso nome.

Configurare l’hashing facoltativo del campo sorgente

I clienti di Experienci Platform possono scegliere di acquisire i dati in Platform in formato hash o in testo normale. Se la piattaforma di destinazione accetta sia dati con hash che dati senza hash, puoi dare ai clienti la possibilità di scegliere se Platform deve eseguire l’hashing dei valori dei campi sorgente quando vengono esportati nella destinazione.

La configurazione seguente abilita il Applica trasformazione nell’interfaccia utente di Platform, nel passaggio Mappatura.

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
            },
            "Phone":{
            }
         }
      }
   }

Seleziona questa opzione quando utilizzi campi di origine senza hash per fare in modo che Adobe Experience Platform ne esegua automaticamente l’hashing all’attivazione.

Quando mappi gli attributi di origine senza hash agli attributi di destinazione per i quali la destinazione prevede l'hashing (ad esempio: email_lc_sha256 o phone_sha256), controlla Applica trasformazione opzione per fare in modo che Adobe Experience Platform esegua automaticamente l’hash degli attributi sorgente all’attivazione.

Configurare l’hashing obbligatorio del campo sorgente

Se la destinazione accetta solo dati con hash, puoi configurare gli attributi esportati in modo che ricevano automaticamente l’hash da Platform. La configurazione seguente controlla automaticamente Applica trasformazione opzione quando Email e Phone le identità sono mappate.

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
               "requiredTransformation": "sha256(lower($))"
            },
            "Phone":{
               "requiredTransformation": "sha256(lower($))"
            }
         }
      }
   }

Passaggi successivi next-steps

Dopo aver letto questo articolo, dovresti sapere meglio come configurare gli spazi dei nomi delle identità per le destinazioni create con Destination SDK.

Per ulteriori informazioni sugli altri componenti di destinazione, consulta i seguenti articoli:

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