Politika & KontrolEntegrasyon Önizlemesi

House Ads

Uygun reklam bulunmadığında gösterilecek kendi tanıtım içeriklerinizi yönetin.

Önizleme

House ad nesnesinin alanları ve endpoint yolları örnek amaçlıdır.

House ad'ler, yayıncının kendi ürünlerini, etkinliklerini veya abonelik tekliflerini tanıttığı içeriklerdir. Bir karar isteği için kurallara uyan reklam bulunamadığında ve yerleşimde house_ad_fallback açıksa Decision Engine house_ad sonucunu döndürür.

POST/v1/house-adsYeni bir house ad oluşturur ve bir veya daha fazla yerleşime bağlar.Entegrasyon Önizlemesi

İstek gövdesi

namestringzorunlu
Panelde ve raporlarda görünen ad.
formatstringzorunlu
banner, native, interstitial veya video.
placementsstring[]zorunlu
House ad'in kullanılabileceği yerleşimler.
creativeobjectzorunlu
media_url, click_url ve isteğe bağlı başlık/metin alanları.
priorityintegeropsiyonel
Birden fazla house ad uygunsa seçim önceliği; yüksek değer önce gelir.
scheduleobjectopsiyonel
starts_at ve ends_at ile yayın aralığı.

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 ad ve brand safety

House ad'ler sizin içeriğiniz olduğu için reklamveren onayı gerektirmez, ancak yerleşimin kill switch'i açıksa house ad de gösterilmez.