Show Menu
ARGOMENTI×

Importazione di dati

Modalità di raccolta dei dati

Utilizzo dei dati di un elenco: Leggi l'elenco

I dati inviati in un flusso di lavoro possono provenire da elenchi in cui i dati sono stati preparati e strutturati in anticipo.
Questo elenco potrebbe essere stato creato direttamente in Adobe Campaign o importato dall' Import a list opzione. Per ulteriori informazioni su questa opzione, consultate questa pagina .
Per ulteriori informazioni sull'utilizzo dell'attività di lettura dell'elenco in un flusso di lavoro, vedere Elenco di lettura.

Caricamento di dati da un file

I dati elaborati in un flusso di lavoro possono essere estratti da un file strutturato in modo che possano essere importati in Adobe Campaign.
Una descrizione dell'attività di caricamento dei dati è disponibile nella sezione Caricamento dati (file) .
Esempio di file strutturato da importare:
lastname;firstname;birthdate;email;crmID
Smith;Hayden;23/05/1989;hayden.smith@example.com;124365
Mars;Daniel;17/11/1987;dannymars@example.com;123545
Smith;Clara;08/02/1989;hayden.smith@example.com;124567
Durance;Allison;15/12/1978;allison.durance@example.com;120987

Estrazione o decrittografia di un file prima dell'elaborazione

Adobe Campaign consente di importare file compressi o crittografati. Prima di poter essere letti in un' Data loading (file) attività, potete definire una pre-elaborazione per decomprimere o decrittografare il file.
Per essere in grado di effettuare le seguenti operazioni:
  • Se l'installazione di Adobe Campaign è ospitata da Adobe: inviare una richiesta all' Assistenza per disporre delle utility necessarie installate sul server.
  • Se l'installazione di Adobe Campaign è in sede: installare l'utility che si desidera utilizzare (ad esempio: GPG, GZIP) e le chiavi necessarie (chiave di crittografia) sul server dell'applicazione.
  1. Aggiungete e configurate un' File transfer attività nel flusso di lavoro.
  2. Aggiungete un' Data loading (file) attività e definite il formato del file.
  3. Selezionare l' Pre-process the file opzione.
  4. Specificate il comando di pre-elaborazione da applicare. Ad esempio, per decifrare un file con PGP:
    <path-to_pgp_if-not_global_or_server/>pgp.exe --decrypt --input nl6/var/vp/import/filename.pgp --passphrase "your password" --recipient recipient @email.com --verbose --output nl6/var/vp/import/filename
    
    
  5. Aggiungere altre attività per gestire i dati provenienti dal file.
  6. Salvate ed eseguite il flusso di lavoro.
Quando esportate un file, potete anche comprimerlo o cifrarlo. Consultate Applicazione di un'aliquota o cifratura a un file .

Procedure ottimali per l'importazione dei dati

Essere cauti e seguire le poche semplici regole descritte di seguito aiuterà molto a garantire la coerenza dei dati all'interno del database e ad evitare errori comuni durante l'aggiornamento del database o le esportazioni di dati.

Utilizzo dei modelli di importazione

La maggior parte dei flussi di lavoro di importazione deve contenere le seguenti attività: Data loading (file) , Enrichment , Split , Deduplication , Update data .
Utilizzando i modelli di importazione è molto comodo preparare importazioni simili e garantire la coerenza dei dati all'interno del database. Scopri come creare modelli di workflow nella sezione Modelli di workflow.
In molti progetti, le importazioni vengono create senza Deduplication attività perché i file utilizzati nel progetto non hanno duplicati. Talvolta i duplicati vengono visualizzati durante l’importazione di file diversi. La deduplicazione è quindi difficile. Pertanto, un passaggio di deduplicazione è una buona precauzione in tutti i flussi di lavoro di importazione.
Non devi basarti sul presupposto che i dati in arrivo siano coerenti e corretti o che il reparto IT o il supervisore di Adobe Campaign se ne occuperanno. Durante il progetto, tenere presente la pulizia dei dati. Deduplicare, riconciliare e mantenere la coerenza quando si importano i dati.
Un esempio di modello di importazione è disponibile nella sezione Impostazione di una sezione di importazione ricorrente.

Uso dei formati di file semplici

Il formato più efficiente per le importazioni è rappresentato dai file semplici. I file flat possono essere importati in modalità collettiva a livello di database.
Ad esempio:
  • Separatore: tabulazione o punto e virgola
  • Prima riga con intestazioni
  • Nessun delimitatore di stringa
  • Formato data: AAAA/MM/GG HH:mm:SS
Adobe Campaign non è in grado di importare file XML utilizzando attività di importazione file standard. È possibile importare file XML utilizzando JavaScript ma solo con volumi ridotti: meno di 10K record per file.

Utilizzo di compressione e crittografia

Quando possibile, usate file ZIP per le importazioni e le esportazioni.
In Linux è possibile decomprimere un file e importarlo contemporaneamente utilizzando una riga di comando. Ad esempio:
zcat nl6/var/vp/import/filename.gz

È inoltre buona norma crittografare i file inviati in rete se non sono protetti. GPG può essere utilizzato per questo.

Caricamento dei dati in batch dai file

Il caricamento di dati in batch da un file è più efficace rispetto al caricamento di una riga alla volta e in tempo reale (ad esempio tramite un servizio Web).
Le importazioni che utilizzano i servizi Web non sono efficienti. È consigliabile utilizzare i file quando possibile.
È inoltre noto che la chiamata di servizi Web esterni per arricchire i profili in tempo reale causa problemi di prestazioni e perdite di memoria, perché funziona a livello di linea.
Se è necessario importare i dati, è meglio farlo in batch, utilizzando un flusso di lavoro, che in tempo reale, utilizzando un'applicazione Web o un servizio Web.

Utilizzo della gestione dei dati

Il caricamento in modalità iterativa (riga per riga) tramite JavaScript deve essere limitato a volumi di piccole dimensioni.
Per una migliore efficienza, utilizza sempre l' Data Loading (File) attività nei flussi di lavoro di gestione dei dati.

Importazione in modalità Delta

Le importazioni regolari devono essere effettuate in modalità delta. Significa che solo i dati nuovi o modificati vengono inviati ad Adobe Campaign, invece che l'intera tabella ogni volta.
Le importazioni complete devono essere utilizzate solo per il carico iniziale.
Importa i dati utilizzando la gestione dei dati anziché JavaScript.

Mantenimento della coerenza

Per mantenere la coerenza dei dati nel database Adobe Campaign, segui i principi riportati di seguito:
  • Se i dati importati corrispondono a una tabella di riferimento in Adobe Campaign, è necessario riconciliarla con tale tabella nel flusso di lavoro. I record che non corrispondono devono essere rifiutati.
  • Assicurarsi che i dati importati siano sempre "normalizzati" (e-mail, numero di telefono, indirizzo e-mail diretto) e che la normalizzazione sia affidabile e non cambi nel corso degli anni. In caso contrario, è probabile che nel database vengano visualizzati dei duplicati, e dato che Adobe Campaign non fornisce strumenti per effettuare la corrispondenza "sfocata", sarà molto difficile gestirli e rimuoverli.
  • I dati transazionali devono avere una chiave di riconciliazione e devono essere riconciliati con i dati esistenti al fine di evitare la creazione di duplicati.
  • Importa i file correlati in ordine .
    Se l’importazione è composta da più file che dipendono l’uno dall’altro, il flusso di lavoro deve verificare che i file vengano importati nell’ordine corretto. Quando un file ha esito negativo, gli altri file non vengono importati.
  • Deduplicare , riconciliare e mantenere la coerenza quando si importano i dati.

Impostazione di un'importazione ricorrente

L’utilizzo di un modello di importazione è una procedura consigliata se è necessario importare regolarmente file con la stessa struttura.
Questo esempio mostra come impostare un flusso di lavoro che può essere riutilizzato per importare profili provenienti da un CRM nel database Adobe Campaign. Per ulteriori informazioni su tutte le impostazioni possibili per ogni attività, consultate questa sezione .
  1. Crea un nuovo modello di workflow da Resources > Templates > Workflow templates .
  2. Aggiungete le seguenti attività:
    • Data loading (file) : Definire la struttura prevista del file contenente i dati da importare.
    • Enrichment : Riconciliare i dati importati con i dati del database.
    • Split : Creare filtri per elaborare i record in modo diverso a seconda che possano essere riconciliati o meno.
    • Deduplication : Deduplicare i dati dal file in entrata prima di essere inseriti nel database.
    • Update data : Aggiornate il database con i profili importati.
  3. Configurare l' Data Loading (file) attività:
    • Definite la struttura prevista caricando un file di esempio. Il file di esempio deve contenere solo poche righe, ma tutte le colonne necessarie per l'importazione. Controllare e modificare il formato del file per essere certi che il tipo di ogni colonna sia impostato correttamente: testo, data, numero intero, ecc. Ad esempio:
      lastname;firstname;birthdate;email;crmID
      Smith;Hayden;23/05/1989;hayden.smith@mailtest.com;123456
      
      
    • Nella Name of the file to load sezione, selezionare Upload a file from the local machine e lasciare il campo vuoto. Ogni volta che viene creato un nuovo flusso di lavoro da questo modello, potete specificare qui il file desiderato, purché corrisponda alla struttura definita.
      Potete utilizzare una qualsiasi delle opzioni, ma dovete modificare di conseguenza il modello. Ad esempio, se selezionate Specified in the transition , potete aggiungere un' File Transfer attività prima di recuperare il file da importare da un server FTP/SFTP. Con la connessione S3 o SFTP, puoi anche importare dati di segmento in Adobe Campaign con la piattaforma dati cliente in tempo reale Adobe. Per ulteriori informazioni, consulta questa documentazione .
  4. Configurare l' Enrichment attività. Lo scopo di questa attività in questo contesto è identificare i dati in arrivo.
    • Nella Enrichment scheda, selezionare Add data e definire un collegamento tra i dati importati e la dimensione di targeting dei destinatari. In questo esempio, il campo personalizzato ID ​CRM viene utilizzato per creare la condizione di partecipazione. Utilizzare il campo o la combinazione di campi necessari, purché sia possibile identificare record univoci.
    • Nella Reconciliation scheda, lasciate l' Identify the document from the working data opzione deselezionata.
  5. Configurare l' Split attività per recuperare i destinatari riconciliati in una transizione e i destinatari che non possono essere riconciliati ma che dispongono di dati sufficienti in una seconda transizione.
    La transizione con destinatari riconciliati può quindi essere utilizzata per aggiornare il database. La transizione con destinatari sconosciuti può quindi essere utilizzata per creare nuove voci di destinatari nel database se nel file è disponibile un insieme minimo di informazioni.
    I destinatari che non possono essere riconciliati e che non dispongono di dati sufficienti vengono selezionati in una transizione in uscita complementare e possono essere esportati in un file separato o semplicemente ignorati.
    • Nella General scheda dell'attività, selezionate Use the additional data only come impostazione di filtro e accertatevi che l' Targeting dimension impostazione sia automatica su Enrichment .
      Selezionare l' Generate complement opzione per verificare se non è possibile inserire alcun record nel database. Se necessario, è possibile applicare ulteriore elaborazione ai dati complementari: esportazione di file, aggiornamento di elenchi, ecc.
    • Nel primo sottoinsieme della Subsets scheda, aggiungi una condizione di filtro nella popolazione in entrata per selezionare solo i record per i quali la chiave primaria del destinatario non è uguale a 0. In questo modo, i dati del file riconciliati con i destinatari del database vengono selezionati in tale sottoinsieme.
    • Aggiungere un secondo sottoinsieme che selezioni record non riconciliati con dati sufficienti per essere inseriti nel database. Ad esempio: indirizzo e-mail, nome e cognome.
      I sottoinsiemi vengono elaborati nell'ordine di creazione, il che significa che quando viene elaborato questo secondo sottoinsieme, tutti i record già presenti nel database sono già selezionati nel primo sottoinsieme.
    • Tutti i record non selezionati nei primi due sottoinsiemi sono selezionati nella Complement .
  6. Configurate l' Update data attività situata dopo la prima transizione in uscita dell' Split attività configurata in precedenza.
    • Selezionate Update come Operation type perché la transizione in entrata contiene solo i destinatari già presenti nel database.
    • Nella Record identification sezione, selezionate Using reconciliation keys e definite una chiave tra la dimensione di targeting e il collegamento creato nella Enrichment . In questo esempio, viene utilizzato il campo personalizzato ID ​CRM.
    • Nella Fields to update sezione, indicare i campi dalla dimensione destinatari da aggiornare con il valore della colonna corrispondente dal file. Se i nomi delle colonne del file sono identici o quasi identici ai nomi dei campi dimensione destinatari, è possibile utilizzare il pulsante bacchetta magica per far corrispondere automaticamente i diversi campi.
  7. Configurate l' Deduplication attività che si trova dopo la transizione che contiene destinatari non riconciliati:
    • Selezionate Edit configuration e impostate la dimensione di targeting sullo schema temporaneo generato dall' Enrichment attività del flusso di lavoro.
    • In questo esempio, il campo e-mail viene utilizzato per trovare profili univoci. Potete utilizzare qualsiasi campo sicuramente compilato e parte di una combinazione univoca.
    • Nella Deduplication method schermata, selezionate Advanced parameters e selezionate l' Disable automatic filtering of 0 ID records opzione per fare in modo che i record con una chiave primaria uguale a 0 (che dovrebbe essere tutti i record di questa transizione) non siano esclusi.
  8. Configurate l' Update data attività che si trova dopo che l' Deduplication attività è stata configurata in precedenza.
    • Selezionate Insert come Operation type perché la transizione in entrata contiene solo i destinatari non presenti nel database.
    • Nella Record identification sezione, selezionate Directly using the targeting dimension e scegliete la Recipients quota.
    • Nella Fields to update sezione, indicare i campi dalla dimensione destinatari da aggiornare con il valore della colonna corrispondente dal file. Se i nomi delle colonne del file sono identici o quasi identici ai nomi dei campi dimensione destinatari, è possibile utilizzare il pulsante bacchetta magica per far corrispondere automaticamente i diversi campi.
  9. Dopo la terza transizione dell' Split attività, aggiungete un' Data extraction (file) attività e un' File transfer attività se desiderate tenere traccia dei dati non inseriti nel database. Configurate queste attività per esportare la colonna desiderata e per trasferire il file su un server FTP o SFTP in cui potete recuperarlo.
  10. Aggiungete un' End attività e salvate il modello di workflow.
Ora è possibile utilizzare il modello ed è disponibile per ogni nuovo flusso di lavoro. È quindi necessario specificare il file contenente i dati da importare nell' Data loading (file) attività.