Customer Data Feeds customer-data-feeds

Basisinformatie over Customer Data Feed (CDF) en instructies over hoe u aan de slag kunt gaan. Begin hier als je interesse hebt in CDF of meer informatie.

Bestandsinhoud en doel file-contents-purpose

Een CDF-bestand bevat dezelfde data die een Audience Manager-gebeurteniscall (/event) naar onze servers verzendt. Dit omvat gegevens zoals gebruikers-id's, trait IDs, segment IDsen alle andere parameters die door een gebeurtenisaanroep worden vastgelegd. Intern Audience Manager systemen verwerken gebeurtenisgegevens in een CDF bestand met inhoud die is ingedeeld in velden die in een ingestelde volgorde worden weergegeven. Audience Manager pogingen om te genereren CDF bestanden per uur worden opgeslagen en opgeslagen in een beveiligd, klantspecifiek emmertje op een Amazon S3 server. We bieden deze bestanden zodat u kunt werken met Audience Manager gegevens buiten de grenzen die door onze gebruikersinterface worden opgelegd.

Aan de slag getting-started

Er is geen zelfbedieningsproces om te beginnen CDF bestandslevering. Neem contact op met uw Audience Manager consultant of klantenservice om aan de slag te gaan. Tijdens de implementatie Audience Manager vertegenwoordiger:

Bestandsmeldingen en CDF bestanden worden weergegeven in uw S3 emmertje als ze klaar zijn om te downloaden. U bent verantwoordelijk voor het controleren en downloaden van bestanden van uw toegewezen S3 directory. Zie Voortgangsmeldingen voor klantdatafeedbestanden.

Volgende stappen next-steps

De onderstaande secties en de Veelgestelde vragen over de gegevensfeed van de klant kan u helpen vertrouwd met deze dienst worden.

Customer Data Feed Gedefinieerde inhoud cdf-defined

Hiermee worden de gegevenselementen en arrays in een CDF bestand, op volgorde van weergave. Definities omvatten gegevenstypen, maar deze informatie maakt geen deel uit van een CDF bestand.

Definities definitions

A CDF bevat enkele of alle velden die hieronder worden gedefinieerd. Voor informatie over interne bestandsorganisatie raadpleegt u Bestandsstructuur voor klantgegevens.

Customer Data Feed Bestandsstructuur cdf-file-structure

Hiermee geeft u de gegevensstructuur van een CDF bestand. Dit omvat gegevensreeksen, gebiedsscheidingen en scheidingstekens, een kaart van het gegevensdossier, en steekproefdossier.

Id's en volgorde van gegevensvelden identifiers-and-sequence

CDF bestanden bevatten geen gelabelde kolommen of veldkoppen. In plaats daarvan CDF bestand definieert velden en arrays met niet-afdrukbare ASCII tekens. Ook de CDF elk veld en elke array wordt in een bepaalde volgorde weergegeven. Als u de veld-id's en de volgorde begrijpt, kunt u het bestand op de juiste wijze parseren.

CDF Bestandstoewijzing cdf-file-map

CDF bestandsgegevens worden weergegeven in de volgorde hieronder.

Arrays identificeren

Arrays in een CDF het dossier begint en beëindigt met Ctrl + a veldscheidingsteken. Hierdoor lijkt het eerste element in een array op een zelfstandig gegevensveld. De gerealiseerde traits array begint met ^A1234. Arrayscheidingsteken en id ^B5678 volgt deze vermelding. Als gevolg hiervan zou u geneigd kunnen zijn te denken dat het eerste element in gerealiseerde traits array is ID 5678 (omdat deze begint met ^B). Dit is niet het geval, en daarom moet u met de opeenvolging en de structuur van een gegevensdossier vertrouwd zijn. Hoewel het eerste element in de trait array (of een van de andere arrays in een CDF bestand) begint met ^ADe volgorde van weergave of positie in het bestand definieert het begin van een array. En het eerste element in een array wordt altijd gescheiden van het vorige item door ^A.

Monster CDF Bestand sample-file

Een monster CDF kan er als volgt uitzien. In dit voorbeeld zijn regeleinden ingevoegd om deze aan te passen aan de pagina.

Customer Data Feed Naamgevingsconventies voor bestanden cdf-naming-conventions

In de onderstaande secties worden de elementen in uw CDF bestandsnaam.

CDF Bestandsnaam: Syntaxis en voorbeeld cdf-file-name

Een standaard CDF de bestandsnaam bevat de onderstaande elementen. Opmerking: cursief Hiermee wordt een tijdelijke aanduiding voor een variabele aangegeven:

Syntaxis

s3://aam-cdf/YOUR-S3-BUCKET-NAME/day=yyyy-mm-dd/hour=hh/AAM-CDF_PARTNER-ID_FILE-SEQUENCE_0.gz

Voorbeeld

s3://aam-cdf/dataCompany/day=2017-09-14/hour=17/AAM_CDF_1234_0_0_0.gz

In uw S3 opslagemmer, de dossiers worden gesorteerd in stijgende orde door identiteitskaart van de Partner (PID), dag en uur.

CDF Bestandsnaamelementen gedefinieerd cdf-file-name-elements

In de volgende tabel worden de elementen in een CDF bestandsnaam.

Customer Data Feed Meldingen voor bestandsverwerking cdf-file-processing-notifications

Audience Manager schrijft een .info bestand naar uw S3 directory om u te laten weten wanneer uw Customer Data File (CDF) is klaar om te worden gedownload. De .info bestand bevat ook JSON opgemaakte metagegevens over de inhoud van uw CDF bestanden. Controleer deze sectie voor informatie over de syntaxis en de gebieden die door dit berichtdossier worden gebruikt.

Voorbeeldgegevensbestand sample-info-file

Elk .info bestand bevat een Files en Totals sectie. De Files -sectie bevat een array die specifieke meetgegevens bevat voor elk uurbestand. De Totals sectie bevat cijfers die zijn geaggregeerd voor al uw CDF bestanden voor een bepaalde dag. De inhoud van uw .info kan er ongeveer als volgt uitzien.

{
    "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
    }
}

Gedefinieerde gegevensbestandsvelden info-file-fields-defined

In de volgende tabellen worden de elementen in een CDF .info bestand.

Bestandsobject

Totalen, object

Customer Data Feed Tijdstippen voor bestandsnaam en bestandsinhoud verschillen different-processing-times

Uw CDF bevat tijdstempels in de bestandsnaam en de bestandsinhoud. Deze tijdstempels registreren verschillende gebeurtenisprocessen voor hetzelfde CDF bestand. Het is niet ongebruikelijk om verschillende tijdstempels in de naam en inhoud van het zelfde dossier te zien. Als u een goed begrip van elk tijdstempel hebt, voorkomt u vaak voorkomende fouten wanneer u met deze gegevens werkt of probeert deze op tijd te sorteren.

Locatie CDF Tijdstempels voor bestand locating-timestamps

CDF in bestanden wordt de tijd op twee verschillende locaties vastgelegd.

Het verschil tussen tijdstempels begrijpen understanding-timestamps

De volgende tabel bevat aanvullende informatie over uw CDF bestandstijdstempels samen met informatie over het juiste gebruik ervan.