Customer Data Feeds

Informazioni di base sui file Customer Data Feed (CDF) e istruzioni su come iniziare. Iniziate da qui se siete interessati a ricevere CDF file o volete solo ulteriori informazioni.

Contenuto file e scopo

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 IDs e tutti gli altri parametri acquisiti da una chiamata evento. I sistemi Audience Manager interni elaborano i dati evento in un file CDF con il contenuto organizzato in campi che vengono visualizzati in un ordine impostato. Audience Manager tenta di generare CDF i file ogni ora e li memorizza in un bucket sicuro e specifico per il cliente su un Amazon S3 server. Forniamo questi file in modo che possiate lavorare con i dati Audience Manager al di fuori dei limiti imposti dalla nostra interfaccia utente.

Introduzione

Non è disponibile alcun processo self-service per avviare la consegna dei file CDF. Contatta il tuo Audience Manager consulente o l'Assistenza clienti per iniziare. Durante l'implementazione, il tuo Audience Manager rappresentante:

• Configurare il bucket di storage Amazon S3.
• Fornire le credenziali di autenticazione S3 di sola lettura al bucket di archiviazione file. Non potrai vedere né accedere a directory e file appartenenti ad altri clienti.

Le notifiche dei file e i file CDF verranno visualizzati nel bucket S3 quando sono pronti per il download. Sei responsabile del monitoraggio e del download dei file dalla directory S3 assegnata. Consulta Customer Data Feed File Processing Notifications.

Passaggi successivi

Le sezioni seguenti e le Domande frequenti sui feed di dati cliente possono aiutarti a familiarizzare con questo servizio.

Customer Data Feed Contenuto definito

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

Definizioni

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

Customer Data Feed Struttura file

Elenca e definisce la struttura dati di un file CDF. Sono inclusi sequenza di dati, delimitatori e separatori di campi, una mappa di file di dati e un file di esempio.

Identificatori dei campi dati e sequenza

CDF i file non contengono colonne con etichetta o intestazioni di campo. Al contrario, un file CDF definisce campi e array con caratteri ASCII non stampabili. Inoltre, il file CDF elenca ogni campo e array in un ordine specifico. La comprensione degli identificatori e dell'ordine dei campi facilita l'analisi del file.

CDF Mappa file

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

Identificazione degli array

Gli array in un file CDF iniziano e terminano con il separatore di campo Ctrl + a. In questo modo il primo elemento di una matrice viene visualizzato come un campo di dati standalone. Ad esempio, l'array traits realizzato inizia con ^A1234. Il delimitatore e l'ID della matrice ^B5678 seguono questa voce. Di conseguenza, si potrebbe essere tentati di pensare che il primo elemento nell'array traits realizzato sia ID 5678 (perché inizia con ^B). Questo non è il caso, motivo per cui è necessario avere familiarità con la sequenza e la struttura di un file di dati. Anche se il primo elemento nell'array trait realizzato (o qualsiasi altro array in un file CDF) inizia con ^A, l'ordine di aspetto o di posizione nel file definisce l'inizio di un array. Inoltre, il primo elemento di un array è sempre separato dalla voce precedente da ^A.

Esempio di file CDF

Un file di esempio CDF potrebbe essere 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 nome del file CDF.

CDF Nome file: Sintassi ed esempio

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

Sintassi

s3://aam-cdf/YOUR-S3-BUCKET-NAME/day=yyyy-mm-dd/hour=hh/AAM-CDF-PARTNER-ID-AAM PROCESS-ID_0.gz

Esempio

s3://aam-cdf/dataCompany/day=2017-09-14/hour=17/AAM_CDF_1234_000058_0.gz

Nel periodo di S3 archiviazione, i file vengono ordinati in ordine crescente in base all'ID partner (PID), al giorno e all'ora.

CDF Elementi nome file definiti

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

Customer Data Feed Notifiche di elaborazione dei file

Audience Manager scrive un .info file nella S3 directory per informarvi quando Customer Data File (CDF) è pronto per il download. Il file .info include anche i metadati JSON formattati relativi al contenuto dei file CDF. Leggere questa sezione per informazioni sulla sintassi e i campi utilizzati da questo file di notifica.

File di informazioni di esempio

Ogni file .info contiene una sezione Files e Totals. La sezione Files contiene un array che contiene metriche specifiche per ciascun file ogni ora. La sezione Totals contiene metriche aggregate per tutti i file CDF relativi a un giorno specifico. Il contenuto del file .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 di file di informazioni definiti

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

Oggetto Files

Oggetto Totals

Customer Data Feed I tempi dei nomi dei file e i tempi dei contenuti dei file sono diversi

Il file CDF contiene marche temporali nel nome del file e nel contenuto del file. Queste marche temporali registrano diversi processi di evento per lo stesso file CDF. Non è raro che il nome e il contenuto dello stesso file contengano marche temporali diverse. La comprensione di ciascuna marca temporale può aiutarti a evitare errori comuni quando lavori con questi dati o cerchi di ordinarli per ora.

Individuazione delle marche temporali CDF del file

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

Differenza tra le marche temporali

Nella tabella seguente sono riportati ulteriori dettagli sulle marche temporali dei file CDF, oltre a informazioni su come utilizzarle correttamente.