Datafiler för Audience Optimization-rapporter och verkställbara loggfiler data-files-for-audience-optimization-reports

En datafil innehåller indata för att visa, klicka eller konvertera. När data är korrekt formaterade kan du importera dem till Audience Manager för att visa dem i Audience Optimization-rapporter och skapa egenskaper med hjälp av data via Åtgärdsbara loggfiler. Formatera datafilerna enligt dessa specifikationer i det här avsnittet.

Översikt overview

Med en korrekt namngiven och formaterad datafil kan du importera, klicka och konvertera data till Audience Optimization-rapporter. Detta är användbart när du arbetar med en partner som inte är integrerad med Audience Manager och du vill arbeta med deras data i den rapportsviten. Den här processen kräver separata filer för bild-, klicknings- och konverteringsdata. Blanda inte dessa händelser i en enda fil.

En datafil måste åtföljas av en metadatafil. Innehållet i metadatafilen matchar informationen i datafilen med relaterade, läsbara etiketter på rapportmenyerna. Mer information finns i Översikt och mappningar för metadatafiler.

Namnkonventioner för datafiler naming-conventions

Följande syntax definierar strukturen för ett välformaterat datafilnamn. Obs! kursiv används för att ange en variabelplatshållare som ändras beroende på filinnehållet.

Syntax:

händelsetyp_yyyymmdd

I ett filnamn:

  • Händelsetypen anger att filen innehåller avbildningar, klickningar eller konverteringar. Skapa en separat fil för varje händelsetyp.
  • Ett understreck skiljer händelsetypen och en tidsstämpel för årsdatum.
  • Innan du överför filerna ska du komprimera dem med gzip och spara dem med .gz filtillägg.

Med tanke på dessa krav bör du namnge dina datafiler baserat på deras innehåll så här:

  • Impressionsdata:
    imponations_yyyymmdd.gz
    
  • Klicka på data:
    klickningar_yyyymmdd.gz
    
  • Konverteringsdata:
    conversions_yyyymmdd.gz
    

Innehållsformat för datafiler content-format

Följande syntax definierar innehållsstrukturen i välformade datafiler. Obs! kursiv anger en variabelplatshållare och ersätts med en etikett i en faktisk datafil.

Syntax:

rubriketikett 1 | rubriketikett 2 … rubriketikett n | version

I filinnehållet:

  • Rubriketiketterna måste finnas i den ordning som visas i tabellen nedan. Samma etiketter används för tryck och klick. Konverteringsfiler innehåller extra rubriker.

  • Om du inte har data för en viss kolumn fyller du i fältet med ett -1.

  • Filer måste avslutas med ett versionsnummer. Den aktuella versionen är 1.1.

  • Avgränsa filhuvuden och -innehåll med icke-utskrivbara ASCII 001-tecken. Om du inte kan använda ASCII 001 ska du separera sidhuvuden och data med en tabbavgränsare. Eftersom det här är tecken som inte skrivs ut visas ett rör i syntaxexemplet ovan "|" endast för visning.

Fältetiketter

Tabellen nedan listar och beskriver kolumnrubrikerna för datafilen. Sidhuvuden är skiftlägeskänsliga och måste visas enligt ordningen i tabellen. Alla datatyper är heltal (INT) om inget annat anges.

Etikett
Beskrivning
Tidsstämpel
Ett UTC-datum och en UTC-tid för intrycket, klickningen eller konverteringshändelsen. Använd yyyy-MM-dd HH:mm:ss format.
Användar-ID
Ditt ID för en besökare på platsen, kallas även unikt användar-ID för dataleverantör eller DPUID.
Advertiser-ID
Datakällans ID eller integrationskoden för annonseraren.
BU-ID
Affärsenhets-ID.
Kampanj-ID
Kampanj-ID.
Creative-ID
Kreativt ID.
Plats-ID
Plats-ID.
Placement-ID
Numeriskt placerings-ID från annonsservern.
Infog-order-ID
Infogningsorder-ID.
Taktiskt-ID
Taktiskt ID.
Lodrätt-ID
ID för en lodrät eller kategoribaserad bransch.
Kvantitet

Antalet artiklar som har sålts i en konverteringshändelse.

Endast för konvertering av datafiler.

Intäkter

Inköp eller annat konverteringsbelopp. Datatyp: Flyt.

Endast för konvertering av datafiler.

Andra data

URL för konverteringslandsidan. Datatyp: Sträng.

Endast för konvertering av datafiler.

Händelsetyp

Konverteringstyp. Anger om en konvertering matchar eller inte. Alternativen är:

  • 0: Impression
  • 1: Klicka på
  • -1: Okänd eller okänd

Endast för konvertering av datafiler.

Version
Ett obligatoriskt versionsnummer som visas i slutet av varje rad i en bild, ett klick eller en konverteringsdatafil. Den aktuella versionen är 1.1.

Leveransmetoder för datafiler delivery-methods

Överför dina intryckta, klickningar eller konverteringar till en Amazon S3-katalog Audience Manager konto. I det här avsnittet finns information om leverans-/katalogsökvägar, bearbetningstider och uppdateringar.

IMPORTANT
Kontakta Audience Manager eller kundtjänst för att komma igång och konfigurera en Amazon S3 -katalog för dina datafiler.

Syntax och exempel för leveranssökväg

Data lagras i en separat namnrymd för varje kund i en Amazon S3 katalog. Filsökvägen följer den syntax som visas nedan. Obs! kursiv används för att ange en variabelplatshållare. Andra element är konstanter eller nycklar och ändras inte.

Syntax:

…/log_inghit/pid= AAM ID/dpid= d_src/logs/ filtyp_yyyymmdd

I följande tabell definieras vart och ett av dessa element i en filleveranssökväg.

Filparameter
Beskrivning
.../log_ingestion/
Detta är början på kataloglagringssökvägen. Du får den fullständiga sökvägen när allt är klart.
pid=AAM ID
Detta nyckelvärdepar innehåller Audience Manager kund-ID.
dpid=d_src
Detta nyckelvärdepar innehåller det datakälla-ID som skickades vid ett händelseanrop. Den identifierar byrån som uppgifterna kommer från och knyter dem till en metadatafil som stöds.
logs
En katalog på högre nivå för datafiler.
file type_yyyymmdd
Ett filtypsnamn som anger vilken typ av data det innehåller och en leveranstidsstämpel.

Exempel på överföringssökväg och filnamn

När du överför en fil ser sökvägen ut ungefär så här:

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

Filbehandlingstider och uppdateringar

Datafilerna behandlas fyra gånger dagligen med regelbundna intervall.

Om du vill uppdatera dina data skickar du in en fil som innehåller alla visningar, klick eller konverteringar för en viss dag. I det här fallet är en dag dygnet runt, från en midnatt till nästa. Det är en god vana att använda UTC-tid för att definiera ditt dagsintervall.

Nästa steg next-steps

Granska kraven för att namnge och skapa metadatafiler. För att komma igång, se Översikt och mappningar för metadatafiler.

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