In questa pagina: scopri come utilizzare l’attività di gestione dei dati di caricamento file per eseguire il targeting di un pubblico di una campagna orchestrata da un file CSV o TXT esterno al momento dell’esecuzione, senza acquisire il file in Adobe Experience Platform.
L’attività Carica file è un’attività di gestione dati. Utilizzala per lavorare con profili e dati memorizzati in un file esterno. Supporta il targeting basato su file nelle campagne orchestrate quando l’elenco dei destinatari proviene da un sistema esterno (ad esempio, un’esportazione CRM o un file partner) e desideri eseguire una campagna senza prima creare una pipeline di acquisizione Adobe Experience Platform completa.
Durante l’impostazione del file, puoi definire le mappature di colonna, i tipi di dati, la gestione dei valori NULL e i criteri di errore per colonna. Le righe che non superano la convalida vengono rifiutate e registrate prima dell’esecuzione della campagna, mantenendo il pubblico pulito senza la pre-elaborazione manuale.
Autorizzazioni permissions
Per utilizzare l’attività Load file in una campagna orchestrata, è necessario assegnare agli utenti le autorizzazioni corrette. Entrambe le autorizzazioni sono disponibili in Adobe Experience Platform > Adobe Journey Optimizer > Campagne orchestrate nell’interfaccia utente delle autorizzazioni.
- Visualizza file in campagne orchestrate - Consente l’accesso in sola lettura. Gli utenti con questa autorizzazione possono visualizzare in anteprima i risultati di una campagna orchestrata che contiene un’attività Carica file, ma non possono aggiungere l’attività o caricare un file.
- Gestisci file in campagne orchestrate — Necessario per aggiungere un’attività Carica file all’area di lavoro della campagna e caricare i file. Assegna questa autorizzazione a qualsiasi utente che deve creare o configurare un’attività Load file.
Per istruzioni sull’assegnazione delle autorizzazioni, vedere Gestione di utenti e ruoli.
Guardrail e limitazioni limitations
All’attività Load file si applicano le seguenti limitazioni:
- Puoi caricare fino a 50 MB per file.
- Sono supportati solo i file CSV e TXT a struttura piatta.
- I dati caricati vengono utilizzati durante l’esecuzione della campagna e non vengono memorizzati come set di dati di Adobe Experience Platform.
Per i limiti sulle attività dei canali e delle aree di lavoro, vedere Guardrail e limitazioni.
Prerequisiti prerequisites
Prima di poter aggiungere un’attività Load file a una campagna orchestrata e collegarla a un’attività messaggio, un amministratore deve completare la seguente configurazione una tantum.
Creare una dimensione di destinazione di tipo File file-target-dimension
Un Dimension di destinazione profilo di tipo File consente alle campagne orchestrate di risolvere i destinatari da un file caricato anziché da uno schema Adobe Experience Platform. Definisce lo spazio dei nomi dell’identità e il campo dell’identificatore utilizzati quando il pubblico del file viene elaborato durante l’esecuzione della campagna.
Crea una dimensione di destinazione da Amministrazione > Configurazioni > Dimension di destinazione di Campaign. Ulteriori informazioni sulle dimensioni di destinazione
Quando crei la dimensione di destinazione per il targeting basato su file, assicurati di:
- Imposta origine Dimension su File.
- Seleziona lo spazio dei nomi Identity che corrisponde alla colonna dell’identificatore nei tuoi file, ad esempio E-mail.
- Immetti il percorso campo identità. Utilizza il campo del file che contiene l’identificatore, ad esempio
emailse i file caricati includono una colonnaemail.
Creare una configurazione di canale per la distribuzione basata su file file-channel-configuration
Crea una configurazione di canale dedicata che utilizza la dimensione di destinazione di tipo File. Questa configurazione è selezionata nell’attività messaggio che segue l’attività Carica file nell’area di lavoro della campagna.
-
Passa a Amministrazione > Canali > Configurazioni canale e crea una nuova configurazione.
-
In Dettagli esecuzione, seleziona la scheda Campagne orchestrate e abilita la configurazione per le campagne orchestrate.
-
Nel campo Destinazione profilo Dimension, selezionare la dimensione di destinazione di tipo file creata nel passaggio precedente.
-
Completa i campi di configurazione dei canali rimanenti e salva. Ulteriori informazioni sulle configurazioni dei canali per le campagne orchestrate
Configurare l’attività Load file load-file-configuration
Configura l’attività in due parti: definisci la struttura del file prevista con un file di esempio, quindi specifica il file da caricare durante l’esecuzione della campagna.
-
Aggiungi un’attività Load file all’area di lavoro della campagna orchestrata.
-
Immetti un Etichetta per l’attività.
Definire il file di esempio sample-file
Utilizzare un file di esempio per configurare Colonne e Formattazione. I dati di esempio non vengono importati come pubblico della campagna.
-
Nella sezione File di esempio selezionare il file locale che definisce la struttura prevista.
note NOTE Il file di esempio viene utilizzato solo per configurare colonne e formattazione; i relativi dati non vengono importati come pubblico della campagna. Il formato deve corrispondere ai file che verranno caricati durante l’esecuzione della campagna. -
Nell’elenco a discesa Tipo file, specificare se il file utilizza colonne delimitate o colonne a larghezza fissa.
-
Nella sezione Colonne, espandi ogni colonna e configurane le proprietà.
Dopo aver selezionato un tipo di dati Tipo di dati, vengono visualizzate ulteriori opzioni per tale tipo. Espandi le sezioni seguenti per i parametri comuni a tutte le colonne e per le opzioni specifiche del tipo.
accordion Parametri comuni per le colonne -
Ignora colonna - Escludi la colonna dall’importazione se selezionata.
-
Etichetta — Nome visualizzato per la colonna (ad esempio,
email). -
Nome interno — Nome di sistema per la colonna, derivato dall’intestazione del file (sola lettura).
-
Tipo di dati — Tipo di dati nella colonna.
-
Consenti valori NULL - Specifica come gestire i valori vuoti nella colonna:
- Impostazione predefinita di Adobe Campaign - Genera un errore solo per i campi numerici. In caso contrario, inserisce un valore NULL.
- È consentito un valore vuoto — autorizza valori vuoti. Pertanto, viene inserito il valore NULL.
- Sempre popolato — Genera un errore se un valore è vuoto.
-
Errore durante l’elaborazione — definisce il comportamento in caso di errore nella colonna:
- Ignora il valore. Il valore viene ignorato.
- Rifiuta la riga — L’intera riga non viene elaborata.
- Utilizzare un valore predefinito in caso di errore — Sostituisce il valore che causa l’errore con un valore predefinito, definito nel campo Valore predefinito.
- Utilizzare un valore predefinito se il valore non viene rimappato — Sostituisce il valore che causa l’errore con un valore predefinito, definito nel campo Valore predefinito, a meno che non sia stata definita una mappatura per il valore errato.
- Rifiuta la riga quando non è presente alcun valore di mapping. L’intera riga non viene elaborata a meno che non sia stata definita una mappatura per il valore errato.
-
Valore predefinito — Valore predefinito da utilizzare quando Errore di elaborazione è impostato per l’utilizzo di un valore predefinito.
-
Nuova mappatura valori - Mappa valori specifici a nuovi valori. Fai clic su Aggiungi mapping per definire ogni mapping (ad esempio, sostituisci
True/Falsecon1/0).
accordion Parametri delle colonne stringa - Larghezza — Numero massimo di caratteri.
- Trasformazione dati - Trasformazione di maiuscole e minuscole applicata ai valori stringa (ad esempio, nessuna o maiuscole/minuscole).
- Gestione degli spazi vuoti: come gestire gli spazi iniziali o finali nei valori stringa.
accordion Parametri per colonne a numero intero e a numero mobile -
Formato — definisce la modalità di lettura dei valori numerici nel file:
- Altro — Definisci il Separatore delle migliaia e il Separatore decimale nella sezione Separatori.
- 1.000.00 — Virgola come separatore delle migliaia e punto come separatore decimale.
- 1 000,00 — Spazio come separatore delle migliaia e virgola come separatore decimale.
-
Separatori (quando Formato è Altro):
- Separatore delle migliaia - Carattere che raggruppa le migliaia in valori numerici (lasciare vuoto se non utilizzato).
- Separatore decimale - Carattere utilizzato per la parte decimale dei valori numerici (ad esempio,
,o.).
accordion Parametri delle colonne data e ora Le opzioni dipendono dal tipo di dati Tipo di dati: Data, Ora o Data e ora.
Data
-
Formato data — Pattern che corrisponde alla modalità di visualizzazione delle date nel file (ad esempio,
yyyy/mm/dd). -
Separatori:
- Anno, mese, giorno - Carattere tra i componenti anno, mese e giorno (ad esempio,
/).
- Anno, mese, giorno - Carattere tra i componenti anno, mese e giorno (ad esempio,
Ora
-
Formato ora — Schema che corrisponde al modo in cui le ore vengono visualizzate nel file (ad esempio,
13:30per ore e minuti di 24 ore). -
Separatori:
- Ora, minuto, secondo — Carattere tra i componenti ora, minuto e secondo (ad esempio,
:).
- Ora, minuto, secondo — Carattere tra i componenti ora, minuto e secondo (ad esempio,
Data e ora
- Formato data — Pattern che corrisponde alla modalità di visualizzazione della porzione di data nel file.
- Formato ora — Schema che corrisponde al modo in cui la porzione di tempo viene visualizzata nel file.
- Separatori — Caratteri tra i componenti data e ora.
-
-
Nella sezione Formattazione, specifica la struttura del file in modo che le righe e le colonne vengano lette correttamente durante l’esecuzione della campagna. Il file di destinazione deve utilizzare la stessa formattazione del file di esempio.
- Utilizza la prima riga come intestazione di colonna. Se selezionata, la prima riga del file viene considerata come nomi di colonna. Questa opzione è in genere abilitata quando configuri l’esempio da un file che include una riga di intestazione.
- Utilizzare un numero di riga come identificatore: se selezionata, ogni riga viene identificata dal relativo numero di riga nel file.
- I record si estendono su più righe. Se selezionata, un singolo record può estendersi su più righe nel file, ad esempio quando i campi contengono interruzioni di riga.
- Righe da ignorare — Numero di righe da ignorare all’inizio del file prima che i dati vengano letti (ad esempio, righe di commento o metadati).
- Fuso orario — Fuso orario applicato quando vengono importati i valori di data e ora.
- Codifica - Codifica caratteri del file. Seleziona la codifica corrispondente al file di origine.
- Delimitatore stringa — Carattere utilizzato per racchiudere i valori stringa nel file.
- Separatore colonne - Carattere che separa le colonne in un file delimitato.
-
Fai clic su Conferma per convalidare la configurazione del file di esempio.
Definire il file di destinazione target-file
Specifica il file da caricare all’esecuzione della campagna e come ogni riga corrisponde ai destinatari esistenti.
-
Nella sezione File di destinazione, seleziona il file CSV o TXT contenente il pubblico di destinazione.
note caution CAUTION Assicurati che il file di destinazione segua lo stesso formato, la stessa struttura delle colonne e lo stesso numero di colonne del file di esempio. -
Nella sezione Rifiuta gestione, definisci il comportamento dell’attività quando si verificano errori durante l’elaborazione del file:
- Numero di errori consentito — Numero massimo di errori consentiti prima che l’attività non riesca.
- Mantieni i rifiuti in un file — Se abilitata, le righe che non possono essere caricate vengono scritte in un file rifiutato sul server per la revisione dopo l’esecuzione.
-
Facoltativamente, abilitare Elimina file dopo l’importazione per rimuovere il file caricato dal server dopo l’esecuzione della campagna.
Dopo che il file di caricamento risolve il pubblico, connetti la transizione in uscita alle attività a valle. Scopri come orchestrare le attività della campagna