BaşlarkenEntegrasyon Önizlemesi

Hızlı Başlangıç

Sandbox ortamında ilk reklam kararınızı birkaç adımda alın ve sonucu yorumlayın.

Önizleme

Aşağıdaki adımlar entegrasyon akışını göstermek içindir. Gerçek endpoint'ler, anahtar formatları ve paket adları hesap onayı sonrası paylaşılan dokümanda yer alır.

1. Sandbox anahtarlarınızı alın

Hesabınız onaylandığında panelde iki ortam için ayrı anahtarlar oluşturulur: sandbox ve live. İlk denemelerinizi her zaman sandbox ortamında yapın; sandbox kararları gerçek gösterim veya gelir üretmez.

2. İlk yerleşiminizi tanımlayın

Panelden veya API üzerinden bir yerleşim oluşturun. Örneğin maç sonu ekranında gösterilecek ödüllü video için rewarded adlı bir yerleşim ve brand-safe adlı bir politika tanımlayın.

3. Karar isteği gönderin

curl https://api.reinoads.com/v1/decisions \
  -H "Authorization: Bearer sk_sandbox_..." \
  -H "Content-Type: application/json" \
  -d '{
    "placement": "rewarded",
    "policy": "brand-safe",
    "audience": { "segments": ["premium", "engaged_30d"] },
    "consent": { "kvkk": true, "personalized_ads": true }
  }'

4. Sonucu yorumlayın

{
  "id": "dec_01HZX4K2Q8",
  "outcome": "served",
  "placement": "rewarded",
  "format": "rewarded_video",
  "source": { "type": "controlled", "id": "src_direct_sponsor" },
  "creative": {
    "id": "cr_8812",
    "media_url": "https://cdn.example.com/creatives/cr_8812.mp4",
    "click_url": "https://example.com/landing"
  },
  "reward": { "type": "coins", "amount": 50 },
  "tracking": {
    "impression": "https://api.reinoads.com/v1/events/imp/dec_01HZX4K2Q8",
    "click": "https://api.reinoads.com/v1/events/clk/dec_01HZX4K2Q8"
  },
  "environment": "sandbox"
}

Sonraki adım

outcome alanı served dışında bir değer döndürürse reklam alanını boş bırakın veya house ad gösterin. Tüm sonuç türleri Reklam Kararı bölümünde açıklanmıştır.