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.
yyyy-MM-dd HH:mm:ss
-indeling.Het aantal objecten dat tijdens een conversiegebeurtenis is verkocht.
slechts voor de dossiers van omzettingsgegevens.
Aankoop of ander omrekeningsbedrag. Gegevenstype: Zwevend.
slechts voor de dossiers van omzettingsgegevens.
URL van de bestemmingspagina van de conversie. Gegevenstype: String.
slechts voor de dossiers van omzettingsgegevens.
Conversietype. Geeft aan of een conversie overeenkomt of niet. U kunt onder andere de volgende opties kiezen:
0
: Impressie1
: klikken-1
: Niet toegewezen of onbekend
slechts voor de dossiers van omzettingsgegevens.
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.
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.
.../log_ingestion/
pid=AAM ID
dpid=d_src
logs
file type_yyyymmdd
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 .