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 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 delle identità in Experience Platform, consulta la documentazione sugli spazi dei nomi delle 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 nella documentazione delle opzioni di configurazione oppure consulta 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 puoi utilizzare per la tua destinazione e mostra cosa vedranno i clienti nell’interfaccia utente di 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 identità Platform che i clienti possono esportare nella 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 destinazione.

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

Ulteriori informazioni sulle identità nella 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 Experience 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 l'opzione opzionale 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 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 fare in modo che Adobe Experience Platform esegua automaticamente l'hash degli attributi di origine 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 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

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: