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à:

  • Durante la creazione di destinazioni in tempo reale (streaming) tramite Destination SDK, oltre a configurare uno schema partner in cui gli utenti possono mappare gli attributi e le identità del profilo, devi anche definire almeno uno spazi dei nomi di identità supportati dalla piattaforma di destinazione. Ad esempio, se la piattaforma di destinazione accetta e-mail con hash e IDFA, è necessario definire queste due identità come descritte più avanti in questo documento.

    note important
    IMPORTANT
    Quando si attivano tipi di pubblico su destinazioni di streaming, gli utenti devono mappare anche almeno un'identità di destinazione, oltre agli attributi del profilo di destinazione. In caso contrario, i tipi di pubblico non verranno attivati nella piattaforma di destinazione.
  • Durante la creazione di destinazioni basate su file tramite Destination SDK, la configurazione degli spazi dei nomi di identità è facoltativa.

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.

IMPORTANT
Tutti i nomi e i valori dei parametri supportati da Destination SDK sono con distinzione tra maiuscole e 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)
Sì (obbligatorio)
Integrazioni basate su file (batch)
Sì (facoltativo)

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 quali spazi dei nomi di identità standard (ad esempio, IDFA) i clienti possono mappare all'identità che stai configurando.
transformation
Stringa
Facoltativo
Visualizza la casella di controllo 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, impostare il valore su sha256(lower($)).
requiredTransformation
Stringa
Facoltativo
Quando i clienti selezionano questo spazio dei nomi dell'identità di origine, la casella di controllo Applica trasformazione viene applicata automaticamente alla mappatura e i clienti non possono disattivarla. Per abilitare questa opzione, impostare il valore su sha256(lower($)).
"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:

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