Protos ve Referans Verileri

RTB protokolünü destekleyen dosyaları görüntüleme veya indirme.

Protos

Dosya Açıklama Sürüm Son Güncelleme
cookie-bulk-upload.proto Kullanıcı hedefleme verilerini toplu olarak yüklemek için bu mesajı kullanın. v.24 27 Mart 2024
openrtb.proto Google, OpenRTB protokolünü JSON veya Protobuf kodlamasıyla destekler. OpenRTB/Protobuf kullanıyorsanız bu proto gereklidir. Ayrıca, desteklenen alanların ve bunların Google'ın yerel protokolüyle eşlenmesinin dokümanlarını da içerir. 2.6 11 Ağustos 2025
openrtb-adx.proto Google'ın OpenRTB protokolü, ayrı bir proto dosyasında sağlanan bazı uzantıları içerir. v.192 21 Temmuz 2025
publisher-settings.proto Gerçek zamanlı teklif veren bir ağa özel bir dizi yayıncı ayarı. v.14 5 Şubat 2024

Açık Beta Protos

Dosya Açıklama Sürüm Son Güncelleme
openrtb-adx.proto Google'ın OpenRTB protokolü, ayrı bir proto dosyasında sağlanan bazı uzantıları içerir. v.200 21 Temmuz 2025

Referans verileri

Sözlükler (Click to download .txt file)
Reklam ürün kategorileri BidRequest alanının excluded_product_category alanında kullanılır. Bu alan, yayıncının izin vermediği ürün ve hizmet kategorilerini açıklar. Örneğin, yayıncı internet bankacılığıyla ilgili reklamları barındırmak istemiyorsa.
Reklam kısıtlaması uygulanan kategoriler BidRequest öğesinin allowed_restricted_category alanında ve BidResponse öğesinin restricted_category alanında kullanılır. allowed_restricted_category alanı, normalde kısıtlanmış olan ancak bir yayıncı tarafından açıkça izin verilmiş olarak beyan edilen kategorileri (ör. alkolle ilgili içerik barındıran reklamlar) açıklar.
Reklam hassas kategorileri BidRequest öğesinin excluded_sensitive_category alanında ve BidResponse öğesinin category alanında kullanılır. excluded_sensitive_category alanı, yayıncı tarafından izin verilmeyen hassas kategorileri açıklar. Örneğin, yayıncı siyasetle ilgili reklamları barındırmak istemiyorsa.
Reklamverenler SnippetStatusItem'ın advertiser_id alanında kullanılır. Bu alan, snippet ile ilişkili reklam öğesi tarafından temsil edilen reklamvereni belirtir. Bu listede, borsa genelindeki reklamverenler yer alır ve herhangi bir alıcı tarafından temsil edilen reklamverenler yer almaz.
Markalar İstemci Erişim API'sinde kullanılan markaların listesi.
Alıcı tarafından bildirilebilen reklam öğesi özellikleri BidResponse'deki attribute alanı için kullanılır. Bu alan, reklam öğelerinde alıcı tarafından beyan edilebilen ve excluded_attribute içinde BidRequest görünmemesi gereken özellikleri açıklar.
Açıklama metni durum kodları performancereport yöntemi çağrısı tarafından döndürülen durum kodları.
İçerik etiketleri BidRequest öğesinin detected_content_labels alanında kullanılır.
Çerez eşleştirici durum kodları RTB protokolü performans raporlarının cookieMatcherStatusRate alanında kullanılır. Kullanılabilir kodlar Çerez eşleştirme kılavuzunda açıklanmıştır.
Reklam öğesi durum kodları

Kullanıldığı yer:

creative_status_code, anlık geri bildirim olarak döndürüldü.
Barındırılan eşleşme durumu kodları RTB protokolü performans raporlarının hostedMatchStatusRate alanında kullanılır.
Teklif vermeme nedenleri Authorized Buyers teklif protokolündeki BidResponse.no_bid_reason alanında verilecek standart teklif verilmemesi nedeni değerleri.
Önceden hedeflenebilir reklam öğesi özellikleri Alıcı REST API'sinde kullanıma sunulan PretargetingConfig kaynağındaki supportedCreativeAttribute alanında kullanılır. Bu alan, tek bir ön hedefleme yapılandırmasına karşılık gelen tüm reklam öğelerinde bulunması beklenen reklam öğesi özelliklerini açıklar.
Yayıncı tarafından hariç tutulabilen reklam öğesi özellikleri BidRequest alanının excluded_attribute alanında kullanılır. Bu alanda, yayıncı tarafından izin verilmeyen reklam öğesi türleri açıklanır. Örneğin, çerez kullanımına izin verilip verilmediği veya medya ve/veya metin reklamların yayınlanmasına izin verilip verilmediği konusunda kısıtlamalar belirtebilirler.
Yayıncı kategorileri BidRequest alanının detected_vertical alanında kullanılır. Bu alan, reklamın gösterileceği sayfanın sektörlerini (anahtar kelimelere benzer) belirtir. Google, sayfayı tarayarak ve hangi dikey alanların kullanıldığını belirleyerek bu alanı oluşturur.
Tedarikçiler BidRequest alanının allowed_vendor_type alanında kullanılır. Bu alanda, yayıncı tarafından belirtildiği şekilde, yayınlanan reklam öğesi için hangi Rich Media sağlayıcılarına (ör. Campaign Monitor ve VoiceFive) izin verildiği listelenir.

Kullanımdan kaldırılan gdn-vendors.txt sözlük dosyasındaki tedarikçileri içerir.
Veri sağlayıcılar BidRequest alanının SegmentData.id alanında kullanılır. Bu alan, Yayıncı Tarafından Sağlanan Sinyaller'i sağlayan tüzel kişiyle ilgili bilgileri içerir.

Referans tabloları (CSV'leri indirmek için tıklayın)
Android mobil uygulamaları Hedeflenebilir Android mobil uygulamalarının uygulama kimlikleri, kategori kimlikleri ve kullanıcı tarafından okunabilir uygulama adlarının listesi.
Coğrafi tablolar geo_criteria_id alanının kodunu çözmek için kullanılan tablo. BidRequest. Daha fazla bilgi için Coğrafi hedefleme konusuna bakın.
LGPD Sağlayıcıları LGPD trafiğinde yayın yapmasına izin verilen reklam kişiselleştirme sağlayıcılarının kimlikleri, kullanıcı tarafından okunabilir adları, gizlilik URL'leri ve sağlayıcıyla ilişkilendirilebilecek alan adlarının listesi. LGPD'nin uygulanması, Authorized Buyers teklif protokolündeki BidRequest.adslot.regs_lgpd alanı ve OpenRTB teklif protokolündeki BidRequest.regs.ext.lgpd alanı aracılığıyla belirli bir teklif isteğinde belirtilir.
Mobil operatörler Mobil operatörlerin listesi.
Mobil cihazlar Mobil cihazların listesi.
Mobil işletim sistemleri Mobil işletim sistemlerinin listesi.
Sağlayıcılar Haritalar, reklam kişiselleştirme sağlayıcı kimliklerini insan tarafından okunabilir bir ada, gizlilik politikası URL'sine ve sağlayıcıyla ilişkilendirilebilecek alan adlarının listesine eşler. Şu anda sağlayıcılar, AdX protokolü için BidRequest.AdSlot.consented_providers_settings alanında ve OpenRTB protokolü için BidRequest.User.UserExt.consented_providers_settings alanında kullanılmaktadır. Bu alanlarda, listelenen sağlayıcılar Avrupa Ekonomik Alanı'ndaki ülkelerde bulunan kullanıcılar için yayıncılar tarafından iletilen kullanıcı iznine sahiptir.

Yayıncı ayarları

Hesap temsilcinizden publisher-settings.pb.gz dosyasını isteyin.

Reklam öğesi inceleme politikası konuları

Bu dosyadaki politika konularını kullanarak Real-time Bidding API'de inceleme sırasında reklam öğelerini filtreleyebilirsiniz.

Politika konularını CSV dosyası olarak indirin.

Son güncelleme: 18 Nisan 2022