Customer Data Feeds

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.

Contenuto e scopo del file

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.

Introduzione

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:

• Imposta il tuo Amazon S3 bucket di archiviazione.
• Fornisci di sola lettura S3 credenziali di autenticazione nel bucket di archiviazione dei file. Non potrai visualizzare o accedere a directory e file appartenenti ad altri clienti.

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.

Passaggi successivi

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

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.

Definizioni

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.

Customer Data Feed Struttura dei file

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.

Identificatori dei campi dati e sequenza

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.

CDF Mappa dei file

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

Identificazione di array

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.

Esempio CDF File

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.

Customer Data Feed Convenzioni di denominazione dei file

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

CDF Nome file: Sintassi ed esempio

Tipico CDF il nome del 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 del nome file definiti

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

Customer Data Feed Notifiche di elaborazione dei file

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.

File di informazioni di esempio

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

Campi file di informazioni definiti

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

Oggetto Files

Oggetto Totals

Customer Data Feed I tempi e i tempi del contenuto dei file sono diversi

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.

Posizione CDF Marca temporale file

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

Comprendere la differenza tra le marche temporali

La tabella seguente fornisce ulteriori dettagli sulle CDF le marche temporali dei file e informazioni su come utilizzarle correttamente.