Configurazione dello spazio dei nomi dell’identità

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

A seconda del tipo di destinazione creato (in streaming o basata su file), tieni presente i seguenti requisiti di spazio dei nomi delle identità:

Per ulteriori informazioni sugli spazi dei nomi di identità in Experience Platform, consulta la 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, vedere il diagramma nella documentazione delle opzioni di configurazione o la guida su come utilizzare Destination SDK per configurare una destinazione basata su file.

È possibile configurare gli spazi dei nomi di identità supportati tramite l’endpoint /authoring/destinations. 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 è possibile utilizzare per la destinazione e mostra ciò che viene visualizzato nell’interfaccia utente di Experience Platform.

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.

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.

"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

È necessario indicare le Experience Platform identità che è possibile esportare nella destinazione. Alcuni esempi sono Experience Cloud ID, e-mail con hash, ID dispositivo (IDFA, GAID). Questi valori sono Experience Platform spazi dei nomi di identità che è possibile mappare agli spazi dei nomi di identità dalla destinazione.

Gli spazi dei nomi di identità non richiedono una corrispondenza 1-a-1 tra Experience Platform e la destinazione. Ad esempio, è possibile mappare uno spazio dei nomi Experience Platform IDFA a uno spazio dei nomi IDFA dalla destinazione oppure lo stesso spazio dei nomi Experience Platform IDFA a uno spazio dei nomi Customer ID nella destinazione.

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

Considerazioni sulla mappatura mapping-considerations

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

Configurare l’hashing facoltativo del campo sorgente configure-optional-hashing

In Experience Platform è possibile scegliere di acquisire i dati in formato hash o in testo normale. Se la piattaforma di destinazione accetta sia dati con hash che dati senza hash, è possibile scegliere se Experience Platform esegue l’hash dei valori del campo di origine quando vengono esportati nella destinazione.

La configurazione seguente abilita l’opzione facoltativa Applica trasformazione nell’interfaccia utente Experience 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 non sottoposti ad hashing per fare in modo che Adobe Experience Platform ne esegua automaticamente l’hashing al momento dell’attivazione.

Quando si esegue il mapping degli attributi di origine senza hash agli attributi di destinazione per i quali la destinazione prevede l’hash (ad esempio: email_lc_sha256 o phone_sha256), selezionare l’opzione Applica trasformazione per impostare Adobe Experience Platform per l’hash automatico degli attributi di origine durante l’attivazione.

Configurare l’hashing obbligatorio del campo sorgente configure-mandatory-hashing

Se la destinazione accetta solo dati con hash, è possibile configurare gli attributi esportati in modo che l’hashing venga eseguito automaticamente da Experience Platform. La configurazione seguente controlla automaticamente l’opzione Applica trasformazione quando le identità Email e Phone 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

È ora possibile comprendere come configurare gli spazi dei nomi di identità per le destinazioni create con Destination SDK, incluso come consentire le mappature di attributi e spazi dei nomi e come applicare l’hashing facoltativo o obbligatorio durante l’esportazione.

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