İlan portallarında ve yüksek trafikli içerik sitelerinde reklam gelirinin önemli bir kısmı banner envanterinden gelir. Bu envanteri satmanın eski yolu "waterfall" denen sıralı yapıydı: ad server önce bir alıcıya sorar, o almazsa bir sonrakine geçer. Header bidding ise bu sırayı bozar; sayfa yüklenirken birden fazla talep kaynağına aynı anda teklif isteği gönderilir, gelen teklifler ad server'a hedefleme anahtarı olarak taşınır ve ad server kendi kampanyalarıyla bu teklifleri tek bir karar anında karşılaştırır.
Ben Koray Yalçın; lead yönetimi, CRM ve dijital pazarlama altyapıları kuruyorum, ağırlıklı olarak gayrimenkul projeleri ve ilan tarafında, reklamdan satış ofisine uzanan veri hattında çalışıyorum. Programatik reklam konuşulurken genellikle satın alma tarafı (DSP, hedefleme, retargeting) öne çıkar. Bu yazıda öbür tarafa, yayıncının sayfasına bakacağım: header bidding'i bir geliştirici olarak nasıl kurarım, nerede bozulur, sayfa performansını nasıl korurum ve "daha fazla gelir getiriyor mu" sorusunu nasıl ölçülebilir hale getiririm.
Örnekleri yaygın açık kaynak kütüphane olan Prebid.js ve Google Publisher Tag (GPT) üzerinden vereceğim. Kod parçaları öğretici amaçlıdır; bidder adları ve parametreler yer tutucudur. Kendi kurulumunuzda her bidder'ın kendi dokümantasyonundaki zorunlu parametreleri kullanmanız gerekir.
1. Mimarinin kısa özeti: kim neye karar verir?
Header bidding'i anlamanın en kolay yolu, kararı kimin verdiğini netleştirmektir:
- Tarayıcıdaki wrapper (Prebid.js): Reklam alanlarını tanımlar, bidder'lara paralel istek gönderir, belirli bir süre bekler ve gelen teklifleri toplar.
- Bidder adapter'ları: Her SSP veya ad exchange için isteği ve cevabı o sistemin formatına çeviren modüller.
- Ad server (ör. Google Ad Manager): Prebid'in sayfaya bıraktığı hedefleme anahtarlarını (
hb_pb,hb_bidder,hb_adidgibi) okur, bunları önceden kurulmuş line item'larla eşleştirir ve doğrudan satılmış kampanyalarla birlikte son kararı verir. - Render: Kazanan Prebid teklifiyse, ad server'ın döndürdüğü kreatif Prebid'e "şu reklam kimliğini göster" der ve asıl reklam render edilir.
Buradan çıkan ilk ders şudur: header bidding ad server'ın yerini almaz. Wrapper bir açık artırma yapar, ama nihai öncelik kuralları hâlâ ad server'dadır. Line item yapısı yanlışsa, tarayıcıda ne kadar iyi teklif toplarsanız toplayın, o teklif hiç kazanamaz.
2. Temel kurulum: GPT'yi bekletmek ve Prebid'i çalıştırmak
En sık yapılan hata, GPT'nin reklamı Prebid'in teklifleri gelmeden istemesidir. Bunu önlemek için GPT'nin ilk yüklemesi kapatılır ve istek, açık artırma bitince elle tetiklenir:
var PREBID_TIMEOUT = 1000; // bidder'lara tanınan süre (ms) var FAILSAFE_TIMEOUT = 2500; // her koşulda reklam isteğinin gideceği üst sınır var googletag = window.googletag || { cmd: [] }; var pbjs = window.pbjs || { que: [] }; googletag.cmd.push(function () { googletag.pubads().disableInitialLoad(); }); var adUnits = [{ code: 'ilan-detay-sag-300x250', mediaTypes: { banner: { sizes: [[300, 250], [300, 600]] } }, bids: [ { bidder: 'ornekBidderA', params: { placementId: 'YER_TUTUCU' } }, { bidder: 'ornekBidderB', params: { siteId: 'YER_TUTUCU' } } ] }]; pbjs.que.push(function () { pbjs.addAdUnits(adUnits); pbjs.requestBids({ timeout: PREBID_TIMEOUT, bidsBackHandler: sendAdServerRequest }); }); function sendAdServerRequest() { if (pbjs.adserverRequestSent) return; pbjs.adserverRequestSent = true; googletag.cmd.push(function () { pbjs.que.push(function () { pbjs.setTargetingForGPTAsync(); googletag.pubads().refresh(); }); }); } // Prebid hiç yüklenemezse bile reklam isteği gitsin setTimeout(sendAdServerRequest, FAILSAFE_TIMEOUT); Buradaki iki zaman sınırı farklı işler görür. PREBID_TIMEOUT bidder'lara tanınan süredir. FAILSAFE_TIMEOUT ise sistemin sigortasıdır: Prebid dosyası CDN'den gelmezse, bir adapter hata verirse ya da kod bir yerde takılırsa, sayfa reklamsız kalmasın diye GPT isteği her durumda gönderilir. adserverRequestSent bayrağı da iki yolun aynı anda çalışıp iki kez refresh yapmasını engeller. Bu bayrak olmadan, yavaş bağlantılarda aynı alan için iki ayrı gösterim isteği gidebilir ve raporlar bozulur.
3. Zaman aşımı: gelirle sayfa hızı arasındaki pazarlık
Header bidding'in en çok tartışılan parametresi timeout'tur. Uzun tutarsanız daha fazla bidder cevap verir ama reklam alanı geç dolar, kullanıcı alanı boş görür ve sayfa deneyimi kötüleşir. Kısa tutarsanız sayfa hızlı kalır ama bazı teklifler açık artırmaya yetişemez.
Benim yaklaşımım bu değeri tahminle değil, veriyle seçmektir. Bunun için Prebid'in olaylarını dinleyip her bidder için cevap süresini ve zaman aşımı oranını kaydediyorum:
pbjs.que.push(function () { pbjs.onEvent('bidResponse', function (bid) { logEvent({ type: 'bid_response', bidder: bid.bidderCode, adUnit: bid.adUnitCode, cpm: bid.cpm, timeToRespond: bid.timeToRespond, size: bid.size }); }); pbjs.onEvent('bidTimeout', function (timedOutBids) { timedOutBids.forEach(function (b) { logEvent({ type: 'bid_timeout', bidder: b.bidder, adUnit: b.adUnitCode }); }); }); pbjs.onEvent('bidWon', function (bid) { logEvent({ type: 'bid_won', bidder: bid.bidderCode, adUnit: bid.adUnitCode, cpm: bid.cpm }); }); }); function logEvent(payload) { payload.pageType = document.body.dataset.pageType || 'unknown'; payload.ts = Date.now(); navigator.sendBeacon('/collect/adtech', JSON.stringify(payload)); } Bu kayıtlar birkaç hafta biriktiğinde şu soruların cevabı veriyle verilebilir: Hangi bidder sürekli zaman aşımına uğruyor? Mobilde ve masaüstünde cevap süreleri ne kadar farklı? Belirli bir bidder hiç kazanmıyorsa, sadece gecikme mi ekliyor? Bazen en doğru optimizasyon timeout'u artırmak değil, hiç kazanmayan ve sürekli geç kalan bir bidder'ı listeden çıkarmaktır. Her ek bidder, ek ağ isteği, ek JavaScript ve ek gizlilik yükü demektir.
sendBeacon kullanmamın nedeni, kullanıcı sayfadan çıkarken bile kaydın kaybolmamasıdır. Sunucu tarafında bu olayları ham olarak saklayıp sonra özetlemek, doğrudan özet tablosuna yazmaktan daha güvenlidir; kural değiştiğinde geçmişi yeniden hesaplayabilirsiniz.
4. Fiyat granülerliği ve line item yapısı
Prebid, kazanan teklifin fiyatını ad server'a ham olarak değil, bir fiyat kovasına yuvarlanmış halde hb_pb anahtarıyla taşır. Ad server tarafında her kova için bir line item bulunur. Bu yüzden priceGranularity ayarı ile ad server'daki line item kurulumu birebir aynı olmalıdır:
pbjs.que.push(function () { pbjs.setConfig({ priceGranularity: { buckets: [ { precision: 2, max: 5, increment: 0.05 }, { precision: 2, max: 20, increment: 0.5 } ] }, enableSendAllBids: false }); }); Kova tanımı tarayıcıda değişip ad server'da değişmezse, örneğin yeni bir fiyat kovası için line item yoksa, o teklif ad server'da eşleşmez ve sessizce kaybolur. Bu, header bidding'in en sinsi hatalarından biridir çünkü hiçbir yerde hata mesajı görmezsiniz; sadece kazanma oranı düşer.
Bu yüzden fiyat kovası tanımını kodda tek bir yapılandırma dosyasında tutuyor, ad server'daki line item'ları da aynı tanımdan üretiyorum. "Tek kaynak" ilkesi CRM alan eşlemesinde ne kadar önemliyse burada da o kadar önemlidir: iki ayrı yerde elle tutulan iki liste er geç birbirinden ayrışır.
5. Sayfa performansı: lazy loading, yerleşim kayması ve tek çağrı
Header bidding'in kötü bir ünü vardır: sayfayı yavaşlattığı söylenir. Bunun önemli kısmı kurulum tercihlerinden gelir. Benim kontrol ettiğim noktalar şunlar:
Ekrana girmeyen alan için açık artırma yapmamak. Sayfanın altındaki bir alan için ilk yüklemede teklif istemek, hem gereksiz ağ trafiği hem de görünürlüğü düşük gösterim demektir. Bu alanlar için IntersectionObserver ile alan ekrana yaklaştığında ayrı bir requestBids çağrısı yapıyorum:
var observer = new IntersectionObserver(function (entries) { entries.forEach(function (entry) { if (!entry.isIntersecting) return; observer.unobserve(entry.target); var code = entry.target.id; pbjs.que.push(function () { pbjs.requestBids({ adUnitCodes: [code], timeout: PREBID_TIMEOUT, bidsBackHandler: function () { pbjs.setTargetingForGPTAsync([code]); googletag.cmd.push(function () { var slot = googletag.pubads().getSlots() .find(function (s) { return s.getSlotElementId() === code; }); if (slot) googletag.pubads().refresh([slot]); }); } }); }); }); }, { rootMargin: '200px 0px' }); document.querySelectorAll('[data-lazy-ad]').forEach(function (el) { observer.observe(el); }); Yerleşim kaymasını önlemek. Reklam alanına önceden sabit bir yükseklik vermezseniz, reklam geldiğinde içerik aşağı kayar. İlan detay sayfasında kullanıcı tam "Ara" butonuna basacakken buton yer değiştirirse, bu hem kötü deneyimdir hem de yanlış tıklama demektir. Alanın beklenen en yaygın boyutuna göre min-height vermek basit ama etkili bir önlemdir.
Modül sayısını küçük tutmak. Prebid.js, sadece kullandığınız adapter ve modüllerle derlenebilir. Her şeyi içeren hazır bir paketi yüklemek, gereksiz kilobaytlar demektir. Derlemeyi kendi CI hattınızda yapıp sürümü sabitlemek, hem boyutu küçültür hem de "dün çalışıyordu, bugün neden bozuldu" sorusunun cevabını kolaylaştırır.
6. Kullanıcı izni: teklif isteğinden önce gelen kapı
Avrupa'daki ve KVKK kapsamındaki kullanıcılar için teklif isteği, izin durumu bilinmeden gönderilmemelidir. Prebid'in izin yönetimi modülü, sayfadaki izin yönetim platformundan (CMP) izin dizgesini okuyup bidder isteklerine ekler:
pbjs.que.push(function () { pbjs.setConfig({ consentManagement: { gdpr: { cmpApi: 'iab', timeout: 8000, defaultGdprScope: true } } }); }); Geliştirici olarak dikkat ettiğim iki şey var. Birincisi, izin yönetim platformu yüklenmeden açık artırmanın başlamaması; aksi halde izin bilgisi boş gider. İkincisi, kullanıcının reddettiği durumda sistemin ne yaptığının test edilmiş olması. Ret durumunda bazı bidder'lar hiç teklif vermez, bazıları kişiselleştirilmemiş teklif verir; bu davranışı canlıya çıkmadan önce bilmek gerekir. Bu yazı hukuki görüş değildir; izin metinleri ve kapsam için hukuk danışmanınızla çalışmanız gerekir.
Daha önce çerez izni üzerine yazdığım yazıda anlattığım "izin durumu modeli" burada da geçerlidir: izin bir kez okunan bir değişken değil, sayfa boyunca değişebilen bir durumdur. Kullanıcı izin ayarını sayfa içinde değiştirirse, sonraki açık artırmaların bu yeni durumu kullanması gerekir.
7. Ölçüm: "header bidding gelir artırdı mı?" sorusunu dürüst cevaplamak
Header bidding'e geçen ekiplerin çoğu, geçişten önceki ve sonraki ayın gelirini karşılaştırır. Bu karşılaştırma yanıltıcıdır: mevsimsellik, trafik kaynağı değişimi, reklamveren bütçe dönemleri ve sayfa tasarımı değişiklikleri aynı dönemde sonucu etkiler.
Daha sağlam yol, trafiğin küçük bir kısmını kontrol grubu olarak ayırmaktır. Kullanıcıyı (ya da sayfa görüntülemesini) deterministik bir şekilde iki gruba bölüyor, bir grupta header bidding'i kapatıp aynı dönemde iki grubu karşılaştırıyorum:
function hashToBucket(str) { var h = 0; for (var i = 0; i < str.length; i++) { h = (h * 31 + str.charCodeAt(i)) >>> 0; } return h % 100; } var visitorId = getOrCreateVisitorId(); // birinci taraf, izinli tanımlayıcı var inControl = hashToBucket(visitorId) < 5; // trafiğin %5'i kontrol if (inControl) { sendAdServerRequest(); // Prebid'siz, doğrudan GPT } else { runPrebidAuction(); } googletag.cmd.push(function () { googletag.pubads().setTargeting('hb_test', inControl ? 'control' : 'prebid'); }); hb_test anahtarı ad server raporlarında iki grubu ayırmanızı sağlar. Böylece aynı tarih aralığında, aynı sayfa tiplerinde, gösterim başına geliri ve sayfa performansını yan yana görürsünüz. Karşılaştırmada sadece geliri değil, sayfa yükleme metriklerini ve kullanıcı davranışını da izlemek gerekir. İlan portalında asıl iş, kullanıcının ilanı incelemesi ve iletişime geçmesidir. Reklam geliri artarken ilan başına iletişim talebi düşüyorsa, bu bir kazanç değildir.
Bu noktada yayıncı tarafının ölçümüyle CRM tarafının ölçümü birleşir. Ben ilan detay sayfasında oluşan iletişim taleplerini (form, arama, WhatsApp tıklaması) CRM'e kaynak bilgisiyle taşıdığım için, reklam deneyindeki iki grubun lead üretimini de karşılaştırabiliyorum. Reklam geliri ile lead kalitesi arasındaki dengeyi görmenin başka sağlıklı bir yolu yok.
8. Sunucu tarafı açık artırma ne zaman mantıklı?
Bidder sayısı arttıkça tarayıcıdan giden istek sayısı da artar. Prebid Server gibi bir sunucu tarafı çözümde tarayıcı tek bir isteği sunucuya gönderir, sunucu bidder'larla konuşur. Bu, özellikle mobil cihazlarda ağ yükünü azaltabilir.
Bedeli de vardır: bazı bidder'lar tarayıcıdaki kullanıcı eşleştirmesine (cookie sync) bağlı olduğu için sunucu tarafında daha az eşleşme olabilir, sunucuyu siz işletiyorsanız altyapı, izleme ve gecikme bütçesi sizin sorumluluğunuzdadır. Benim tercihim karma yapıdır: tarayıcıda iyi performans gösteren az sayıda bidder kalır, geri kalanlar sunucu tarafına taşınır. Bu karar da bir defalık değil; yukarıdaki olay kayıtlarıyla düzenli aralıklarla gözden geçirilir.
9. Canlıya çıkmadan önce kontrol listesi
- GPT'nin ilk yüklemesi kapalı mı, failsafe zamanlayıcı ve çift istek bayrağı var mı?
- Fiyat kovaları ile ad server line item'ları aynı tanımdan mı üretiliyor?
- Her bidder için cevap süresi, zaman aşımı ve kazanma olayları kaydediliyor mu?
- Ekran dışı alanlar lazy loading ile ayrı açık artırmaya mı giriyor?
- Reklam alanlarına sabit yükseklik verilmiş mi?
- İzin yönetim platformu açık artırmadan önce hazır mı, ret senaryosu test edildi mi?
- Kontrol grubu ve
hb_testanahtarı tanımlı mı? - Prebid derlemesi sabit sürümlü ve sadece gerekli modülleri içeriyor mu?
Sonuç
Header bidding, doğru kurulduğunda yayıncıya envanterini daha rekabetçi bir ortamda satma imkânı verir. Ama bir "script ekle, gelir artsın" işi değildir. Zaman aşımı, fiyat kovaları, line item uyumu, izin akışı ve sayfa performansı birbirine bağlıdır; birinde yapılan küçük bir hata, hiçbir hata mesajı üretmeden geliri ya da kullanıcı deneyimini aşındırabilir. Benim için bu işin özü, CRM ve lead hatlarında da uyguladığım ilkeyle aynıdır: tek kaynaktan yapılandırma, olay bazlı kayıt ve kontrollü karşılaştırma. Ölçemediğiniz bir optimizasyon, sadece bir varsayımdır.
Sık Sorulan Sorular (SSS)
Header bidding ile waterfall arasındaki temel fark nedir?
Waterfall'da talep kaynakları sırayla denenir ve ilk kabul eden alanı alır. Header bidding'de teklifler aynı anda toplanır ve ad server'a birlikte sunulur; böylece sıralamada geride kalan ama daha yüksek teklif verebilecek alıcılar da karşılaştırmaya girer.
Timeout değeri için doğru sayı nedir?
Herkese uyan tek bir değer yoktur. Sayfa tipine, cihaza ve bidder listesine göre değişir. Doğru yaklaşım, bidder bazında cevap sürelerini ve zaman aşımı oranlarını kaydedip kontrollü denemeyle karar vermektir.
Header bidding sayfayı yavaşlatır mı?
Kötü kurulduğunda evet. Gereksiz bidder'lar, ekran dışı alanlar için ilk yüklemede yapılan açık artırmalar, sabit yüksekliği olmayan reklam alanları ve şişkin bir Prebid paketi yavaşlığın tipik nedenleridir. Lazy loading, modül seçimi ve alan rezervasyonuyla bu etki büyük ölçüde kontrol altına alınabilir.
Prebid teklifleri ad server'da neden kazanamıyor olabilir?
En sık neden, fiyat kovası ile line item kurulumunun uyuşmamasıdır. Hedefleme anahtarlarının ad server isteğinden önce ayarlanmaması ve doğrudan satılmış kampanyaların öncelik ayarları da diğer yaygın nedenlerdir.
Sunucu tarafı header bidding her zaman daha iyi mi?
Hayır. Tarayıcıdaki ağ yükünü azaltır ama kullanıcı eşleştirmesi ve altyapı sorumluluğu gibi bedelleri vardır. Çoğu durumda karma bir yapı ve düzenli veri bazlı gözden geçirme daha sağlıklıdır.
Gayrimenkul ilan portalı için header bidding'de neye dikkat etmeliyim?
Reklam gelirini, ilan başına iletişim talebi ve lead kalitesiyle birlikte izlemek gerekir. Reklam alanları iletişim butonlarını kaydırmamalı, ilan detay sayfasındaki asıl eylemin önüne geçmemelidir.