Riferimento mappatura destinazioni batch

In questo articolo vengono descritti gli attributi obbligatori, le chiavi di deduplicazione, i campi calcolati e le limitazioni note del passaggio Mappatura quando attivi tipi di pubblico nelle destinazioni di esportazione dei profili batch.

Attributi obbligatori mandatory-attributes

Un attributo obbligatorio è una casella di controllo abilitata dall’utente che garantisce che tutti i record di profilo contengano l’attributo selezionato. Ad esempio: tutti i profili esportati contengono un indirizzo e-mail.

È possibile contrassegnare gli attributi come obbligatori per assicurarsi che Experience Platform esporti solo i profili che includono l’attributo specifico. Di conseguenza, può essere utilizzato come forma aggiuntiva di filtro. Contrassegnare un attributo come obbligatorio è non obbligatorio.

Se non si seleziona un attributo obbligatorio, vengono esportati tutti i profili qualificati, indipendentemente dai loro attributi.

È consigliabile che uno degli attributi sia un identificatore univoco dallo schema. Per ulteriori informazioni sugli attributi obbligatori, consulta la sezione Identità nella documentazione delle Destinazioni di e-mail marketing.

Chiavi di deduplicazione deduplication-keys

IMPORTANT
Configura sempre una chiave di deduplicazione per le esportazioni pianificate. Senza deduplicazione, è possibile che vengano visualizzate righe duplicate o appartenenze a segmenti in conflitto per lo stesso profilo, perché le esportazioni pianificate elaborano sia i dati snapshot che quelli incrementali.

Una chiave di deduplicazione è una chiave primaria definita dall’utente che determina il modo in cui i profili vengono deduplicati. Quando esistono più record per la stessa persona, la deduplicazione assicura che venga esportato solo il record più recente.

Le chiavi di deduplicazione eliminano la possibilità di avere più record dello stesso profilo in un unico file di esportazione.

In Experience Platform è possibile utilizzare le chiavi di deduplicazione in tre modi:

  • Utilizzo di un singolo spazio dei nomi delle identità come chiave di deduplicazione
  • Utilizzo di un singolo attributo di profilo da un profilo XDM come chiave di deduplicazione
  • Utilizzo di una combinazione di due attributi di profilo da un profilo XDM come chiave composita
IMPORTANT
Puoi esportare un singolo spazio dei nomi delle identità in una destinazione e lo spazio dei nomi viene impostato automaticamente come chiave di deduplicazione. L’invio di più spazi dei nomi a una destinazione non è supportato.
Non è possibile utilizzare una combinazione di spazi dei nomi di identità e attributi di profilo come chiavi di deduplicazione.

Esempio di deduplicazione deduplication-example

Questo esempio illustra il funzionamento della deduplicazione, a seconda delle chiavi di deduplicazione selezionate.

Prendiamo in considerazione i due profili seguenti.

Profilo A

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe@example.com"
      },
      {
        "id": "doejohn_1@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "realized",
        "lastQualificationTime": "2021-03-10 10:03:08"
      }
    }
  },
  "person": {
    "name": {
      "lastName": "Doe",
      "firstName": "John"
    }
  },
  "personalEmail": {
    "address": "johndoe@example.com"
  }
}

Profilo B

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe@example.com"
      },
      {
        "id": "doejohn_2@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "realized",
        "lastQualificationTime": "2021-04-10 11:33:28"
      }
    }
  },
  "person": {
    "name": {
      "lastName": "D",
      "firstName": "John"
    }
  },
  "personalEmail": {
    "address": "johndoe@example.com"
  }
}

Caso di utilizzo 1: nessuna deduplicazione deduplication-use-case-1

Se non si utilizza alcuna deduplicazione, il file di esportazione conterrà le seguenti voci.

personalEmail
firstName
lastName
johndoe@example.com
John
Doe
johndoe@example.com
John
D

Caso di utilizzo 2: deduplicazione basata sullo spazio dei nomi delle identità deduplication-use-case-2

Se si presuppone la deduplicazione da parte dello spazio dei nomi Email, il file di esportazione conterrà le seguenti voci. Il profilo B è l’ultimo che si è qualificato per il pubblico, quindi è l’unico che viene esportato.

E-mail*
personalEmail
firstName
lastName
johndoe@example.com
johndoe@example.com
John
D
doejohn_2@example.com
johndoe@example.com
John
D

Caso di utilizzo 3: deduplicazione basata su un singolo attributo di profilo deduplication-use-case-3

Se si presuppone la deduplicazione tramite l’attributo personal Email, il file di esportazione conterrà la voce seguente. Il profilo B è l’ultimo che si è qualificato per il pubblico, quindi è l’unico che viene esportato.

personalEmail*
firstName
lastName
johndoe@example.com
John
D

Caso di utilizzo 4: deduplicazione basata su due attributi di profilo deduplication-use-case-4

Se si presuppone la deduplicazione per la chiave composita personalEmail + lastName, il file di esportazione conterrà le voci seguenti.

personalEmail*
lastName*
firstName
johndoe@example.com
D
John
johndoe@example.com
Doe
John

Adobe consiglia di selezionare uno spazio dei nomi di identità come CRM ID o un indirizzo e-mail come chiave di deduplicazione, per garantire che tutti i record di profilo siano identificati in modo univoco.

Comportamento di deduplicazione per profili con la stessa marca temporale deduplication-same-timestamp

Durante l’esportazione di profili in destinazioni basate su file, la deduplica garantisce che venga esportato un solo profilo quando più profili condividono la stessa chiave di deduplica e la stessa marca temporale di riferimento. Questa marca temporale rappresenta il momento in cui l’iscrizione al pubblico o il grafico delle identità di un profilo è stato aggiornato per l’ultima volta. Per ulteriori informazioni sull’aggiornamento e l’esportazione dei profili, vedere il documento comportamento di esportazione dei profili.

Considerazioni chiave key-considerations

  • Selezione deterministica: quando più profili hanno chiavi di deduplicazione identiche e lo stesso timestamp di riferimento, la logica di deduplicazione determina il profilo da esportare ordinando i valori delle altre colonne selezionate (esclusi i tipi complessi come array, mappe o oggetti). I valori ordinati vengono valutati in ordine lessicografico e viene selezionato il primo profilo.

  • Scenario di esempio

Considera i seguenti dati, in cui la chiave di deduplicazione è la colonna Email:

E-mail*
nome
cognome
timestamp
test1@test.com
John
Morris
2024-10-12T09:50
test1@test.com
John
Doe
2024-10-12T09:50
test2@test.com
Frank
Smith
2024-10-12T09:50

Dopo la deduplicazione, il file di esportazione conterrà:

E-mail*
nome
cognome
timestamp
test1@test.com
John
Doe
2024-10-12T09:50
test2@test.com
Frank
Smith
2024-10-12T09:50

Spiegazione: per test1@test.com, entrambi i profili condividono la stessa chiave di deduplicazione e la stessa marca temporale. L’algoritmo ordina i valori delle colonne first_name e last_name in modo lessicografico. Poiché i nomi sono identici, il pareggio viene risolto utilizzando la colonna last_name, dove “Doe” precede “Morris”.

Affidabilità migliorata: questo processo di deduplicazione aggiornato garantisce che le esecuzioni successive con le stesse coordinate producano sempre gli stessi risultati, migliorando la coerenza.

Eseguire trasformazioni dei dati tramite campi calcolati calculated-fields

È possibile utilizzare il controllo Campi calcolati per eseguire varie trasformazioni di dati sui dati esportati in destinazioni basate su file.

Limitazioni note known-limitations

La nuova pagina Mapping presenta le seguenti limitazioni note:

Impossibile selezionare l’attributo di appartenenza del pubblico tramite il flusso di lavoro di mappatura audience-membership-attribute-mapping

A causa di un limite noto, al momento non è possibile utilizzare la finestra Seleziona campo per aggiungere segmentMembership.seg_namespace.seg_id.status alle esportazioni di file. È invece necessario incollare manualmente il valore xdm: segmentMembership.seg_namespace.seg_id.status nel campo schema, come illustrato di seguito.

Registrazione dello schermo che mostra la soluzione alternativa per l'iscrizione al pubblico nel passaggio di mappatura del flusso di lavoro di attivazione. {modal="regular"}

NOTE
Per le destinazioni dell’archiviazione cloud, i seguenti attributi vengono aggiunti alla mappatura per impostazione predefinita:
  • segmentMembership.seg_namespace.seg_id.status
  • segmentMembership.seg_namespace.seg_id.lastQualificationTime

Le esportazioni di file variano nei modi seguenti, a seconda che sia selezionato segmentMembership.seg_namespace.seg_id.status:

  • Se il campo segmentMembership.seg_namespace.seg_id.status è selezionato, i file esportati includono membri attivi nello snapshot completo iniziale e i nuovi membri attivi e membri scaduti nelle esportazioni incrementali successive.
  • Se il campo segmentMembership.seg_namespace.seg_id.status non è selezionato, i file esportati includono solo membri attivi nello snapshot completo iniziale e nelle esportazioni incrementali successive.

Ulteriori informazioni sul comportamento di esportazione del profilo per le destinazioni basate su file.

Al momento non è possibile selezionare gli spazi dei nomi delle identità per le esportazioni identity-namespaces-export-limitation

La selezione degli spazi dei nomi delle identità per l’esportazione, come illustrato nell’immagine seguente, non è attualmente supportata. Se si selezionano spazi dei nomi di identità per l’esportazione, verrà generato un errore nel passaggio Rivedi.

Mappatura non supportata che mostra le esportazioni di identità. {modal="regular"}

Come soluzione alternativa temporanea, se devi aggiungere spazi dei nomi di identità ai file esportati durante la versione beta, puoi effettuare le seguenti operazioni:

  • Utilizza le destinazioni dell’archiviazione cloud legacy per i flussi di dati in cui desideri includere spazi dei nomi di identità nelle esportazioni
  • Carica le identità come attributi in Experience Platform, per poi esportarle nelle destinazioni dell’archiviazione cloud.
recommendation-more-help
experience-platform-help-destinations