Attivare i tipi di pubblico per le destinazioni di esportazione dei profili in batch

Panoramica overview

Questo articolo spiega il flusso di lavoro necessario per attivare i tipi di pubblico in Adobe Experience Platform per mettere in batch destinazioni basate su file di profilo, come l’archiviazione cloud e le destinazioni del marketing via e-mail.

Prerequisiti prerequisites

Per attivare i tipi di pubblico nelle destinazioni, devi avere connesso correttamente a una destinazione. Se non lo hai già fatto, vai al catalogo delle destinazioni, sfoglia le destinazioni supportate e configura la destinazione che desideri utilizzare.

Formati di file supportati per l’esportazione supported-file-formats-export

Durante l’esportazione dei tipi di pubblico sono supportati i seguenti formati di file:

L’esportazione di file CSV offre maggiore flessibilità in termini di struttura dei file esportati. Ulteriori informazioni sulla configurazione della formattazione dei file per i file CSV.

Selezionare il formato di file desiderato per l'esportazione durante la creazione di una connessione alla destinazione basata su file.

Seleziona la destinazione select-destination

Seleziona i tipi di pubblico select-audiences

Per selezionare i tipi di pubblico da attivare nella destinazione, utilizzare le caselle di controllo a sinistra dei nomi dei tipi di pubblico, quindi selezionare Next.

Puoi scegliere tra più tipi di pubblico, a seconda della loro origine:

Pianificare l’esportazione del pubblico scheduling

Adobe Experience Platform esporta i dati per le destinazioni di e-mail marketing e archiviazione cloud come tipi di file diversi. Nella pagina Scheduling è possibile configurare la pianificazione e i nomi dei file per ogni pubblico da esportare.

Experience Platform imposta automaticamente una pianificazione predefinita per ogni esportazione di file. Puoi modificare la pianificazione predefinita in base alle tue esigenze, selezionando l’icona a forma di matita accanto a ogni pianificazione e definendo una pianificazione personalizzata.

Per modificare più pianificazioni contemporaneamente, selezionare i tipi di pubblico utilizzando le caselle di controllo sul lato sinistro dello schermo, quindi selezionare Edit schedule. La pianificazione configurata verrà quindi applicata a tutti i file esportati per i tipi di pubblico selezionati.

Esportare file completi export-full-files

Selezionare Export full files per attivare l'esportazione di un file contenente un'istantanea completa di tutte le qualifiche di profilo per il pubblico selezionato.

Esportare file incrementali

Selezionare Export incremental files per attivare un'esportazione in cui il primo file è uno snapshot completo di tutte le qualifiche di profilo per il pubblico selezionato e i file successivi sono qualifiche di profilo incrementali dall'esportazione precedente.

Configurare nomi file configure-file-names

Per la maggior parte delle destinazioni, i nomi di file predefiniti sono costituiti dal nome della destinazione, dall’ID del pubblico e da un indicatore di data e ora. Ad esempio, puoi modificare i nomi dei file esportati per distinguere tra diverse campagne o per aggiungere ai file il tempo di esportazione dei dati. Tieni presente che alcuni sviluppatori di destinazione potrebbero scegliere di visualizzare diverse opzioni di aggiunta dei nomi di file predefiniti per le loro destinazioni.

Per aprire una finestra modale e modificare i nomi dei file, seleziona l’icona della matita. I nomi dei file non possono superare i 255 caratteri.

Nell’editor dei nomi di file puoi selezionare diversi componenti da aggiungere al nome del file.

Il nome di destinazione e l’ID del pubblico non possono essere rimossi dai nomi dei file. Oltre a queste opzioni, puoi aggiungere le seguenti opzioni:

Per modificare più nomi di file contemporaneamente, selezionare il pubblico utilizzando le caselle di controllo sul lato sinistro dello schermo, quindi selezionare Edit file name. Le opzioni di nome file configurate verranno quindi applicate a tutti i file esportati per i tipi di pubblico selezionati.

Seleziona Apply changes per confermare la selezione.

Al termine della configurazione di tutti i tipi di pubblico, selezionare Next per continuare.

Mappatura mapping

In questo passaggio, devi selezionare gli attributi del profilo che desideri aggiungere ai file esportati nella destinazione di destinazione. Per selezionare gli attributi e le identità del profilo per l'esportazione:

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

Una chiave di deduplicazione è una chiave primaria definita dall’utente che determina l’identità in base alla quale gli utenti desiderano deduplicare i propri profili​

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:

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.

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.

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.

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.

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

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

Dopo la deduplicazione, il file di esportazione conterrà:

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

A causa di un limite noto, al momento non è possibile utilizzare la finestra Select field 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.

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

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

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 Review.

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

Seleziona attributi profilo select-attributes

Per le destinazioni basate su profili, devi selezionare gli attributi del profilo che desideri inviare alla destinazione target.

IMPORTANT

A causa di un limite noto, al momento non è possibile utilizzare la finestra Select field 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.

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

Selezionare attributi di arricchimento select-enrichment-attributes

Gli attributi di arricchimento corrispondono ai pubblici caricati personalizzati acquisiti in Experience Platform come Custom uploads. In questo passaggio puoi selezionare gli attributi da esportare nella destinazione per ogni pubblico esterno selezionato.

Per selezionare gli attributi di arricchimento per ciascun pubblico esterno, segui i passaggi seguenti:

Se desideri attivare tipi di pubblico esterni nelle destinazioni senza esportare alcun attributo, abilita l'interruttore Exclude enrichment attributes. Questa opzione esporta i profili dai tipi di pubblico esterni, ma nessuno degli attributi corrispondenti viene inviato alla destinazione.

Seleziona Next per passare al passaggio Rivedi.

Rivedi review

Nella pagina Review è disponibile un riepilogo della selezione. Selezionare Cancel per interrompere il flusso, Back per modificare le impostazioni oppure Finish per confermare la selezione e iniziare a inviare dati alla destinazione.

Valutazione dei criteri di consenso consent-policy-evaluation

Se la tua organizzazione ha acquistato Adobe Healthcare Shield o Adobe Privacy & Security Shield, seleziona View applicable consent policies per vedere quali criteri di consenso sono applicati e quanti profili sono inclusi nell'attivazione come risultato di tali criteri. Leggi informazioni sulla valutazione dei criteri di consenso per ulteriori informazioni.

Controlli dei criteri di utilizzo dei dati data-usage-policy-checks

Nel passaggio Review, Experience Platform controlla anche eventuali violazioni dei criteri di utilizzo dei dati. Di seguito è riportato un esempio di violazione di una policy. Non puoi completare il flusso di lavoro di attivazione del pubblico finché non hai risolto la violazione. Per informazioni su come risolvere le violazioni dei criteri, leggere le violazioni dei criteri di utilizzo dei dati nella sezione relativa alla governance dei dati.

Filtrare i tipi di pubblico filter-audiences

Inoltre, in questo passaggio puoi utilizzare i filtri disponibili nella pagina per visualizzare solo i tipi di pubblico la cui pianificazione o mappatura è stata aggiornata come parte di questo flusso di lavoro. Puoi anche scegliere quali colonne della tabella visualizzare.

Se si è soddisfatti della selezione e non sono state rilevate violazioni dei criteri, selezionare Finish per confermare la selezione e iniziare a inviare dati alla destinazione.

Verificare l’attivazione del pubblico verify

Durante l'esportazione dei tipi di pubblico nelle destinazioni dell'archiviazione cloud, Adobe Experience Platform crea un file .csv, .json o .parquet nel percorso di archiviazione fornito. È necessario creare un nuovo file nel percorso di archiviazione in base alla pianificazione impostata nel flusso di lavoro. Di seguito è riportato il formato di file predefinito, ma è possibile modificare i componenti del nome di file:
<destinationName>_segment<segmentID>_<timestamp-yyyymmddhhmmss>.csv

Ad esempio, se hai selezionato una frequenza di esportazione giornaliera, i file che riceverai in tre giorni consecutivi potrebbero essere simili al seguente:

Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200408061804.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200409052200.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200410061130.csv

La presenza di questi file nel percorso di archiviazione conferma la riuscita dell’attivazione. Per comprendere la struttura dei file esportati, è possibile scaricare un file .csv di esempio. Questo file di esempio include gli attributi di profilo person.firstname, person.lastname, person.gender, person.birthyear e personalEmail.address.