DokumentationAudience ManagerAnvändarhandbok för Audience Manager

Datafiler för Audience Optimization-rapporter och åtgärdsloggfiler data-files-for-audience-optimization-reports

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

En datafil innehåller indata för att visa, klicka eller konvertera. När dessa 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 loggfiler som kan användas. 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! italics anger en variabelplatshållare som ändras beroende på filinnehållet.

Syntax:

händelsetyp_åååmmdd

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 filer komprimerar du filerna med gzip och sparar dem med filtillägget .gz.

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

  • Impressionsdata:

    code language-none 
    imponeringar_åååmmdd.gz

  • Klicka på data:

    code language-none 
    klickningar_åååmmdd.gz

  • Konverteringsdata:

    code language-none 
    conversions_yyymmdd.gz

Innehållsformat för datafiler content-format

Följande syntax definierar innehållsstrukturen i välformade datafiler. Obs! italics 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 en -1.

  • Filerna måste sluta 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 visar syntaxexemplet ovan endast ett rör "|" i visningssyfte.

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 formatet yyyy-MM-dd HH:mm:ss.
Användar-ID
Ditt ID för en besökare på platsen, kallas även -dataleverantörens unika användar-ID 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: Float.

Endast för konvertering av datafiler.

Andra data

URL för konverteringslandsidan. Datatyp: String.

Endast för konvertering av datafiler.

Händelsetyp

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

  • 0: Impression
  • 1: Klicka
  • -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 konverteringsdatafiler till en Amazon S3-katalog för ditt Audience Manager-konto. I det här avsnittet finns information om leverans-/katalogsökvägar, bearbetningstider och uppdateringar.

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

Syntax för leveranssökväg och exempel

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 anger en variabelplatshållare. Andra element är konstanter eller nycklar och ändras inte.

Syntax:

…/log_inghit/pid= AAM ID/dpid= d_src/logs/ filtyp_åååmmdd

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 ditt Audience Manager kund-ID.
dpid=d_src
Detta nyckelvärdepar innehåller datakällans 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 24-timmarsperioden 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. Information om hur du kommer igång finns i Översikt och mappningar för metadatafiler.

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