Customer Data Feeds

Ultimo aggiornamento: 2023-05-20

Informazioni di base su Customer Data Feed (CDF) file e istruzioni su come iniziare. Inizia qui se sei interessato a ricevere CDF o semplicemente per ottenere ulteriori informazioni.

Contenuto e finalità 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 gli ID utente, trait IDs, segment IDse tutti gli altri parametri acquisiti da una chiamata evento. Interno Audience Manager system elabora i dati evento in una CDF file con contenuto organizzato in campi che vengono visualizzati in un ordine preimpostato. Audience Manager tenta 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 che tu possa utilizzare Audience Manager dati al di fuori dei limiti imposti dalla nostra interfaccia utente.

IMPORTANTE

Durante l'utilizzo dei file CDF, tenete presente le seguenti limitazioni:

  • Prima di configurare la consegna dei file CDF, assicurati di disporre delle autorizzazioni appropriate da parte dei provider di dati di terze parti per l’esportazione di caratteristiche di terze parti. Audience Manager al momento non supporta la funzionalità nell’interfaccia utente di richiesta dell’autorizzazione di esportazione per la consegna dei file CDF da parte di provider di dati di terze parti, pertanto contatta tali provider in modo indipendente.
  • Non deve usare CDF file come proxy per monitorare il traffico di pagina, risolvere le discrepanze nei rapporti, per la fatturazione, ecc.

Introduzione

Nessun processo self-service da avviare CDF consegna dei file. Contatta il tuo Audience Manager consulente o assistenza clienti. Durante l'implementazione, Audience Manager il rappresentante:

  • Configurare Amazon S3 bucket di archiviazione.
  • Fornisci sola lettura S3 credenziali di autenticazione per il bucket di archiviazione file. Non potrai visualizzare o accedere alle directory e ai file che appartengono ad altri clienti.

Notifiche sui file 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 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 una CDF file, in ordine di visualizzazione. Le definizioni includono i tipi di dati, ma queste informazioni non fanno parte di un CDF file.

IMPORTANTE

I pixel degli eventi sono esclusi per impostazione predefinita nelle configurazioni CDF. Assicurati di specificare nella richiesta all’assistenza clienti se desideri includere i pixel dell’evento nei file CDF. Ogni pixel dell’evento viene compilato 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, vedere Struttura del file di feed dati del cliente.

Campo Tipo di dati Descrizione

Event Time

Timestamp

Ora in cui un file CDF è stato elaborato da Server di raccolta dati (DCS) La marca temporale utilizza aaaa-mm-gg hh:mm:ss ed è impostato nel fuso orario UTC.

Nota: l'ora dell'evento non è:

Device

Stringa

Questo è il ID utente univoco (UUID), che è 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 le sincronizzazioni ID. Questo campo viene compilato solo se imposti l’ID contenitore nel d_nsid all'interno dell'implementazione del sito. In caso contrario, il valore predefinito 0 non verrà incluso nei file CDF.

Realized Traits

Matrice numerica

Un array di ID di caratteristiche che contiene tutte le caratteristiche realizzate (qualificate) da un visitatore nella chiamata dell’evento.

L’array può contenere caratteristiche per le quali il visitatore si era qualificato in precedenza e che sono state riqualificate tramite questa chiamata dell’evento.

Realized Segments

Matrice numerica

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

Request Parameters

Stringa

Una stringa che acquisisce tutti i parametri (variabili, ID, coppie chiave-valore, ID dispositivo pubblicitario, ecc.) passato alla chiamata 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

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

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

All Segments

Matrice numerica

Un array di ID 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 prima e terze parti delle caratteristiche che contiene caratteristiche realizzate in precedenza e nuove caratteristiche per le quali il visitatore è qualificato dall’ultimo feed di dati generato.

Customer Data Feed Struttura dei file

Elenca e definisce la struttura dati di un CDF file. Ciò include sequenza di dati, delimitatori di campo e separatori, una mappa del file di dati e un file di esempio.

Identificatori e sequenza dei campi dati

CDF i file non contengono colonne con etichetta o intestazioni di campo. Invece, un’ CDF file definisce campi e array senza funzionalità di stampa ASCII caratteri. Inoltre, il CDF file elenca ogni campo e matrice in un ordine specifico. Comprendere gli identificatori e l’ordine dei campi ti aiuterà ad 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 nei singoli campi con un indicatore di spazio non stampabile.
  • Ctrl + B (ASCII) 002 o ^B) separa i dati, un array e i parametri di richiesta.
  • Ctrl + C (ASCII) 003 o ^C) definisce 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 file parsing system non deve presupporre un numero fisso di colonne (anche se potrebbe presupporre un ordine fisso per le colonne esistenti).

I dati nel file CDF vengono visualizzati nell’ordine mostrato di seguito. /N può essere visualizzato 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. Referer
  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, vedi Contenuto feed dati cliente definito.

CDF Mappa file

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

Identificazione degli array

Array in un CDF inizio e fine 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 l’array inizia con ^A1234. Il delimitatore e l’ID della matrice ^B5678 segue questa voce. Di conseguenza, si potrebbe essere tentati di pensare che il primo elemento nel realizzato traits l'array è l'ID 5678 (perché inizia con ^B). In caso contrario, ecco perché è necessario avere familiarità con la sequenza e la struttura di un file di dati. Anche se il primo elemento nella trait array (o uno qualsiasi degli altri array in un CDF file) inizia con ^A, l'ordine di visualizzazione o la posizione nel file definisce l'inizio di un array. Il primo elemento di un array è sempre separato dalla voce precedente da ^A.

Esempio CDF File

Un esempio CDF potrebbe avere un aspetto simile al seguente. Abbiamo inserito interruzioni di riga in questo esempio per adattarlo alla pagina.

Customer Data Feed Convenzioni di denominazione dei file

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

CDF Nome file: sintassi ed esempio

Un tipico CDF il nome 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 nome file definiti

Nella tabella seguente sono elencati e definiti gli elementi di 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

Nome del bucket S3 di sola lettura contenente i file CDF.

day=yyyy-mm-dd

Data di elaborazione del file.

hour=hh

Un valore di ora espresso in notazione di 24 ore e impostato nel fuso orario UTC. Vedi anche, Nome file feed dati cliente Tempi e contenuto file....

partner ID

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 di file gzip. I file CDF sono compressi con Gzip.

Customer Data Feed Notifiche elaborazione file

Audience Manager scrive un .info file nel tuo S3 directory per comunicare quando Customer Data File (CDF) è pronto per il download. Il .info Il file include anche JSON metadati formattati sul contenuto del CDF file. Consulta questa sezione per informazioni sulla sintassi e i campi utilizzati da questo file di notifica.

File di informazioni di esempio

Ogni .info il file contiene un Files e Totals sezione. Il Files contiene un array che contiene metriche specifiche per ciascun file orario. Il Totals contiene metriche aggregate in tutte le CDF per un giorno specifico. Contenuto della .info potrebbe essere simile all'esempio seguente.

{
    "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 informazioni definiti

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

Oggetto Files

Campo Descrizione

Files

Avvia l’array che contiene i metadati sui file CDF.

FileByteSize

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

FileName

Il nome del file. Consulta Convenzioni di denominazione dei file dei feed di dati del cliente.

FileSequenceNumber

Un 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. Usa aaaa-mm-gg formato.

Hour

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

TotalByteSize

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

TotalNumberFiles

Numero totale di file caricati nella directory S3.

Customer Data Feed I tempi del nome file e del contenuto file sono diversi

Il tuo CDF il file contiene marche temporali nel nome e nel contenuto del file. Queste marche temporali registrano diversi processi evento per lo stesso CDF file. Non è raro vedere marche temporali diverse nel nome e nel contenuto dello stesso file. Comprendere ogni marca temporale può aiutarti a evitare errori comuni quando lavori con questi dati o provi a ordinarli in base all’ora.

Individuazione CDF Timestamp file

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

Comprensione della differenza tra marche temporali

La tabella seguente fornisce ulteriori dettagli sul CDF archiviare i timestamp insieme alle informazioni su come utilizzarli correttamente.

Posizione marca temporale Descrizione
Nome file Il timestamp nel tuo CDF nome file indica il momento in cui Audience Manager ha iniziato a preparare il file per la consegna. Questa marca temporale è impostata in UTC fuso orario. Utilizza il hour= parametro, con ora formattata come ora a 2 cifre in formato 24 ore. Questa ora può essere diversa da quella dell’evento registrata nel contenuto del file. Quando si utilizzano CDF file, a volte noterai che il tuo S3 il bucket è vuoto per un’ora specifica. Un bucket vuoto indica una delle seguenti situazioni:
  • Non ci sono dati per quell'ora particolare.
  • I nostri server sono soggetti a carichi pesanti e non sono in grado di elaborare i file per un'ora specifica. Quando il server recupera, inserisce i file che avrebbero dovuto essere inseriti in un bucket precedente in un bucket con un valore temporale successivo. Ad esempio, questo si verifica 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, è probabile che il server abbia iniziato l'elaborazione del file nell'ora 17, ma non è riuscito a completarlo entro tale intervallo di tempo. Viene invece eseguito il push del file al periodo fisso orario successivo.

Importante: non utilizzare il timestamp del nome file per raggruppare gli eventi in base all’ora. Se è necessario eseguire il raggruppamento in base all'ora, utilizzare EventTime timestamp nel contenuto del file.
Contenuto file Il timestamp nel tuo CDF contenuto del file indica l'ora Data Collection Servers ha iniziato l’elaborazione del file. Questa marca temporale è impostata in UTC fuso orario. Utilizza il EventTime campo, con ora formattata come yyyy-mm-dd hh:mm:ss. Questo tempo è vicino all’ora effettiva dell’evento sulla pagina, ma può essere diverso dall’indicatore delle ore nel nome del file.
Suggerimento: a differenza di hour= timestamp nel nome del file, puoi utilizzare EventTime per raggruppare i dati in base all'ora.

In questa pagina