Gegevensbestanden voor Audience Optimization-rapporten en uitvoerbare logbestanden data-files-for-audience-optimization-reports

Een gegevensbestand bevat indruk, klik, of omzettingsgegevens. Wanneer behoorlijk geformatteerd, kunt u deze gegevens in Audience Manager invoeren om het in de ​ Rapporten van Audience Optimization ​ te bekijken en treinen tot stand te brengen gebruikend de gegevens via ​ Actiebare Dossiers van het Logboek ​. Maak uw gegevensbestanden op volgens deze specificaties in deze sectie.

Overzicht overview

Een behoorlijk genoemd en geformatteerd gegevensbestand laat u indruk invoeren, klikken, of omzettingsgegevens in de ​ Rapporten van Audience Optimization ​. Dit is handig wanneer u werkt met een partner die niet is geïntegreerd met Audience Manager en u met de gegevens in die rapportsuite wilt 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. Voor meer informatie, zie ​ Overzicht en Toewijzingen voor de Dossiers van Meta-gegevens ​.

Naamgevingsconventies voor gegevensbestanden naming-conventions

De volgende syntaxis definieert de structuur van een goed gevormde naam van een gegevensbestand. Nota, cursief wijst op veranderlijke placeholder die afhankelijk van de dossierinhoud verandert.

Syntaxis:

 gebeurtenistype  _ jjjjjjmmdd

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

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

  • Impressiegegevens:

    code language-none
     impressions_ jjymmdd  .gz
    
  • Klik op gegevens:

    code language-none
     klikt_ jjjjmmdd .gz
    
  • Conversiegegevens:

    code language-none
     conversions_ jjjjmmdd .gz
    

Indeling van inhoud voor gegevensbestanden content-format

De volgende syntaxis definieert de inhoudsstructuur in een correct samengesteld gegevensbestand. Nota, cursief wijst op veranderlijke placeholder en met een etiket in een werkelijk gegevensdossier vervangen.

Syntaxis:

 kopbaletiket 1  |  kopbaletiket 2 …  kopbaletiket 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, vult u dat veld met een -1 .

  • De dossiers moeten met een versieaantal beëindigen. 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 die alleen voor weergavedoeleinden wordt gebruikt.

Etiketten van het Gebied

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 -indeling.
Gebruikersnaam
Uw id voor een sitebezoeker, ook wel de gegevensaanbieder met unieke gebruikers-id of DPUUID genoemd.
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 plaatsings-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.

slechts voor de dossiers van omzettingsgegevens.

Ontvangsten

Aankoop of ander omrekeningsbedrag. Gegevenstype: Zwevend.

slechts voor de dossiers van omzettingsgegevens.

Andere gegevens

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

slechts voor de dossiers van omzettingsgegevens.

Type gebeurtenis

Conversietype. Geeft aan of een conversie overeenkomt of niet. U kunt onder andere de volgende opties kiezen:

  • 0: Impressie
  • 1: klikken
  • -1: Niet toegewezen of onbekend

slechts voor de dossiers van omzettingsgegevens.

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 van bestanden en updates.

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

Syntaxis en Voorbeelden van de Weg van de Levering

Gegevens worden opgeslagen in een aparte naamruimte voor elke klant in een map Amazon S3 . Het bestandspad volgt de onderstaande syntaxis. Nota, cursief wijst op veranderlijke placeholder. Andere elementen zijn constanten of sleutels en veranderen niet.

Syntaxis:

…/log_ingestion/pid=  identiteitskaart van AAM /dpid=  d_src /logs/  dossiertype  _  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.

Steekproef uploadt Weg en Dossier - Naam

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

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

de Verwerkingstijden en Updates van het Dossier

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. Om begonnen te worden, zie ​ Overzicht en Toewijzingen voor de Dossiers van Meta-gegevens ​.

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