Standard Logs

The standard logs stored within the Data Shipping logs include:

Impression Logs

Name

Description

Sample Data

Type

ID

The unique Impression ID

1

string

AdTypeId

The numeric ID of an ad size. Sourced from the event shim

162

int

AuctionBids

The 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 shim

78

int

BrandId

The numeric ID of the impression's advertiser. Sourced from the event shim

554125

int

BurnIn

If 1, the impression/click/event was served when an eCPM optimized flight was in a "burn-in" period.

TRUE

boolean

CampaignId

The numeric ID of the impression's campaign. Sourced from the event shim

1331048

int

Categories

An array of behavior targeting categories, set by the impression's flight. Sourced from the event shim, absent if absent in the shim

[]

array

ChannelId

The numeric ID of the impression's channel. Sourced from the event shim

40304

int

CreativeId

The numeric ID of the impression's creative. Sourced from the event shim

16458736

int

CreatedOn

A time/date stamp (milliseconds since UNIX epoch) that indicates when the impression happened

"/Date(1581038413783)/"

int (date)

CreativePassId

The numeric ID of the impression's ad (creative mapped to flight). Sourced from the event shim

19126348

int

Datacenter

If true, the event originates from a TAG known datacenter.

FALSE

boolean

DecisionId

The ID of the Decision associated with the impression/click/event

“7fb50ca376064d9ba
50005e24535f4c9”

string

DecisionIdx

Decision 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).

0

int

DeliveryMode

1 = 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)

3

int

Device.brandName

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

““

string

Device.modelName

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

““

string

Device.osRawVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

““

string

Device.osMajorVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

0

int

Device.osMinorVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

0

int

Device.browser

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

““

string

Device.browserRawVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

““

string

Device.browserMajorVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

0

int

Device.browserMinorVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

0

int

Device.formFactor

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

“desktop”

int

Ecpm

Calculated ECPM of the impression/click/event

830.070956

float

EventCreatedOn

When the impression event occurred, as a UNIX timestamp

1581038414099

long

FirstChannelId

Deprecated

40304

int

FrequencyCap

The type(s) of frequency capping applied to the impression. Logged as the decimal value of a hex bit flag:

FlightCapped:                0x00000001
AdCapped:                    0x00000010
CampaignCapped:              0x00000100
AdvertiserCapped:            0x00001000
FlightDoesNotAffectParent:   0x00010000
AdDoesNotAffectParent:       0x00100000
CampaignDoesNotAffectParent: 0x01000000

For instance, an impression with both a flight cap and ad cap has a flag of 0x00000011, i.e. decimal 17.

17

int

GdprComputed

If true, the request has GDPR consent (from the request itself, from a UserDB record, etc.)

TRUE

boolean

GdprConsentRequired

If 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).

FALSE

boolean

GdprConsentString

The IAB consent string provided with the request if the string was used when computing GDPR consent.

““

string

GdprIsEU

If true, the request originates from the EU, the UK, or Switzerland.

TRUE

boolean

GdprSource

Where 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

GdprVendorId

The vendor ID provided in the request (if available).

Gmv

Gross Merchandise Value. Sourced from the event URL if appended as a query parameter. Calculated by taking the gmv parameter on the event URL and multiplying by 1,000,000.

1000000

int

GrossRevenue

0

int

ImpressionCount

The number of impressions in the object. Default is 1

1

int

ImpressionCreatedOn

Records the time this Event was created in the server, as a UNIX timestamp

1581038413783

long

IsNoTrack

If true, the impression was served to a Do Not Track enabled user (boolean)

FALSE

boolean

IsPublisherPayoutExempt

FALSE

boolean

IsRemainder

If true, the impression was served as part of the "Remainder Percentage" in an auction priority. IsRemainder is only logged when true.

FALSE

boolean

IsTrackingCookieEvents

If true, the impression is tracking conversions. Sourced from the event shim (boolean)

FALSE

boolean

IsPublisherPayoutExempt

Deprecated (boolean)

FALSE

boolean

IsValidUA

If true, the impression passed the bots and spiders filter (boolean)

TRUE

boolean

Keywords

Keyword(s) sent on the request, converted into a comma separated string. Sourced from the event shim

"fpfdvrmwggl4z,j7sr2ywldd
6m,dt7zi5mlfrrs7,kr74uow
fsyyzp"

string (comma delimited)

Location.CountryCode

An array of location data from the request. Sourced from the ad request, NOT the event shim

"AU"

string

Location.CountryName

See above

"Australia"

string

Location.Region

See above

"NSW"

string

Location.City

See above

"Sydney"

string

Location.PostalCode

See above

"2000"

string

Location.Latitude

See above

0

int

Location.Longitude

See above

0

int

Matching Keywords

Keyword(s) present in the ad. Sourced from the event shim

["j7sr2ywlddf6m", "hh7sr2ywlddf6"]

array[string]

Meta:schema

The type of log - will always be event

"event"

string

Meta:version

The version of the log format this log object uses

"1.3"

string

NetRevenue

0

int

NetworkId

The numeric ID of the impression's network. Sourced from the event shim

10322

int

PassId

The numeric ID of the impression's flight. Sourced from the event shim

11082877

int

PhantomCreativePassId

Internal - used during phantom mode for impression goal ads. Sourced from the event shim

0

int

PlacementName

The name of the Placement object or <div> that served the ad. Sourced from the event shim

"placement 1"

string

PhantomPassId

Internal - used during phantom mode for impression goal ads. Sourced from the event shim

0

int

PriorityId

The numeric ID of the impression's priority. Sourced from the event shim

161492

int

Price

The price per unit (CPA, CPM, CPC etc.) associated with the impression. Returned as a string. Sourced from the event shim

"6.01"

string

RateType

The rate used by the flight. Sourced from the event shim:

2 = CPM
3 = CPC
4 = CPA View
5 = CPA Click
6 = CPA Both```

3

int

ReferrerUrl

The URL that led to the page that hosted the ad request. Sourced from the event shim

RelevancyScore

500

int

Revenue

Revenue generated via the event(impression/click). Calculated by taking the revenue field in the event shim and multiplying by 1,000,000 (in order to support very small prices, such as $0.01 CPM).

For instance, if a flight has a Price of $50 CPM, each impression will have $0.05 of revenue associated with it. Multiplying that by 1,000,000 yields a Revenue value of 50000 on the impression record.

0

int

RemoteIP

Due 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

"0.0.0.0"

string

RtbBids

The number of RTB bids competing for the impression. Remember, RTB ads can be used in any priority type. Also, please note that some RTB partners provide more than one bid per request, but most only provide one. Sourced from the event shim

ServedBy

"i-0ecaf52dd4dba2672"

string

ServedByAsg

"bifrost-adservers-default-
us-east-1"

string

ServedByPid

43473

int

SiteId

The numeric ID of the impression's site. Sourced from the event shim

1086974

int

TimeZoneId

The time zone of the flight. If no time zone is explicitly set, defaults to "UTC". Sourced from the event shim

Url

The URL of the page the ad served on. This may be missing if there was no referrer header on the request. Sourced from the ad request

User.Key

An 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 cookie

"ue1-3542a229b8be4109
bcad892fc317ddfa"

string

User.IsNew

FALSE

boolean

User.Type

Where user data was stored/retrieved from:

1 = Cookie
2 = UserDB

int

UserAgent

Deprecated for privacy purposes. User agent data can now be found in the Device object

““

string

UserKey

The user Key (used by UserDB) associated with the impression. Sourced from the ad request

"ue1-3542a229b8be4109
bcad892fc317ddfa"

string

ZoneId

The numeric ID of the impression's zone (if applicable). Sourced from the event shim

0

int

Click Logs

The JSON objects for other events use the same format as the impression object. Additional parameters for clicks (or parameters with differences):

Name

Description

Sample Data

Type

Id

The unique Click ID

"71f5686388df4fd99
fbf43b96eeb4946"

string

AdTypeId

The numeric ID of an ad size. Sourced from the event shim

162

int

BrandId

The numeric ID of the impression's advertiser. Sourced from the event shim

554125

int

CampaignId

The numeric ID of the impression's campaign. Sourced from the event shim

1331048

int

Categories

An array of behavior targeting categories, set by the impression's flight. Sourced from the event shim, absent if absent in the shim

[]

array

ClickBuckets

Whether the click was bucketed as Unique, with the schema "Unique": {"Value": true/false}. Refer to the click bucketing docs for details

ClickCount

The number of clicks in the object. Always set to 1

int

CreativeId

The numeric ID of the impression's creative. Sourced from the event shim

16458736

int

CreatedOn

A time/date stamp (milliseconds since UNIX epoch) that indicates when the impression happened

"/Date(1581038413783)/"

int (date)

CreativePassId

The numeric ID of the impression's ad (creative mapped to flight). Sourced from the event shim

19126348

int

Datacenter

If true, the event originates from a TAG known datacenter.

FALSE

boolean

DecisionId

The ID of the Decision associated with the impression/click/event

“7fb50ca376064d9b
a50005e24535f4c9”

string

DecisionIdx

0

int

DeliveryMode

1 = 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)

3

int

Device.brandName

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

““

string

Device.modelName

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

““

string

Device.osRawVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

““

string

Device.osMajorVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

0

int

Device.osMinorVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

0

int

Device.browser

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

““

string

Device.browserRawVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

““

string

Device.browserMajorVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

0

int

Device.browserMinorVersion

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

0

int

Device.formFactor

Device fields are from the WURFL field set, see http://wurfl.sourceforge.net/

“desktop”

string

Ecpm

Calculated ECPM of the impression/click/event

830.070956

float

EventCreatedOn

When the click event occurred, as a UNIX timestamp

1581038414099

long

FirstChannelId

Deprecated

40304

int

GdprComputed

If true, the request has GDPR consent (from the request itself, from a UserDB record, etc.)

TRUE

boolean

GdprConsentRequired

If 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).

FALSE

boolean

GdprConsentString

The IAB consent string provided with the request if the string was used when computing GDPR consent.

““

string

GdprIsEU

If true, the request originates from the EU, the UK, or Switzerland.

TRUE

boolean

GdprSource

Where 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

GrossRevenue

0

int

ImpressionCount

The unique Impression Id related to this click

1

ImpressionCreatedOn

Records the time this Event was created in the server, as a UNIX timestamp

1581038413783

long

ImpressionId

The Impression ID

"83ea1dc7160f4
83397eb6f5d1c4e62aa"

string

IsNoTrack

If true, the impression was served to a Do Not Track enabled user (boolean)

FALSE

boolean

IsPublisherPayoutExempt

Deprecated (boolean)

FALSE

boolean

IsRemainder

If true, the impression was served as part of the "Remainder Percentage" in an auction priority. IsRemainder is only logged when true.

FALSE

boolean

IsTrackingCookieEvents

If true, the impression is tracking conversions. Sourced from the event shim (boolean)

FALSE

boolean

IsValidUA

If true, the impression passed the bots and spiders filter. Sourced from the click request (boolean)

TRUE

boolean

Keywords

Keyword(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.CountryCode

An array of location data from the request. Sourced from the click request, NOT the ad request

"AU"

string

Location.CountryName

see above

"Australia"

string

Location.Region

see above

"NSW"

string

Location.City

see above

"Sydney"

string

Location.PostalCode

see above

"2000"

string

Location.Latitude

see above

0

int

Location.Longitude

see above

0

int

Matching Keywords

Keyword(s) present in the ad. Sourced from the event shim

["j7sr2ywlddf6m",
"hh7sr2ywlddf6"]

array[string]

Meta:schema

The type of log - will always be event

"event"

string

Meta:version

The version of the log format this log object uses

0

string

NetRevenue

0

int

NetworkId

The numeric ID of the impression's network. Sourced from the event shim

10322

int

PassId

The numeric ID of the impression's flight. Sourced from the event shim

11082877

int

PlacementName

The name of the Placement object or

that served the ad. Sourced from the event shim

"placement 1"

string

PriorityId

The numeric ID of the impression's priority. Sourced from the event shim

161492

int

Price

The price per unit (CPA, CPM, CPC etc.) associated with the impression. Returned as a string. Sourced from the event shim

"6.01"

string

RateType

The 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

3

int

RelevancyScore

500

int

RemoteIP

This is sanitized as 0.0.0.0 instead of the IP address

"0.0.0.0"

string

Revenue

Revenue generated via the impression. Calculated by taking the revenue field in the event shim and multiplying by 1,000,000

0

int

SiteId

The numeric ID of the impression's site. Sourced from the event shim

1086974

int

Url

The URL of the page the ad served on. This may be missing if there was no referrer header on the request. Sourced from the click request

User

An 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 the click request

UserAgent

The string of the user agent that created the impression. Sourced from the click request

““

string

UserKey

The user Key (used by UserDB) associated with the impression. Sourced from the click request

"ue1-3542a229b8be4109
bcad892fc317ddfa"

string

ZoneId

The numeric ID of the impression's zone (if applicable). Sourced from the event shim

0

int

Conversion Logs

The JSON objects for other events use the same format as the impression object. Additional parameters for conversions (or parameters with differences):

Name

Description

CreatedOn

(Deprecated) When the impression associated with the conversion occurred, as a UNIX timestamp

EventCreatedOn

When the conversion occurred, as a UNIX timestamp

ImpressionCreatedOn

Records the time this Event was created in the server, as a UNIX timestamp

IsValidUA

If true, the impression passed the bots and spiders filter. Sourced from the conversion request (boolean)

Location

An array of location data from the request. Sourced from the conversion request, NOT the ad request

RemoteIP

This is sanitized as 0.0.0.0 instead of the IP address

Url

The URL of the page the ad served on. This may be missing if there was no referrer header on the request. Sourced from the conversion request

User

An 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 the conversion request

UserAgent

The string of the user agent that created the impression. Sourced from the conversion request

UserKey

The user Key (used by UserDB) associated with the impression. Sourced from the conversion request

Custom Event Logs

The JSON objects for other events use the same format as the impression object. They have the same additional parameters as conversions, with one notable difference:

📘

Custom event logs have an additional EventId field that is the ID of the custom event type. (For example, an EventId of 10 is an Upvote event.)