Event level logs

This page describes the format of the raw adserver logs.

Fields

The top level bid request object and accompanying fields are below, followed by each lower level object contained within it.

FieldTypeDescription
event_nameString; requiredThe event type
tagString; requiredThe creative ID of the request
cf_coloString; requiredThe three-letter airport code (e.g. ATX, LUX) representing the colocation which processed the request
cf_asnInteger; requiredThe Autonomous System Number (ASN) of the request, e.g. 395747
cf_countryString; requiredThe two-letter country code of origin for the request. This is the same value as that provided in the CF-IPCountry header, e.g. "US"
cf_cityString; requiredCity of the incoming request, e.g. “Austin”.
cf_continentString; requiredContinent of the incoming request, e.g. “NA”
cf_postal_codeString; requiredPostal code of the incoming request, e.g. “78701”
cf_regionString; optionalIf known, the ISO 3166-2 name for the first level region associated with the IP address of the incoming request, e.g. “Texas”.
cf_region_codeString; optionalIf known, the ISO 3166-2 code for the first level region associated with the IP address of the incoming request, e.g. “TX”.
worker_cf_rayString; requiredThe Cf-Ray of the worker that handled the request
auction_idString; optionalIf present, the replaced auction ID macro provided by the DSP
cachebusterString; optionalIf present, the replaced cachebuster macro provided by the DSP
client_ipString; requiredThe ip of the request
timestampInteger; requiredThe timestamp of the request
dateString; requiredThe date of the request in the format YYYY-MM-DD