Show Menu
ARGOMENTI×

Feed dati cliente

Informazioni di base sui Customer Data Feed (CDF) file 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 CDF file contiene gli stessi dati che una chiamata Audience Manager evento ( /event ) invia ai nostri server. Ciò include dati come ID utente, ID caratteristica, ID segmento e tutti gli altri parametri acquisiti da una chiamata evento. I Audience Manager sistemi interni elaborano i dati evento in un CDF file 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 Audience Manager i dati oltre i limiti imposti dalla nostra interfaccia utente.
Non utilizzare CDF i file come proxy per monitorare il traffico delle pagine, riconciliare le discrepanze dei rapporti, o per la fatturazione, ecc.

Introduzione

Non esiste un processo self-service per avviare la consegna dei CDF file. Contact your Audience Manager consultant or Customer Care to get started. Durante l'implementazione, il Audience Manager rappresentante:
  • Configurare il bucket Amazon S3 di archiviazione.
  • Fornire le credenziali di autenticazione di sola lettura S3 al bucket di archiviazione file. Non potrai vedere né accedere a directory e file appartenenti ad altri clienti.
Le notifiche e CDF i file vengono visualizzati nel S3 bucket quando sono pronti per il download. Siete responsabili del monitoraggio e del download dei file dalla S3 directory assegnata. Consulta Notifiche di elaborazione dei file feed di dati cliente.

Passaggi successivi

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

Contenuto feed dati cliente definito

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

Definizioni

Un CDF file 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.
Campo Tipo di dati Descrizione
Event Time
Timestamp
L'ora in cui un file CDF è stato elaborato dai server di raccolta dati (DCS). Il timestamp utilizza il formato yyyy-mm-dd hh:mm:ss ed è impostato nel fuso orario UTC.
Nota: L'ora evento non è :
  • L'ora dell'evento pagina o l'evento si chiama da sola, anche se potrebbe essere vicino a tali ore.
  • Relativo all’ora DCS nel nome del file. Vedi anche: Data Feed File Time Nome e File Content Times...
Device
Stringa
Si tratta dell’ ID utente univoco (UUID), un ID dispositivo di 38 cifre per il visitatore del sito. Vedi anche, Indice degli ID in Audience Manager .
Container ID
Numeriche
ID del contenitore che attiva la sincronizzazione ID.
Realized Traits
Matrice numerica
Un array di ID caratteristica che contiene tutte le caratteristiche realizzate (qualificate) da un visitatore nella chiamata all’evento.
L’array può contenere caratteristiche per le quali il visitatore ha già acquisito i requisiti necessari e per le quali è stato riqualificato tramite questa chiamata all’evento.
Realized Segments
Matrice numerica
Un array di ID di segmento che contiene tutti i segmenti realizzati (qualificati) da un visitatore nella chiamata all’evento.
Request Parameters
Stringa
Una stringa che acquisisce tutti i parametri (variabili, ID, coppie chiave-valore, ID pubblicità dispositivo, ecc.) passato alla 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
L’ Experience Cloud ID (MID) assegnato al visitatore del sito. Vedi anche Cookie e il servizio Experience Cloud ID.
All Segments
Matrice numerica
Un array di ID di segmento che contiene segmenti realizzati in precedenza e nuovi segmenti per i quali il visitatore è qualificato.
All Traits
Matrice numerica
Un array di ID di caratteristiche di prime e terze parti che contiene caratteristiche realizzate in precedenza e caratteristiche nuove per le quali il visitatore si è qualificato dall’ultimo feed di dati generato.

Struttura dei file feed di dati cliente

Elenca e definisce la struttura dati di un CDF file. 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 CDF file definisce campi e array con ASCII caratteri non stampabili. Inoltre, il CDF file elenca ciascun campo e array in un ordine specifico. La comprensione degli identificatori e dell'ordine dei campi facilita l'analisi del 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 di singoli campi con un indicatore dello 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 release 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.
  1. Ora evento
  2. Dispositivo
  3. ID contenitore
  4. Caratteristiche realizzate
  5. Segmenti Realizzati
  6. Parametri di richiesta
  7. Referente
  8. Indirizzo IP
  9. Experience Cloud Device ID (o MID). See also, Cookies and the Experience Cloud ID Service
  10. Tutti i segmenti
  11. Tutte le caratteristiche
Per le descrizioni dei campi, vedi Contenuto feed dati cliente definito .

Mappa file CDF

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

Identificazione degli array

Gli array di un CDF file iniziano e terminano con il separatore di Ctrl + a campo. In questo modo il primo elemento di una matrice viene visualizzato come un campo di dati standalone. Ad esempio, l'array di caratteristiche realizzate inizia con ^A1234 . Il delimitatore e l'ID della matrice ^B5678 seguono questa voce. Di conseguenza, potreste essere tentati di pensare che il primo elemento nell'array di caratteristiche realizzate 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 di caratteristiche realizzato (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 per ^A .

Esempio di file CDF

Un CDF file di esempio potrebbe essere simile al seguente. In questo esempio sono state inserite interruzioni di riga per adattarle alla pagina.

Convenzioni di denominazione dei file feed di dati cliente

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

Nome file CDF: Sintassi ed esempio

Un nome CDF file tipico contiene gli elementi elencati di seguito. Note, italics indicates a variable placeholder:

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.

Elementi CDF Nome File Definiti

Nella tabella seguente sono elencati e definiti gli elementi presenti nel nome di un CDF file.
Elemento nome file Descrizione
s3://aam-cdf/
Si tratta del bucket di memorizzazione 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 a 24 ore e impostato nel fuso orario UTC. Vedi anche: Data Feed File Time Nome e File Content Times...
partner ID
Il tuo ID partner.
AAM process ID _0
Un ID processo interno Audience Manager .
.gz
Estensione del file gzip. I file CDF vengono compressi con gzip.

Notifiche di elaborazione dei file feed di dati cliente

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

Esempio di file

Ogni .info file contiene una Files sezione e Totals . La Files sezione contiene un array che contiene metriche specifiche per ciascun file ogni ora. La Totals sezione contiene metriche aggregate per tutti i CDF file per un giorno particolare. Il contenuto del .info file 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 Info 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 relativi ai 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 di più parti. Il valore non ETag è identico al checksum MD5 del file.
FileName
Nome del file. Consulta Convenzioni di denominazione dei file 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 il quale i dati sono disponibili. Utilizza il formato yyyy-mm-dd .
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 tale data.
TotalNumberFiles
Numero totale di file caricati nella directory S3.

Il nome del file dei feed di dati del cliente e i tempi di contenuto del file sono diversi

Il CDF file contiene marche temporali nel nome del file e nel contenuto del file. Tali marche temporali registrano diversi processi di evento per lo stesso CDF file. 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 dei file CDF

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

Differenza tra marche temporali

La tabella seguente fornisce ulteriori dettagli sulle marche temporali CDF del file e informazioni su come utilizzarle correttamente.
Posizione timestamp
Descrizione
Nome file
La marca temporale nel nome del file CDF indica l’ora in cui è Audience Manager iniziata la preparazione del file per la consegna. Questa marca temporale è impostata nel fuso orario UTC. Utilizza il hour= parametro, con il tempo formattato come ora a 2 cifre nella notazione a 24 ore. Questa ora può essere diversa da quella registrata nel contenuto del file. BREAKWquando si lavora con file CDF, a volte si noterà che il bucket S3 è vuoto per un'ora particolare. Un bucket vuoto può indicare una delle seguenti situazioni:
  • Non ci sono dati per quella particolare ora.
  • I nostri server sono sottoposti a carichi pesanti e non possono elaborare i file per un'ora particolare. Quando il server raggiunge, inserisce i file che avrebbero dovuto passare in un bucket di tempo precedente in un bucket con un valore di ora successivo. Ad esempio, questo verrà visualizzato quando un file che avrebbe dovuto essere nel bucket ore 17 viene visualizzato nel bucket ore 18 (con hour=18 nel nome del file). In questo caso, il server probabilmente ha iniziato l'elaborazione del file nell'ora 17 ma non è stato possibile completarlo entro tale intervallo di tempo. Al contrario, il file viene inviato al bucket orario successivo.
Importante : Non utilizzate la marca temporale del nome del file per raggruppare gli eventi per ora. Per raggruppare in base all’ora, usate la EventTime marca temporale nel contenuto del file.
Contenuto file
La marca temporale nel contenuto del file CDF indica l'ora in cui i server di raccolta dati hanno iniziato a elaborare il file. Questa marca temporale è impostata nel fuso orario UTC. 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 della hour= marca temporale nel nome del file, è possibile raggruppare i dati EventTime per ora.