Customer Data Feeds

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 file CDF contiene gli stessi dati che una chiamata evento di Audience Manager (/event) invia ai nostri server. This includes data like user IDs, trait IDs, segment IDs, and all the other parameters captured by an event call. 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 al di fuori dei limiti imposti dalla nostra interfaccia utente.

IMPORTANTE

Tenete presenti le seguenti limitazioni quando lavorate con i file CDF:

  • Prima di configurare la distribuzione dei file CDF, accertatevi di disporre delle autorizzazioni appropriate da parte di fornitori di dati di terze parti per l'esportazione di caratteristiche di terze parti. Audience Manager attualmente non supporta le funzionalità dell'interfaccia utente per richiedere l'autorizzazione di esportazione per la consegna di file CDF da provider di dati di terze parti, pertanto contattateli in modo indipendente.
  • 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 tuo 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 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 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 daticliente.

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 è:

Device

Stringa

Si tratta dell’ ID utente univoco (UUID), un ID dispositivo di 38 cifre per il visitatore del sito. See also, Index of IDs 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 ha ottenuto i requisiti per questa chiamata dell’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’ID Experience Cloud (MID) assegnato al visitatore del sito. Vedi anche Cookie e il servizioAdobe 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.

Customer Data Feed Struttura file

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. ID dispositivo Experience Cloud (o MID). See also, Cookies and the Adobe Experience Platform Identity Service
  10. Tutti i segmenti
  11. Tutte le caratteristiche

Per le descrizioni dei campi, vedi Contenuto feed dati cliente definito.

CDF Mappa file

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' traits array realizzato 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 realizzato sia traits 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 dell'array realizzato trait (o qualsiasi altro array di 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.

Sample CDF File

Un CDF file di esempio 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 CDF file.

CDF Nome file: 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.

CDF Elementi 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 di processo interno Audience Manager .

.gz

Estensione del file gzip. I file CDF vengono compressi con gzip.

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

Il 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. See Customer Data Feed File Naming Conventions.

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.

Customer Data Feed I tempi dei nomi dei file e i tempi dei contenuti dei 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 CDF del 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 marche temporali CDF del file e informazioni su come utilizzarle correttamente.

Posizione timestamp Descrizione
Nome file La marca temporale nel nome del CDF file indica l’ora in cui è Audience Manager iniziata la preparazione del file per la consegna. Questa marca temporale è impostata nel fuso UTC orario. Utilizza il hour= parametro, con il tempo formattato come ora a 2 cifre nella notazione a 24 ore. Questa ora può essere diversa dall'ora dell'evento registrata nel contenuto del file. Quando lavorate con CDF i file, talvolta noterete che il S3 bucket è 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 laEventTimemarca temporale nel contenuto del file.
Sommario file La marca temporale nel contenuto del CDF file indica l'ora in cui il file è stato Data Collection Servers avviato. Questa marca temporale è impostata nel fuso UTC 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 della hour= marca temporale nel nome del file, è possibile raggruppare i dati EventTime per ora.

In questa pagina