Policy & controlIntegration Preview

House Ads

Manage your own promotional content to show when no eligible ad is available.

Preview

House ad object fields and endpoint paths are illustrative.

House ads promote the publisher's own products, events or subscription offers. When no ad satisfies the rules for a request and house_ad_fallback is enabled on the placement, the Decision Engine returns the house_ad outcome.

POST/v1/house-adsCreates a house ad and attaches it to one or more placements.Integration Preview

Request body

namestringrequired
Name shown in the dashboard and reports.
formatstringrequired
banner, native, interstitial or video.
placementsstring[]required
Placements where the house ad may be used.
creativeobjectrequired
media_url, click_url and optional title/body fields.
priorityintegeroptional
Selection priority when several house ads are eligible; higher wins.
scheduleobjectoptional
Flight window defined by starts_at and ends_at.

curl https://api.reinoads.com/v1/house-ads \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Season pass promo",
    "format": "interstitial",
    "placements": ["match_end_interstitial"],
    "creative": {
      "media_url": "https://cdn.example.com/house/season-pass.png",
      "click_url": "myapp://store/season-pass"
    },
    "priority": 10,
    "schedule": {
      "starts_at": "2026-10-01T00:00:00Z",
      "ends_at": "2026-12-31T23:59:59Z"
    }
  }'

House ads and brand safety

House ads are your own content, so they don't require advertiser approval. However, if the placement's kill switch is on, house ads are suppressed as well.