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, JSON veya Protobuf kodlamasını kullanarak 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 dokümanları da bu sayfada yer alır. 2.6 18 Kasım 2024
openrtb-adx.proto Google'ın OpenRTB protokolü, ayrı bir protoda sağlanan bazı uzantıları içerir. v.183 10 Aralık 2024
publisher-settings.proto Gerçek zamanlı teklif veren ağına özel bir yayıncı ayarları grubu. v.14 5 Şubat 2024
realtime-bidding.proto Google'ın Authorized Buyers GZT protokolü. Bu, Google'ın teklif istemek için kullandığı mesajdır. BidRequest, tek bir gösterimdeki reklam alanını içerir. v.331 1 Kasım 2024

Açık Beta Prototipleri

Dosya Açıklama Sürüm Son Güncelleme
openrtb-adx.proto Google'ın OpenRTB protokolü, ayrı bir protoda sağlanan bazı uzantıları içerir. v.189 10 Aralık 2024
realtime-bidding.proto Google'ın Authorized Buyers GZT protokolü. Bu, Google'ın teklif istemek için kullandığı mesajdır. BidRequest, tek bir gösterimdeki reklam alanını içerir. v.342 31 Ekim 2024

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ının izin vermediği ürün ve hizmet kategorilerini tanımlar. Örneğin, yayıncı internet bankacılığıyla ilgili reklamlar yayınlamak istemiyorsa bu alan kullanılır.
Reklam kısıtlaması olan kategoriler BidRequest öğesinin allowed_restricted_category alanında ve BidResponse öğesinin restricted_category alanında kullanılır. allowed_restricted_category alanının normalde kısıtlanmış ancak yayıncı tarafından açıkça izin verilen olarak beyan edilen kategorileri (ör. alkolle ilgili içerik barındıran reklamlar) tanımlar.
Reklamlara duyarlı kategoriler 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 tanımlar. Örneğin, yayıncı siyasetle ilgili reklamlar yayınlamak istemiyorsa bu alan kullanılır.
Reklamverenler SnippetStatusItem nesnesinin advertiser_id alanında kullanılır. Bu alan, snippet ile ilişkili reklam öğesi tarafından temsil edilen reklamvereni belirtir. Bu liste, exchange'teki reklamverenleri yansıtır ve herhangi 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 öğelerinde alıcı tarafından tanımlanabilen ve BidRequest içinde BidRequest görünmemesi gereken özellikleri açıklar.excluded_attribute
Açıklama metni durum 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

creative_status_code, anlık geri bildirimde 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 verme nedenleri yok Authorized Buyers teklif protokolündeki BidResponse.no_bid_reason alanında verilecek standart teklif vermeme nedeni değerleri.
Önceden hedeflenebilen 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ı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 reklamlara izin verilip verilmediğiyle ilgili kısıtlamaları belirtebilirler.
Yayıncı sektörleri BidRequest öğesinin 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 sektörlerin kullanıldığını belirleyerek bu alanı oluşturur.
Tedarikçi firmalar BidRequest öğesinin allowed_vendor_type alanında kullanılır. Bu alanda, yayıncı tarafından belirtildiği üzere, yayınlanacak reklam öğesi için hangi Rich Media tedarikçi firmalarına (ör. Campaign Monitor ve VoiceFive) izin verildiği listelenir.

Desteği sonlandırılan gdn-vendors.txt sözlük dosyasından 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 tüzel kişi hakkında bilgi içerir.

Referans tabloları (CSV dosyalarını indirmek için tıklayın)

Android mobil uygulamaları Uygulama kimlikleri, kategori kimlikleri ve kullanıcı tarafından okunabilen uygulama adlarıyla hedeflenebilecek Android mobil uygulamalarının listesi.
Coğrafi tablolar BidRequest öğesinin geo_criteria_id alanının kodunu çözmek için kullanılan tablo. Daha fazla bilgi için Coğrafi hedefleme bölümüne bakın.
LGPD Sağlayıcılar LGPD trafiğinde yayınlanmasına izin verilen reklam kişiselleştirme sağlayıcılarının kimlikleri, okunabilir adları, gizlilik URL'leri ve sağlayıcıyla ilişkilendirilebilecek alanların listesi. LGPD yaptırımı, belirli bir teklif isteğinde Authorized Buyers teklif protokolündeki BidRequest.adslot.regs_lgpd alanı ve OpenRTB teklif protokolündeki BidRequest.regs.ext.lgpd alanı aracılığıyla 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, kullanıcı tarafından okunabilen 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 ülkelerdeki kullanıcılar için yayıncılar tarafından iletilen kullanıcı rızasına sahiptir.

Yayıncı ayarları

Hesap temsilcinizden 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