Geniee Exchange
Features
| Bidder Code | ex_geniee | Prebid.org Member | no |
|---|---|---|---|
| Prebid.js Adapter | yes | Prebid Server Adapter | no |
| Media Types | display, video | Multi Format Support | will-bid-on-any |
| TCF-EU Support | no | IAB GVL ID | none |
| GPP Support | none | DSA Support | no |
| USP/CCPA Support | no | COPPA Support | no |
| Supply Chain Support | yes | Demand Chain Support | no |
| Safeframes OK | no | Supports Deals | no |
| Floors Module Support | yes | First Party Data Support | yes |
| Endpoint Compression | check with bidder | ORTB Blocking Support | partial |
| User IDs | all | Privacy Sandbox | check with bidder |
Note
This is the Geniee Exchange Bidder Adapter for Prebid.js.
Geniee maintains three separate bid adapters. This adapter (ex_geniee) is independent of “Geniee SSP” (ssp_geniee, zoneId based) and “Geniee” (dsp_geniee, Geniee DSP) and can be used alongside them.
Please contact us at aladdin-back@geniee.co.jp before using the adapter. partnerId values are publisher-specific and are issued by Geniee; a generic value will not return bids.
Ads are served when all of the following conditions are satisfied:
- The ad unit declares
mediaTypes.bannerwith valid sizes, ormediaTypes.videowithmimesset onmediaTypes.videoorortb2Imp.video(see Video). Native-only ad units are rejected. Native and audio parts of a multiformat ad unit are dropped. A multiformat ad unit (banner + video) is sent as one impression carrying both. - Payment is possible in Japanese yen or US dollars.
- The request contains either
site(withsite.page) orapp(withapp.bundle). - GDPR does not apply to the request. The Exchange does not serve GDPR territories, so no request is sent when
gdprAppliesis true. The adapter does not add consent signals itself; values written toortb2by the TCF consent module (regs.ext.gdpr,user.ext.consent) are passed through with the rest of the first party data.
Bid Params
| Name | Scope | Description | Example | Type |
|---|---|---|---|---|
partnerId |
required | The per-publisher ID issued by Geniee. Must be an integer >= 1 (number only; string forms such as '123' are rejected). |
123 |
integer |
currency |
optional | Currency setting, 'JPY' or 'USD'. When omitted, the currency module’s adServerCurrency is used, then 'USD'. If the resolved currency is neither JPY nor USD, no request is sent. |
'JPY' |
string |
placementId |
optional | Reporting label for the ad unit, defined by the publisher (not issued by Geniee). Use a fixed value per ad unit; if omitted, Geniee reports cannot be broken down by ad unit. Alphanumeric, hyphen and underscore, max 40 characters, case-insensitive. Sent as imp.tagid. If the value violates these rules, the request is still bid on, but reports cannot be broken down correctly by that placementId. |
'top-banner_1' |
string |
Video
mediaTypes.video field |
Scope | Notes |
|---|---|---|
mimes |
required | Non-empty array of MIME types. Can also be set on ortb2Imp.video.mimes. |
playerSize |
recommended | Sent as imp.video.w/imp.video.h. |
plcmt |
recommended | Passed to demand partners as is; the Exchange does not fill it in. |
minduration, maxduration, protocols |
recommended | Some demand partners require them. |
- If the video part has no valid
mimes(MIME type strings onmediaTypes.videoorortb2Imp.video), or size mapping disables video for the current viewport or for this bidder, a multiformat ad unit is sent as banner only and a video-only ad unit is rejected. - Geniee does not provide an outstream renderer. You will need to set up your own. See Show Outstream Video Ads for more information.
- A video bid takes
w/hfrom the response when both are present, otherwise both fromplayerSize; withoutplayerSize, a missingworhis 0. - Floors: with the Price Floors module,
imp.bidflooris the lowest floor among the media types sent (banner / video); if any of them has no floor, theortb2Imp.bidfloorset on the ad unit is sent, or no floor when none is set.
Video Caching
Note that the Geniee Exchange adapter expects a client-side Prebid Cache to be enabled for video bidding.
pbjs.setConfig({
cache: {
url: 'https://prebid.example.com/pbc/v1/cache'
}
});
First Party Data
ortb2 and ortb2Imp first party data are included in the OpenRTB request. Note the following:
imp.tagidset throughortb2Impis overridden whenparams.placementIdis set.ortb2Imp.videois sent only when the ad unit declaresmediaTypes.videoandmimesis set onmediaTypes.videoorortb2Imp.video; otherwise it is dropped.ortb2Imp.banneris sent only when the ad unit declaresmediaTypes.bannerand size mapping leaves it enabled; otherwise it is dropped.ortb2Imp.nativeandortb2Imp.audioare never sent.- User IDs are read from
user.ext.eidsand mirrored touser.eids. - The Exchange runs a first price auction only. If
atis set to any value other than1throughortb2, no request is sent.
OpenRTB Blocking
Support for OpenRTB blocking parameters is partial. All four parameters below are forwarded to demand partners, but only badv and bapp are enforced by the Exchange when it filters bid responses. bcat and battr are passed on to demand partners only; the Exchange does not reject a bid that violates them, so blocking depends on each demand partner honoring the value. Set them through first party data; the adapter passes them to the Exchange unchanged.
| Parameter | Where to set | Forwarded to demand partners | Enforced on bid responses by the Exchange |
|---|---|---|---|
badv |
ortb2.badv |
yes | yes |
bapp |
ortb2.bapp |
yes | yes |
bcat |
ortb2.bcat |
yes | no |
battr |
ortb2Imp.banner.battr, ortb2Imp.video.battr |
yes | no |
Notes:
badv: every listed domain is checked against the winning bid’s advertiser domains. A bid whose advertiser domain contains a listed value is dropped, soexample.comalso blocks subdomains such asads.example.com. An empty array is forwarded as an explicit “nothing blocked” declaration.bapp: matched case-insensitively against the bid’s app bundle.bcat: only IAB content taxonomy codes with theIABprefix (for exampleIAB1,IAB26-1) are forwarded; codes in any other format are dropped.battr:banner.battrandvideo.battrare each sent with their media type.
User Sync
On a winning response the Exchange returns a single cookie-sync URL, which the adapter registers as an iframe sync. Only the iframe type is supported; no sync is registered on a no-bid.
Prebid disables iframe syncs by default, so publishers must allow them for this bidder:
pbjs.setConfig({
userSync: {
filterSettings: {
iframe: {
bidders: ['ex_geniee'],
filter: 'include'
}
}
}
});
"Send All Bids" Ad Server Keys
These are the bidder-specific keys that would be targeted within GAM in a Send-All-Bids scenario. GAM truncates keys to 20 characters.hb_pb_ex_geniee |
hb_bidder_ex_geniee |
hb_adid_ex_geniee |
hb_size_ex_geniee |
hb_source_ex_geniee |
hb_format_ex_geniee |
hb_cache_host_ex_gen |
hb_cache_id_ex_genie |
hb_uuid_ex_geniee |
hb_cache_path_ex_gen |
hb_deal_ex_geniee |