IntegrationIntegration Preview

Placements

Define ad slots, manage allowed formats and sources, and use the kill switch.

Preview

Placement object fields are illustrative and may change according to the schema shared after account approval.

A placement is a concrete slot where an ad appears: an in-game reward screen, a native card in a news feed, or a post-match interstitial. Format, default policy, allowed demand sources and house ad behavior are all configured per placement.

GET/v1/placementsLists the placements in your account. Requires a secret key.Integration Preview

POST/v1/placementsCreates a new placement. Requires a secret key.Integration Preview

Placement fields

namestringrequired
Unique name used in SDK and API requests.
formatsstring[]required
Ad formats allowed in this slot.
default_policystringoptional
Policy applied when a decision request does not specify one.
allowed_sourcesstring[]optional
Programmatic demand sources allowed in addition to controlled inventory. An empty list means controlled inventory only.
house_ad_fallbackbooleanoptional
Whether to show a house ad when no eligible ad is found.
kill_switchbooleanoptional
When true, every decision for this placement returns blocked_by_policy.

curl https://api.reinoads.com/v1/placements \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "rewarded",
    "formats": ["rewarded_video", "reward_sponsorship"],
    "default_policy": "brand-safe",
    "allowed_sources": ["src_programmatic_restricted_a"],
    "house_ad_fallback": true
  }'

Format	Tier	Typical use
banner	Standard	Fixed slot at the top or bottom of the screen
native	Standard	Card that blends into a content feed
interstitial	Standard	Full screen between transitions
video	Standard	Pre-roll or mid-roll video
rewarded_video	Standard	Video watched in exchange for a reward
sponsored_placement	Premium	A persistent slot reserved for one sponsor
branded_challenge	Premium	Branded in-game mission or challenge
game_sponsorship	Premium	Sponsorship of an entire game mode or event
reward_sponsorship	Premium	A reward provided by a brand

Kill switch

A kill switch can be enabled per placement, advertiser or source and applies to new decisions immediately. Keep the SDK's pre-render check enabled so creatives that already reached the client but have not yet been shown are also suppressed.