Customer Data Feeds customer-data-feeds

Informazioni di base su Customer Data Feed (CDF) file e istruzioni su come iniziare. Inizia qui se sei interessato a ricevere CDF o semplicemente per ottenere ulteriori informazioni.

Contenuto e finalità del file file-contents-purpose

Un file CDF contiene gli stessi dati che una chiamata evento di Audience Manager (/event) invia ai nostri server. Ciò include dati come gli ID utente, trait IDs, segment IDse tutti gli altri parametri acquisiti da una chiamata evento. Interno Audience Manager system elabora i dati evento in una CDF file con contenuto organizzato in campi che vengono visualizzati in un ordine preimpostato. Audience Manager tenta 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 che tu possa utilizzare Audience Manager dati al di fuori dei limiti imposti dalla nostra interfaccia utente.

Introduzione getting-started

Nessun processo self-service da avviare CDF consegna dei file. Contatta il tuo Audience Manager consulente o assistenza clienti. Durante l'implementazione, Audience Manager il rappresentante:

Notifiche sui file 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 S3 directory. Consulta Customer Data Feed File Processing Notifications.

Passaggi successivi next-steps

Le sezioni seguenti e Domande frequenti sui feed di dati cliente può aiutarti a acquisire maggiore familiarità con questo servizio.

Customer Data Feed Contenuto definito cdf-defined

Elenca e definisce gli elementi dati e gli array in una CDF file, in ordine di visualizzazione. Le definizioni includono i tipi di dati, ma queste informazioni non fanno parte di un CDF file.

Definizioni definitions

A CDF Il file include alcuni o tutti i campi definiti di seguito. Per informazioni sull'organizzazione interna dei file, vedere Struttura del file di feed dati del cliente.

Customer Data Feed Struttura dei file cdf-file-structure

Elenca e definisce la struttura dati di un CDF file. Ciò include sequenza di dati, delimitatori di campo e separatori, una mappa del file di dati e un file di esempio.

Identificatori e sequenza dei campi dati identifiers-and-sequence

CDF i file non contengono colonne con etichetta o intestazioni di campo. Invece, un’ CDF file definisce campi e array senza funzionalità di stampa ASCII caratteri. Inoltre, il CDF file elenca ogni campo e matrice in un ordine specifico. Comprendere gli identificatori e l’ordine dei campi ti aiuterà ad analizzare correttamente il file.

CDF Mappa file cdf-file-map

CDF i dati del file vengono visualizzati nell'ordine indicato di seguito.

Identificazione degli array

Array in un CDF inizio e fine 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 l’array inizia con ^A1234. Il delimitatore e l’ID della matrice ^B5678 segue questa voce. Di conseguenza, si potrebbe essere tentati di pensare che il primo elemento nel realizzato traits l'array è l'ID 5678 (perché inizia con ^B). In caso contrario, ecco perché è necessario avere familiarità con la sequenza e la struttura di un file di dati. Anche se il primo elemento nella trait array (o uno qualsiasi degli altri array in un CDF file) inizia con ^A, l'ordine di visualizzazione o la posizione nel file definisce l'inizio di un array. Il primo elemento di un array è sempre separato dalla voce precedente da ^A.

Esempio CDF File sample-file

Un esempio CDF potrebbe avere un aspetto simile al seguente. Abbiamo inserito interruzioni di riga in questo esempio per adattarlo alla pagina.

Customer Data Feed Convenzioni di denominazione dei file cdf-naming-conventions

Le sezioni seguenti elencano e definiscono gli elementi nel CDF nome file.

CDF Nome file: sintassi ed esempio cdf-file-name

Un tipico CDF il nome file contiene gli elementi elencati di seguito. Nota: corsivo indica un segnaposto variabile:

Sintassi

s3://aam-cdf/YOUR-S3-BUCKET-NAME/day=yyyy-mm-dd/hour=hh/AAM-CDF_PARTNER-ID_FILE-SEQUENCE_0.gz

Esempio

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.

CDF Elementi nome file definiti cdf-file-name-elements

Nella tabella seguente sono elencati e definiti gli elementi di un CDF nome file.

Customer Data Feed Notifiche elaborazione file cdf-file-processing-notifications

Audience Manager scrive un .info file nel tuo S3 directory per comunicare quando Customer Data File (CDF) è pronto per il download. Il .info Il file include anche JSON metadati formattati sul contenuto del CDF file. Consulta questa sezione per informazioni sulla sintassi e i campi utilizzati da questo file di notifica.

File di informazioni di esempio sample-info-file

Ogni .info il file contiene un Files e Totals sezione. Il Files contiene un array che contiene metriche specifiche per ciascun file orario. Il Totals contiene metriche aggregate in tutte le CDF per un giorno specifico. Contenuto della .info potrebbe essere simile all'esempio seguente.

{
    "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
    }
}

Campi file informazioni definiti info-file-fields-defined

Le tabelle seguenti elencano e definiscono gli elementi in un CDF .info file.

Oggetto Files

Oggetto Totals

Customer Data Feed I tempi del nome file e del contenuto file sono diversi different-processing-times

Il tuo CDF il file contiene marche temporali nel nome e nel contenuto del file. Queste marche temporali registrano diversi processi evento per lo stesso CDF file. Non è raro vedere marche temporali diverse nel nome e nel contenuto dello stesso file. Comprendere ogni marca temporale può aiutarti a evitare errori comuni quando lavori con questi dati o provi a ordinarli in base all’ora.

Individuazione CDF Timestamp file locating-timestamps

CDF i file registrano il tempo in modo diverso in 2 posizioni separate.

Comprensione della differenza tra marche temporali understanding-timestamps

La tabella seguente fornisce ulteriori dettagli sul CDF archiviare i timestamp insieme alle informazioni su come utilizzarli correttamente.