Beta Logs

Quick Links:

Request Logs

NameDescriptionSample DataType
IdThe unique Request ID55cc44928bd94f4a9
c18b8a4edac2365
string
BlockedAdvertiserIdsarray[int]
BlockedCampaignIdsarray[int]
BlockedCreativeIdsarray[int]
BlockedFlightsarray[int]
Datacenterboolean
DeliveryMode1 = Web (served by ados.js tags)
2 = Email (served by HTML tags)
3 = API (served by REST call)
4 = Static Tracking Link (served by GIF)
3int
Deviceobject - see other
EnableBotFilteringIndicated whether or not the request was bot filtered against IAB bots/spiders listboolean
EnableUserDBIPIndicates whether or not we store the IP in UserDBboolean
GdprComputedGiven all gdpr variables/vendor lookups etc, whether the request qualifies as consentingTRUEboolean
GdprIsEuBoolean indicating whether request's origin country is EUboolean
GdprRawBoolean passed in for consentboolean
GdprsourceSource of consent. '+' separated string of values: 'blk', 'req', 'udb', 'req'. example: 'req+udb'string
HostName“e-10322.adzerk.net“string
IncludePricingDataIndicates whether pricing data was requested - we returnboolean
IsValidUAIf true, the request passed the bots and spiders filterTRUEboolean
KeywordsKeywords defining the request made.[cp4uowfsyyzpt,
dt7zi5mlfrrs7]
array[string]
Location.CityAn array of location data from the ad request.Sydneystring
Location.CountryCodesee aboveAUstring
Location.CountryNamesee aboveAustraliastring
Location.Latitudesee above0int
Location.Longitudesee above0int
Location.PostalCodesee above2000string
Location.Regionsee aboveNSWstring
Meta:schemaThe type of log - will always be eventeventstring
Meta:versionThe version of the log format this log object uses1string
NetworkIdThe network ID from the request10322int
PropertiesCustom properties set by the user on the request. only appears if not emptyhttpsarray[string]
ProtocolProtocol of this requeststring
ReferrerUrlReferrer url if request.referrer is setstring
RequestCountNumber of items requested to be returned for this request1int
TimestampTime of the request, as milliseconds since UNIX epoch1581038415077long
UrlURL if request.url is setstring
User.IsNewAn array of user data (in UserDB) associated with the request. Contains two fields: the Key, and whether or not this is a new user. Sourced from the requestTRUEboolean
User.KeySee aboveue1-708a3d9146d7438
b85a8cc6686e9a0e8
string

Decision Logs

The ad serving engine makes a decision from the request as to which ad (if any) to return in the response. Every placement sent in the request will receive its own decision, so one request could generate ten decisions if there are ten placements.

Decision logs contain a JSON object for each decision.

NameDescriptionSample DataType
IdThe decision ID"8f4f8ce4c48041ebb
abe267bc619a644"
string
AdIdThe ad ID if it was passed in the placement1234567int
AdTypesThe ad types from the placement[5]array[int]
CampaignIdThe campaign ID if it was passed in the placementint
ClickUrlThe ClickUrl if passed in the placementstring
ContentKeysA map of key/value pairs used for ContentDB if passed in the placementobject
CountThe number of ads to return per placement if passed in the placementint
DecisionCountNumber of decisions per object. You can sum the DecisionCount to get a total1int
DivNameThe name of the div from the placement"div1"string
EventIdsEvent IDs if passed in the placementarray
FlightIdThe flight ID if it was passed in the placementint
FloorCPCFloor price if passed in the placementfloat
FloorPriceFloor CPC if passed in the placementfloat
Meta:versionThe decision ID"1.0"string
Meta:schemaThe type of log - will always be decision"decision"string
NetworkIdThe network ID from the request1234int
OverridesAn object that overrides values for an advertiser, campaign, flight or ad, if passed in the placementobject
PropertiesA map of key/value pairs used to pass custom properties in the placementobject
ProportionalityIf a multi-winner placement used the proportionality settingboolean
RequestIdThe ID of the decision's request"a6dca0abf19e4b41a4ac
679b9328907b"
string
SiteIdThe site ID from the placementint
TimestampTime of the decision, as milliseconds since UNIX epoch1541173272293long
ZoneIdsThe zone ID(s) if they were passed in the placementarray
{
  "Meta:schema": "decision",
  "Meta:version": "1.0",
  "NetworkId": 1234,
  "Id": "8f4f8ce4c48041ebbabe267bc619a644",
  "DecisionCount": 1,
  "RequestId": "a6dca0abf19e4b41a4ac679b9328907b",
  "Timestamp": 1541173272293,
  "DivName": "div1",
  "AdTypes": [
    5
  ],
  "SiteId": 123456,
  "AdId": 1234567
}

Selection Logs

The JSON objects for other events use the same format as the impression object.

NameDescriptionSample DataType
AdTypeIdThe numeric ID of an ad size. Sourced from the event shim162int
AuctionBidsThe number of non-RTB ads competing for the impression in an Auction priority. If the ad served was selected outside of an Auction priority, then this AuctionsBids value will be zero. Note that this field is absent unless there is at least one auction bid in the event shim78int
BrandIdThe numeric ID of the impression's advertiser. Sourced from the event shim554125int
CampaignIdThe numeric ID of the impression's campaign. Sourced from the event shim1331048int
CategoriesThe numeric ID of the impression's advertiser. Sourced from the event shim[]array
ChannelIdThe numeric ID of the impression's channel. Sourced from the event shim40304int
CreatedOnA time/date stamp (milliseconds since UNIX epoch) that indicates when the impression happened"/Date(1581038413783)/"int (date)
CreativeIdThe numeric ID of the impression's creative. Sourced from the event shim16458736int
CreativeMetadataThe creative metadata and/or creative template values of the selection if they are set on the creative{
"customData": {
"example": {
"keyName": true
}
},
"ctTemplateVariable": "foo"
}
object
CreativePassIdThe numeric ID of the impression's ad (creative mapped to flight). Sourced from the event shim19126348int
DatacenterIf true, the event originates from a TAG known datacenter.FALSEboolean
DecisionIdDecision ID associated with this selection“7fb50ca376064d9ba5
0005e24535f4c9”
string
DecisionIdxDecision Index. If the Decision generates only one Selection (i.e. it does not originate from a multi-winner placement) then the DecisionIdx will always be 0. For multi-winner placements, the DecisionIdx will be the order of the Selection within the Decision (zero indexed).0int
DeliveryMode1 = Web (served by ados.js tags)
2 = Email (served by HTML tags)
3 = API (served by REST call)
4 = Static Tracking Link (served by GIF)
3int
EcpmCalculated ECPM of the impression/click/event830.070956float
FirstChannelIdDeprecated40304int
GeoMatchedPointsOnly included when using GeoDistance targeting. List of GeoDistance targets
GdprComputedIf true, the request has GDPR consent (from the request itself, from a UserDB record, etc.)TRUEboolean
GdprConsentRequiredIf true, the gdprConsentRequired parameter was provided on the request, indicating that the user was subject to GDPR regulation (even if they didn't use an EU IP address).FALSEboolean
GdprConsentStringThe IAB consent string provided with the request if the string was used when computing GDPR consent.““string
GdprSourceWhere GDPR consent data (true or false) originates:

none - no consent
request - on the ad request
userdb - on the user record
both - both user record and request
str - from an IAB consent string + allowed vendor ID
"none"string
IdThe unique Selection ID"71f5686388df4fd99fb
f43b96eeb4946"
string
IsNoTrackIf true, the impression was served to a Do Not Track enabled user (boolean)FALSEboolean
IsPublisherPayoutExemptDeprecated (boolean)FALSEboolean
IsRemainderIf true, the impression was served as part of the "Remainder Percentage" in an auction priority. IsRemainder is only logged when true.FALSEboolean
IsTrackingCookieEventsIf true, the impression is tracking conversions. Sourced from the event shim (boolean)FALSEboolean
IsValidUAIf true, the impression passed the bots and spiders filter (boolean)TRUEboolean
KeywordsKeyword(s) sent on the request, converted into a comma separated string. Sourced from the event shim"fpfdvrmwggl4z,j7sr2y
wlddf6m,dt7zi5mlfrrs7,
kr74uowfsyyzp"
string (comma delimited)
Location.CountryCodeAn array of location data from the request. Sourced from the ad request, NOT the event shim"AU"string
Location.CountryNameSee above"Australia"string
Location.RegionSee above"NSW"string
Location.CitySee above"Sydney"string
Location.PostalCodeSee above"2000"string
Location.LatitudeSee above0int
Location.LongitudeSee above0int
MatchingKeywordsKeyword(s) present in the ad. Sourced from the event shim["j7sr2ywlddf6m",
"hh7sr2ywlddf6"]
array[string]
Meta:schemaThe type of log - will always be event"event"string
Meta:versionThe version of the log format this log object uses"1.3"string
NetworkIdThe numeric ID of the selection's network. Sourced from the event shim10322int
PassIdThe numeric ID of the selection's flight. Sourced from the event shim11082877int
PlacementNameThe name of the Placement object or
that served the ad. Sourced from the event shim
"placement 5"string
PriceThe price per unit (CPA, CPM, CPC etc.) associated with the impression. Returned as a string. Sourced from the event shim"6.01"string
PriorityIdThe numeric ID of the selection's priority. Sourced from the event shim161492int
RateTypeThe rate used by the flight. Sourced from the event shim:
· 1 - Flat
· 2 = CPM
· 3 = CPC
· 4 = CPA View
· 5 = CPA Click
· 6 = CPA Both
3int
RelevancyScore500int
RemoteIPDue to GDPR regulation, this is sanitized as 0.0.0.0 instead of the IP address. You can optionally log IP addresses if the request or user record IP address does not originate from a GDPR regulated area(https://dev.kevel.co/docs/gdpr-compliance-and-consent-settings#section-writing-ip-addresses-to-data-shipping-when-gdpr-doesnt-apply)"0.0.0.0"string
RevenueRevenue generated via the impression. Calculated by taking the revenue field in the event shim and multiplying by 1,000,0000
ServedBy"i-0ecaf52dd4dba2672"string
ServedByAsg"bifrost-adservers-default
-us-east-1"
string
ServedByPid43473int
SiteIdThe numeric ID of the impression's site. Sourced from the event shim1086974int
User.IsNewAn array of user data (in UserDB) associated with the impression. Contains two fields: the Key, and whether or not this is a new user. Sourced from either the UserDB record or the user's azk cookieFALSEboolean
User.KeySee above"ue1-3542a229b8be4109b
cad892fc317ddfa"
string
UserAgentDeprecated for privacy purposes. User agent data can now be found in the Device object““string
UserKeyThe user Key (used by UserDB) associated with the impression. Sourced from the ad request"ue1-3542a229b8be4109b
cad892fc317ddfa"
string
ZoneIdThe numeric ID of the impression's zone (if applicable). Sourced from the event shim0int

UserDB Logs

UserDB logs contain JSON objects that represent an activity involving user records— adding custom interests, setting interests, setting GDPR consent, etc. UserDB logs are not shipped by default. You will UserDB enabled, data shipping enabled, AND request the beta logs via a support ticket.

KeyDescription
ActionThe UserDB action logged. See table below
BrandIdThe ID of a retargeted advertiser, set by the /rt endpoint
Custom:[key]Custom JSON values set by /custom endpoint
ConsentGDPR consent string set by /consent endpoint
InterestInterest, set by /interest endpoint
IPUser's IP address, set by the /ip endpoint
Meta:versionThe version of the log format this log object uses
Meta:schemaThe type of log - will always be userdb
NetworkIdYour account's network ID
PartnerIdRTB partner ID set by /sync endpoint
PartnerKeyPartner key that was set by /sync endpoint
Property:[key]Any properties passed as a query string on the endpoint, as ?property:foo=bar
SegmentIdThe ID of a retargeting segment, set by the /rt endpoint
TimestampTime of the action, as milliseconds since UNIX epoch
UserKeyThe UserDB ID (also known as "user key") of the user

Action values:

ActionDescription
cookieUser record was loaded as the azk cookie (/set endpoint)
consentUser's consent was added/removed (/consent endpoint)
customCustom JSON data was added to a user record (/custom endpoint)
forgetUser record was forgotten (/forgot endpoint)
interestInterest was added to a user record (/interest endpoint)
ipIP address was added to user record (/ip endpoint)
retargetingUser record was added to retargeting segment (/rt endpoint)
optoutUser was opted out of UserDB tracking (/optout endpoint)
syncUser record was synced with a third-party ID (/sync endpoint)
{
  "Meta:schema": "userdb",
  "Meta:version": "1.0",
  "NetworkId": 1234,
  "UserKey": "newKey",
  "Timestamp": 1540920521404,
  "Action": "cookie"
}