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 le destinazioni basate su file di profilo batch, ad esempio l’archiviazione cloud e le destinazioni di e-mail marketing.

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

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 Pianificazione è possibile configurare la pianificazione e i nomi dei file per ogni pubblico che si sta esportando.

Utilizza le opzioni Nuovi tipi di pubblico e Tipi di pubblico attivati per passare da una visualizzazione all’altra di questa pagina:

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 ogni pubblico, scegli uno dei due tipi di esportazione: Esporta file completi o Esporta file incrementali.

{modal="regular"}

Per modificare più pianificazioni contemporaneamente, seleziona i tipi di pubblico utilizzando le caselle di controllo sul lato sinistro della schermata, quindi seleziona Modifica pianificazione. La pianificazione configurata verrà quindi applicata a tutti i file esportati per i tipi di pubblico selezionati.

{modal="regular"}

Esportare file completi export-full-files

Seleziona Esporta file completi per attivare l’esportazione di un file contenente uno snapshot completo di tutte le qualifiche di profilo per il pubblico selezionato.

{modal="regular"}

Comprensione del comportamento di esportazione pianificato export-behavior

Le esportazioni pianificate includono i dati delle istantanee del pubblico ed eventuali modifiche incrementali del profilo o dell’identità che si verificano tra il momento della creazione e quello dell’esportazione delle istantanee. Si tratta di una differenza rispetto alle esportazioni su richiesta, che utilizzano solo i dati snapshot.

La tabella seguente evidenzia le differenze tra le esportazioni pianificate e le esportazioni su richiesta, in particolare in termini di aggiornamento dei dati e utilizzo previsto:

Se i profili vengono aggiornati dopo la valutazione del pubblico, le esportazioni pianificate includono i valori degli attributi aggiornati anche se l’appartenenza al pubblico è stata determinata al momento della valutazione.

Esempio: un pubblico per “profili in cui retailID è null” può esportare profili con retailID popolato se tale campo è stato aggiornato dopo la valutazione ma prima dell’esportazione pianificata.

Consigli

Per le esportazioni su richiesta, consulta la documentazione su esportazione di file su richiesta.

Esportare file incrementali export-incremental-files

Selezionare Esporta file incrementali 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.

{modal="regular"}

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.

{modal="regular"}

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

{modal="regular"}

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 della schermata, quindi selezionare Modifica nome file. Le opzioni di nome file configurate verranno quindi applicate a tutti i file esportati per i tipi di pubblico selezionati.

{modal="regular"}

Seleziona Applica modifiche per confermare la selezione.

Dopo aver configurato tutti i tipi di pubblico, seleziona Successivo 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:

Per informazioni dettagliate sugli attributi obbligatori, le chiavi di deduplicazione, i campi calcolati e le limitazioni note del passaggio di mappatura, consulta il riferimento di mappatura delle destinazioni batch.

Selezionare attributi di arricchimento select-enrichment-attributes

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

TIP

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

{modal="regular"}

{modal="regular"}

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

Seleziona Avanti per passare al passaggio Rivedi.

[Beta]{class="badge informative"} Esporta array e oggetti dagli attributi di arricchimento export-arrays-enrichment-attributes

Quando si esportano tipi di pubblico in destinazioni di archiviazione cloud con output JSON o Parquet e l’interruttore Esporta array, mappe e oggetti ​​abilitato, è possibile esportare strutture di dati complesse, inclusi array interi o campi selezionati da array di oggetti, come attributi di arricchimento.

{modal="regular"}

Il passaggio Attributi di arricchimento mostra un’interfaccia di mappatura a due colonne:

Questa funzionalità è disponibile solo se sono soddisfatte tutte le seguenti condizioni:

Esportare un intero array export-entire-array

Selezionare il nome dell’attributo array dalla schermata di selezione del campo di origine. Il campo di origine viene compilato con il percorso dell’array, mentre il campo di destinazione viene compilato automaticamente con il nome dell’array. L’output esportato mantiene tutti gli oggetti nell’array con tutte le relative proprietà.

{modal="regular"}

Esportare un singolo campo da un array di oggetti export-single-array-field

Quando si seleziona una proprietà nidificata all’interno di un array di oggetti, il campo Source viene automaticamente popolato con un’espressione calcolata transformArray utilizzando to_object per estrarre tale proprietà da ogni oggetto dell’array.

Se ad esempio si seleziona someArray[*].amount, il campo di origine viene compilato con:

transformArray(someArray, x -> to_object("amount", x.amount))

Il campo di destinazione viene compilato automaticamente con il nome del nodo foglia (amount). Se lo desideri, puoi modificare il nome del campo di destinazione.

{modal="regular"}

Esportare più campi da un array di oggetti export-multiple-array-fields

Per esportare più di una proprietà dalla stessa matrice di oggetti, seguire questa procedura in due passaggi:

Ad esempio, per esportare sia amount che date da someArray, iniziare selezionando someArray[*].amount, quindi modificare l’espressione in:

transformArray(someArray, x -> to_object("amount", x.amount, "date", x.date))

Solo i campi specificati vengono inclusi in ogni oggetto all’interno dell’array esportato. Inoltre, se necessario, puoi modificare il nome dell’array di livello superiore nel file esportato.

{modal="regular"}

Rivedi review

Nella pagina Rivedi puoi visualizzare un riepilogo della selezione. Seleziona Annulla per interrompere il flusso, Indietro per modificare le impostazioni oppure Fine per confermare la selezione e iniziare a inviare dati alla destinazione.

{modal="regular"}

Valutazione dei criteri di consenso consent-policy-evaluation

Se l’organizzazione ha acquistato Adobe Healthcare Shield o Adobe Privacy & Security Shield, seleziona Visualizza i criteri di consenso applicabili per vedere quali criteri di consenso vengono applicati e quanti profili vengono inclusi di conseguenza nell’attivazione. Leggi informazioni sulla valutazione dei criteri di consenso per ulteriori informazioni.

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

Nel passaggio Rivedi, 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.

{modal="regular"}

Filtrare i tipi di pubblico filter-audiences

Utilizza l’interruttore Nuovi tipi di pubblico e Tipi di pubblico attivati per passare dai tipi di pubblico aggiunti in questo flusso di attivazione ai tipi di pubblico già attivati nella destinazione nei flussi precedenti.

Per scegliere le colonne da visualizzare nella tabella, selezionare l’icona Personalizza tabella. Nella finestra di dialogo Personalizza tabella, seleziona o deseleziona le colonne da mostrare, quindi seleziona Applica.

{modal="regular"}

Se si è soddisfatti della selezione e non sono state rilevate violazioni dei criteri, selezionare Fine 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 specificato. È 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.