Object: BidRequest (Req)
Exchange
Name |
Field |
Type |
Description |
exchange |
req.exchange |
STRING |
A service that conducts an auction among bidders per impression.
|
Timestamp
Name |
Field |
Type |
Description |
timestamp |
req.timestamp |
TIMESTAMP |
Bidrequest received time in timestamps
|
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
|
id |
req.app. |
STRING |
Exchange-specific publisher ID.
|
Device
Name |
Field |
Type |
Description |
||||||||||||||||
ifa |
req.device.ifa |
STRING |
ID sanctioned for advertiser use in the clear.
|
||||||||||||||||
os |
req.device.os |
STRING |
Device operating system
|
||||||||||||||||
osv |
req.device.osv |
STRING |
Device operating system version
|
||||||||||||||||
carrier |
req.device.carrier |
STRING |
Carrier or ISP e.g., “VERIZON” using exchange curated string names which should be published to bidders a prior.
|
||||||||||||||||
connectiontype |
req.device. |
INTEGER |
Network connection type.
|
||||||||||||||||
hwv |
req.device.hwv |
STRING |
Hardware version of the device
|
||||||||||||||||
make |
req.device.make |
STRING |
Device maker
|
||||||||||||||||
model |
req.device.model |
STRING |
Device model
|
||||||||||||||||
devicetype |
req.device. |
INTEGER |
The general type of device.
|
||||||||||||||||
language |
req.device. language |
STRING |
Browser language using ISO-639-1-alpha-2.
|
||||||||||||||||
ip |
req.device.ip |
STRING |
IPv4 address closest to device
|
||||||||||||||||
country |
req.device.geo. |
STRING |
Country code using ISO-3166-1-alpha-3
|
||||||||||||||||
utcoffset |
req.device.geo. |
INTEGER |
Local time as the number +/- of minutes from UTC.
|
||||||||||||||||
region |
req.device.geo.region |
STRING |
Region code using ISO-3166-2; 2-letter state code if USA. |
||||||||||||||||
metro |
req.device.geo.metro |
STRING |
Google metro code; similar to but not exactly Nielsen DMAs.
|
||||||||||||||||
city |
req.device.geo.city |
STRING |
City using United Nations Code for Trade & Transport Locations. |
||||||||||||||||
zip |
req.device.geo.zip |
STRING |
Zip or postal code. |
Imp
Name |
Field |
Type |
Description |
bidfloor |
req.imp.bidfloor |
INTEGER |
Minimum bid for this impression expressed in CPM
|
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
|
Banner
Name |
Field |
Type |
Description |
w |
req.imp.banner.w |
INTEGER |
Exactdevice independent pixels DIPS; Could be empty
|
h |
req.imp.banner.h |
INTEGER |
Exact height in device independent pixels DIPS; Could be empty
|
Video
Name |
Field |
Type |
Description |
||||||
maxduration |
req.imp.video. |
INTEGER |
Maximum video ad duration in seconds.
|
||||||
minduration |
req.imp.video. |
INTEGER |
Minimum video ad duration in seconds.
|
||||||
w |
req.imp.video.w |
INTEGER |
|
||||||
h |
req.imp.video.h |
INTEGER |
Height of the video player in device independent pixels DIPS.
|
||||||
skip |
req.imp.video.skip |
INTEGER |
Indicates if the player will allow the video to be skipped
|
||||||
is_rewarded |
req.imp.video.ext. |
BOOLEAN |
|
Native
Name |
Field |
Type |
Description |
has_image |
req.imp.native.ext. |
BOOLEAN |
|
has_video |
req.imp.native.ext. |
BOOLEAN |
|
instl |
req.imp.instl |
BOOLEAN |
|
Object: Bid
MTID
Name |
Field |
Type |
Description |
mtid |
bid.mtid |
STRING |
Single key that can uniquely identify Moloco's “bid"
|
Advertiser
Name |
Field |
Type |
Description |
id |
bid.advertiser.id |
STRING |
Moloco Advertiser ID
|
title |
bid.advertiser.title |
STRING |
Moloco Advertiser Title
|
Campaign
Name |
Field |
Type |
Description |
id |
bid.campaign.id |
STRING |
Moloco Campaign ID
|
title |
bid.campaign.title |
STRING |
Moloco Campaign Title
|
Adgroup
Name |
Field |
Type |
Description |
id |
bid.adgroup.id |
STRING |
Moloco Ad Group ID
|
title |
bid.adgroup.title |
STRING |
c |
Creative group
Name |
Field |
Type |
Description |
id |
bid.creativegroup.id |
STRING |
Moloco Creative Group ID
|
title |
bid.creativegroup.title |
STRING |
Moloco Creative Group Title
|
Creative
Name |
Field |
Type |
Description |
id |
bid.creative.id |
STRING |
Creative ID to assist with ad quality checking.
|
type |
bid.creative.type |
STRING |
Type of creative
|
w |
bid.creative.w |
INTEGER |
|
h |
bid.creative.h |
INTEGER |
Height of the creative in device independent pixels DIPS.
|
size_in_bytes |
bid.creative. |
INTEGER |
Size of a creative file, in byte
|
video_duration |
bid.creative. |
INTEGER |
Duration of the video creative in seconds. Zero for non-video creatives
|
User
Name |
Field |
Type |
Description |
bucket |
bid.user.bucket |
INTEGER |
Assigned user bucket number used in traffic group, ranging from 0 to 99
|
Adslot
Name |
Field |
Type |
Description |
type |
bid.adslot.type |
STRING |
Category of inventory format.
|
w |
bid.adslot.w |
INTEGER |
|
h |
bid.adslot.h |
INTEGER |
Height of inventory in pixel.
|
Object: Imp
Timestamp
Name |
Field |
Type |
Description |
timestamp |
imp.timestamp |
TIMESTAMP |
Row insertion time in timestamps
|
Cost
Name |
Field |
Type |
Description |
moloco_micro |
imp.cost. |
INTEGER |
Moloco’s cost covering raw media, CDN, and other infra cost. 1 USD = 1,000,000 micros
|
currency |
imp.cost.currency |
STRING |
Contract currency with advertiser.
|
fee_percent |
imp.cost.fee_percent |
FLOAT |
Contract fee percent with advertiser.
|
total_micro |
imp. |
INTEGER |
Total cost calculated by moloco_micro * fee_percent to be paid by advertiser.
|
IP
Name |
Field |
Type |
Description |
ip |
imp.ip |
STRING |
IPv4 address closest to device
|
Object: EngagedView
Timestamp
Name |
BQ name |
Field |
Type |
Description |
timestamp |
timestamp |
ev.timestamp |
TIMESTAMP |
Row insertion time in timestamps
|
IP
Name |
BQ name |
Field |
Type |
Description |
ip |
client_ip |
ev.ip |
STRING |
IPv4 address closest to device
|
Object: Click
Timestamp
Name |
BQ name |
Field |
Type |
Description |
timestamp |
timestamp |
click.timestamp |
TIMESTAMP |
Row insertion time in timestamps
|
Type
Name |
BQ name |
Field |
Type |
Description |
type |
click_type |
click.type |
STRING |
Event type related to click
|
IP
Name |
BQ name |
Field |
Type |
Description |
ip |
client_ip |
click.ip |
STRING |
IPv4 address closest to device
|
Object: Conversion
MMP
Name |
Field |
Type |
Description |
mmp |
conversion.mmp |
STRING |
Mobile Measurement Partner
|
Event
Name |
Field |
Type |
Description |
event |
conversion.event |
STRING |
Raw postback event name from MMP
|
Timestamp
Name |
Field |
Type |
Description |
timestamp |
conversion.timestamp |
TIMESTAMP |
Postback received time from MMP
|
Attribution
Name |
Field |
Type |
Description |
timestamp |
conversion.attribution.timestamp |
TIMESTAMP |
Postback recorded time in MMP yyyy-mm-dd hh:mm:ss.ssssss
|
is_view_through |
conversion.attribution.is_view_through |
BOOLEAN |
|
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. |
FLOAT |
Revenue from the postback event
|
currency |
conversion. |
STRING |
Currency of revenue from the postback event
|
amount_usd |
conversion.revenue. |
FLOAT |
Revenue from the postback event in USD
|
Postback
Name |
Field |
Type |
Description |
postback |
conversion.postback |
STRING |
Raw postback string from MMP
|
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
|
Object: SKAdNetwork (Bid)
Ad account
Name |
Field |
Type |
Description |
id |
bid.adaccount.id |
STRING |
Moloco AdAccount ID
|
title |
bid.adaccount.title |
STRING |
Moloco Advertiser Title
|
App
Name |
Field |
Type |
Description |
id |
bid.app.id |
STRING |
Moloco App ID
|
title |
bid.app.title |
STRING |
Moloco App Title
|
Campaign
Name |
Field |
Type |
Description |
id |
bid.campaign.id |
STRING |
Moloco Campaign ID
|
title |
bid.campaign.title |
STRING |
Moloco Campaign Title
|
skan_id |
bid.campaign.skan_id |
INTEGER |
SKAdNetwork Campaign ID explicitly specified by Moloco Campaign.
|
Traffic
Name |
Field |
Type |
Description |
skan |
bid.traffic.skan |
BOOLEAN |
Indicates whether the bid response is SKAdNetwork-supported. Valid values are |
Object: SKAdNetwork (Conversion)
Timestamp
Name |
Field |
Type |
Description |
timestamp |
cv.timestamp |
TIMESTAMP |
Postback received from SKAdNetwork.
|
Client
Name |
Field |
Type |
Description |
ip |
cv.client.ip |
STRING |
IP address of whom sent the postback to Moloco.
|
ua |
cv.client.ua |
STRING |
User Agent of whom sent the postback to Moloco.
|
country |
cv.client.country |
STRING |
Country where the postback comes from in ISO-3166 1-alpha-3.
|
Postback
Name |
Field |
Type |
Description |
raw |
cv.postback.raw |
STRING |
Raw JSON string of SKAdNetwork postback.
|
version |
cv.postback.version |
STRING |
The version of the ad network validation API.
|
campaign-id |
cv.postback.campaign-id |
INTEGER |
The campaign ID ad network provided when displaying ads.
|
app-id |
cv.postback.app-id |
INTEGER |
The item identifier of the advertised product.
|
redownload |
cv.postback.redownload |
BOOLEAN |
A Boolean flag that indicates the customer redownloaded and reinstalled the app when the value is true.
|
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
|
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
|
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.
|