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.

IMPORTANTE

Tieni presente le seguenti restrizioni quando lavori con i file CDF:

  • Prima di configurare la distribuzione di file CDF, assicurati di disporre delle autorizzazioni appropriate da parte di fornitori di dati terzi per l’esportazione di caratteristiche di terze parti. Al momento, Audience Manager non supporta le funzionalità dell’interfaccia utente per richiedere l’autorizzazione di esportazione per la consegna di file CDF da Fornitori di dati di terze parti, quindi contatta l’utente in modo indipendente.
  • Non utilizzare CDF file come proxy per monitorare il traffico della pagina, riconciliare le discrepanze di report, o per la fatturazione, ecc.

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.

IMPORTANTE

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.

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.

Campo Tipo di dati Descrizione

Event Time

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:

Device

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.

Container ID

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.

Realized Traits

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.

Realized Segments

Array numerico

Array di ID segmento che contiene tutti i segmenti realizzati da un visitatore (qualificato per ) nella chiamata dell’evento.

Request Parameters

Stringa

Una stringa che acquisisce tutti i parametri (variabili, ID, coppie chiave-valore, ID pubblicità dispositivo, ecc.) passato nella chiamata dell'evento.

Esempio abbreviato:

d_rtbd:json,c_contextData.a.CarrierName:mobile,c_contextData.a.adid:92D56353-49C5-431E-B474-FC528D585810,c_contextData.a,RunMode:Application,c_contextData.a.DaysSinceLastUpgrade:61,d_cid_ic:xid%01EACB6E40-AC65-4012-9FE9-ABD59965E9C4%011,c_contextData.a.PrevSessionLength:583

Referer Data Type

Stringa

L’URL non codificato della pagina di riferimento (se presente).

IP Data Type

Stringa

L’indirizzo IP del visitatore acquisito nella chiamata dell’evento.

MCDevice

Stringa

La Experience Cloud ID (MID) assegnato al visitatore del sito. Vedi anche Cookie e il servizio Adobe Experience Platform Identity.

All Segments

Array numerico

Array di ID segmento che contiene i segmenti realizzati in precedenza e i nuovi segmenti per i quali il visitatore è qualificato.

All Traits

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.

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.

Elemento file CDF Descrizione

Separatori di campi e delimitatori

Questi caratteri non stampabili definiscono gli elementi e la struttura del file CDF:

  • Ctrl+a (ASCII) 001 o ^A) separa i dati dei singoli campi con un indicatore di spazio non stampabile.
  • Ctrl+b (ASCII) 002 o ^B) separa i dati da un array e richiede i parametri.
  • Ctrl+c (ASCII) 003 o ^C) definisce le coppie chiave-valore.

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.

  1. Ora evento
  2. Dispositivo
  3. ID contenitore
  4. Caratteristiche realizzate
  5. Segmenti realizzati
  6. Parametri di richiesta
  7. Referente
  8. Indirizzo IP
  9. ID dispositivo di Experience Cloud (o MID). Vedi anche Cookie e il servizio Adobe Experience Platform Identity
  10. Tutti i segmenti
  11. Tutte le caratteristiche

Per le descrizioni dei campi, consulta Contenuto del feed di dati cliente definito.

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.

Elemento Nome file Descrizione

s3://aam-cdf/

Questo è il bucket di archiviazione principale predefinito per il file CDF su un server Amazon S3.

your S3 bucket name

Il nome del bucket S3 di sola lettura che contiene i file CDF.

day=yyyy-mm-dd

Data di elaborazione del file.

hour=hh

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

partner ID

Il tuo ID partner.

File Sequence_0

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

.gz

Estensione del file gzip. I file CDF sono compressi con Gzip.

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

Campo Descrizione

Files

Avvia la matrice che contiene i metadati sui file CDF.

FileByteSize

Dimensione del file in byte.

FileChecksumMD5

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 ETag non è identico al checksum MD5 del file.

FileName

Nome del file. Vedi Convenzioni di denominazione dei file dei feed di dati cliente.

FileSequenceNumber

Numero di indice per ciascun file.

Oggetto Totals

Campo Descrizione

Totals

Avvia l'oggetto che contiene dati aggregati su tutti i file CDF.

Day

Il giorno per cui i dati sono disponibili. Usi aaaa-mm-gg formato.

Hour

L’ora per la quale i dati sono disponibili. Utilizza il formato 24 ore impostato nel fuso orario UTC.

TotalByteSize

Dimensione totale in byte di tutti i file CDF per quella data.

TotalNumberFiles

Numero totale di file caricati nella directory S3.

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.

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:
  • Non ci sono dati per quell'ora in particolare.
  • I nostri server sono sotto carichi pesanti e non possono elaborare i file per un'ora specifica. Quando il server raggiunge, inserisce i file che avrebbero dovuto essere presenti in un file bucket di una data precedente in un bucket con un valore di tempo successivo. Ad esempio, lo vedrai quando un file che dovrebbe essere stato nel bucket ore 17 appare nel bucket ore 18 (con hour=18 nel nome del file). In questo caso, probabilmente il server ha iniziato l'elaborazione del file nell'ora 17 ma non è riuscito a completarlo entro tale intervallo di tempo. Al contrario, il file viene inviato al bucket ora oraria successivo.

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.
Articoli correlati

In questa pagina