Site

Site JSON Fields

PropertyDescriptionTypeOptional on Creation?
publisher-idThe id of the publisher to which the site belongs. This can be set only when a site is created.IntegerNo
typeThe site type.

Possible values are:

  • web
  • mobile-in-app
  • tv-ott
  • tv-iptv
StringNo
nameThe site nameString(255)No
contact-nameName of the contactString(255)Yes
contact-emailEmail of the contactString(255)Yes
siteThe site URLString(255)Yes, only when the application is defined as application or the device is defined as mobile-in-app or OTT.
website-typeTells if site is TRANSPARENT or PACKAGED.

If "show-domain" is set to SHOW, website-type is set to TRANSPARENT; otherwise it is set to PACKAGED.
String

READ ONLY
show-domainThe show domain policy for bidders.

Possible values are:

  • SHOW (The domain of the page hosting the player is shown.)
  • FORCE (The domain configured for the site is shown.)
  • *HIDE (Nothing is sent to bidders)
StringYes, only when the application is defined as application or the device is defined as mobile-in-app or OTT.
categoryThe site content category code in the IAB taxonomy.

See OpenRTB API specification version 2.1 page 60.
StringNo
pricing-cpmThe site pricing model for CPM campaignsObjectYes

If not provided the publisher is configured with a 100% revenue sharing for ad network campaigns.
pricing-openrtbThe site pricing model for OpenRTB campaignsObjectYes

If not provided the publisher is configured with a 100% revenue sharing for ad network campaigns and values will be set to: 100-AdexCommission.
max-ad-durationThe maximum duration in seconds the site allows for an ad. Zero value indicates that no limitation is applied.IntegerYes

Default is null: no limitation is applied on ad durations.
floor-priceThe minimum sell-side CPM (in the private exchange currency) that the publisher allows for a campaignString with dot as decimal separator to avoid conversion issuesYes

Default is null: no limitation is applied on bid prices.
floor-price-buy-sideThe minimum buy-side CPM (in the private exchange currency) that the publisher allows for a campaign.

This field is not allowed if the AdNetwork module is disabled.
String with dot as decimal separator to avoid conversion issuesYes

Default is null: no limitation is applied on bid prices.
application-nameThe application nameString(80)No, if the application is defined as mobile-in-app.

Yes, if the application is defined tv-ott.
application-bundleThe application bundleString(200)No, if the application is defined as mobile-in-app.

Yes, if the application is defined tv-ott.
show-application-bundleThe show application bundle policy,

Possible values are:

  • SHOW
  • FORCE
  • HIDE
StringYes except if the application is defined as application or if the device is defined as mobile-in-app
application-versionThe application versionString(20)No, if the application is defined as mobile-in-app.

Yes, if the application is defined tv-ott.
application-store-urlThe application store url from which the application can be downloadedString(255)NNo, if the application is defined as mobile-in-app.

Yes, if the application is defined tv-ott.
application-paidDefines the application as paid (mobile-in-app only)BooleanNo
audience-genderDefine the gender options (male, female, both).StringYes

Default is both.
audience-agesDefines a list of age ranges.

Possible values are:

  • under-13
  • 13-18
  • 19-24
  • 25-49
  • 50-and-over
ArrayYes
externalrefString(50)Yes

Default is null.
ad-typeDefines the ad type for this site:
  • 0 for video
  • 1 for audio


Audio support module is required when creating audio inventory.
IntegerYes

Default is 0, video.

Pricing CPM

PropertyDescriptionTypeOptional on Creation?
modelThe site pricing model for CPM campaigns,.

Possible values are:

  • "CPM for minimum CPM
  • sharing for revenue sharing
  • CPM+sharing for revenue sharing with minimum

CPM

String
No
preroll-cpmThe site minimum CPM revenue for campaigns on preroll zonesString with dot as decimal separator to avoid conversion issuesNo, if the pricing-cpm.model is CPM or CPM+sharing
midroll-cpmThe site minimum CPM revenue for campaigns on midroll zonesString with dot as decimal separator to avoid conversion issuesNo, if the pricing-cpm.model is CPM or CPM+sharing
postroll-cpmThe site minimum CPM revenue for campaigns on postroll zonesString with dot as decimal separator to avoid conversion issuesNo, if the pricing-cpm.model is CPM or CPM+sharing
outstream-cpmThe site minimum CPM revenue for campaigns on outstream zonesString with dot as decimal separator to avoid conversion issuesNo, if the pricing-cpm.model is CPM or CPM+sharing
preroll-percentThe site percentage revenue of the campaigns CPM on preroll zonesIntegerNo, if the pricing-cpm.model is sharing or CPM+sharing
midroll-percentThe site percentage revenue of the campaigns CPM on midroll zonesIntegerNo, if the pricing-cpm.model is sharing or CPM+sharing
postroll-percentThe site percentage revenue of the campaigns CPM on postroll zonesIntegerNo, if the pricing-cpm.model is sharing or CPM+sharing
outstream-percentThe site percentage revenue of the campaigns CPM on outstream zonesIntegerNo, if the pricing-cpm.model is sharing or CPM+sharing

Pricing OpenRTB

PropertyDescriptionTypeAllowed for Model?
modelThe site pricing model for OpenRTB campaigns,

Possible values are:

  • impression for minimum CPM
  • sharing for revenue sharing
  • viewable-impression (only if viewabilty is enabled for the PX), vtr100, vtr75, vtr50 and vtr25

StringNo
preroll-cpmThe site minimum CPM revenue for campaigns on preroll zonesString with decimal point separator to avoid conversion issuescpm, viewable-impression, vtr100, vtr75, vtr50 and vtr25
midroll-cpmThe site minimum CPM revenue for campaigns on midroll zonesString with decimal point separator to avoid conversion issuescpm, viewable-impression, vtr100, vtr75, vtr50, and vtr25
postroll-cpmThe site minimum CPM revenue for campaigns on postroll zonesString with decimal point separator to avoid conversion issuescpm, viewable-impression, vtr100, vtr75, vtr50 and vtr25
outstream-cpmThe site minimum CPM revenue for campaigns on outstream zonesString with decimal point separator to avoid conversion issuescpm, viewable-impression, vtr100, vtr75, vtr50 and vtr25
preroll-percentThe site percentage revenue of the campaigns OpenRTB on preroll zonesIntegersharing
midroll-percentThe site percentage revenue of the campaigns OpenRTB on midroll zonesIntegersharing
postroll-percentThe site percentage revenue of the campaigns OpenRTB on postroll zonesIntegersharing
outstream-percentThe site percentage revenue of the campaigns OpenRTB on outstream zonesIntegersharing

📘

Note

it is not possible to set financial information for CPV campaigns. If you go o the form in the UI, you see CPV campaigns copied from their CPM counterpart.