InMobi DSP

InMobi runs InMobi Exchange, a mobile in-app exchange. This profile covers the requests InMobi Exchange sends to DSPs and the responses DSPs return. Supply sent into InMobi is the separate inmobi-supplier profile.

Direction and version

InMobi Exchange sends bid requests to DSP bidders, and DSPs return bid responses to InMobi.

OpenRTB 2.5 JSON. Most flags are 0 or 1 integers, but imp.ext.hb is a JSON boolean. Native requests are objects with context 1501, and Native responses go in bid.admobject as an object.

The RTBlint profile inmobi checks requests and responses against the published contract.

Rules beyond the OpenRTB spec

Each impression advertises one format; InMobi sends each format opportunity in its own request.
at is 1 or 2, and bapp lists at most 30 blocked app bundles.
Responses need seatbid.seat, burl, and cat. Non-native bids need adm, and banner bids need w and h.
Creative IDs longer than 64 characters are truncated.
History lists such as device.ext.iap and device.ext.lastimpressioncpm hold at most five entries, newest first. Purchase and advertiser histories are left out when empty.
Battery and volume levels are integers from 0 to 100. The Play Store version is left out when device.ext.psdisable is 1.
A supply chain in source.ext.schain needs at least one node, and seller IDs are at most 64 characters.
Video opportunities use linearity 1. A response video experience in bid.ext.video.experience (1, 2, or 3) must be one the request offered in imp.video.ext.experiences.
A SKAdNetwork response must name a network listed in the request's skadnetids.
${AUCTION_LOSS} is substituted only in lurl. In lurl, ${AUCTION_MIN_TO_WIN} carries the clearing price.

Documented extensions

Path	Meaning
`ext.auction_id`	Mediation auction ID that groups the same impression across exchanges.
`ext.mediation_name`	Name of the mediation platform.
`source.ext.header_bidding`	0 for waterfall, 1 for header bidding.
`source.ext.schain`	Supply chain in its OpenRTB 2.5 location.
`imp.ext.hb`	Header bidding flag, sent as a JSON boolean.
`imp.ext.skadn`	SKAdNetwork request data.
`imp.ext.gpid`	Stable ad unit ID.
`imp.video.ext.experiences`	Video experience IDs the placement accepts.
`device.ext.atts`	App Tracking Transparency status.
`device.ext.ifv`	iOS identifier for vendors.
`device.ext.iap`	Up to five recent in-app purchases.
`device.ext.lastimpressioncpm`	Up to five recent impression CPMs.
`bid.ext.campaigntype`	Campaign type: user acquisition, retargeting, brand, or commerce.
`bid.ext.skadn`	SKAdNetwork response, including SKOverlay settings.

What the validator checks for this profile

openrtb.profile.inmobi.bapp_limit InMobi sends at most 30 blocked app bundles.
openrtb.profile.inmobi.category_required InMobi requires the creative's IAB categories.
openrtb.profile.inmobi.creative_id_truncated InMobi truncates creative IDs longer than 64 characters.
openrtb.profile.inmobi.history_count InMobi histories contain at most five entries; purchase and advertiser histories are omitted when empty.
openrtb.profile.inmobi.history_order InMobi documents recent history first; its advertiser example conflicts with this ordering.
openrtb.profile.inmobi.percentage_range InMobi percentage telemetry must be an integer from 0 to 100.
openrtb.profile.inmobi.play_store_state InMobi omits Play Store version when psdisable is 1.
openrtb.profile.inmobi.quality_declaration InMobi Getting Started requires this quality declaration; the current response table labels it recommended. Confirm the active integration contract.
openrtb.profile.inmobi.schain_nodes InMobi's declared supply chain requires at least one node.
openrtb.profile.inmobi.sdk_expected The outgoing guide says this field is passed by the InMobi SDK; verify SDK version and producer configuration.
openrtb.profile.inmobi.single_format InMobi sends each format opportunity to DSPs in a separate request.
openrtb.profile.inmobi.skadnetwork_unoffered The response SKAdNetwork must match a requested skadnetids entry.
openrtb.profile.inmobi.video_experience InMobi video experience IDs are 1, 2 and 3.
openrtb.profile.inmobi.video_experience_unoffered InMobi portrait and vertical experiences must be explicitly offered in the request.
openrtb.profile.inmobi.video_linearity InMobi outgoing video opportunities use linearity 1.

Validate against this contract

Open the tester with the InMobi DSP profile, or run:

rtblint validate --profile inmobi request.json