Yandex'in Header Bidding Kütüphanesine Genel Bakış

Yandex'in Header Bidding Kütüphanesine Genel Bakış

Header Bidding (HB) — yayıncıların gelirlerini maksimize etmelerine olanak tanıyan bir teknolojidir. Yayıncılar, SSP'ler ve DSP'ler arasında gerçek zamanlı açık artırmalar düzenleyerek gelirlerini artırabilirler. Yandex, kendi kapalı Header Bidding (header-bidding.js) çözümünü geliştirdi. Ancak bu sistemin iç mekanizmaları kamuya açık değildir. AdFox ve diğer Yandex hizmetleri ile derinlemesine entegre edilmiş olup, dış SSP'lerle de çalışabilmektedir.

Bu analiz, Yandex'in Header Bidding kitaplığının halka açık koduna dayanmaktadır. Kod, kullanıcıların tarayıcılarına yüklenir ve geliştirici araçları ile incelenebilir. Tüm bilgiler yalnızca açık kaynaklardan alınmış olup, Yandex'e ait gizli veya dahili verileri içermez.

Ben profesyonel bir geliştirici değilim, bu nedenle bu materyal bir kullanım kılavuzu veya teknik dokümantasyon olarak değerlendirilmemelidir. Kitaplığın çalışma mekanizmalarına ilişkin açıklamalar, gözlemler ve analizlere dayanmaktadır ve hatalar içerebilir. Yazar, bu bilgilerin kullanılması sonucunda doğabilecek hatalardan veya eylemlerden sorumlu değildir.

Makale oldukça kapsamlı oldu ancak bu konuyu ilerleyen yayınlarda daha detaylı ele almayı planlıyorum.

Mimari

Yandex, Header Bidding kitaplığını aşağıdaki bileşenlere sahip modüler bir sistem olarak geliştirdi:

  • Açık artırma yapılandırıcısı YaHeaderBiddingSettings — reklam birimlerinin, SSP'lerin ve zaman aşımı ayarlarının saklanmasını yönetir.
  • Teklif yönetim mekanizması callBids — SSP'lere yapılan talepleri ve yanıtların işlenmesini yönetir.
  • SSP adaptörleri — farklı reklam platformları (SSP) ile etkileşim için özel modüller.
  • Teklif işleme mekanizması resolveBids — teklifler toplanır, kazanan belirlenir ve reklam birimine iletilir.
  • Günlük kaydı ve hata ayıklama alt sistemi — hata izleme ve sorun giderme sağlar.
  • Çerez Eşleştirme — kullanıcı kimliklerinin platformlar arasında senkronize edilmesini sağlar.
Reklamın Kıyameti

Yapılandırma

Header Bidding betiği, aşağıdaki temel ayarları içeren küresel YaHeaderBiddingSettings nesnesi aracılığıyla başlatılır:

  • Reklam Birimleri — reklam yerleşimleri ve ilişkili SSP'lerin tanımları.
  • Teklif Verenler Haritası — adaptörler ve yapılandırmalarının eşlemesi.
  • Zaman Aşımı Süreleri — isteklerin tamamlanma süresi için sınırlamalar.
  • Geri Çağırma Fonksiyonları — sonuçları işleme mekanizmaları.

Teklif Toplama

callBids() fonksiyonu, açık artırma sürecinin en kritik bileşenlerinden biridir. Bu fonksiyon SSP'lere yapılan talepleri ve teklifler alındıktan sonra bunların işlenmesini yönetir:

  1. Tüm SSP'lere HTTP istekleri gönderilir.
  2. fetchBids() aracılığıyla yanıtlar alınır (CPM, kreatif, kimlik ve SSP'den gelen ek veriler).
  3. Bütün teklifler getBidsReceived() ve getLastBidsReceived() fonksiyonları kullanılarak bir diziye kaydedilir.

Kazananın Seçilmesi

Toplanan veriler daha sonra AdFox'un sunucu tarafına iletilir. Bu süreci managerForAdfox nesnesi yönetir ve Yandex'in teklifleri gizli kalır. Esasen, managerForAdfox, tüm teklifleri alarak AdFox'a gönderir ve AdFox, iç kriterlerine göre kazananı belirleyebilir. İşlem tamamlandıktan sonra, kazanan teklifin bilgileri istemciye geri gönderilir.

Reklamların Yayınlanması

  1. Eğer kazanan AdFox ise → teklif tekrar AdFox’a yönlendirilir ve reklam, AdFox’un betikleri aracılığıyla yüklenir.
  2. Eğer kazanan harici bir SSP ise → reklam, bir iframe veya JavaScript kodu kullanılarak eklenir.
Kimlik Pazarı

Çerez Eşleştirme

Yandex Header Bidding'deki Çerez Eşleştirme mekanizması, kullanıcıları tanımlayarak daha doğru hedefleme sağlar. Çerez eşleştirme, açık artırma başlamadan önce gerçekleştirilir: Sayfa yüklendiğinde tarayıcı, https://matchid.adfox.yandex.ru/getcookie adresine bir istek gönderir. AdFox, benzersiz kullanıcı kimliklerini (örneğin, yandexuid, cryptouid) kontrol eder. Bu kimlikler, CPM'yi artırmak ve reklamları kişiselleştirmek için SSP'lere iletilir.

Yandex'in Diğer Hizmetleriyle Entegrasyon

Header Bidding kitaplığı, Yandex'in ekosistemine aşağıdaki şekilde entegre edilmiştir:

  • AdFox — açık artırmaları yöneten, teklifleri toplayan ve trafiği SSP'ler arasında dağıtan ana bileşen.
  • Yandex.Metrika — kullanıcı verilerini toplar ve reklam gösterimlerinin etkinliğini değerlendirir.
  • Yandex.Direct — kodda bu servise bir entegrasyon var gibi görünüyor, ancak tam olarak nasıl kullanıldığı net değil.
  • Yandex.Crypta — hedefleme ve kişiselleştirme için kullanıcı verilerini analiz eder.
  • Yandex ID ve Çerez Eşleştirme — kullanıcı kimliklerini senkronize ederek platformlar arası hedeflemeyi iyileştirir.

SSP Kitaplığında Adı Geçen Platformlar (Şubat 2025 itibarıyla alfabetik sırayla):

Bu adaptörlerin Rusya pazarındaki payını görmek için HBTracker Battleboard sayfasına göz atabilirsiniz.

Sonuçlar

Yandex’in Header Bidding kitaplığı, istemci tarafında şeffaf bir açık artırma süreci sağlar. Kazanan yalnızca en yüksek CPM teklifine göre belirlenir ve SSP’ler arasında manipülasyon yapılmaz. Ancak, teklifler sunucu tarafında AdFox üzerinden işlendiği için, nihai kazananı belirlerken ek düzeltmeler yapılabilir.