Customer Data Feeds customer-data-feeds

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

Contenuto e finalità del file file-contents-purpose

Un file CDF contiene gli stessi dati inviati ai nostri server da una chiamata evento Audience Manager (/event). Sono inclusi dati come ID utente, trait IDs, segment IDs e tutti gli altri parametri acquisiti da una chiamata evento. I sistemi interni Audience Manager elaborano i dati evento in un file CDF con contenuto organizzato in campi 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 server Amazon S3. Questi file vengono forniti per consentire l'utilizzo di Audience Manager dati al di fuori dei limiti imposti dall'interfaccia utente.

Introduzione getting-started

Nessun processo self-service per avviare la consegna di CDF file. Per iniziare, contatta il tuo consulente Audience Manager o l'Assistenza clienti. Durante l'implementazione, il rappresentante Audience Manager:

Le notifiche dei file e i file CDF verranno visualizzati nel bucket S3 quando saranno 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 next-steps

Le sezioni seguenti e le Domande frequenti sui feed di dati dei clienti possono aiutarti a acquisire maggiore familiarità con questo servizio.

Customer Data Feed contenuto definito cdf-defined

Elenca e definisce gli elementi dati e le matrici in un file CDF, in ordine di aspetto. Le definizioni includono tipi di dati, ma queste informazioni non fanno parte di un file CDF.

Definizioni definitions

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

Customer Data Feed struttura file cdf-file-structure

Elenca e definisce la struttura dati di un file CDF. 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 identifiers-and-sequence

CDF file non contengono colonne con etichetta o intestazioni di campo. Un file CDF definisce invece campi e matrici con ASCII caratteri non stampabili. Inoltre, nel file CDF sono elencati tutti i campi e gli array in un ordine specifico. Comprendere gli identificatori e l’ordine dei campi ti aiuterà ad analizzare correttamente il file.

Mappa file CDF cdf-file-map

I dati del file CDF vengono visualizzati nell'ordine seguente.

Identificazione degli array

Le matrici in un file CDF iniziano e terminano con il separatore di campo Ctrl + a. In questo modo il primo elemento di un array viene visualizzato come un campo dati autonomo. Ad esempio, l'array traits realizzato inizia con ^A1234. Il delimitatore di matrice e l'ID ^B5678 seguono questa voce. Di conseguenza, si potrebbe essere tentati di pensare che il primo elemento nell'array traits realizzato sia 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 nell'array trait realizzato (o qualsiasi altro array in un file CDF) inizia con ^A, l'ordine di aspetto o posizione nel file definisce l'inizio di un array. Il primo elemento di un array è sempre separato dalla voce precedente da ^A.

Esempio di file CDF sample-file

Un file CDF di esempio 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 file cdf-naming-conventions

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

Nome file CDF: sintassi ed esempio cdf-file-name

Un tipico nome di file CDF 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 bucket di archiviazione S3, i file vengono ordinati in ordine crescente per ID partner (PID), giorno e ora.

CDF elementi nome file definiti cdf-file-name-elements

Nella tabella seguente sono elencati e definiti gli elementi in un nome di file CDF.

Customer Data Feed notifiche di elaborazione file cdf-file-processing-notifications

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

File di informazioni di esempio sample-info-file

Ogni file .info contiene una sezione Files e Totals. La sezione Files contiene un array che contiene metriche specifiche per ciascun file orario. La sezione Totals contiene metriche aggregate in tutti i file CDF per un giorno specifico. Il contenuto del file .info potrebbe essere simile a quello dell'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 info-file-fields-defined

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

Oggetto Files

Oggetto Totals

Customer Data Feed Tempi di denominazione file e tempi di contenuto file diversi different-processing-times

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

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

Comprensione della differenza tra marche temporali understanding-timestamps

Nella tabella seguente vengono forniti ulteriori dettagli sui timestamp del file CDF e informazioni su come utilizzarli correttamente.