EntegrasyonEntegrasyon Önizlemesi

Yerleşimler (Placements)

Reklam alanlarını tanımlama, format ve kaynak izinlerini yönetme, kill switch kullanımı.

Önizleme

Yerleşim nesnesinin alanları örnek amaçlıdır ve hesap onayı sonrası paylaşılan şemaya göre değişebilir.

Yerleşim, reklamın gösterileceği somut alandır: bir oyun içi ödül ekranı, bir haber akışındaki native kart veya maç sonu interstitial'ı. Format, varsayılan politika, izin verilen talep kaynakları ve house ad davranışı yerleşim düzeyinde belirlenir.

GET/v1/placementsHesabınızdaki yerleşimleri listeler. Secret key gerektirir.Entegrasyon Önizlemesi

POST/v1/placementsYeni bir yerleşim oluşturur. Secret key gerektirir.Entegrasyon Önizlemesi

Yerleşim alanları

namestringzorunlu
SDK ve API isteklerinde kullanılan benzersiz ad.
formatsstring[]zorunlu
Bu alanda izin verilen reklam formatları.
default_policystringopsiyonel
Karar isteğinde politika belirtilmezse uygulanacak politika.
allowed_sourcesstring[]opsiyonel
Kontrollü envanter dışında izin verilen programatik talep kaynakları. Boş liste yalnızca kontrollü envanter anlamına gelir.
house_ad_fallbackbooleanopsiyonel
Uygun reklam bulunamazsa house ad gösterilsin mi.
kill_switchbooleanopsiyonel
true olduğunda yerleşim için tüm kararlar blocked_by_policy döner.

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	Tür	Tipik kullanım
banner	Standart	Ekranın alt veya üst kısmında sabit alan
native	Standart	İçerik akışına uyumlu kart
interstitial	Standart	Ekran geçişlerinde tam ekran
video	Standart	Video içerik öncesi veya arası
rewarded_video	Standart	Ödül karşılığı izlenen video
sponsored_placement	Premium	Bir sponsora ayrılmış kalıcı alan
branded_challenge	Premium	Markalı oyun içi görev veya meydan okuma
game_sponsorship	Premium	Bir oyun modu veya etkinliğin tamamının sponsorluğu
reward_sponsorship	Premium	Ödülün bir marka tarafından sağlanması

Kill switch

Kill switch yerleşim, reklamveren veya kaynak düzeyinde açılabilir ve yeni kararlara anında uygulanır. Daha önce istemciye ulaşmış ancak henüz gösterilmemiş kreatifler için SDK'nın gösterim öncesi kontrolünü açık tutmanızı öneririz.