Skip to main content

Log data field & specification

  • Updated

Object: BidRequest (Req)

Exchange

Name

Field

Type

Description

exchange

req.exchange

STRING

A service that conducts an auction among bidders per impression.

ADX, MOPUB

 

Timestamp

Name

Field

Type

Description

timestamp

req.timestamp

TIMESTAMP

Bidrequest received  time in timestamps
yyyy-mm-dd hh:mm:ss.ssssss

2020-02-23 00:00:58.026083

 

App

Name

Field

Type

Description

bundle

req.app.bundle

STRING

A platform-specific application identifier intended to be unique to the app and independent of the exchange

com.youtube, 1234567890

id

req.app.
publisher.id

STRING

Exchange-specific publisher ID.

pub-6821112058762467, 156998

 

Device

Name

Field

Type

Description

ifa

req.device.ifa

STRING

ID sanctioned for advertiser use in the clear.
Device ID for mobile. ADID / IDFA

7e18d70d-b15a-4d4e-8d29-92984ccd6d21

os

req.device.os

STRING

Device operating system

ios, android

osv

req.device.osv

STRING

Device operating system version

8.1.0, 12.4.0, 12.0

carrier

req.device.carrier

STRING

Carrier or ISP e.g., “VERIZON” using exchange curated string names which should be published to bidders a prior.

NTT DOCOMO, Verizon, 310-410

connectiontype

req.device.
connectiontype

INTEGER

Network connection type.

Value Meaning

0

 UNKNOWN

1

ETHERNET

2

WIFI

3

Cellular Network – Unknown Generation

4

Cellular Network – 2G

5

 Cellular Network – 3G

6

 Cellular Network – 4G

 

hwv

req.device.hwv

STRING

Hardware version of the device

ipad air, iPhone11,6, samsung SM-J7109, or mostly empty

make

req.device.make

STRING

Device maker

samsung, apple

model

req.device.model

STRING

Device model

iPhone7,2, sm-j327v, iPad5,3

devicetype

req.device.
devicetype

INTEGER

The general type of device.

Value Meaning

1

Mobile/Tablet

2

Personal Computer

3

Connected TV

4

Phone

5

Tablet

6

Connected Device

7

 Set Top Box

 

language

req.device.

language

STRING

Browser language using ISO-639-1-alpha-2.

en, es, fr, ko, ...

ip

req.device.ip

STRING

IPv4 address closest to device

255.255.255.255

country

req.device.geo.
country

STRING

Country code using ISO-3166-1-alpha-3

USA, BRA, PHL, HKG, ...

utcoffset

req.device.geo.
utcoffset

INTEGER

Local time as the number +/- of minutes from UTC.

540, 0, -30

region

req.device.geo.region

STRING

Region code using ISO-3166-2; 2-letter state code if USA.
ny,wi,tx

metro

req.device.geo.metro

STRING

Google metro code; similar to but not exactly Nielsen DMAs.

658,573,592

city

req.device.geo.city

STRING

City using United Nations Code for Trade & Transport Locations.
newyork,alcoron,lagos,tokyo

zip

req.device.geo.zip

STRING

Zip or postal code.
10016,80001

 

Imp

Name

Field

Type

Description

bidfloor

req.imp.bidfloor

INTEGER

Minimum bid for this impression expressed in CPM

0.01, 0.09775099903345108

tagid

req.imp.tagid

STRING

Identifier for specific ad placement or ad tag that was used to initiate the auction. This can be useful for debugging of any issues, or for optimization by the buyer

cbb1c24b598d420496dd919e7950c254, com.miniclip.eightballpool-vast

 

Banner

Name

Field

Type

Description

w

req.imp.banner.w

INTEGER

Exactdevice independent pixels DIPS;

Could be empty

250, 320

h

req.imp.banner.h

INTEGER

Exact height in device independent pixels DIPS;

Could be empty

250, 50

 

Video

Name

Field

Type

Description

maxduration

req.imp.video.
maxduration

INTEGER

Maximum video ad duration in seconds.

15, 30, 60, 120, ….

minduration

req.imp.video.
minduration

INTEGER

Minimum video ad duration in seconds.

0, 1, 5, 6, 10, 15, 16, ...

w

req.imp.video.w

INTEGER

320

h

req.imp.video.h

INTEGER

Height of the video player in device independent pixels DIPS.

480

skip

req.imp.video.skip

INTEGER

Indicates if the player will allow the video to be skipped

Value Meaning

0

no

1

yes

 

is_rewarded

req.imp.video.ext.
is_rewarded

BOOLEAN

true if the video type is rewarded video,false otherwise.

 

Native

Name

Field

Type

Description

has_image

req.imp.native.ext.
has_image

BOOLEAN

true if inventory allows banner,false otherwise.

has_video

req.imp.native.ext.
has_video

BOOLEAN

true if inventory allows video format,false otherwise.

instl

req.imp.instl

BOOLEAN

true for interstitial format,false otherwise.

 

 

 

Object: Bid

MTID

Name

Field

Type

Description

mtid

bid.mtid

STRING

Single key that can uniquely identify Moloco's “bid"

Ghg1ZTUxYmRkNzJlYWZmNTA0MDc1OGMyMzVCJDAzNjYyZTUzLWQ5MjItNGVlYy1iY2Y3LTQ5MDY4NmQ4ODI2YqABAcACAcgCAg

 

Advertiser

Name

Field

Type

Description

id

bid.advertiser.id

STRING

Moloco Advertiser ID

juoG8R5VJUsFPdkl

title

bid.advertiser.title

STRING

Moloco Advertiser Title

We SHOP, Go Hero Co.

 

Campaign

Name

Field

Type

Description

id

bid.campaign.id

STRING

Moloco Campaign ID

O3gGyW5KLxyuGDfH

title

bid.campaign.title

STRING

Moloco Campaign Title

SegaHeroes_pl:IP_geo:US_ta:UA_ch:Moloco, shopee_a_ua_vnm

 

Adgroup

Name

Field

Type

Description

id

bid.adgroup.id

STRING

Moloco Ad Group ID

tf_joint_snow_usd_install_1112_kn55e3zg0h6iqfzk12q7_a_idn_ni_fpa_android

title

bid.adgroup.title

STRING

c

 

Creative group

Name

Field

Type

Description

id

bid.creativegroup.id

STRING

Moloco Creative Group ID

XQIqp0RDcA0kFTg3

title

bid.creativegroup.title

STRING

Moloco Creative Group Title

Banner_BricksBreakerQuestEN_2002XX

 

Creative

Name

Field

Type

Description

id

bid.creative.id

STRING

Creative ID to assist with ad quality checking.

k2vjdlov_000, k1plgzfg_000

type

bid.creative.type

STRING

Type of creative

IMAGE, NATIVE, or VIDEO

w

bid.creative.w

INTEGER

1200, 640

h

bid.creative.h

INTEGER

Height of the creative in device independent pixels DIPS.

628, 100

size_in_bytes

bid.creative.
size_in_bytes

INTEGER

Size of a creative file, in byte

154335

video_duration

bid.creative.
video_duration

INTEGER

Duration of the video creative in seconds. Zero for non-video creatives

0, 15, 30

 

User

Name

Field

Type

Description

bucket

bid.user.bucket

INTEGER

Assigned user bucket number used in traffic group, ranging    from 0 to 99

0, 1, 2, ... 98, 99

 

Adslot

Name

Field

Type

Description

type

bid.adslot.type

STRING

Category of inventory format. 

IMAGE, VIDEO, NATIVE, INTERSTITIAL

w

bid.adslot.w

INTEGER

300, 320

h

bid.adslot.h

INTEGER

Height of inventory in pixel.

250, 50

 

 

 

 

Object: Imp

Timestamp

Name

Field

Type

Description

timestamp

imp.timestamp

TIMESTAMP

Row insertion time in timestamps
yyyy-mm-dd hh:mm:ss.ssssss

2020-02-23 00:00:58.026083

 

Cost

Name

Field

Type

Description

moloco_micro

imp.cost.
moloco_micro

INTEGER

Moloco’s cost covering raw media, CDN, and other infra cost.

1 USD = 1,000,000 micros

91, 993, 2000

currency

imp.cost.currency

STRING

Contract currency with advertiser.

USD, KRW

fee_percent

imp.cost.fee_percent

FLOAT

Contract fee percent with advertiser.

10, 15, 12.5

total_micro

imp.
cost.total_micro

INTEGER

Total cost calculated by moloco_micro * fee_percent to be paid by advertiser.

105, 1142, 2300

 

IP

Name

Field

Type

Description

ip

imp.ip

STRING

IPv4 address closest to device

255.255.255.255

 

Object: EngagedView

Timestamp

Name

BQ name

Field

Type

Description

timestamp

timestamp

ev.timestamp

TIMESTAMP

Row insertion time in timestamps
yyyy-mm-dd hh:mm:ss.ssssss

2020-02-23 00:00:58.026083

 

IP

Name

BQ name

Field

Type

Description

ip

client_ip

ev.ip

STRING

IPv4 address closest to device

255.255.255.255

 

Object: Click

Timestamp

Name

BQ name

Field

Type

Description

timestamp

timestamp

click.timestamp

TIMESTAMP

Row insertion time in timestamps
yyyy-mm-dd hh:mm:ss.ssssss

2020-02-23 00:00:58.026083

 

Type

Name

BQ name

Field

Type

Description

type

 click_type

click.type

STRING

Event type related to click

DUPLICATED_CLICK, NORMAL_CLICK, NO_IMP_CLICK

 

IP

Name

BQ name

Field

Type

Description

ip

client_ip

click.ip

STRING

IPv4 address closest to device

255.255.255.255


Object: Conversion

MMP

Name

Field

Type

Description

mmp

conversion.mmp

STRING

Mobile Measurement Partner

APPSFLYER, ADJUST, …...

 

Event

Name

Field

Type

Description

event

conversion.event

STRING

Raw postback event name from MMP

add_to_cart, 03_Character Create, 1st Purchase, ...

 

Timestamp

Name

Field

Type

Description

timestamp

conversion.timestamp

TIMESTAMP

Postback received time from MMP
yyyy-mm-dd hh:mm:ss.ssssss

2020-02-22 23:59:18.279045

 

Attribution

Name

Field

Type

Description

timestamp

conversion.attribution.timestamp

TIMESTAMP

Postback recorded time in MMP

yyyy-mm-dd hh:mm:ss.ssssss

2020-02-22 23:59:18.279045

is_view_through

conversion.attribution.is_view_through

BOOLEAN

true if the postback event occurred from view_through link,false otherwise.

is_engaged_view_through

conversion.attribution.is_engaged_view_through

BOOLEAN

Valid values are true and false. When the value is true, the postback event has occurred from the engaged_view_through link.

 

Revenue

Name

Field

Type

Description

amount

conversion.
revenue.amount

FLOAT

Revenue from the postback event

124300.0, 43800.0

currency

conversion.
revenue.currency

STRING

Currency of revenue from the postback event

USD, KRW

amount_usd

conversion.revenue.
amoun_tusd

FLOAT

Revenue from the postback event in USD

124300.0, 43800.0

 

Postback

Name

Field

Type

Description

postback

conversion.postback

STRING

Raw postback string from MMP

/postback?ref_name=branch_data_sync&imp_id=adxr_20200223090354196376039775&country=KR&event_type=Auto-Login&reengage=1&network=Moloco&android_id=&aaid=5d83ca47-1776-479b-b344-54fccf9dc413&idfa=&idfv=&uid=2992304&app_id=com.wemakeprice&app_v=5.7.1&branch_v=4.1.2&device_name=SM-G965N&device_type=&language=KO&ip_address=1.176.18.163&os_name=ANDROID&osv=9&source=Gh9hZHhyXzIwMjAwMjIzMDkwMzU0MTk2Mzc2MDM5Nzc1QiQ1ZDgzY2E0Ny0xNzc2LTQ3OWItYjM0NC01NGZjY2Y5ZGM0MTOgAQHAAgHIAgI&is_attributed=1&is_view_through=0&custom_data=%7B%22rating%22%3A%221524437945355993556%22%7D&revenue=&currency=&click_at=1582416249&install_at=&event_at=1582416254&adv_ref_id=&txn_id=&campaign=wemakeprice_p2_ar_a_re_kor&creative=&adgroup=&my_campaign=C1009&my_ad=G_7&my_adgroup=2002_G&my_publisher=&my_placement=4000036&my_keyword=&items_json=%5B%5D&limit_ad_tracking=1&sub_publisher=

 

Object: SKAdNetwork (Req)

Device

Name

Field

Type

Description

lmt

req.device.lmt

INTEGER

“Limit Ad Tracking” signal commercially endorsed (e.g., iOS, Android), where 0 = tracking is unrestricted, 1 = tracking must be limited per commercial guidelines.

/ 0, 1

0, 1

 

Object: SKAdNetwork (Bid)

Ad account

Name

Field

Type

Description

id

bid.adaccount.id

STRING

Moloco AdAccount ID

hNbQr7Ilpl9hmseo

title

bid.adaccount.title

STRING

Moloco Advertiser Title

We SHOP, Go Hero Co.

 

 

App

Name

Field

Type

Description

id

bid.app.id

STRING

Moloco App ID

lS39DZTfzAoALIaO

title

bid.app.title

STRING

Moloco App Title

We SHOP IOS, Go Hero Co. Android

 

Campaign

Name

Field

Type

Description

id

bid.campaign.id

STRING

Moloco Campaign ID

dwy9FguozqvXTm4H

title

bid.campaign.title

STRING

Moloco Campaign Title

watchmovie_a_ua_kor, AndroidCS_MolocoDSP_Install_UA10

skan_id

bid.campaign.skan_id

INTEGER

SKAdNetwork Campaign ID explicitly specified by Moloco Campaign.

1,3, 4,5, 7,8, 9

 

Traffic

Name

Field

Type

Description

skan

bid.traffic.skan

BOOLEAN

Indicates whether the bid response is SKAdNetwork-supported. Valid values are true and false.

 

 

Object: SKAdNetwork (Conversion)

Timestamp

Name

Field

Type

Description

timestamp

cv.timestamp

TIMESTAMP

Postback received from SKAdNetwork.

2021-04-05 00:00:58.026083

 

Client

Name

Field

Type

Description

ip

cv.client.ip

STRING

IP address of whom sent the postback to Moloco.

172.58.121.61,67.212.16.16

ua

cv.client.ua

STRING

User Agent of whom sent the postback to Moloco.

App Store

country

cv.client.country

STRING

Country where the postback comes from in ISO-3166 1-alpha-3.

USA,KOR

 

Postback

Name

Field

Type

Description

raw

cv.postback.raw

STRING

Raw JSON string of SKAdNetwork postback.

{
  “app-id” : 553834731,
  “campaign-id” : 10,
  “attribution-signature” : “MDYCGQC2jD\/cAUcX4VkNw2Xs0tDCrxsdvRnN+l4CGQD4jwUW2JruWPY4ug1TMrh7ehnH9p31850=“,
  “transaction-id” : “155639df-06c9-418b-a427-43682a15dcb7",
  “version” : “2.0",
  “ad-network-id” : “9t245vhmpl.skadnetwork”,
  “redownload” : false
}

version

cv.postback.version

STRING

The version of the ad network validation API.

1.0,2.0,2.1,2.2

campaign-id

cv.postback.campaign-id

INTEGER

The campaign ID ad network provided when displaying ads.

1,4,7,96

app-id

cv.postback.app-id

INTEGER

The item identifier of the advertised product.

525463029,1234567891

redownload

cv.postback.redownload

BOOLEAN

A Boolean flag that indicates the customer redownloaded and reinstalled the app when the value is true.

true,false

source-app-id

cv.postback.source-app-id

INTEGER

The item identifier of the app that displayed the ad. Note: The source_app_id appears in the postback only if providing the parameter meets Apple’s privacy threshold

525463029,1234567891

fidelity-type

cv.postback.fidelity-type

INTEGER

A value of 0 indicates a view-through ad presentation; a value of 1 indicates a StoreKit-rendered ad

0,1

conversion-value

cv.postback.conversion-value

INTEGER

An unsigned 6-bit representation of conversion events.

Note: The conversion-value only appears in the postback if the installed app provides it, and if providing the parameter meets Apple’s privacy threshold.

0,9,17,63

 

 

Was this article helpful?

1 out of 1 found this helpful

Have more questions? Submit a request