GZT Protokolü'nü destekleyen dosyaları görüntüleyin veya indirin.
Protokoller
| Dosya | Açıklama | Sürüm | Son Güncelleme |
|---|---|---|---|
| çerez-toplu-upload.proto | Kullanıcı hedefleme verilerini toplu 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 protokol gereklidir. Ayrıca, desteklenen alanlar ve bunların Google'ın yerel protokolüyle eşlenmesiyle ilgili belgeler de yer alır. | 2.6 | 22 Mayıs 2024 |
| openrtb-adx.proto | Google'ın OpenRTB protokolü, ayrı bir protokolde sağlanan bazı uzantıları içerir. | v.174 | 21 Mayıs 2024 |
| yayıncı-ayarları.proto | Gerçek zamanlı teklif veren ağına özel bir dizi yayıncı ayarı. | v.13 | 5 Şubat 2024 |
| realtime-bidding.proto | Google'ın Authorized Buyers GZT protokolüdür. Bu, Google'ın teklif istemek için kullandığı mesajdır. BidRequest, tek bir gösterimdeki reklam alanını içerir. |
v.328 | 21 Mayıs 2024 |
Açık Beta Protolar
| 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.179 | 24 Mayıs 2024 |
| realtime-bidding.proto | Google'ın Authorized Buyers GZT protokolüdür. Bu, Google'ın teklif istemek için kullandığı mesajdır. BidRequest, tek bir gösterimdeki reklam alanını içerir. |
v.338 | 24 Mayıs 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 alanda, yayıncının izin vermediği ürün ve hizmet kategorileri açıklanmaktadır (örneğin, yayıncı internet bankacılığıyla ilgili reklamlar barındırmak istemiyorsa). |
| Reklamla 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 bir yayıncı tarafından izin verildiği açıkça belirtilen kategorileri (ör. alkolle ilgili içerik barındıran reklamlar) açıklar. |
| Reklama duyarlı kategoriler | BidRequest öğesinin excluded_sensitive_category alanında ve BidResponse öğesinin category alanında kullanılır. excluded_sensitive_category alanı, yayıncının izin vermediği 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şkili reklam öğesi tarafından temsil edilen reklamvereni belirtir. Bu liste, exchange'deki 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 öğesindeki attribute alanı için kullanılır.
Bu alanda, reklam öğelerindeki alıcı tarafından bildirilebilen ve BidRequest içindeki excluded_attribute içinde görünmemesi gereken özellikler açıklanmaktadır. |
| 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ı | GZT Protokolü performans raporlarının cookieMatcherStatusRate alanında kullanılır. Kullanılabilir kodlar, Çerez eşleştirme kılavuzunda açıklanmaktadır. |
| Reklam öğesi durum kodları | Kullanıldığı yer: creative_status_code, gerçek zamanlı geri bildirim ile geri döndü.
|
| 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ündeki BidResponse.no_bid_reason alanında verilecek standart teklif vermeme neden 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 şekilde) belirtir. Google, bu alanı sayfayı tarayıp hangi temaların kullanıldığını belirleyerek oluşturur. |
| Sağlayıcılar | BidRequest öğesinin allowed_vendor_type alanında kullanılır. Bu alanda, yayıncı tarafından belirtildiği şekliyle yayınlanan reklam öğesi için Campaign Monitor ve VoiceFive gibi hangi Rich Media tedarikçi firmalarına izin verildiği listelenir. Kullanımdan kaldırılan |
| Veri sağlayıcılar | BidRequest öğesinin SegmentData.id alanında kullanılır. Bu alan, Yayıncı Tarafından Sağlanan Sinyaller'i sağlayan varlıkla 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ılar tarafından okunabilen uygulama adlarıyla 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, kimlikleri, okunabilir bir ad, gizlilik URL'si ve sağlayıcıyla ilişkilendirilebilecek alan adlarının listesiyle birlikte yer aldığı liste. 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ı kimliklerinin okunabilir bir ad, gizlilik politikası URL'si ve sağlayıcıyla ilişkilendirilebilecek alan adlarının bir listesi ile eşleştirilir.
Şu anda sağlayıcılar AdX protokolü için BidRequest.AdSlot.consented_providers_settings alanında, 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ı iznine sahiptir. |
Yayıncı ayarları
Hesap temsilcinizden publisher-settings.pb.gz dosyasını isteyin.
Reklam öğesi 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