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.21 14 Kasım 2023
openrtb.proto Google, JSON veya Protobuf kodlamasını kullanarak OpenRTB protokolünü destekler. OpenRTB/Protobuf kullanıyorsanız bu proto gereklidir. Ayrıca, desteklenen alanlarla ilgili belgeleri ve bunların Google'ın yerel protokolüyle eşlenmesini de içerir. 2.6 14 Kasım 2023
openrtb-adx.proto Google'ın OpenRTB protokolü, ayrı bir protokolde sağlanan bazı uzantılar içerir. v.161 8 Kasım 2023
publisher-settings.proto (yayıncı-ayarları.proto) Gerçek zamanlı teklif veren ağına özel bir grup yayıncı ayarı. v.13 2 Şubat 2023
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.311 21 Kasım 2023

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.163 8 Kasım 2023
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.316 21 Kasım 2023

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 alanda, yayıncının internet bankacılığıyla ilgili reklamlar barındırmak istememesi gibi durumlarda izin verilmeyen ürün ve hizmet kategorileri açıklanmaktadır.
Reklam kısıtlanmış kategoriler BidRequest için allowed_restricted_category ve BidResponse için 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ça beyan eden kategorileri (örneğin, alkolle ilgili içerik barındıran reklamlar) açıklar.
Reklam hassas kategorileri BidRequest için excluded_sensitive_category ve BidResponse için 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.
Ajanslar BidResponse alanının agency_id alanında kullanılır. Bu alan, döndürülen reklamla ilişkili ajansı bildirmek için kullanılır.
Markalar Client Access API'de kullanılan markaların listesi.
Alıcı tarafından bildirilebilir reklam öğesi özellikleri BidResponse içindeki attribute alanı için kullanılır. Bu alanda, BidRequest içindeki excluded_attribute öğesinde görünmemesi gereken reklam öğelerinde alıcı tarafından bildirilebilir özellikler açıklanmaktadır.
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ı GZT 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, gerçek zamanlı geri bildirim ile yanıt verdi.
Barındırılan eşleşme durum kodları GZT Protokolü performans raporlarının hostedMatchStatusRate alanında kullanılır.
Teklif nedeni yok Authorized Buyers teklif protokolünün 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ği veya medya ve/veya metin reklamlara izin verilip verilmeyeceğini belirleyen kısıtlamalar belirtebilir.
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 şekilde) belirtir. Google, bu alanı sayfayı tarayıp hangi temaların kullanıldığı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ğine göre artan düzende sıralanır.
Satıcılar BidRequest öğesinin allowed_vendor_type alanında kullanılır. Bu alan, 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 sağlayı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 kullanıcılar tarafından 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'ye 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; kimliği, okunabilir bir ad, gizlilik URL'si ve sağlayıcıyla ilişkilendirilebilecek alan listesi içerir. Belirli bir teklif isteğinde LGPD'nin zorunlu kılınması, 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ılar tarafından okunabilir bir ad, gizlilik politikası URL'si ve sağlayıcıyla ilişkilendirilebilecek alan adları 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 ü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ı

Real-time Bidding API'deki 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 tarihi: 18 Nisan 2022