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.25 27 Mart 2024
openrtb.proto Google, JSON veya Protobuf kodlaması kullanan OpenRTB protokolünü destekler. OpenRTB/Protobuf kullanıyorsanız bu proto gereklidir. Ayrıca desteklenen alanların ve bunların Google'ın yerel protokolüyle eşlenmesinin belgelerini de içerir. 2.6 15 Ekim 2026
openrtb-adx.proto Google'ın OpenRTB protokolü, ayrı bir protokolle sağlanan bazı uzantılar içerir. v.210 4 Ağustos 2026
publisher-settings.proto Gerçek zamanlı teklif ağına özel bir yayıncı ayarları grubu. 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 protokolle sağlanan bazı uzantılar içerir. v.220 16 Eylül 2026

Referans verileri

Sözlükler (.txt dosyasını indirmek için tıklayın)

Reklam ürün kategorileri BidRequest öğesinin excluded_product_category alanında kullanılır. Bu alan, yayıncı tarafından izin verilmeyen ürün ve hizmet kategorilerini açıklar. Örneğin, yayıncı internet bankacılığıyla ilgili reklamlar yayınlamak istemeyebilir.
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 yayıncı tarafından açıkça izin verildiği 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 liste, exchange genelindeki reklamverenleri yansıtır ve tek bir alıcı tarafından temsil edilen reklamverenleri yansıtmaz.
Markalar Client Access API'de kullanılan markaların listesi.
Alıcı tarafından beyan edilebilir reklam öğesi özellikleri BidResponse içindeki attribute alanı için kullanılır. Bu alan, reklam öğelerindeki alıcı tarafından beyan edilebilir özellikleri açıklar. Bu özellikler, excluded_attribute içinde BidRequest olarak görünmemelidir.
Belirtme durumu kodları performancereport yöntem ç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:

Anında geri bildirim özelliğinde creative_status_code döndürüldü.
Barındırılan eşleşme durum 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 vermeme nedeni değerleri.
Önceden hedeflenebilir reklam öğesi özellikleri Alıcı REST API'sinde 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 öğesinin excluded_attribute alanında kullanılıyor. Bu alan, yayıncı tarafından izin verilmeyen reklam öğesi türlerini açıklar. Örneğin, çerez kullanımına izin verilip verilmediği veya medya ve/veya metin reklamlarına izin verilip verilmediğiyle ilgili kısıtlamalar belirtebilirler.
Tedarikçiler BidRequest öğesinin allowed_vendor_type alanında kullanılır. Bu alan, yayıncı tarafından belirtildiği şekilde, sunulan reklam öğesi için hangi rich media tedarikçilerine (ör. Campaign Monitor ve VoiceFive) izin verildiğini listeler.

Kullanımdan kaldırılan gdn-vendors.txt sözlük dosyasındaki tedarikçi firmaları içerir.

Veri sağlayıcılar BidRequest öğesinin SegmentData.id alanında kullanılır. Bu alan, yayıncı tarafından sağlanan sinyalleri sağlayan varlık hakkında bilgi 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 okunabilir uygulama adlarıyla birlikte listesi.
Coğrafi tablolar BidRequest tablosunun geo_criteria_id alanının kodunu çözmek için kullanılan tablo. Daha fazla bilgi için Coğrafi hedefleme konusunu inceleyin.
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 yaptırımı, 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 Reklam kişiselleştirme sağlayıcı kimliklerini, okunabilir bir ad, gizlilik politikası URL'si ve sağlayıcıyla ilişkilendirilebilecek alan adlarının listesiyle 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ı rızasına sahiptir.

Yayıncı ayarları

Hesabınızın temsilcisinden publisher-settings.pb.gz dosyasını isteyin.

Reklam öğesi inceleme politikası konuları

Real-Time Bidding API'de inceleme sırasında reklam öğelerini filtrelemek için bu dosyadaki politika konularını kullanabilirsiniz.

Politika konularını CSV dosyası olarak indirin.

Son güncelleme: 18 Nisan 2022