Databestanden voor Audience Optimization-rapporten en actiegerichte logboekbestanden data-files-for-audience-optimization-reports

Een gegevensbestand bevat indruk, klik, of omzettingsgegevens. Als de indeling correct is, kunt u deze gegevens importeren in de Audience Manager om deze weer te geven in het dialoogvenster Audience Optimization-rapporten en maakt u eigenschappen met behulp van de gegevens via Werkbare logbestanden. Maak uw gegevensbestanden op volgens deze specificaties in deze sectie.

Overzicht overview

Met een bestand met een correcte naam en opmaak kunt u indruk-, klik- of conversiegegevens importeren in het dialoogvenster Audience Optimization-rapporten. Dit is handig wanneer u werkt met een partner die niet is geïntegreerd met Audience Manager en u wilt met hun gegevens in die rapportreeks werken. Voor dit proces zijn aparte bestanden nodig voor de weergave, klik en conversie van gegevens. Meng deze gebeurtenissen niet in één bestand.

Een gegevensbestand moet vergezeld gaan van een metagegevensbestand. De inhoud van het meta-gegevensdossier past de informatie van het gegevensdossier aan verwante, mens-leesbare etiketten in de rapportmenu's aan. Zie voor meer informatie Overzicht en toewijzingen voor metagegevensbestanden.

Naamgevingsconventies voor gegevensbestanden naming-conventions

De volgende syntaxis definieert de structuur van een goed gevormde naam van een gegevensbestand. Opmerking: cursief Hiermee wordt een variabele tijdelijke aanduiding aangegeven die afhankelijk van de bestandsinhoud verandert.

Syntaxis:

gebeurtenistype_jjjjjjjjmmdd

In een bestandsnaam:

  • Het gebeurtenistype geeft aan dat het bestand afbeeldingen bevat, klikt of conversies. Maak een afzonderlijk bestand voor elk gebeurtenistype.
  • Een onderstrepingsteken scheidt het gebeurtenistype en een jaar-maand-datum timestamp.
  • Voordat u bestanden uploadt, comprimeert u ze met gzip en slaat u ze op met de .gz bestandsextensie.

Geef uw gegevensbestanden, op basis van de inhoud van de bestanden, de volgende naam op basis van deze vereisten:

  • Impressiegegevens:
    impressies_jjjjjjjjmmdd.gz
    
  • Klik op gegevens:
    click_jjjjjjjjmmdd.gz
    
  • Conversiegegevens:
    conversies_jjjjjjjjmmdd.gz
    

Indeling van inhoud voor gegevensbestanden content-format

De volgende syntaxis definieert de inhoudsstructuur in een correct samengesteld gegevensbestand. Opmerking: cursief Hiermee wordt een tijdelijke aanduiding voor een variabele aangegeven die wordt vervangen door een label in een feitelijk gegevensbestand.

Syntaxis:

koptekstlabel 1 | koptekstlabel 2 … koptekstlabel n | versie

In de bestandsinhoud:

  • De koptekstlabels moeten in de volgorde staan die in de onderstaande tabel wordt weergegeven. Bij indrukken en klikken worden dezelfde labels gebruikt. Conversiebestanden bevatten extra kopteksten.

  • Als u geen gegevens voor een bepaalde kolom hebt, bevolkt dat gebied met a -1.

  • Bestanden moet eindigen met een versienummer. De huidige versie is 1.1.

  • Scheid bestandsheaders en inhoud met het niet-afdrukbare ASCII 001-teken. Als u ASCII 001 niet kunt gebruiken, dan scheidt u de kopballen en de gegevens met een lusjescheidingsteken. Aangezien dit niet-afdrukbare tekens zijn, wordt in het bovenstaande syntaxisvoorbeeld een pipe weergegeven "|" uitsluitend voor weergavedoeleinden.

Veldlabels

In de onderstaande tabel vindt u een overzicht en beschrijving van de kolomkoppen voor het gegevensbestand. De kopballen zijn case-sensitive en moeten verschijnen zoals bevolen in de lijst. Alle gegevenstypen zijn gehele getallen (INT), tenzij anders aangegeven.

Label
Beschrijving
Tijdstempel
Een UTC-datum en -tijd voor de impositie, klik of conversiegebeurtenis. Gebruik de yyyy-MM-dd HH:mm:ss gebruiken.
Gebruikersnaam
Uw id voor een sitebezoeker, ook wel de unieke gebruikersnaam van gegevensaanbieder of DPUUID.
Advertiser-ID
De gegevensbron-id of integratiecode voor uw adverteerder.
BU-ID
Bedrijfs-eenheid-id.
Campagne-id
Campagne-id.
Creative-id
Creative ID.
Site-id
Site-id.
Plaatsing-id
Numerieke plaatsing-id van de advertentieserver.
Id van invoegvolgorde
Invoegvolgorde-id.
Tactic-ID
Tactische id.
Verticaal-id
ID voor een verticale branche of een categorie.
Aantal

Het aantal objecten dat tijdens een conversiegebeurtenis is verkocht.

Alleen voor conversiegegevensbestanden.

Ontvangsten

Aankoop of ander omrekeningsbedrag. Gegevenstype: Zweven.

Alleen voor conversiegegevensbestanden.

Andere gegevens

URL van de bestemmingspagina van de conversie. Gegevenstype: Tekenreeks.

Alleen voor conversiegegevensbestanden.

Type gebeurtenis

Conversietype. Geeft aan of een conversie overeenkomt of niet. De volgende opties zijn beschikbaar:

  • 0: Impressie
  • 1: Klik op
  • -1: Onbeheerd of onbekend

Alleen voor conversiegegevensbestanden.

Versie
Een vereist versienummer dat aan het einde van elke rij in een afbeeldings-, klik- of conversiegegevensbestand wordt weergegeven. De huidige versie is 1.1.

Leveringsmethoden voor gegevensbestanden delivery-methods

Upload uw afbeeldings-, klik- of conversiegegevensbestanden naar een Amazon S3-directory voor uw Audience Manager account. Raadpleeg deze sectie voor informatie over levering/directorypaden, verwerkingstijden en updates.

IMPORTANT
Neem contact op met uw Audience Manager consultant of klantenservice om aan de slag te gaan en een Amazon S3 voor uw gegevensbestanden.

Syntaxis en voorbeelden van leveringspad

Gegevens worden opgeslagen in een aparte naamruimte voor elke klant in een Amazon S3 directory. Het bestandspad volgt de onderstaande syntaxis. Opmerking: cursief Hiermee wordt een tijdelijke aanduiding voor een variabele aangegeven. Andere elementen zijn constanten of sleutels en veranderen niet.

Syntaxis:

…/log_ingesation/pid= AAM-id/dpid= d_src/logs/ bestandstype_jjjjjjjjmmdd

In de volgende tabel worden deze elementen gedefinieerd in een pad voor het leveren van bestanden.

Bestandsparameter
Beschrijving
.../log_ingestion/
Dit is het begin van de weg van de folderopslag. U ontvangt het volledige pad wanneer alles is ingesteld.
pid=AAM ID
Dit sleutelwaardepaar bevat uw Audience Manager klant-id.
dpid=d_src
Dit zeer belangrijk-waardepaar bevat gegevensbronidentiteitskaart die op een gebeurtenisvraag wordt overgegaan. De instantie waar de gegevens vandaan komen, wordt geïdentificeerd en deze gegevens worden gekoppeld aan een bestand met ondersteunende metagegevens.
logs
Een map op een hoger niveau voor gegevensbestanden.
file type_yyyymmdd
Een bestandstype met de naam die aangeeft welk type gegevens het bevat en een tijdstempel voor de levering.

Voorbeeld van uploadpad en bestandsnaam

Wanneer u een bestand uploadt, ziet het pad er als volgt uit:

.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902

Verwerkingstijden en updates van bestanden

Gegevensbestanden worden vier keer per dag verwerkt, met regelmatige intervallen.

Om uw gegevens bij te werken, verzend in een dossier dat alle beelden, klikken, of omzettingen voor een bepaalde dag bevat. In dit geval is een dag de periode van 24 uur van middernacht aan volgende. Als beste praktijken, kunt u UTC tijd willen gebruiken om uw daginterval te bepalen.

Volgende stappen next-steps

Controleer de vereisten voor het benoemen en maken van metagegevensbestanden. Ga als volgt te werk om aan de slag te gaan: Overzicht en toewijzingen voor metagegevensbestanden.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695