EntegrasyonEntegrasyon Önizlemesi

Reklam Kararı (Ad Decision)

Decision Engine'e karar isteği gönderme, istek parametreleri ve sonuç türleri.

Önizleme

Endpoint yolu, alan adları ve sonuç değerleri örnek amaçlıdır; kesin şema hesabınıza özel dokümanda yer alır.

Her reklam gösterimi bir karar isteğiyle başlar. Decision Engine isteği politika, ticari, brand safety ve kaynak uygunluğu kontrollerinden sırayla geçirir. Herhangi bir adımda kesin sonuç üretilemezse sistem fail-closed davranır ve reklam sunmaz.

const decision = await reinoAds.requestAd({
  placement: "rewarded",
  audience: "premium-fans",
  policy: "brand-safe"
});

POST/v1/decisionsBir yerleşim için reklam kararı oluşturur. Secret key (sunucu) veya publishable key (SDK) ile çağrılabilir.Entegrasyon Önizlemesi

İstek gövdesi

placementstringzorunlu
Yerleşim kimliği veya adı, örn. rewarded.
policystringopsiyonel
Uygulanacak politika adı. Verilmezse yerleşimin varsayılan politikası kullanılır.
audienceobject | stringopsiyonel
Kitle sinyalleri. Segment listesi içeren nesne veya panelde tanımlı bir kitle adı, örn. premium-fans.
consentobjectzorunlu
KVKK ve kişiselleştirme rıza bayrakları. Bkz. Kitle Sinyalleri.
contextobjectopsiyonel
Ekran, oyun modu, içerik kategorisi gibi bağlamsal bilgiler.
formatsstring[]opsiyonel
Kabul edilen formatlar: banner, native, interstitial, video, rewarded_video, sponsored_placement, branded_challenge, game_sponsorship, reward_sponsorship.
testbooleanopsiyonel
true ise test kreatifi döner ve gösterim faturalanmaz.

curl https://api.reinoads.com/v1/decisions \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "placement": "match_end_banner",
    "policy": "brand-safe",
    "formats": ["banner", "native"],
    "audience": { "segments": ["club_affinity:gs", "age_25_34"] },
    "consent": { "kvkk": true, "personalized_ads": true },
    "context": { "screen": "match_end", "content_category": "sports" }
  }'

outcome	Anlamı	Önerilen davranış
served	Tüm kontrollerden geçen bir reklam seçildi.	Kreatifi gösterin, gösterim ve tıklama olaylarını bildirin.
house_ad	Uygun reklam yok; yerleşim için tanımlı house ad döndü.	House ad'i gösterin; gelir üretmez.
no_fill	Kurallara uyan reklam veya house ad bulunamadı.	Reklam alanını gizleyin veya daraltın.
blocked_by_policy	İstek bir politika, ticari kural veya kill switch nedeniyle engellendi.	Alanı gizleyin; reason alanını loglayın.

Kontrol sırası

reason.stage alanı engelin hangi adımda oluştuğunu gösterir: policy_check, commercial_check, brand_safety veya source_eligibility. Kill switch kaynaklı engellerde code değeri kill_switch_active olur.