Informazioni di base Customer Data Feed (CDF) file e istruzioni su come iniziare. Inizia qui se sei interessato a ricevere CDF file o solo per altre informazioni.
Un file CDF contiene gli stessi dati che una chiamata evento di Audience Manager (/event
) invia ai nostri server. Ciò include dati come ID utente, trait IDs, segment IDse tutti gli altri parametri acquisiti da una chiamata evento. Interno Audience Manager elabora i dati evento in un CDF file con contenuto organizzato in campi che vengono visualizzati in un ordine impostato. Audience Manager cerca di generare CDF file ogni ora e li memorizza in un bucket sicuro specifico per il cliente su un Amazon S3 server. Forniamo questi file in modo da poter lavorare con Audience Manager dati al di fuori dei limiti imposti dalla nostra interfaccia utente.
Tieni presente le seguenti restrizioni quando lavori con i file CDF:
Nessun processo self-service da avviare CDF consegna dei file. Contatta il tuo Audience Manager per iniziare, rivolgiti al consulente o all’Assistenza clienti. Durante l’implementazione, la Audience Manager il rappresentante:
Notifiche e CDF i file verranno visualizzati nel S3 quando sono pronti per il download. Sei responsabile del monitoraggio e del download dei file dal tuo assegnato S3 directory. Consulta Customer Data Feed File Processing Notifications.
Le sezioni seguenti e Domande frequenti sui feed di dati cliente può aiutarti a acquisire maggiore familiarità con questo servizio.
Elenca e definisce gli elementi dati e gli array in un CDF file, in ordine di aspetto. Le definizioni includono tipi di dati, ma queste informazioni non fanno parte di un CDF file.
I pixel dell’evento sono esclusi per impostazione predefinita nelle configurazioni CDF. Accertati di specificare nella richiesta all’assistenza clienti se desideri includere i pixel dell’evento nei file CDF. Ogni pixel evento verrà popolato come riga univoca nei file CDF.
A CDF Il file include alcuni o tutti i campi definiti di seguito. Per informazioni sull’organizzazione interna dei file, consulta Struttura dei file feed dati cliente.
Campo | Tipo di dati | Descrizione |
---|---|---|
|
Timestamp |
L’ora in cui un file CDF è stato elaborato da Server di raccolta dati (DCS). La marca temporale utilizza la variabile aaaa-mm-gg hh:mm:ss e viene impostato nel fuso orario UTC.
Nota: Ora evento non:
|
|
Stringa |
Questa è la ID utente univoco (UUID), che è un ID dispositivo a 38 cifre per il visitatore del sito. Vedi anche Indice degli ID nell’Audience Manager. |
|
Numeriche |
ID del contenitore che attiva la sincronizzazione degli ID. Questo campo viene compilato solo se imposti l'ID del contenitore nel d_nsid all'interno dell'implementazione del sito. In caso contrario, il valore predefinito pari a 0 non sarà incluso nei file CDF. |
|
Array numerico |
Array di ID di caratteristiche che contiene tutte le caratteristiche realizzate (idonee) da un visitatore nella chiamata dell’evento. L’array può contenere caratteristiche per le quali il visitatore si è qualificato in precedenza e per le quali è stato riqualificato tramite questa chiamata dell’evento. |
|
Array numerico |
Array di ID segmento che contiene tutti i segmenti realizzati da un visitatore (qualificato per ) nella chiamata dell’evento. |
|
Stringa |
Una stringa che acquisisce tutti i parametri (variabili, ID, coppie chiave-valore, ID pubblicità dispositivo, ecc.) passato nella chiamata dell'evento. Esempio abbreviato: |
|
Stringa |
L’URL non codificato della pagina di riferimento (se presente). |
|
Stringa |
L’indirizzo IP del visitatore acquisito nella chiamata dell’evento. |
|
Stringa |
La Experience Cloud ID (MID) assegnato al visitatore del sito. Vedi anche Cookie e il servizio Adobe Experience Platform Identity. |
|
Array numerico |
Array di ID segmento che contiene i segmenti realizzati in precedenza e i nuovi segmenti per i quali il visitatore è qualificato. |
|
Array numerico |
Array di ID di caratteristiche di prime e terze parti contenenti caratteristiche realizzate in precedenza e nuove caratteristiche per le quali il visitatore si è qualificato dall’ultimo feed di dati generato. |
Elenca e definisce la struttura dati di un CDF file. Sono inclusi sequenza di dati, delimitatori e separatori di campi, una mappa file di dati e un file di esempio.
CDF i file non contengono colonne o intestazioni di campo con etichetta. Invece, un CDF il file definisce campi e array con elementi non stampabili ASCII caratteri. Inoltre, il CDF in questo file vengono elencati tutti i campi e gli array in un ordine specifico. La comprensione degli identificatori e dell’ordine dei campi consente di analizzare correttamente il file.
Elemento file CDF | Descrizione |
---|---|
Separatori di campi e delimitatori |
Questi caratteri non stampabili definiscono gli elementi e la struttura del file CDF:
|
Sequenza campi |
Importante: Audience Manager si riserva il diritto di aggiungere nuovi campi alla fine del file CDF nelle versioni future. Ciò significa che la progettazione tecnica del sistema di analisi dei file non deve assumere un numero fisso di colonne (anche se può assumere un ordine fisso per le colonne esistenti). I dati nel file CDF vengono visualizzati nell’ordine indicato di seguito. /N può apparire al posto di uno qualsiasi di questi campi, indicando un valore nullo.
Per le descrizioni dei campi, consulta Contenuto del feed di dati cliente definito. |
CDF i dati del file vengono visualizzati nell’ordine indicato di seguito.
Array in un CDF inizio e fine del file con Ctrl + a
separatore di campo. In questo modo il primo elemento di un array viene visualizzato come un campo dati autonomo. Ad esempio, il traits inizia con ^A1234
. ID e delimitatore della matrice ^B5678
segue questa voce. Di conseguenza, potreste essere tentati di pensare che il primo elemento nel realizzato traits array è ID 5678 (perché inizia con ^B
). Questo non è il caso, ed è per questo che devi avere familiarità con la sequenza e la struttura di un file di dati. Anche se il primo elemento nel realizzato trait array (o qualsiasi altro array in un CDF file) inizia con ^A
, l’ordine di aspetto o di posizione nel file definisce l’inizio di una matrice. Inoltre, il primo elemento di un array è sempre separato dalla voce precedente da ^A
.
Un campione CDF il file potrebbe avere un aspetto simile al seguente. In questo esempio sono state inserite interruzioni di riga per adattarle alla pagina.
Le sezioni seguenti elencano e definiscono gli elementi nel tuo CDF nome file.
Tipico CDF il nome del file contiene gli elementi elencati di seguito. Nota: corsivo indica un segnaposto variabile:
s3://aam-cdf/YOUR-S3-BUCKET-NAME/day=yyyy-mm-dd/hour=hh/AAM-CDF_PARTNER-ID_FILE-SEQUENCE_0.gz
s3://aam-cdf/dataCompany/day=2017-09-14/hour=17/AAM_CDF_1234_0_0_0.gz
Nel tuo S3 bucket di archiviazione, i file vengono ordinati in ordine crescente per ID partner (PID), giorno e ora.
Nella tabella seguente sono elencati e definiti gli elementi in un CDF nome file.
Elemento Nome file | Descrizione |
---|---|
|
Questo è il bucket di archiviazione principale predefinito per il file CDF su un server Amazon S3. |
|
Il nome del bucket S3 di sola lettura che contiene i file CDF. |
|
Data di elaborazione del file. |
|
Un valore di ora espresso in notazione 24 ore e impostato nel fuso orario UTC. Vedi anche Tempi dei file dei feed di dati cliente e tempi dei file.... |
|
Il tuo ID partner. |
|
Valori che identificano la sequenza di file. La sequenza viene incrementata come segue: 0_0_0 , 0_1_0, 0_2_0....1_0_0 |
|
Estensione del file gzip. I file CDF sono compressi con Gzip. |
Audience Manager scrive .info
file al tuo S3 per sapere quando Customer Data File (CDF) è pronto per il download. La .info
include anche JSON metadati formattati sul contenuto del CDF file. Leggi questa sezione per informazioni sulla sintassi e sui campi utilizzati da questo file di notifica.
Ogni .info
contiene un file Files
e Totals
sezione . La Files
contiene un array che contiene metriche specifiche per ciascun file ogni ora. La Totals
contiene metriche aggregate in tutti i CDF file per un giorno particolare. I contenuti .info
potrebbe essere simile al seguente esempio.
{
"Files": [
{
"FileByteSize": 2709730,
"FileChecksumMD5": "a9ea418e79511642cff11c2a898037dc-1",
"FileName": "AAM_CDF_1109_000000_0.gz",
"FileSequenceNumber": 1
},
{
"FileByteSize": 2783351,
"FileChecksumMD5": "7b469485d60274b6991acd0817855840-3",
"FileName": "AAM_CDF_1109_000001_0.gz",
"FileSequenceNumber": 2
}
],
"Totals": {
"Day": "2017-09-26",
"Hour": "18",
"TotalByteSize": 150092997,
"TotalNumberFiles": 2
}
}
Le tabelle seguenti elencano e definiscono gli elementi in un CDF .info
file.
Campo | Descrizione |
---|---|
|
Avvia la matrice che contiene i metadati sui file CDF. |
|
Dimensione del file in byte. |
|
Amazon S3 ETag. Il numero che segue il trattino mostra il numero di parti utilizzate per creare il file durante il caricamento in più parti. La |
|
Nome del file. Vedi Convenzioni di denominazione dei file dei feed di dati cliente. |
|
Numero di indice per ciascun file. |
Campo | Descrizione |
---|---|
|
Avvia l'oggetto che contiene dati aggregati su tutti i file CDF. |
|
Il giorno per cui i dati sono disponibili. Usi aaaa-mm-gg formato. |
|
L’ora per la quale i dati sono disponibili. Utilizza il formato 24 ore impostato nel fuso orario UTC. |
|
Dimensione totale in byte di tutti i file CDF per quella data. |
|
Numero totale di file caricati nella directory S3. |
Le CDF il file contiene timestamp nel nome del file e nel contenuto del file. Queste marche temporali registrano diversi processi evento per lo stesso CDF file. Non è raro visualizzare marche temporali diverse nel nome e nel contenuto dello stesso file. La comprensione di ogni marca temporale può aiutarti a evitare errori comuni quando lavori con questi dati o provi a ordinarli per tempo.
CDF i file registrano il tempo in modo diverso in 2 posizioni separate.
La tabella seguente fornisce ulteriori dettagli sulle CDF le marche temporali dei file e informazioni su come utilizzarle correttamente.
Posizione timestamp | Descrizione |
---|---|
Nome file | La marca temporale nel CDF il nome del file indica il momento in cui Audience Manager avvio della preparazione del file per la consegna. Questa marca temporale è impostata nel UTC fuso orario. Utilizza il hour= , con tempo formattato come ora a 2 cifre in notazione a 24 ore. Questa ora può essere diversa da quella registrata nel contenuto del file. Quando si lavora con CDF file, a volte noterai che S3 il secchio è vuoto per un'ora particolare. Un bucket vuoto indica che può indicare uno dei seguenti elementi:
Importante: Non utilizzare la marca temporale del nome file per raggruppare gli eventi per ora. Se devi raggruppare per tempo, utilizza la EventTime marca temporale nel contenuto del file. |
Contenuto del file | La marca temporale nel CDF il contenuto del file indica l'ora Data Collection Servers avvio dell'elaborazione del file. Questa marca temporale è impostata nel UTC fuso orario. Utilizza il EventTime campo, con il tempo formattato come yyyy-mm-dd hh:mm:ss . Questa ora è vicina all'ora effettiva dell'evento sulla pagina, ma può essere diversa dall'indicatore dell'ora nel nome del file. Suggerimento: A differenza di hour= marca temporale nel nome del file, puoi utilizzare EventTime per raggruppare i dati in base al tempo. |