Ad Server Logs
This page describes the Adnuntius Ad Server Log format. Obtaining access to logs is a premium feature; please contact Adnuntius if you would like this to be enabled for your account
Ad Server logs can be downloaded via an SFTP server or pushed to cloud storage. An example of the log files can be found here. The logs are in a JSON format, with each line having the format described below.
Field Name | Data Type | Description |
|---|---|---|
eventTime | Timestamp | An ISO 8601 date string ( yyyy-MM-ddTHH:mm:ss.sss) |
eventId | String | The identifier for the original ad server request. Can be used to match clicks to impressions etc |
referrer | String | The HTTP Referer header of the ad request |
userAgentString | String | The User-Agent header of the ad request |
segments | Collection[ObjectId] | User segments that apply to the ad request |
keyValues | Map[String, Collection[String]] | Key Values that apply to the ad request e.g. {"interests":["sport", "music"]} |
keywords | Collection[String] | Keywords that apply to the ad request e.g ["news", "business", "australia"] |
categories | Collection[String] | Categories that apply to the ad request |
iabCategory | String | An IAB Category for the Advertiser e.g. IAB_3_1_3_8 |
cost | MonetaryAmount | The cost for this event |
device | Map[String, String] | The detected user device |
location | Location | The detected location |
consents | Collection[Consent] | The user consents provided to Adnuntius with this request. |
latitude | Float | The detected latitutde |
longitude | Float | The detected longitude |
pseudoUserId | String | An anonymised user identifier. It cannot be used to track individual users. See below for further details. |
adUnit | ObjectId | The Adnuntius Ad Unit that received this ad request |
lineItem | ObjectId | The Adnuntius Line Item that won the auction |
creative | ObjectId | The Adnuntius Creative that won the auction |
advertiser | ObjectId | The Adnuntius Creative that won the auction |
team | ObjectId | The Adnuntius Team of the auction winning Line Item |
References to Adnuntius objects in the logs are desribed using an
ObjectId, which has the following fields:Field Name | Data Type | Description |
|---|---|---|
id | String | The Adnuntius object ID |
name | String | The object name |
Example:
{
"id": "s8734kjhw98",
"name": "July Line Item"
}
Costs are described using a
MonetaryAmount object.Field Name | Data Type |
|---|---|
currency | String |
amount | Number |
Example:
{
"curreny": "EUR",
"amount": 10.0
}
The location is reported using the following properites:
CONTINENTCOUNTRYREGIONCITYPOSTCODE
Example:
{
"CONTINENT": "Oceania",
"COUNTRY": "Australia"
"REGION": "Victoria",
"CITY": "Melbourne",
"POSTCODE": "3000",
}
One of the following values:
Name | Description |
|---|---|
TCF_PURPOSE_1 | IAB Europe Transparency & Consent Framework Purpose 1 - Store and/or access information on a device |
TCF_PURPOSE_2 | IAB Europe Transparency & Consent Framework Purpose 2 - Select basic ads |
TCF_PURPOSE_3 | IAB Europe Transparency & Consent Framework Purpose 3 - Create a personalised ads profile |
TCF_PURPOSE_4 | IAB Europe Transparency & Consent Framework Purpose 4 - Select personalised ads |
TCF_PURPOSE_5 | IAB Europe Transparency & Consent Framework Purpose 5 - Create a personalised content profile |
TCF_PURPOSE_6 | IAB Europe Transparency & Consent Framework Purpose 6 - Select personalised content |
TCF_PURPOSE_7 | IAB Europe Transparency & Consent Framework Purpose 7 - Measure ad performance |
TCF_PURPOSE_8 | IAB Europe Transparency & Consent Framework Purpose 8 - Measure content performance |
TCF_PURPOSE_9 | IAB Europe Transparency & Consent Framework Purpose 9 - Apply market research to generate audience insights |
TCF_PURPOSE_10 | IAB Europe Transparency & Consent Framework Purpose 10 - Develop and improve products |
The logs include "pseudo" user identifiers that have been anonymised so that they no longer uniquely identify a single user. The same user will always be assigned the same identifier, but that same identifier can and will also be assigned to multiple other users as well. The identifiers can be used with a probabilistic cardinality estimation method, such as the popular HyperLogLog algorithm, to estimate the number of unique users that viewed an advertisement without knowing precisely the number of times that each individual user viewed the ad.