Protos ve Referans Verileri

RTB Protokolü'nü destekleyen dosyaları görüntüleyin veya indirin.

Proto'lar

Dosya Açıklama Sürüm Son Güncelleme
cookie-bulk-upload.proto Kullanıcı hedefleme verilerini toplu yüklemek için bu mesajı kullanın. v.23 12 Ocak 2024
openrtb.proto Google, JSON veya Protobuf kodlamasını kullanan OpenRTB protokolünü destekler. Bu protokol, OpenRTB/Protobuf kullanıyorsanız gereklidir. Ayrıca, desteklenen alanlarla ilgili belgeleri ve bunların Google'ın yerel protokolüyle eşlenmesini de içerir. 2.6 10 Ocak 2024
openrtb-adx.proto Google'ın OpenRTB protokolü, ayrı bir protokolde sağlanan bazı uzantıları içerir. v.166 13 Şubat 2024
yayıncı-ayarları.proto Gerçek zamanlı teklif veren ağına özel yayıncı ayarları grubu. v.13 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.320 13 Şubat 2024

Açık Beta Proto'ları

Dosya Açıklama Sürüm Son Güncelleme
openrtb-adx.proto Google'ın OpenRTB protokolü, ayrı bir protokolde sağlanan bazı uzantıları içerir. v.168 13 Ş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.326 13 Şubat 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, örneğin yayıncının internet bankacılığıyla ilgili reklamlar barındırmak istememesi gibi durumlarda izin verilmeyen ürün ve hizmet kategorilerini açıklar.
Reklam kısıtlanmış 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 izin verildiğini açık bir şekilde beyan eden kategorileri (örneğin, 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 öğesinin advertiser_id alanında kullanılır. Bu alan, snippet ile ilişkilendirilmiş reklam öğesinin temsil ettiği reklamvereni belirtir. Bu liste, exchange'deki reklamverenleri yansıtır ve herhangi bir alıcının temsil ettiği reklamverenleri yansıtmaz.
Markalar Client Access API'de kullanılan markaların listesi.
Alıcı tarafından bildirilebilen reklam öğesi özellikleri BidResponse içindeki attribute alanı için kullanılır. Bu alan, BidRequest içindeki excluded_attribute içinde görünmemesi gereken reklam öğelerinde alıcı tarafından bildirilebilen özellikleri açıklar.
Açıklama metni durum kodları performancereport yöntem çağrısının döndürdüğü 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 ürün, gerçek zamanlı geri bildirim ile geri döndü.
Barındırılan eşleşme durum kodları RTB Protokolü performans raporlarının hostedMatchStatusRate alanında kullanılır.
Teklif nedeni yok 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 gösterilen PretargetingConfig kaynağındaki supportedCreativeAttribute alanında kullanılır. Bu alanda, tek bir ön hedefleme yapılandırmasına karşılık gelen tüm reklam öğelerinde bulunması beklenen reklam öğesi özellikleri açıklanmaktadır.
Yayıncı tarafından hariç tutulabilir reklam öğesi özellikleri BidRequest öğesinin excluded_attribute alanında kullanılır. Bu alanda, yayıncının izin vermediği reklam öğesi türleri açıklanmaktadır. Örneğin, çerez kullanımına izin verilip verilmeyeceğine veya medya ve/veya metin reklamlara izin verilip verilmeyeceğine ilişkin kısıtlamalar belirleyebilirler.
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, bu alanı sayfayı tarayıp hangi temaların kullanılacağını belirleyerek oluşturur.
Satıcı ağ kimlikleri BidRequest öğesinin seller_network_id alanında kullanılır. Bu alan, yayıncının ait olduğu satıcı ağını belirtir. Bu dosyanın içeriği, satıcı ağ kimliğinin değerine göre artan düzendedir.
Tedarikçi firmalar BidRequest öğesinin allowed_vendor_type alanında kullanılır. Bu alanda, yayıncı tarafından belirtilen şekilde yayınlanan reklam öğesi için hangi Rich Media tedarikçi firmalarına (Campaign Monitor ve VoiceFive gibi) izin verildiğini listeler.

Kullanımdan kaldırılan gdn-vendors.txt sözlük dosyasındaki satıcıları 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ı ile birlikte 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 listesi. Bu listede kimlikleri, okunabilir bir ad, gizlilik URL'si ve sağlayıcıyla ilişkilendirilebilecek alan adları yer alır. 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, okunabilir bir adla, bir gizlilik politikası URL'siyle ve sağlayıcıyla ilişkilendirilebilecek alan adlarıyla 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 verilen kullanıcı iznine sahiptir.

Yayıncı ayarları

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

Reklam incelemesi politika konuları

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

Politika konularını CSV dosyası olarak indirin.

Son güncelleme tarihi: 18 Nisan 2022