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.

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 i file CDF come proxy per monitorare il traffico delle pagine, riconciliare le discrepanze dei rapporti, o per la fatturazione, ecc.

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.

Campo Tipo di dati Descrizione

Event Time

Timestamp

L'ora in cui un file CDF è stato elaborato da Data Collection Servers (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. 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'ID Experience Cloud (MID) assegnato al visitatore del sito. Vedi anche Cookie e il servizio identità Experience Platform Adobe .

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

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 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). Vedere anche Cookie e Adobe Experience Platform Identity Service
  10. Tutti i segmenti
  11. Tutte le caratteristiche

Per le descrizioni dei campi, vedere 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 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.

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 Tempi del nome del file dei feed di dati cliente e tempi del contenuto del file....

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

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

FileName

Nome del file. Vedere Convenzioni di denominazione dei file di 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.

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.

Posizione timestamp Descrizione
Nome file La marca temporale nel nome del file CDF indica l'ora in cui Audience Manager ha iniziato a preparare il file per la consegna. Questa marca temporale è impostata nel fuso orario UTC. Utilizza il parametro hour=, con l'ora formattata 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 lavori con CDF file, a volte noterai 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 trovarsi 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. Se è necessario raggruppare per ora, utilizzare la marca temporale EventTime nel contenuto del file.
Sommario file La marca temporale nel contenuto del file CDF indica l'ora in cui Data Collection Servers ha iniziato l'elaborazione del file. Questa marca temporale è impostata nel fuso orario UTC. Utilizza il campo EventTime, 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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now