OpenRTB Entegrasyonu

Bu kılavuzda, OpenRTB 2.5'in (makrolar dahil) ve Yerel reklamların Authorized Buyers ile entegrasyonu açıklanmaktadır. Ayrıca, Authorized Buyers OpenRTB uzantıları protosundaki her bir alanı açıklamaktadır.

OpenRTB protoları hakkında daha fazla bilgi için OpenRTB proto dosyasına göz atın. Authorized Buyers uzantıları için OpenRTB Uzantıları Protokol Arabellek dosyasına bakın.

Authorized Buyers'da OpenRTB uygulaması, iki benzer biçimde kullanılabilir.

• JSON
• Protobuf: Mesajın kodunu çözmek için .proto tanım dosyasına başvurabilir.

Bu sayfa, Google'ın OpenRTB uygulaması için referans görevi görür ve Protobuf protokolünü temel alır. Bu alanların JSON protokolünde nasıl doldurulduğu hakkında daha fazla bilgi için OpenRTB JSON kullanıcılarının resmi OpenRTB spesifikasyonuna da başvurmalarını öneririz.

Entegrasyonla ilgili dikkat edilmesi gereken noktalar

Entegrasyon testine başlamadan önce bu bölümü baştan sona okumalısınız.

Bu dokümanın yapısı

Aşağıdaki tablolar, nesnenin adı, teklif isteğinde veya teklif yanıtında gerekli olup olmaması, Authorized Buyers gerçek zamanlı teklif verme protokolünde eşdeğer olması ve bazı uygulama ayrıntıları dahil olmak üzere nesnelerin tanımlarını içerir.

Ayrıca şunları unutmayın:

• cid alanı, ön hedefleme kurulumunuzda belirtilen faturalandırma kimliğini temsil eder. Bu alan, teklifi teklif isteğinde gönderilen bir billing_id ile bağlamak için kullanılır. İstekte birden fazla cid/billing_id varsa veya etkin alt lisanslarınız varsa yanıtınızda amaçlanan cid öğesini belirtmeniz gerekir. İstekte yalnızca bir alt öğe varsa ve etkin bir alt öğeniz yoksa yanıtta varsayılacak değer budur.
• Aşağıdaki bölümlerde adlandırma, basit olması için OpenRTB'yi izler.
• Varsa tüm alanlar istekle doldurulur. Hiçbir zaman boş değerler veya boş dizeler iletmeyiz.
• OpenRTB türleri ve açıklamaları aşağıdaki tablolara dahil değildir. OpenRTB proto dosyasına bakın.
• JSON kodlamalı teklif isteklerinde, 64 bit integral değerlerinde doğruluk kaybını önlemek için aşağıda int64 veya düzeltilmiş 64 yazılan tüm alanlar dize olarak gönderilir.
• OpenRTB JSON protokolü, istekteki tüm bool alanlarını tam sayı biçiminde gösterir. 0 değeri, false ve 1 değeri ise true değerini temsil eder. Bu, OpenRTB spesifikasyonu için gereklidir.

Gösterimleri sayma ve makroları kullanma

Tutarsızlıkları sınırlamak amacıyla yerel dahil olmak üzere tüm envanter için BidResponse.seatbid[].bid[].ext.impression_tracking_url alanını kullanmanızı öneririz.

Alıcıların, gösterim izleme piksellerini reklam öğesinden (reklam işaretlemesi) kaldırmaları ve bunun yerine teklif yanıtında impression_tracking_url alanını (dize dizisi) içermesi gerekir. OpenRTB 2.5'te BidResponse.seatbid[].bid[].burl de kullanılabilir. impression_tracking_url, gösterim faturalandırılabilir olarak kabul edildiğinde etkinleşir. Bu, izleme piksellerinden daha doğru sonuç verir. Bu, önceden getirme nedeniyle uygulama tarafından getirilen ancak hiç oluşturulmayan gösterimleri izleyebilir. Bu alan için şifrelenmiş %%WINNING_PRICE%% makrosu veya ${AUCTION_PRICE} makrosu kullanın.

impression_tracking_url ve burl tarafından desteklenen makroların listesini burada bulabilirsiniz:

• ${AUCTION_ID} - Teklif isteğinin kimliği; BidRequest.id özelliğinden.
• ${AUCTION_BID_ID} - Teklifin kimliği; BidResponse.bidid özelliğinden.
• ${AUCTION_IMP_ID} - BidRequest.imp[].id özelliğinin yeni aldığı gösterimin kimliği.
• ${AUCTION_SEAT_ID} - Teklifin verildiği teklif veren lisansının kimliği; BidResponse.seatbid[].seat özelliğinden.
• ${AUCTION_AD_ID} - Teklif verenin sunmak istediği reklam işaretlemesinin kimliği; BidResponse.seatbid[].bid[].adid özelliğinden.
• ${AUCTION_PRICE} - Teklifle aynı para birimini ve birimi kullanarak fiyatı silme. Bu makronun şu anda AMP reklamlarında desteklenmediğini unutmayın.

Google'ın OpenRTB uygulaması, AUCTION_PRICE öğesini Authorized Buyers protokolünün WINNING_PRICE makrosuyla açıkça şifreler. Fiyatın şifresinin nasıl çözüleceği hakkında daha fazla bilgi için Fiyat Onaylarının Şifresini Çözme kılavuzuna bakın.

Protobuf'a Taşıma

Protobuf kodlaması, bant genişliği ve işleme açısından çok daha etkili olduğu için önerilir. Protobuf'a taşıma işlemi her iki biçimde de eşleşen alanlar içerdiğinden, basit bir taşıma işlemidir.

JSON'den Protobuf'e geçiş yaparken cid alanının teklif yanıtında bir dize olarak ayarlandığından emin olun. Bu alanı, ön hedeflemedeki teklifi billing_id kampanyanıza bağlamak için kullanırız. Metin okunamazsa teklifi kabul etmeyiz.

VAST ve video desteği

Varsayılan olarak VAST reklamları için tam XML yerine SSL URL'lerini destekliyoruz. Bununla birlikte, Exchange Teklif Verenleri satır içi VAST'ın tamamını döndürebilir ve tüm hesaplar, hesap destek ekibinizle iletişime geçerek bu özellik için etkinleştirilebilir.

OpenRTB 2.4 ve sonraki sürümlerde alıcıların video.skip=1 atlanamayan veya atlanabilir video reklam öğeleriyle teklif verebileceğini unutmayın. OpenRTB'de ALLOW_SKIPPABLE ile REQUIRE_SKIPPABLE arasında bir ayrım yapılmadığı için hesap kurulumu sırasında Düzeltmeyi Atla'yı etkinleştirmenizi öneririz.

Desteklenmeyen alanlar

Nurl alanı şu anda desteklenmese de OpenRTB 2.5'te Bid.burl gibi impression_tracking_url desteklenir: Yukarıdaki yorumları inceleyin.

Teklif yok

Teklif vermek istemeyen müşterilerin bu e-postayı 204 koduyla yanıtlaması gerekir.

Sıralamalar

Tüm sıralamalar, OpenRTB 2.5 ve Yerel reklamların resmi dokümanlarında bulunabilir.

MRAID-1, MRAID-2'nin bir alt kümesidir. OpenRTB 2.1 ve önceki sürümlerde 3 değeri MRAID idi. Bununla birlikte, MRAID özellikli tüm API'ler MRAID-2 özelliklerini anlamadığından 3 değerinin tek güvenli yorumu MRAID-1'dir. Bu, OpenRTB 2.2'de açık hale getirilmiş ve MRAID-2, 5 değeri olarak eklenmiştir.

OpenRTB sürümünü kontrol etme

OpenRTB/JSON

x-openrtb-version mevcut ve 2.2, 2.3, 2.4 veya 2.5 değerini içeriyor. Content-Type: application/json charset=utf-8

OpenRTB/Protobuf

x-openrtb-version mevcut ve 2.3, 2.4 veya 2.5 değerini içeriyor. Content-Type: application/octet-stream

Teklif isteği değişkenleri ve tanımları

Bu sayfaya danışırken OpenRTB 2.5 Spesifikasyon Kılavuzu'nu yanınızda bulundurun. Spesifikasyon, Authorized Buyers uygulamasına özel bilgileri ve ayrıntıları içerir. Değişiklik yapılmadığı sürece OpenRTB'de sunulan yönergelere de uymanız gerekir.

Teklif isteği

Üst düzey teklif isteği nesnesi, genel olarak benzersiz bir teklif isteği veya açık artırma kimliği içerir. Bu kimlik özelliği ve en az bir Imp (gösterim) nesnesi gereklidir. Bu üst düzey nesnedeki diğer özellikler, sunulan tüm gösterimler için geçerli olan kurallar ve kısıtlamalar oluşturur.

Ayrıca, potansiyel alıcılara ayrıntılı veriler sağlayan birkaç nesne de mevcuttur. Bunların arasında, gösterimlerin göründüğü yayınlanmış medyanın türünü açıklayan Site ve App nesneleri bulunur. Bu nesneler kesinlikle önerilir ancak medyanın sırasıyla tarayıcı tabanlı web içeriği veya tarayıcı olmayan uygulama olmasına bağlı olarak belirli bir teklif isteği için yalnızca bir tane uygulanır.

Not: OpenRTB JSON protokolü, istekteki tüm bool alanlarını tam sayı olarak temsil eder. Burada 0, false ve 1, true değerini temsil eder. Bu, OpenRTB spesifikasyonu için gereklidir.

Özellik	Her zaman başarılı	Type	Yetkili Alıcılar eşdeğeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Evet	string	BidRequest.id	2,3 2,4 2,5		Exchange tarafından sağlanan teklif isteğinin benzersiz kimliği. OpenRTB, web güvenli Base64'tür (dolgusuzdur).
imp	Evet	Imp nesne dizisi	BidRequest.AdSlot	2,3 2,4 2,5		Sunulan gösterimleri temsil eder. En az 1 Imp nesnesi gerekli.
site	Hayır	Site nesne	Teklif İsteği	2,3 2,4 2,5		Yayıncının web sitesiyle ilgili ayrıntılar. Yalnızca web siteleri için geçerlidir ve önerilir. app ile bir kerelik.
app	Hayır	App nesne	BidRequest BidRequest.Mobile	2,3 2,4 2,5		Yayıncının uygulaması hakkında ayrıntılar. (tarayıcı dışı uygulamalar). Yalnızca uygulamalar için geçerlidir ve önerilir. site ile bir kerelik.
device	Hayır	Device nesne	BidRequest.Mobile, BidRequest.Device	2,3 2,4 2,5		Gösterimin yayınlanacağı kullanıcının cihazıyla ilgili ayrıntılar.
regs	Hayır	Regs nesne		2,3 2,4 2,5		Bu taleple ilgili olarak yürürlükte olan sektör, yasal veya kamu düzenlemelerini belirtir.
user	Hayır	User nesne	Teklif İsteği	2,3 2,4 2,5		Cihazın insan kitlesi (reklam kitlesi) ile ilgili ayrıntılar.
at	Hayır	AuctionType nesne	BidRequest.auction_type	2,3 2,4 2,5		Burada 1 = İlk Fiyat, 2 = İkinci Fiyat Plus. Exchange'e özel açık artırma türleri 500'den büyük değerler kullanılarak tanımlanabilir. Varsayılan = NFC_PRICE.
tmax	Hayır	int32 [int32]	80-1.000 ms.	2,3 2,4 2,5		Teklifin zaman aşımına uğramasını önlemek için milisaniye cinsinden maksimum süre. Bu değer genellikle çevrimdışı olarak iletilir.
wseat	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Alıcı gösteriminin (örneğin, reklamverenler, ajanslar) bu gösterim için teklif vermesine izin verilen izin verilenler listesi. Koltuk kimlikleri ve alıcının başvuruda bulunduğu müşterilerin bilgileri, teklif verenler ile borsa arasında koordinasyon içinde olmalıdır. Eksiklik, koltuk kısıtlaması olmadığını gösterir.
allimps	Hayır	bool	Desteklenmiyor	2,3 2,4 2,5		Exchange'in, sunulan engellemeleri desteklemek için sunulan gösterimlerin, bağlam içinde sunulan tüm gösterimleri (örneğin, tümü web sayfasında, videodan önce/videonun ortasından/videodan sonra gösterilen reklamlar gibi) temsil edip etmediğini doğrulayıp belirtmediğini belirtir. 0 = hayır veya bilinmeyen, 1 = evet, kullanılabilir gösterimlerin tümünü kullanılabilir.
cur	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		ISO-4217 alfa kodlarını kullanarak bu teklif isteğindeki teklifler için izin verilen para birimi dizisi. Yalnızca exchange birden çok para birimini kabul ediyorsa önerilir.
bcat	Hayır	Dize dizisi	BidRequest.AdSlot. excluded_Sensitive _category, BidRequest.AdSlot. excluded_product _category	2,3 2,4 2,5		IAB içerik kategorilerini kullanan reklamveren kategorileri engellendi. Sıralama İçerik Kategorisi'ne bakın.
badv	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		Reklamverenlerin listesini alanlarına göre engelleyin (örneğin, "addomain.com")
bapp	Hayır	Dize dizisi	BidRequest.AdSlot.excluded_app_ids	2,4 2,5		Uygulama listesini, platforma özgü exchange'den bağımsız uygulama tanımlayıcılarına göre engelleyin. Android'de bu adlar, paket veya paket adları olmalıdır (örneğin, com.foo.mygame). iOS'te bunlar sayısal kimliklerdir.
test	Hayır	bool	Teklif İsteği.is_test	2,3 2,4 2,5		Açık artırmaların faturalandırılamadığı test modu göstergesi. Burada 0 = canlı mod, 1 = test modudur. Varsayılan : 1
bseat	Hayır	string	Desteklenmiyor	2.5		Alıcı gösterim listesinin (ör. reklamverenler, ajanslar) bu gösterim için teklif vermesini engelleyin. Koltuk kimlikleri ve alıcının başvuruda bulunduğu müşterilerin bilgileri, teklif verenler ile borsa arasında koordinasyon içinde olmalıdır. Aynı istekte en fazla wseat ve bseat kullanılmalıdır. Her ikisinin de atlanması, koltuk kısıtlaması olmadığı anlamına gelir.
wlang	Hayır	string	BidRequest .AdSlot .allowed _languages	2.5		ISO-639-1-alpha-2 kullanan reklam öğeleri için izin verilenler listesi. Atlama, belirli bir kısıtlama olmadığını ifade eder ancak alıcılara cihaz ve/veya içerik nesnelerindeki dil özelliğini (varsa) değerlendirmeleri önerilir.
source	Hayır	Source nesne	Yalnızca uzantılar için kullanılır	2.5		Envanter kaynağı ve son kararı hangi tüzel kişinin aldığı hakkında veri sağlayan bir Source nesnesi.
ext	Hayır	BidRequestExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.bid_request] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için BidRequest mesajındaki ext alanıyla erişirsiniz.

Teklif İsteği Uzatma

Daha fazla bilgi için gerçek zamanlı geri bildirim bölümüne bakın.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
bid_feedback	Hayır	BidFeedback nesne dizisi	BidRequest.bid_response_feedback	Önceki yanıtlarda gönderilen teklifler hakkında geri bildirim. Bu, yalnızca teklif vereniniz için gerçek zamanlı geri bildirim etkinleştirilmişse ayarlanır. Gerçek zamanlı geri bildirimi etkinleştirmek istiyorsanız hesap yöneticinizle iletişime geçin.
google_query_id	Hayır	string	BidRequest.google_sorgu_kimliği	Bu, genel sorgu için benzersiz bir kimliği temsil eder. Bir sorgu için birden fazla açıklama metni varsa bu sorgu için tüm açıklama metni istekleri aynı google_query_id parametresini içerir.
fcap_scope	Evet	FrequencyCappingScope sıralama	BidRequest.AdSlot.Sıklık Sınırı Sınırı	Deneysel özellik, değişebilir. Daha fazla bilgi için GZT teklifleri için Google tarafından barındırılan sıklık sınırları ayarlama bölümüne bakın. Bu istek için kullanılabilecek sıklık sınırı yaptırımının kapsamını açıklar. Bir teklif için zorunlu kılınacak sıklık sınırları, Bid.ext.fcap alanında belirtilebilir. FREQUENCY_CAPPING_SCOPE_UNKNOWN = 0; Kullanılmaması gereken veya sıklık sınırı kapsamının güvenilir şekilde belirlenemeyeceğini belirten varsayılan değer. FREQUENCY_CAPPING_SCOPE_NONE = 1; Bu istek için teklif yanıtı özelliklerine dayalı sıklık sınırı kullanılamaz. Sıklık sınırı olmayan teklif istekleri için sıklık sınırı olan bir teklif, açık artırmadan önce filtrelenir. FREQUENCY_CAPPING_SCOPE_BROWSER = 2; Sıklık sınırı yaptırımı, aynı tarayıcı içindeki birden fazla sitede kullanılabilir. FREQUENCY_CAPPING_SCOPE_DEVICE = 3; Sıklık sınırı yaptırımı, tarayıcılar hariç cihazdaki birden fazla sitede kullanılabilir. FREQUENCY_CAPPING_SCOPE_APP = 4; Sıklık sınırı uygulama tek bir uygulamada kullanılabilir. FREQUENCY_CAPPING_SCOPE_SITE = 5; Sıklık sınırı uygulama tek bir sitede kullanılabilir.
privacy_treatments	Hayır	PrivacyTreatments nesne	BidRequest.privacy_treatments	Gizlilik tedavileri. Teklif isteğindeki bazı alanlar, kullanıcı gizliliğini korumak için yaklaşık olarak çıkarılabilir veya çıkarılabilir. Bu mesaj, bu istek üzerinden sunulan bir reklam fırsatı için geçerli olan gizlilik işlemleri hakkında bilgi sağlar.

TeklifGeri Bildirimi

Önceki yanıtlarda gönderilen teklifler hakkında geri bildirim. Bu, yalnızca teklif vereniniz için gerçek zamanlı geri bildirim etkinleştirilmişse ayarlanır. Gerçek zamanlı geri bildirimi etkinleştirmek istiyorsanız hesap yöneticinizle iletişime geçin.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
request_id	Hayır	string	BidRequest.BidResponsefeedback.request_id.	BidRequest.id'deki benzersiz kimlik.
creative_status_code	Hayır	int32 [int32]	BidRequest.BidResponseRefund.creative_status_code	Reklamın durum kodu. Kimliklerin listesi için Proto'lar ve Referans Verileri sayfasındaki reklam öğesi durum kodlarına bakın.
price	Hayır	double	BidRequest.BidResponsefeedback.bgbm_mikro	Teklif açık artırmayı kazandıysa bu, hesabınızın para biriminde ödenen fiyattır. Teklif açık artırmaya katılmışsa ancak daha yüksek teklif verildiyse bu, kazanmak için aşılması gereken BGBM'dir. Teklif, açık artırmadan önce filtrelendiyse, yayıncı veya kazanan teklif veren fiyat geri bildirimini devre dışı bıraktıysa veya hesabınız, kazanan fiyatları diğer teklif verenlerle paylaşmayı devre dışı bıraktıysa bu ayar yapılmaz. İlk fiyat açık artırmalarında, bu alan yerine minimum_bid_to_win doldurulur.
minimum_bid_to_win	Hayır	double	BidRequest.BidResponsefeedback.minimum_bid_to_win	Açık artırmayı kazanmak için gereken minimum teklif değeri, hesabınızın para birimi cinsindendir. Teklifiniz açık artırmayı kazandıysa bu, filtrelenmemiş ikinci en yüksek tekliftir (taban fiyat dahil). Teklifiniz açık artırmayı kazanmadıysa kazanan adayın teklifidir. Bu alan, yalnızca teklifiniz bir ilk fiyat açık artırmasına katıldıysa doldurulur ve teklifiniz açık artırmadan önce filtrelendiyse doldurulmaz.
sampled_mediation_cpm_ahead_of_auction_winner	Hayır	double	BidRequest.BidResponsefeedback.sampled_uyumlulaştırması_cpm_ahead_of_auction_wner	Bir yayıncı, aynı sorguda GZT açık artırması ve şelale tabanlı SDK uyumlulaştırması kullandığında, gerçek zamanlı açık artırmanın kazananı da gösterim kazanmak için bir uyumlulaştırma şelalesinde (fiyata göre sıralanmış şekilde) rekabet etmelidir. Teklif açık artırmaya katıldıysa ve hiçbir şelale yoksa bu alanın değeri 0'dır. Teklif açık artırmaya katılmışsa ve bir şelale varsa bu alanın değeri, açık artırma kazananından daha yüksek olan ve beklenen doluluk oranıyla ağırlıklandırılan örnek bir teklifi temsil eden fiyattır. Bu alan, teklif modellerini eğitmek için minimum_bid_to_win ile birlikte kullanılabilir. BGBM, hesabınızın para birimindedir.
event_notification_token	Hayır	EventNotificationToken nesne	BidRequest.BidResponseRefund.event_notification_token	İlgili teklife dahil edilen jeton.
buyer_creative_id	Hayır	string	BidRequest.BidResponsefeedback.buyer_creative_id	İlgili teklife dahil edilen reklam öğesi kimliği.

Etkinlik Bildirimi Jetonu

İlgili teklife dahil edilen jeton.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
event_notification_token.payload	Hayır	string	BidRequest.BidResponseRefund.event_notification_token	Jetonun içeriği.

Gizlilik İşlemleri nesnesi

Üst öğe

Gizlilik tedavileri. Teklif isteğindeki bazı alanlar, kullanıcı gizliliğini korumak için yaklaşık olarak çıkarılabilir veya çıkarılabilir. Bu mesaj, bu istek üzerinden sunulan bir reklam fırsatı için geçerli olan gizlilik işlemleri hakkında bilgi sağlar.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
non_personalized_ads_reason	Hayır	NonPersonalizedAdsReason sıralama	BidRequest.privacy_treatments.non_personalized_ads_reason	Bu isteğe yanıt olarak döndürülen reklamların neden kişiselleştirilmemiş olması gerektiğini belirtir. UNKNOWN = 0; Neden bilinmiyor. PUBLISHER_DECLARED_NPA = 1; Yayıncı bu isteğin diğer sinyallerden bağımsız olarak kişiselleştirilmemiş reklamlar yayınlaması gerektiğini beyan etti. RESTRICT_DATA_PROCESSING= 2; Yayıncı bu istek için kısıtlanmış veri işleme isteğinde bulundu. USER_OPT_OUT = 3; Kullanıcı, reklam kişiselleştirmeyi devre dışı bıraktı.
allow_user_data_collection	Hayır	bool	BidRequest.privacy_treatments.allow_user_data_collection	Yayıncı, teklif verenin ilgi alanına dayalı reklamlar ve yeniden pazarlama gibi amaçlarla kullanıcı profilleri oluşturmak için teklif isteği verilerini kullanmasına izin veriyorsa doğru değerini döndürür. Bu verileri kullanarak kullanıcı profilleri oluşturmak için teklif verenin de belirli bir gösterimi kazanması gerekir. Veri toplama kontrolleri hakkında başlıklı makaleyi inceleyin.

Kaynak

Bu nesne, exchange'den sonraki teklif isteğinin kaynağı olan varlığın yapısını ve davranışını açıklar. Bu nesnenin birincil amacı, exchange'in son kararı kontrol etmediği durumlarda açık artırma sonrası veya yayın öncesi kararının tanımlanmasıdır. Buna yaygın bir örnek, başlıktan teklif alma (header bidding) seçeneğidir ancak başka bir GZT exchange, uyumlulaştırma platformu veya reklam sunucusu gibi yayın öncesi sunucu varlıkları için de geçerlidir.

Özellik	Her zaman başarılı	Type	Yetkili Alıcılar eşdeğeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
fd	Hayır	boolean	Desteklenmiyor	2.5		Nihai gösterim satışı kararından sorumlu olan varlık. Burada 0 = exchange, 1 = yayın kaynağıdır. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
tid	Hayır	string	Desteklenmiyor	2.5		Bu teklif isteğindeki tüm katılımcılar arasında ortak olması gereken işlem kimliği (örneğin, birden fazla exchange). OpenRTB spesifikasyonu tarafından ÖNERİLİR.
pchain	Hayır	string	Desteklenmiyor	2.5		TAG Ödeme Kimliği Protokolü 1.0 sürümünde açıklanan yerleşik söz dizimini içeren ödeme kimliği zincir dizesi. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
ext	Hayır	SourceExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.source] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için kaynak mesajdaki ext alanıyla erişirsiniz.
schain	Hayır	SupplyChain nesne	BidRequest.supply_chain	2,3 2,4 2,5		OpenRTB SupplyChain nesnesi. Daha fazla bilgi için bu makaleyi inceleyin.

Kaynak Harici

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
omidpn	Hayır	string	BidRequest.AdSlot.omidpn	OM SDK entegrasyonunun tanımlayıcısı. Daha fazla bilgi için Open Measurement SDK'sı için OpenRTB Danışmanlığı bölümüne bakın.
omidpv	Hayır	string	BidRequest.AdSlot.omidpv	OM SDK entegrasyonunun sürümü. Daha fazla bilgi için Open Measurement SDK'sı için OpenRTB Danışmanlığı bölümüne bakın.
schain	Hayır	SupplyChain nesne	BidRequest.supply_chain	Bu alan, BidRequest.source.schain yerine kullanımdan kaldırılmıştır ve Aralık 2023'te kaldırılacaktır. Bu alan OpenRTB SupplyChain nesnesini içerir. Daha fazla bilgi için bu makaleyi inceleyin.

Tedarik Zinciri

OpenRTB SupplyChain nesnesi. Daha fazla bilgi için bu makaleye bakın.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
complete	Hayır	int32 [int32]	BidRequest.supply_chain.complete	Zincirin sitenin, uygulamanın veya envanterin diğer aracısının öncesinde gerçekleşen işleme dahil olan tüm düğümleri içerip içermediğini belirten seçenek. Bu durumda 0 = hayır, 1 = evet olur.
nodes	Hayır	SupplyChainNode nesne dizisi	BidRequest.supply_chain.nodes	Zincir sırasına göre SupplyChainNode nesneleri dizisi. Eksiksiz bir tedarik zincirinde ilk düğüm, işleme dahil olan ilk reklamcılık sistemini ve satıcı kimliğini (ör. sitenin, uygulamanın veya başka bir aracının sahibi) temsil eder. Tamamlanmamış bir tedarik zincirinde bilinen ilk düğümü temsil eder. Son düğüm, bu teklif isteğini gönderen varlığı temsil eder.
ver	Hayır	string	BidRequest.supply_chain.version	Tedarik zinciri spesifikasyonunun "major.minor" biçiminde kullanılan sürümü. Örneğin, spesifikasyonun 1.0 sürümü için "1.0" dizesini kullanın.

SupplyChainNode

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
asi	Hayır	string	BidRequest.supply_chain.nodes.advertising_system_identifier	Teklif verenlerin bağlandığı STP, Exchange, Başlık Sarmalayıcı vb. sistemin standart alan adı. Bu, yetki verilmiş sistemin açıkça sahipliğinin belirlenmesi amacıyla WHOIS ve ters IP aramalarını kolaylaştırmak için sistemin operasyonel alan adı (üst kurumsal alan adından farklıysa) olabilir. Bu değer, ads.txt dosyasında mevcut olan satıcıları tanımlamak için kullanılan değerle aynı olmalıdır.
sid	Hayır	string	BidRequest.supply_chain.nodes.seller_identifier	Reklamcılık sistemindeki satıcı veya bayi hesabıyla ilişkilendirilen tanımlayıcı. Bu, STP/exchange'ler tarafından belirtilen alanda işlemlerde (ör. OpenRTB teklif istekleri) kullanılan değerin aynısını içermelidir. Bu, genellikle OpenRTB'de yayıncı.id'dir. OpenDirect için genellikle yayıncının kuruluş kimliğidir. Uzunluk 64 karakterle sınırlandırılmalıdır.
rid	Hayır	string	Desteklenmiyor	Bu satıcı tarafından gönderilen isteğin OpenRTB İstek Kimliği.
name	Hayır	string	Desteklenmiyor	Belirtilen sellers_id altında işlem gören envanter için ödenen şirketin (tüzel kişi) adı. Bu değer isteğe bağlıdır ve reklamcılık sisteminin sellers.json dosyasında varsa EKLENMEMELİDİR.
domain	Hayır	string	Desteklenmiyor	Bu düğümle temsil edilen tüzel kişinin işletme alan adı. Bu değer isteğe bağlıdır ve reklamcılık sisteminin sellers.json dosyasında mevcutsa bu değere EKLENMEMELİDİR.
hp	Hayır	int32 [int32]	BidRequest.supply_chain.nodes.handles_payment	Bu düğümün envanter için ödeme akışına dahil olup olmayacağını belirtir. 1 olarak ayarlandığında, Asya alanındaki reklamcılık sistemi sid alanında satıcıya ödeme yapar. SIM, zincirdeki önceki düğümün ödemesinden sorumludur. 0 olarak ayarlandığında bu düğüm, envanter için ödeme akışına dahil olmaz. SupplyChain'in 1.0 sürümü için bu özellik her zaman 1 olmalıdır. Spesifikasyonun gelecekteki sürümlerinin ödeme yapmayan düğümleri kullanıma girmesi beklendiğinden bu değerin açıkça belirtilmesi gerekir. Uygulamacılar, bu alanı desteklediklerinden ve bir aşağı akış reklamcılık sistemine gönderilen teklif isteklerinde SupplyChain nesneleri oluşturulurken bu alanı genişlettiklerinden emin olmalıdır.

Küçük şeytan

Bu nesne, açık artırmada bulunan bir reklam yerleşimini veya gösterimi açıklar. Tek bir teklif isteği birden fazla Imp nesnesi içerebilir. Kullanım alanı, belirli bir sayfadaki tüm reklam konumlarının satılmasını destekleyen bir exchange olabilir. Her Imp nesnesinin tekliflere tek tek başvuruda bulunabilmesi için zorunlu bir kimliği vardır.

Imp nesnesine bağlı Banner, Video veya Native nesnesinin varlığı, sunulan gösterim türünü gösterir. Yayıncı, tipik bir örnek olan bu türlerden birini seçebilir veya bunları kendi takdirine bağlı olarak karıştırabilir. Gösterim için verilen herhangi bir teklif, sunulan türlerden birine uygun olmalıdır.

Özellik	Her zaman başarılı	Type	AuthorizedAlıcılareşdeğeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Evet	string	BidRequest .Adslot.id	2,3 2,4 2,5		Teklif isteği bağlamında bu gösterimin benzersiz bir tanımlayıcısı (genellikle değer 1 ile başlar ve n gösterim için n'ye kadar artar).
banner	Hayır	Banner nesne	BidRequest .AdSlot	2,3 2,4 2,5		Banner nesnesi. Bu gösterim bir banner reklam fırsatı olarak sunuluyorsa zorunludur.
video	Hayır	Video nesne	BidRequest .AdSlot BidRequest .Video	2,3 2,4 2,5		Bu gösterim bir video reklam fırsatı olarak sunuluyorsa gerekir.
audio	Hayır	Audio nesne	BidRequest .AdSlot BidRequest .Video	2,3 2,4 2,5		Bu gösterim işitsel reklam fırsatı olarak sunuluyorsa gerekir.
displaymanager	Hayır	string	BidRequest .AdSlot .renderer	2,3 2,4 2,5		Reklam uyumlulaştırma iş ortağının, SDK teknolojisinin veya reklamı oluşturmaktan sorumlu olan oynatıcının adı (genellikle video veya mobil). Reklam kodunu iş ortağına göre özelleştirmek için bazı reklam sunucuları tarafından kullanılır. Video ve/veya uygulamalar için önerilir. Örnek dizeler: UNKNOWN_RENDERER GOOGLE PUBLISHER
displaymanagerver	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Reklam uyumlulaştırma iş ortağı, SDK teknolojisi veya reklamı oluşturmaktan sorumlu olan oynatıcının (genellikle video veya mobil) sürümü. Reklam kodunu iş ortağına göre özelleştirmek için bazı reklam sunucuları tarafından kullanılır. Video ve/veya uygulamalar için önerilir.
instl	Hayır	bool	BidRequest .AdSlot .Mobile. is_interstitial _request	2,3 2,4 2,5		1 = reklam geçiş reklamı veya tam ekrandır, 0 = geçiş reklamı değil.
tagid	Hayır	string	BidRequest .AdSlot .ad_block_key	2,3 2,4 2,5		Açık artırmayı başlatmak için kullanılan belirli reklam yerleşimi veya reklam etiketinin tanımlayıcısı. Bu bilgiler, olası hataları ayıklamak veya alıcının optimizasyonu için faydalı olabilir.
bidfloor	Hayır	double	min(BidRequest .AdSlot. eşleştiriliyor _ad_data .minimum_cpm _micros) * 1.000.000	2,3 2,4 2,5		Bu gösterim için BGBM olarak belirtilen minimum teklif.
bidfloorcur	Hayır	string	Faturalandırma_kimliğinden elde edilir desteklenir	2,3 2,4 2,5		ISO-4217 alfa kodları kullanılarak belirtilen para birimi. Exchange tarafından izin veriliyorsa bu, teklif veren tarafından döndürülen teklif para biriminden farklı olabilir. Dahil edilen billing_id öğesinden alınan tek bir para birimi.
clickbrowser	Hayır	bool	Desteklenmiyor	2,4 2,5		Bir uygulamada reklam öğesini tıkladıktan sonra açılan tarayıcı türünü belirtir. Burada 0 = yerleştirilmiş, 1 = yerel'dir. iOS 9.x cihazlardaki Safari View Controller'ın, bu özellik için yerel bir tarayıcı olarak kabul edildiğini unutmayın.
secure	Hayır	bool	BidRequest .ad_slot .excluded_attribute 48:RichMedia Kapasite	2,3 2,4 2,5		Gösterimin güvenli HTTPS URL'si reklam öğeleri ve işaretleme gerektirip gerektirmediğini belirtir. 0 = güvenli olmayan, 1 = güvenli. Atlanırsa güvenli durum bilinmiyor ancak güvenli olmayan HTTP desteği varsayılabilir.
iframebuster	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		Desteklenen iframe engelleyicilerinin exchange'e özel adları dizisi.
pmp	Hayır	Pmp nesne	BidRequest .AdSlot .EşleşmeReklam Verileri	2,3 2,4 2,5		Bu gösterim için etkin olan tüm özel pazar yeri anlaşmalarını içeren Pmp nesnesi.
native	Hayır	Yerel biçim	BidRequest .AdSlot .NativeAdTemplate	2,3 2,4 2,5		Bir Native nesnesi. Bu gösterim yerel reklam fırsatı olarak sunuluyorsa gereklidir.
exp	Hayır	int32 [int32]	BidRequest .AdSlot .impression_expiration _seconds	2,4 2,5		Açık artırma ve gerçek gösterim arasında geçen saniye sayısıyla ilgili uyarı.
metric	Hayır	Metric nesne dizisi	BidRequest .AdSlot .viewability BidRequest .AdSlot .click_through _rate BidRequest .AdSlot .video_complete _rate BidRequest .AdSlot .session_depth.	2.5		Metric nesneden oluşan dizi. AdX, bu alan için şu metrikleri sağlar: click_through_rate, viewability, completion_rate ve session_depth. viewability metriği, OpenRTB metriğinde 0,00 ile 1,00 arasında bir kesirdir, ancak AdX protokolünde yüzde [0-100] olarak ifade edilir. Bu metriklerin açıklamaları için Gerçek Zamanlı Teklif Verme Kılavuzu'ndaki AdSlot nesne tablosuna bakın. session_depth bir tam sayı değeridir.
ext	Hayır	ImpExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.imp] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için Imp mesajındaki ext alanıyla erişirsiniz.
rwdd	Hayır	bool	BidRequest.AdSlot.is_rewarded	2.6		Kullanıcının reklamı görüntülediği için bir ödül alıp almadığını belirtir. Video reklamlar için tipik uygulamalar, kullanıcıların ek bir haber makalesini ücretsiz olarak okumalarına, oyunlarda ek can bulmalarına veya sponsorlu bir reklamsız müzik oturumu elde etmelerine olanak tanır. Ödül genellikle video reklam tamamlandıktan sonra dağıtılır.

Ekspres

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
billing_id	Evet	int64 dizisi	BidRequest.AdSlot.EşleşenAdData.billing_id	Eşleşen ön hedefleme yapılandırmalarına karşılık gelen faturalandırma kimlikleri.
publisher_settings_list_id	Evet	Sabit 64 dizisi	BidRequest.publisher_settings_list_id BidRequest.AdSlot.publisher_settings_list_id	Bu sayfa için geçerli olan yayıncı ayarları listesi kimliği. Ayrıntılar için GZT Yayıncı Ayarları kılavuzuna bakın.
allowed_vendor_type	Hayır	int32 dizisi	BidRequest.AdSlot.allowed_vendor_type	İzin verilen tedarikçi firma türleri. Kimlik listesi için vendors.txt dosyasını inceleyin.
excluded_creatives	Hayır	ExcludedCreative nesne dizisi	BidRequest.AdSlot.excluded_creatives	Gösterim için izin verilmeyen reklam öğeleri. Bu listedeki reklam öğelerinden biriyle birlikte bir teklif göndermek, bu tür bir teklifin açık artırmadan önce filtrelenmesine neden olur. Bu özelliği etkinleştirmek istiyorsanız hesap yöneticinizle iletişime geçin.
publisher_parameter	Hayır	Dize dizisi	BidRequest.AdSlot.ExchangeBidding.yayıncı_parametresi	Ad Manager kullanıcı arayüzünde eşleşen getiri grubu yapılandırmalarının parçası olarak yayıncı tarafından isteğe bağlı olarak sağlanan UTF8 dizeleri. Biçim rastgeledir ve yayıncı ile Authorized Buyers teklif vereni tarafından kabul edilmelidir.
dfp_ad_unit_code	Hayır	string	BidRequest.AdSlot.dfp_ad_unit_kodu	Ad Manager reklam birimi kodu. Bu, şu anda yalnızca Open Bidding istekleri için ayarlanmıştır.
is_rewarded_inventory	Hayır	bool	BidRequest.AdSlot.ödüllü	Bu alan, BidRequest.imp.rwdd lehine kullanımdan kaldırılmıştır ve Temmuz 2023'te kaldırılacaktır. Bu alan, kullanıcının reklamı görüntülediği için bir ödül alıp almadığını gösterir. Video reklamlar için tipik uygulamalar, kullanıcıların ek bir haber makalesini ücretsiz olarak okumalarına, oyunlarda ek can bulmalarına veya sponsorlu bir reklamsız müzik oturumu elde etmelerine olanak tanır. Ödül genellikle video reklam tamamlandıktan sonra dağıtılır.
is_app_open_ad	Hayır	bool	BidRequest.Mobile.is_app_open_ad	Mobil uygulama teklif isteğinin bir uygulama açılış reklamı için olup olmadığını belirtir. Daha fazla bilgi için Uygulama açılış reklamı kılavuzuna bakın.
ampad	Hayır	Enum AmpAdrequirementType	BidRequest.AdSlot.amp_ad_request_type	AMP reklamları için olası koşul türleri. UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 1; (Varsayılan) AMP reklam koşulları bilinmiyor. AMP_AD_NOT_Allowed = 2; AMP reklamlarına izin verilmez. AMP_AD_Allowed_AND_NOT_EARLY_RENDERED = 3; AMP reklamlarına veya AMP olmayan reklamlara izin verilir; AMP reklamları erken oluşturulmaz. AMP_AD_Allow_AND_EARLY_RENDERED = 4; AMP reklamlarına veya AMP olmayan reklamlara izin verilir, AMP reklamları erken oluşturulur. AMP_AD_REQUIRED = 5; AMP reklamları gereklidir. AMP olmayan reklamlar yayıncı tarafından reddedilebilir.
buyer_generated_request_data	Hayır	BuyerGeneratedRequestData nesne dizisi	BidRequest.AdSlot.güvenli_sinyaller	Yayıncı tarafından iletilen güvenli sinyaller.
billable_event_rate_adjustment	Hayır	double	BidRequest.AdSlot.faturalandırılabilir_etkinlik_rate_adjustment	Yalnızca özel SDK kullanılarak oluşturulan reklamlar için: Açık artırmadaki teklife uygulanan çarpan. Ayarlama, açık artırmanın kazanılmış olması koşuluyla teklifinizin faturalandırılabilir bir etkinlik (örneğin, reklam başarıyla oluşturma) oluşturma olasılığını (diğer tekliflerin açık artırmayı kazandıklarında faturalandırılabilir etkinlik oluşturma olasılığına göre) yansıtır. Bu düzenleme, 1'den büyük veya küçük olabilir. Bu yalnızca açık artırmadaki nihai sıralamayı etkiler. Özellikle, bu çarpan ödemeyi etkilemez. Varsayılan = 1,0.
open_bidding	Hayır	OpenBidding nesne	BidRequest.AdSlot.open_bidding	Open Bidding ile ilgili parametreler.
ad_unit_mapping	Hayır	AdUnitMapping nesne	BidRequest.AdSlot.reklam_birimi_eşleme	Belirtilen reklam alanıyla eşleşen reklam birimi eşlemeleri.
allowed_restricted_category	Hayır	int32 [int32]	BidRequest.AdSlot.allowed_restricted_kategori	İzin verilen kısıtlanmış reklam kategorileri. Kimliklerin listesi için ad-restricted-category.txt adresini inceleyin.
skadn	Hayır	SKAdNetworkRequest nesne	BidRequest.Mobile.skadn	Yayıncının iOS 14 ve üzeri sürümler için uygulama yükleme ilişkilendirmesini destekleyen SKAdNetwork bilgileri Apple'ın SKAdNetwork API'si, reklamverenlerin başarılı bir yüklemenin ardından reklam ağına bir geri gönderme göndererek reklam odaklı uygulama yüklemesini ölçmesine yardımcı olur. Bir yüklemenin reklam gösterimiyle ilişkilendirilmesine izin vermek için yayıncıların, uygulamalarının mülk listesinde (Info.plist) desteklenen reklam ağlarını yapılandırması gerekir. Daha fazla bilgi için Apple'ın dokümanlarına bakın.
Hariç Tutulan Reklam Öğesi
buyer_creative_id	Hayır	string	BidRequest.AdSlot.Hariç Tutulan Reklam Öğesi.buyer_creative_id	İzin verilmeyen reklam öğesinin alıcı reklam öğesi kimliği.
Alıcı Oluşturulan İstek Verileri
data	Hayır	string	BidRequest.AdSlot.SecureSignal.data	Güvenli sinyal.
source_app	Hayır	KaynakUygulama	BidRequest.AdSlot.SecureSignal.source	Verilerin kaynağı.
KaynakUygulama
id	Hayır	string	BidRequest.AdSlot.SecureSignal.source	Bu verileri oluşturan SDK'nın tanımlayıcısı. Bu kimlik, BidRequest.AppExt.InstalledSdk.id içindeki kimlikle eşleşecektir.
OpenBidding
is_open_bidding	Hayır	bool	BidRequest.AdSlot.OpenBidding.is_open_bidding	Yayıncı bu reklam alanını ve bu teklif vereni hedefleyen bir getiri grubu veya uyumlulaştırma grubu oluşturduysa bu alan doğru değerine ayarlanır. Open Bidding ve teklif verme sürecindeki etkileri hakkında bilgi edinmek için Yardım Merkezimizi ziyaret edin.
Reklam Birimi Eşleme
Keyval	Hayır	Keyval nesne	BidRequest.AdSlot.AdUnitMapping.temel	Teklif verenin ad alanındaki envanter birimini belirtmek için kullanılan anahtar/değer çifti.
FormatType	Hayır	enum	BidRequest.AdSlot.AdUnitMapping.format_type	Eşleme için kullanılabilecek olası reklam birimi biçimleri. SDK'da kullanılacak adaptöre karşılık gelir. Olası değerler: FORMAT_UNKNOWN = 0; Web veya mobil uygulamalar için görüntülü banner reklamlar. Örneğin, 320x50 leaderboard alanı. Buna, yayın dışı video dahildir. FORMAT_BANNER = 1; Bir mobil uygulamanın içinde görüntülenecek tam ekran reklam. FORMAT_INTERSTITIAL = 2; Web uygulamaları veya mobil uygulamalar için, yerleştirildikleri sitenin veya uygulamanın kullanıcı deneyimiyle uyumlu olan özel görüntülü ya da video reklamlar. FORMAT_NATIVE = 3; Video içerik akışından önce, içerik akışı sırasında veya içerik akışından sonra görünen video reklamlar. FORMAT_VIDEO_VAST = 4; Kullanıcıların uygulama içi ödül kazanmak amacıyla exchange'de gönüllü olarak reklam izlemesini sağlayan, mobil uygulamalar için video reklamlar. FORMAT_REWARDED = 5; Kullanıcıların uygulama içi ödül karşılığında bir reklam izlemesine olanak tanıyan geçiş reklamları Etkinleştirilmesi zorunlu değildir. https://support.google.com/admanager/answer/7386053 FORMAT_REWARDED_INTERSTITIAL = 6; Uygulama açılış reklamları, uygulama yükleme ekranlarında gösterilir. Uygulama açılış reklamları, istediğiniz zaman kapatılabilir ve kullanıcılar uygulamayı ön plana aldığında gösterilecek şekilde tasarlanmıştır. FORMAT_APP_OPEN = 7;
SKAdNetworkİstek
versions	Hayır	Dize dizisi	BidRequest.Mobile.skadn.versions	OS sürümüne ve SDK sürümüne bağlı olarak istek tarafından desteklenen tüm SKAdNetwork sürümlerinin listesi.
sourceapp	Hayır	string	BidRequest.Mobile.skadn.sourceapp	Apple App Store'daki yayıncı uygulamasının kimliği.
skadnetids	Hayır	Dize dizisi	BidRequest.Mobile.skadn.skadnetids	Yayıncı uygulamasının Info.plist dosyasındaki SKAdNetworkIdentifier girişleri.
fidelities	Hayır	SKAdNetworkFidelityType nesne dizisi	BidRequest.Mobile.skadn.supported_fidelity_types	İşletim sistemi ve SDK tarafından desteklenen SKAdNetwork API sürümüne ve reklam alanı özelliklerine bağlı olarak desteklenen doğruluk türlerinin listesi.
skoverlay	Hayır	bool	BidRequest.Mobile.skadn.skoverlay	Bu isteğin video reklamlar için SKOverlay'yi destekleyip desteklemediğini belirtir.

Keyval nesnesi

Üst öğe

Envanter birimi alanı hiyerarşik olan ve birden fazla tanımlayıcısı olan teklif verenleri desteklemek için birden fazla anahtar/değer çifti belirtilebilir. Seçilen AdUnitMapping için anahtar/değer çiftleri, teklif yanıtında BidResponse.seatbid.bid.ext.sdk_rendered_ad.sdk_params olarak geri gönderilmelidir. Bu, teklif verenin SDK'sına iletilir.

Özellik	Type	Her zaman başarılı	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
key	string	Hayır	BidRequest.AdSlot.AdUnitMapping.keyval.key	Anahtar, teklif verenin SDK için envanter birimi tanımlayıcısının adıdır.
value	string	Hayır	BidRequest.AdSlot.AdUnitMapping.keyval.value	Belirli bir biçim için teklif verenin envanter birimi tanımlayıcısının değeri.

Metrik

Bu nesne, bir gösterim dizisi olarak bir gösterimle ilişkilendirilir. Bu metrikler, karar vermenize yardımcı olmak için ortalama yakın zamanda görüntülenebilirlik, tıklama oranı gibi gösterimle ilgili bilgiler sunabilir. Her metrik, türüne göre tanımlanır, metriğin değerini raporlar ve isteğe bağlı olarak değeri ölçen kaynağı veya tedarikçiyi tanımlar.

Özellik	Her zaman başarılı	Type	Yetkili Alıcılar eşdeğeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
type	Hayır	string	Şunlardan biri: BidRequest .AdSlot .viewability BidRequest .AdSlot .click_ through_rate BidRequest .AdSlot .video_ complete_rate BidRequest .AdSlot .session_depth.	2.5		Önceden teklif verenlere yayınlanması gereken exchange tarafından seçilen dize adları kullanılarak sunulan metriğin türü. OpenRTB spesifikasyonu tarafından gerekli. Desteklediğimiz türler şunlardır: click_through_rate, viewability, completion_rate ve session_depth.
value	Hayır	double	0 ile 1 arasında değer.	2.5		Metriğin değerini temsil eden sayı. Olasılıklar 0,00 – 1,00 aralığında olmalıdır. OpenRTB spesifikasyonu tarafından GEREKLİ. viewability metriği, OpenRTB metriğinde 0,00 ile 1,00 arasında bir kesirdir, ancak AdX protokolünde yüzde [0-100] olarak ifade edilir.
vendor	Hayır	string	DEĞİŞTİR	2.5		Exchange'ler tarafından seçilen dize adlarını kullanan ve bu değer teklifi verenlere öncelikle yayınlanması gereken değerin kaynağı. Exchange'in kendisi bir üçüncü ve üçüncü tarafsa "EXCHANGE" önerilir. OpenRTB spesifikasyonu tarafından ÖNERİLİR.

Banner

Bu nesne, en genel gösterim türünü temsil eder. "Banner" terimi diğer bağlamlarda çok spesifik bir anlama sahip olabilir. Ancak basit bir statik resim, genişletilebilir reklam birimi, hatta banner içi video dahil olmak üzere birçok farklı anlama gelebilir (daha genel ve tam özellikli video reklam birimleri için Video nesnesine bakın). VAST spesifikasyonunda tanımlanan isteğe bağlı tamamlayıcı reklamları açıklamak için Video'da bir dizi Banner nesnesi de gösterilebilir.

Imp nesnesinin alt öğesi olarak Banner bulunması, bu gösterimin banner türü bir gösterim olarak sunulduğunu belirtir. Yayıncının onayıyla, aynı gösterim sırasıyla Video ve/veya Native nesnelerini Imp olarak dahil ederek video ve/veya yerel olarak sunulabilir. Bununla birlikte, gösterim için herhangi bir teklif, sunulan türlerden birine uygun olmalıdır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
w	Hayır	int32 [int32]	BidRequest.AdSlot.width[0] (Yalnızca İngilizce)	2,3 2,4 2,5		Cihazdan bağımsız piksel cinsinden genişlik (DIPS). Hiçbir Format nesnesi belirtilmezse bu tam olarak bir genişlik gereksinimidir. Aksi takdirde tercih edilen genişliktir.
h	Hayır	int32 [int32]	BidRequest.AdSlot.height[0]	2,3 2,4 2,5		Cihazdan bağımsız piksel (DIPS) yüksekliği. Herhangi bir Format nesnesi belirtilmezse bu tam bir yükseklik koşuludur. Aksi takdirde tercih edilen yüksekliktir.
format	Hayır	Format nesne dizisi	Desteklenmiyor	2,4 2,5		İzin verilen banner boyutlarını temsil eden Format nesnesi dizisi. Hiçbir özellik belirtilmezse h ve w özelliklerinin kullanılması önemle tavsiye edilir.
id	Hayır	string	BidRequest.AdSlot.id değeri	2,3 2,4 2,5		Bu Banner nesnesinin benzersiz tanımlayıcısı. Banner nesneleri, bir tamamlayıcı reklam dizisini temsil etmek için bir Video nesnesiyle kullanıldığında önerilir. Değerler genellikle 1 ile başlar ve her nesne ile artar; bir gösterim içinde benzersiz olmalıdır.
pos	Hayır	Enum Reklam Konumu	BidRequest.AdSlot.slot_visible BidRequest.StickySettings	2,3 2,4 2,5		Bu OpenRTB tablosunda, IAB Kalite Güvencesi Kurallarından (QAG) türetilen değerler vardır. Uygulayıcılar, KGG değerlerinde yapılan güncellemeleri IAB.net'te yayınlandıkları şekilde senkronize etmelidir. "4" ila "7" değerleri, QAG'nin 1.5 sürümü mobil ekine göre uygulamalar için geçerlidir. Banner.pos yalnızca bir değeri destekler. is_sticky ise Banner.pos yapışkanlıkla doldurulur. unknown_stickiness ise slot_visibility kullanılır. Yapışkanlık, banner'ın her zaman ekranda olduğunu gösterirken ekranın üst veya alt kısmındaki görünürlük, kullanıcı sayfayı kaydırdıkça değişebilir. Aşağıdaki değerlerden biri olabilir: ABOVE_THE_FOLD = 1; BELOW_THE_FOLD = 3; HEADER = 4; Authorized Buyers GZT protokolünde sticky_settings.top_horizontal_stickiness ile eşdeğerdir. FOOTER = 5; Authorized Buyers GZT protokolünde sticky_settings.bottom_horizontal_stickiness ile eşdeğerdir. SIDEBAR = 6; Authorized Buyers GZT protokolünde sticky_settings.vertical_stickiness ile eşdeğerdir.
btype	Hayır	Enum BannerAdType dizisi	Desteklenmiyor	2.5		Engellenen banner reklam türleri Örnekler: XHTML_TEXT_AD = 1; // "Genellikle mobil". XHTML_BANNER_AD = 2; // "Genellikle mobil". JAVASCRIPT_AD = 3; // JavaScript geçerli bir xhtml olmalıdır IFRAME = 4; // Iframe.
battr	Hayır	CreativeAttribute enum dizisi	BidRequest.AdSlot.excluded_attribute	2,3 2,4 2,5		Engellenen reklam öğesi özellikleri. Örnekler: AUDIO_AUTO_PLAY = 1; AUDIO_USER_INITIATED = 2;
mimes	Hayır	Dize dizisi	Yalnızca BidRequest.Video.companionad: için eşlenmiştir: BidRequest.Video.companionad.creative_format BidRequest.AdSlot.excluded_attribute / VPAID	2,3 2,4 2,5		Desteklenen içerik MIME türlerinin izin verilenler listesi. Popüler MIME türleri "image/jpg", "image/gif" ve"application/x-shockwave-flash"ı içerir ancak bunlarla sınırlı değildir.
topframe	Hayır	bool	BidRequest.AdSlot.iframe_state NO_IFRAME: yanlış SAME_DOMAIN_IFRAME, CROSS_DOMAIN_IFRAME: true	2,3 2,4 2,5		Banner'ın üst çerçevede mi (true) yoksa bir iframe'de mi (false) yayınlanacağını belirtin.
expdir	Hayır	ExpandableDirection enum dizisi	BidRequest.AdSlot.excluded_attribute / EXPANDING_*	2,3 2,4 2,5		Banner'ın genişleyebileceği yönler.
api	Hayır	APIFramework nesne dizisi	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2,3 2,4 2,5		Bu gösterim için desteklenen API çerçevelerinin listesi. Bir API açık bir şekilde listelenmemişse, desteklenmediği varsayılır.
vcm	Hayır	bool	BidRequest.Video.end_cap_support	2.5		Yalnızca bir tamamlayıcı reklamlar dizisindeki video nesnesiyle kullanılan banner nesneleri için geçerlidir. İlişkilendirilmiş videoya göre tamamlayıcı banner oluşturma modunu gösterir. Burada 0 = eşzamanlı, 1 = bitiş kartıdır. Şu anda yalnızca mobil uygulama geçiş reklamlarında bitiş kartları desteklenmektedir.
wmax	Hayır	int32 [int32]	BidRequest.AdSlot.flexible_ad_slot_settings.max_width	2,3 2,4 2,5		Gösterimin piksel cinsinden maksimum genişliği.
hmax	Hayır	int32 [int32]	BidRequest.AdSlot.flexible_ad_slot_settings.max_height	2,3 2,4 2,5		Gösterimin piksel cinsinden maksimum yüksekliği.
wmin	Hayır	int32 [int32]	BidRequest.AdSlot.flexible_ad_slot_settings.min_width	2,3 2,4 2,5		Gösterimin piksel cinsinden minimum genişliği.
hmin	Hayır	int32 [int32]	BidRequest.AdSlot.flexible_ad_slot_settings.min_height	2,3 2,4 2,5		Gösterimin piksel cinsinden minimum yüksekliği.

Biçim

Bu nesne, bir banner gösterimi için izin verilen bir boyutu (yükseklik ve genişlik kombinasyonu) temsil eder. Bunlar genellikle birden fazla boyuta izin verilen bir gösterim için dizide kullanılır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
w	Hayır	int32 [int32]	BidRequest.AdSlot.genişliği	2,4 2,5		Cihazdan bağımsız piksel cinsinden genişlik (DIPS).
h	Hayır	int32 [int32]	BidRequest.AdSlot.height	2,4 2,5		Cihazdan bağımsız piksel (DIPS) yüksekliği.
wratio	Hayır	int32 [int32]	Desteklenmiyor	2.5		Boyut, oran olarak ifade edilirken göreli genişlik.
hratio	Hayır	int32 [int32]	Desteklenmiyor	2.5		Boyut, oran olarak ifade edilirken göreli yükseklik.
wmin	Hayır	int32 [int32]	Desteklenmiyor	2.5		Boyut bir oran olarak ifade edildiğinde reklamın gösterileceği cihazdan bağımsız piksellerde (DIPS) minimum genişlik.

Video

Bu nesne, bir yayın içi video gösterimini temsil eder. Alanların çoğu, minimum düzeyde uygulanabilir işlemler için gerekli değildir ancak gerektiğinde hassas kontrol sağlamak için dahil edilir. OpenRTB'deki video, genellikle VAST standardına uygundur. Bu nedenle, tamamlayıcı reklam kavramı isteğe bağlı olarak bu tamamlayıcı reklamları tanımlayan bir dizi Banner nesnesi eklenerek desteklenir.

Imp nesnesinin bir alt öğesi olarak Video bulunması, bu gösterimin video türü gösterim olarak sunulduğunu belirtir. Yayıncının takdirine bağlı olarak aynı gösterim, sırasıyla Banner ve/veya Native nesnelerini Imp olarak dahil ederek banner ve/veya yerel olarak sunulabilir. Bununla birlikte, gösterim için herhangi bir teklif, sunulan türlerden birine uygun olmalıdır.

Daha fazla ayrıntı için OpenRTB Video Reklamlar kılavuzuna bakın.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Sürüm	Google tarafından desteklenir	Uygulama ayrıntıları
mimes	Evet	Dize dizisi	BidRequest.Video.allowed_video_formats, BidRequest.AdSlot.excluded_attribute / VPAID	2,3 2,4 2,5		Desteklenen içerik MIME türlerinin izin verilenler listesi. Popüler MIME türleri "image/jpg", "image/gif" ve "application/x-shockwave-flash"ı içerir ancak bunlarla sınırlı değildir. OpenRTB spesifikasyonu tarafından gerekli: en az 1 öğe.
linearity	Hayır	int32 [int32]		2,3 2,4 2,5		Gösterimin doğrusal, doğrusal olmayan vb. olup olmadığını gösterir. Belirtilmezse tümüne izin verildiğini varsayar. LINEAR = 1: Doğrusal/Yayın içi NON_LINEAR = 2: Doğrusal olmayan/Yer paylaşımlı
minduration	Hayır	int32 [int32]	BidRequest.Video.min_ad_duration	2,3 2,4 2,5		Saniye cinsinden minimum video reklam süresi. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
maxduration	Hayır	int32 [int32]	BidRequest.Video.max_ad_duration	2,3 2,4 2,5		Saniye cinsinden maksimum video reklam süresi. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
protocols	Hayır	Protocol nesne dizisi	BidRequest.Video.protokolleri	2,3 2,4 2,5		Desteklenen video teklif yanıtı protokolleri dizisi. En az bir desteklenen protokol belirtilmelidir. Örnekler: VAST_1_0 = 1; VAST_2_0 = 2; VAST_3_0 = 3;
w	Hayır	int32 [int32]	BidRequest.AdSlot.width[0] (Yalnızca İngilizce)	2,3 2,4 2,5		Video oynatıcının cihazdan bağımsız piksel cinsinden genişliği (DIPS). OpenRTB spesifikasyonu tarafından ÖNERİLİR.
h	Hayır	int32 [int32]	BidRequest.AdSlot.height[0]	2,3 2,4 2,5		Cihazdan bağımsız piksel (DIPS) cinsinden video oynatıcının yüksekliği. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
startdelay	Hayır	int32 [int32]	BidRequest.Video.videoad_start_delay >0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL Diğer değerler: videoad_start_delay / 1.000	2,3 2,4 2,5		Videodan önce, videonun ortasında veya videodan sonra gösterilen reklam yerleşimleri için başlangıç süresini saniye cinsinden belirtir. Genel değerler için enum StartDelay öğesine bakın. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
skip	Hayır	bool	BidRequest.Video.video_ad_atlanabilir	2,4 2,5		Oynatıcının videonun atlanmasına izin verip vermeyeceğini / burada 0 = hayır, 1 = evet değerini belirtir. Bir teklif veren, kendi atlanabilir atlanabilir işaretleme/reklam öğeleri gönderirse Bid nesnesi, atlanabilir videoyu belirten 16 öğesine sahip Attr dizisini içermelidir.
skipmin	Hayır	int32 [int32]	Desteklenmiyor	2,4 2,5		Toplam süresi bu sayıdan fazla olan videolar atlanabilir. Yalnızca reklam atlanabilir olduğunda geçerlidir.
skipafter	Hayır	int32 [int32]	Desteklenmiyor	2,4 2,5		Atlamanın etkinleştirilmeden önce bir videonun oynatılması gereken saniye sayısı. Yalnızca reklam atlanabilir olduğunda geçerlidir.
sequence	Hayır	int32 [int32]	Desteklenmiyor	2,3 2,4 2,5		Aynı teklif isteğinde birden fazla reklam gösterimi sunuluyorsa sıra numarası, birden fazla reklam öğesinin koordineli olarak yayınlanmasına olanak tanır.[varsayılan = 1];
battr	Hayır	Reklam Öğesiözelliği	BidRequest.AdSlot.excluded_attribute	2,3 2,4 2,5		Engellenen reklam öğesi özellikleri.
maxextended	Hayır	int32 [int32]	Desteklenmiyor	2,3 2,4 2,5		Uzatılmışsa izin verilen maksimum genişletilmiş video reklam süresi. Boş veya 0 ise uzantıya izin verilmez. -1 değeri belirlenirse uzantıya izin verilir ve herhangi bir zaman sınırı uygulanmaz. Değer 0'dan büyükse maksimum süre değerinin ötesinde desteklenen genişletilmiş oynatma saniye sayısını temsil eder.
minbitrate	Hayır	int32 [int32]	Desteklenmiyor	2,3 2,4 2,5		Kb/sn cinsinden minimum bit hızı.
maxbitrate	Hayır	int32 [int32]	Desteklenmiyor	2,3 2,4 2,5		Kb/sn cinsinden maksimum bit hızı.
boxingallowed	Hayır	bool	Desteklenmiyor	2,3 2,4 2,5		16:9 pencereye 4:3 oranında sinemaskopik içeriklere izin verilip verilmediğini gösterir. Burada 0 = hayır, 1 = evet'tir. varsayılan = doğru
playbackmethod	Hayır	Oynatma Yöntemi dizisi	BidRequest.Video.playback_method AdX: VideoOynatma Yöntemi.AUTO_PLAY_Ses_ON VideoOynatma Yöntemi.AUTO_PLAY_Ses_OFF VideoOynatma Yöntemi.click_TO_PLAY VideoOynatma Yöntemi.MOUSE_OVER VideoOynatma Yöntemi.ENTER_Ses_ON VideoOynatma Yöntemi.ENTER_Ses_OFF	2,3 2,4 2,5		Kullanımda olabilecek oynatma yöntemleri. Herhangi bir yöntem belirtilmezse herhangi bir yöntem kullanılabilir. Pratikte genellikle yalnızca bir yöntem kullanılır. Sonuç olarak bu dizi, spesifikasyonun gelecekteki bir sürümünde tam sayıya dönüştürülebilir. Bu değişikliğe hazırlık için bu dizinin yalnızca ilk öğesini kullanmanız önemle tavsiye edilir. AUTO_PLAY_SOUND_ON = 1: Ses Açık olarak Sayfa Yükleme'de başlar. AUTO_PLAY_SOUND_OFF = 2: Varsayılan olarak Ses Devre Dışıyken Sayfa Yükleme'de başlar. CLICK_TO_PLAY = 3: Ses açıkken Tıklama'yı başlatır. MOUSE_OVER = 4: Ses Açık olarak Fareyle Üzerine gelindiğinde başlatılır. ENTER_SOUND_ON = 5: Ses Açık Olarak Görüntü Alanına Girme Başlatır. ENTER_SOUND_OFF = 6: Varsayılan Olarak Ses Devre Dışı Bırakılarak Görüntü Alanına Girilmeye Başlanır.
delivery	Hayır	ContentDelivery Method dizisi	Desteklenmiyor	2,3 2,4 2,5		Desteklenen yayın yöntemleri (ör. akış, progresif). Hiçbir ayar belirtilmezse tüm alanların desteklendiği varsayılır. YAYIN = 1; İLERLEME = 2;
pos	Hayır	AdPosition	BidRequest.AdSlot.slot_görünürlük	2,3 2,4 2,5		Reklam konumu ekranda.
companionad	Hayır	Banner nesne dizisi	BidRequest.Video.companion_slot	2,3 2,4 2,5		Tamamlayıcı reklamlar varsa Banner nesneleri dizisi.
api	Hayır	APIFramework nesne dizisi	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2,3 2,4 2,5		Bu gösterim için desteklenen API çerçevelerinin listesi. Açıkça listelenmeyen bir API'nin desteklenmediği varsayılır.
companiontype	Hayır	CompanionType nesne dizisi	BidRequest.Video.companion_slot.creative_format	2,3 2,4 2,5		Desteklenen VAST tamamlayıcı reklam türleri. Tamamlayıcı Banner nesneleri companionad dizisi üzerinden dahil edilirse önerilir.
placement	Hayır	VideoPlacementType	BidRequest.Video.Yerleşim INSTREAM -> IN_STREAM_PLACEMENT INTERSTITIAL -> FLOATING_PLACEMENT IN_FEED -> IN_FEED_PLACEMENT IN_ARTICLE -> IN_ARTICLE_PLACEMENT UNKNOWN_PLACEMENT -> UNDEFINED_VIDEO_PLACEMENT AUDIO -> UNDEFINED_VIDEO_PLACEMENT (ayarlanmadı) -> IN_BANNER_PLACEMENT	2.5		Gösterimin yerleşim türü. UNDEFINED_VIDEO_PLACEMENT: Video yerleşimi tanımlanmamıştır. Varsayılan değer. IN_STREAM_PLACEMENT: Tüketicinin istediği video yayını öncesinde, sırasında veya sonrasında oynatılır. Örneğin, videodan önce gösterilen reklam, videonun ortasında gösterilen reklam, videodan sonra gösterilen reklam. IN_BANNER_PLACEMENT: Başka bir statik veya rich media biçimi yerine video deneyimi sunmak için banner alanından yararlanan bir web banner'ında bulunur. Bu reklam biçiminin yayınlanması için sayfada görüntülü reklam envanterinin varlığına bağlıdır. IN_ARTICLE_PLACEMENT: Markalı bağımsız bir mesaj olarak kullanılabilen editoryal içeriğin paragrafları arasında dinamik olarak yüklenir ve oynatılır. IN_FEED_PLACEMENT: Feed içi: İçerik, sosyal medya veya ürün feed'lerinde bulunur. FLOATING_PLACEMENT: Geçiş reklamı/Kaydırma çubuğu. Ekran alanının tamamını veya bir kısmını kaplar ancak görüntülenirken her zaman ekranda kalır (örneğin, görüntüden dışarı kaydırılamaz). Tam ekran geçiş reklamının (örneğin, mobil cihazlarda) imp.instl alanı tarafından kayan/kaydırma biriminden ayırt edilebileceğini unutmayın.
playbackend	Hayır	PlaybackCessationMode	Desteklenmiyor	2.5		Oynatmanın sona ermesine neden olan etkinlik.

Ses

Bu nesne, bir ses türü gösterimini temsil ediyor. Alanların çoğu, minimum düzeyde uygulanabilir işlemler için gerekli değildir ancak gerektiğinde hassas bir kontrol imkanı sunar. OpenRTB'deki ses genellikle DAAST standardına uygundur. Bu nedenle, tamamlayıcı reklam kavramı isteğe bağlı olarak bu tamamlayıcı reklamları tanımlayan bir dizi Banner nesnesi eklenerek desteklenir. Imp nesnesinin bir alt öğesi olarak Audio nesnesinin varlığı, bu gösterimin bir ses türü gösterimi olarak sunulduğunu belirtir. Yayıncının takdirine bağlı olarak aynı gösterim; bu tür nesneleri Imp alt öğesi olarak ekleyerek banner, video ve/veya yerel olarak sunulabilir. Bununla birlikte, gösterim için herhangi bir teklif, sunulan türlerden birine uygun olmalıdır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
mimes	Hayır	Dize dizisi	BidRequest.Video.allowed_video_formats, BidBid.AdSlot.excluded_attribute / VPAID	2,4 2,5		Desteklenen içerik MIME türleri (ör. "audio/mp4") OpenRTB spesifikasyonu tarafından gerekli: en az 1 öğe.
minduration	Hayır	int32 [int32]	BidRequest.Video.min_ad_duration	2,4 2,5		Saniye cinsinden minimum video reklam süresi. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
maxduration	Hayır	int32 [int32]	BidRequest.Video.max_ad_duration	2,4 2,5		Saniye cinsinden maksimum video reklam süresi. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
protocols	Hayır	Protocol nesne dizisi	BidRequest.Video.protokolleri	2,4 2,5		Desteklenen video teklif yanıtı protokolleri dizisi. En az bir desteklenen protokol belirtilmelidir. Örnekler: DAAST_1_0 = 9; DAAST_1_0_WRAPPER = 10;
startdelay	Hayır	int32 [int32]	BidRequest.Video.videoad_start_delay >0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL Diğer değerler: videoad_start_delay / 1.000	2,4 2,5		Videodan önce, videonun ortasında veya videodan sonra gösterilen reklam yerleşimleri için başlangıç süresini saniye cinsinden belirtir. Genel değerler için enum StartDelay öğesine bakın. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
sequence	Hayır	int32 [int32]	Desteklenmiyor	2,4 2,5		Aynı teklif isteğinde birden fazla reklam gösterimi sunuluyorsa sıra numarası, birden fazla reklam öğesinin koordineli olarak yayınlanmasına olanak tanır.[varsayılan = 1];
battr	Hayır	CreativeAttribute nesne dizisi	BidRequest.AdSlot.excluded_attribute	2,4 2,5		Engellenen reklam öğesi özellikleri.
maxextended	Hayır	int32 [int32]	Desteklenmiyor	2,4 2,5		Uzatılmışsa izin verilen maksimum genişletilmiş video reklam süresi. Boş veya 0 ise uzantıya izin verilmez. -1 değeri belirlenirse uzantıya izin verilir ve herhangi bir zaman sınırı uygulanmaz. Bu değer 0'dan büyükse maxduration değerinin ötesinde desteklenen genişletilmiş oynatma saniye sayısını temsil eder.
minbitrate	Hayır	int32 [int32]	Desteklenmiyor	2,4 2,5		Kb/sn cinsinden minimum bit hızı.
maxbitrate	Hayır	int32 [int32]	Desteklenmiyor	2,4 2,5		Kb/sn cinsinden maksimum bit hızı.
delivery	Hayır	ContentDeliveryMethod nesne dizisi	Desteklenmiyor	2,4 2,5		Desteklenen yayın yöntemleri (ör. akış, progresif). Hiçbir ayar belirtilmezse tüm alanların desteklendiği varsayılır. AKIŞ = 1; DEVAM = 2;
companionad	Hayır	Banner nesne dizisi	BidRequest.Video.companion_slot	2,4 2,5		Tamamlayıcı reklamlar varsa Banner nesneleri dizisi.
api	Hayır	APIFramework nesne dizisi	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2,4 2,5		Bu gösterim için desteklenen API çerçevelerinin listesi. Açıkça listelenmeyen bir API'nin desteklenmediği varsayılır.
companiontype	Hayır	CompanionType nesne dizisi	BidRequest.Video.companion_slot.creative_format	2,4 2,5		Desteklenen DAAST tamamlayıcı reklam türleri.
maxseq	Hayır	int32 [int32]	Desteklenmiyor	2,4 2,5		Reklam kapsülünde oynatılabilecek maksimum reklam sayısı.
feed	Hayır	FeedTürü	Desteklenmiyor	2,4 2,5		Ses feed'inin türü.
stitched	Hayır	bool	Desteklenmiyor	2,4 2,5		Reklamın ses içeriğiyle birleştirilip birleştirilmediğini veya bağımsız olarak mı yayınlandığını (0 = hayır, 1 = evet) belirtir.
nvol	Hayır	VolumeNormalizationMode	Desteklenmiyor	2,4 2,5		Ses normalleştirme modu.

Yerel biçim

Bu nesne, yerel türde bir gösterimi temsil eder. Yerel reklam birimleri, çevresindeki içerikle (ör. sponsorlu bir Twitter veya Facebook yayını) sorunsuz bir şekilde birleştirilmek üzere tasarlanmıştır. Bu nedenle, yayıncının, oluşturma üzerinde hassas bir kontrole sahip olması için yanıtın iyi yapılandırılmış olması gerekir.

Yerel 1.1'in OpenRTB 2.4 ve OpenRTB 2.5'te desteklendiğini unutmayın.

Yerel Alt Komite, OpenRTB için Yerel Reklam Spesifikasyonu adı verilen bir tamamlayıcı spesifikasyon geliştirdi. Yerel reklam birimlerinin istek parametrelerini ve yanıt işaretleme yapısını tanımlar.

Bu nesne, istek parametrelerinin opak dize olarak taşınmasını sağlar. Böylece belirli parametreler Yerel Reklam Spesifikasyonu'nun dışında ayrı olarak gelişebilir. Benzer şekilde, sunulan reklam işaretlemesi de bu spesifikasyona göre yapılandırılır. Imp nesnesinin alt öğesi olarak Native bulunması, bu gösterimin yerel türde bir gösterim olarak sunulduğunu belirtir. Yayıncının onayında, aynı gösterim sırasıyla Banner ve/veya Video nesnelerini Imp olarak dahil ederek banner ve/veya video olarak da sunulabilir. Bununla birlikte, gösterim için herhangi bir teklif, sunulan türlerden birine uygun olmalıdır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
request	Hayır	string	BidRequest.AdSlot.NativeAdŞablonu	2,3 2,4 2,5		Yerel Reklam Spesifikasyonuyla uyumlu istek yükü. Tam olarak {request, request_native} kullanılmalıdır.
request_native	Hayır	Doğal İstek	BidRequest.AdSlot.NativeAdŞablonu	2,3 2,4 2,5		Yerel Reklam Spesifikasyonuyla uyumlu istek yükü. Tam olarak {request, request_native} ürünlerinden biri kullanılmalıdır. Bu, Protobuf serileştirme için tercih edilen alternatif bir alandır.
ver	Hayır	string	OpenRTB spesifikasyonu tarafından ÖNERİLİR.	2,3 2,4 2,5		İsteğin uyumlu olduğu Yerel Reklam Spesifikasyonu. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
api		APIFramework nesne dizisi	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2,3 2,4 2,5		Bu gösterim için desteklenen API çerçevelerinin listesi. Açıkça listelenmeyen bir API'nin desteklenmediği varsayılır.
battr		CreativeAttribute nesne dizisi	BidRequest.AdSlot.excluded_attribute	2,3 2,4 2,5		Engellenen reklam öğesi özellikleri.

Pmp

Bu nesne, alıcılar ve satıcılar arasında bu gösterimle ilgili olabilecek doğrudan anlaşmalar için özel pazar yeri kapsayıcısıdır. Gerçek anlaşmalar, Deal nesneleri koleksiyonuyla temsil edilir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
private_auction	Hayır	bool	BidRequest.AdSlot.only_deal_bids_kabul edildi	2,3 2,4 2,5		Doğrudan Teklifler nesnesinde belirtilen koltuklar için açık artırma uygunluğunun göstergesi. Bu durumda 0 = tüm teklifler kabul edilir, 1 = teklifler belirtilen anlaşmalar ve bunların şartlarıyla sınırlıdır.
deals	Hayır	Deal nesne dizisi	BidRequest.AdSlot.EşleşenAdData.DirectDeal	2,3 2,4 2,5		Bu gösterim için geçerli olan belirli anlaşmaları ileten Deal nesne dizisi.

Fırsat

Bu nesne, alıcı ile satıcı arasında öncelikli olan belirli bir anlaşmayı temsil eder. Pmp koleksiyonuyla varlığı, bu gösterimin söz konusu anlaşmanın şartlarına göre kullanılabilir olduğunu gösterir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Evet	string	BidRequest.AdSlot.EşleşenAdData.DirectDeal.direct_deal_id	2,3 2,4 2,5		Doğrudan sunulan anlaşmanın benzersiz tanımlayıcısı. OpenRTB spesifikasyonu tarafından GEREKLİ.
bidfloor	Hayır	double	BidRequest.AdSlot.EşleşenAdData.DirectDeal.fixed_cpm _micros *1.000.000	2,3 2,4 2,5		Bu gösterim için BGBM olarak belirtilen minimum teklif.
bidfloorcur	Hayır	string	dahil edilen billing_id para biriminden alınan tek bir para birimi	2,3 2,4 2,5		ISO-4217 alfa kodları kullanılarak belirtilen para birimi. Exchange.default = "USD" tarafından izin veriliyorsa bu, teklif veren tarafından döndürülen teklif para biriminden farklı olabilir
wseat	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		Alıcı anlaşmalarının (örneğin, reklamverenler, ajanslar) bu anlaşma için teklif vermesine izin verilen izin verilenler listesi. Lisansların kimliği ve alıcının bilgileri yönlendirdikleri müşterilerin teklif verenlerle exchange arasında koordineli olarak çalışması gerekir. Eksiklik, koltuk kısıtlaması olmadığını gösterir.
wadomain	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		Bu anlaşma için teklif vermesine izin verilen reklamveren alan adları dizisi (örneğin, reklamveren.com). Atlama, herhangi bir reklamveren kısıtlaması olmadığı anlamına gelir.
at	Hayır	Açık Artırma Türü	BidRequest.auction_type	2,3 2,4 2,5		Teklif isteğinin genel açık artırma türünün geçersiz kılınmasını sağlar. Burada 1 = İlk Fiyat, 2 = İkinci Fiyat Plus, 3 = teklif tabanında iletilen değer, üzerinde anlaşılan anlaşma fiyatıdır. Exchange tarafından ek açık artırma türleri tanımlanabilir.
ext	Hayır	DealExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.deal] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için Anlaşma mesajındaki ext alanıyla erişirsiniz.

Fırsat Ekstresi

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
deal_type	Hayır	Enum DealType	BidRequest.AdSlot.Eşleşen Reklam Verileri.DirectDeal.deal_type	Anlaşmanın türü. Authorized Buyers politikasını geçersiz kılma işlemlerinin tüm Programatik Garantili ve Tercih Edilen Anlaşma teklifleri için geçerli olduğunu ve diğer anlaşma türlerinin teklifleri için geçerli olmadığını unutmayın. UNKNOWN_DEAL_TYPE = 0; Varsayılan. PREFERRED_DEAL = 1; Teklifler sabit fiyatla sunulur ve Herkesin Katılabileceği Açık Artırmadan önce değerlendirilir. Teklif isteğinde bulunan teklif verenlerin, Tercih Edilen Anlaşmalar ile teklif vermesi gerekmez. Daha fazla bilgi için bu makaleye bakın. PRIVATE_AUCTION = 2; Teklifler, belirli tabanlara sahip belirli bir alıcı listesine göre bir Özel Açık Artırmaya katılır. Daha fazla bilgi için bu makaleye bakın. PROGRAMMATIC_GUARANTEED = 3; Teklifler sabit fiyatla sunulur ve Herkesin Katılabileceği Açık Artırmadan önce değerlendirilir. Teklif verenlerin, teklif isteğinde mevcut olduklarında Programatik Garantili anlaşmalarla teklif vermeleri beklenir. Belirli bir anlaşma için kabul edilen gösterim sayısının sunulduğundan emin olmak amacıyla ise Must_bid alanı doğrudur. Daha fazla bilgi için bu makaleye bakın. AUCTION_PACKAGE = 4; Anlaşma kimliği, belirli bir hedefleme ölçütü grubuyla eşleşen herkesin katılabileceği açık artırma envanteri koleksiyonunun tanımlayıcısıdır. Daha fazla bilgi için bu makaleye bakın. MagentoPLACE_PACKAGE = 5; Yayıncı tarafından seçilen envanter paketleri için anlaşma kimliği. Bu anlaşma kimlikleri otomatik olarak paket için uygun tüm alıcılara gönderilir. Daha fazla bilgi için bu makaleye bakın.
must_bid	Hayır	bool	BidRequest.AdSlot.Eşleşen Reklam Verileri.DirectDeal.must_bid	Bu alan yalnızca Programatik Garantili anlaşmalar için geçerlidir. Bu alan yanlışsa alıcının gösterime teklif vermeyi atlamasına izin verilir. Doğruysa alıcının bu gösterim fırsatı için bu anlaşmada teklif vermesi gerekir. Bu alan, JSON kablo biçimi için her zaman açık bir şekilde doldurulur. Varsayılan = true.
publisher_blocks_overridden	Hayır	bool	BidRequest.AdSlot.Eşleşen Reklam Verileri.DirectDeal.publisher_blocks_overridden	Yayıncının bu anlaşmayı yapılandırılmış engellemelerden muaf tutup tutmadığı. Bu ayar, Authorized Buyers politikalarını veya Reklam İnceleme Merkezi kararlarını geçersiz kılmaz. Daha fazla bilgi için bu makaleye bakın.
creative_source	Hayır	Enum CreativeSourceType	BidRequest.AdSlot.Eşleşen Reklam Verileri.DirectDeal.creative_source	Deneysel alan, değişebilir. Reklam öğesinin ana makinesini tanımlayan ve yalnızca Programatik Garantili anlaşmalar için doldurulacak bir enum. Bu alan şu anda yalnızca CREATIVE_SOURCE_ADVERTISER olarak ayarlanmalıdır. CREATIVE_SOURCE_UNKNOWN = 0; CREATIVE_SOURCE_ADVERTISER = 1; (Varsayılan) Reklam öğesi reklamveren tarafından barındırılır. Bu, teklif verenin teklif yanıtında bir reklam öğesi sağlaması gerektiği anlamına gelir. CREATIVE_SOURCE_PUBLISHER = 2; Reklam öğesi yayıncı tarafından barındırıldığı için teklif verenin teklif yanıtına bir reklam öğesi eklemesi gerekmez. Yayıncı tarafından barındırılan reklam öğeleri hakkında daha fazla bilgi için https://support.google.com/admanager/answer/9243220 adresine bakın. Bu özellik şu anda GZT teklif verenleri için desteklenmemektedir.

Site

Reklam destekli içerik, tarayıcı olmayan bir uygulamanın aksine web sitesiyse bu nesne eklenmelidir. Teklif isteği hem Site hem de App nesnesi içermemelidir. En azından bir site kimliği veya sayfa URL'si sağlamanız faydalıdır ancak bu kesinlikle zorunlu değildir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Exchange'deki site kimliği. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
name	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Site adı (yayıncının isteği üzerine maskelenebilir)
domain	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Reklamveren tarafı engelleme için kullanılan sitenin alan adı. Örneğin, "foo.com".
cat	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		Sitenin IAB içerik kategorileri dizisi. ContentCategory numaralandırmasına bakın.
sectioncat	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		Sitenin mevcut bölümünü açıklayan bir dizi IAB içerik kategorisi. ContentCategory numaralandırmasına bakın.
pagecat	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		Sitenin mevcut sayfasını veya görünümünü açıklayan bir IAB içerik kategorileri dizisi. ContentCategory numaralandırmasına bakın.
page	Hayır	string	BidRequest.url'si	2,3 2,4 2,5		Gösterimin gösterileceği sayfanın URL'si
privacypolicy	Hayır	bool	Desteklenmiyor	2,3 2,4 2,5		Sitenin gizlilik politikası olup olmadığını gösterir (0 = hayır, 1 = evet).
ref	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Geçerli sayfada gezinmeye neden olan yönlendiren URL'si.
search	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Geçerli sayfada gezinmeye neden olan arama dizesi.
publisher	Hayır	Publisher nesne	Teklif İsteği	2,3 2,4 2,5		Sitenin Publisher nesnesiyle ilgili ayrıntılar.
content	Hayır	Content nesne	Teklif İsteği	2,3 2,4 2,5		Sitedeki Content ile ilgili ayrıntılar.
keywords	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Bu site hakkındaki virgülle ayrılmış anahtar kelime listesi. Not: OpenRTB 2.2, alternatif uygulama olarak bir dizi dizeye izin vermiştir ancak bu sorun, CSV içeriği içeren kesinlikle tek bir dizenin olduğu 2.3 ve sonraki sürümlerde düzeltilmiştir. Alternatif temsili kullanan bazı OpenRTB 2.2 exchange'lerle uyumluluk için JSON'un özel olarak işlenmesi gerekebilir.
mobile	Hayır	bool	BidRequest.Mobile.is_mobile_web_optimize edildi	2,3 2,4 2,5		Sitenin mobil cihazlarda görüntülendiğinde düzeni optimize etmek için programlanıp programlanmadığını belirtir; burada 0 = hayır, 1 = evettir.
ext	Hayır	SiteExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.site] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için Site mesajındaki ext alanıyla erişirsiniz.

Site uzantısı

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
amp	Hayır	Enum AmpPage	BidRequest.AdSlot .is_amp_page	Bu sayfanın bir AMP sayfası olup olmadığı. Bilinmeyen durumlarda yoksayılır. DIALECT_HTML = 0; Bu bir AMP sayfası değil. DIALECT_HTML_AMP = 1; Bu bir AMP sayfasıdır.
page_visibility	Hayır	Sıralama Görünürlüğü Durumu	BidRequest.page_visible özelliği	Reklam alanını içeren web sayfasının görünürlük durumu. www.w3.org/TR/page-Visibility/ konusuna bakın. VISIBILITY_State_UNKNOWN = 0 VISIBILITY_State_VISIBLE = 1; Sayfa en azından kısmen görünür. Örneğin, simge durumuna küçültülmüş bir pencerenin ön planı sekmesinde. VISIBILITY_State_HIDDEN = 2; Sayfa hiçbir şekilde kullanıcılara gösterilmiyor. Örneğin, sayfa bir arka plan tarayıcı sekmesinde veya simge durumuna küçültülmüş bir penceredeyken olabilir.
is_semi_transparent_request	Hayır	bool	BidRequest.is_semi_ şeffaf_request	İstekte yarı şeffaf marka kullanımı kullanıldığını belirtir. Bu, istek URL'sinin yalnızca kesilmiş bir sürümünün sağlanacağı anlamına gelir. Bu karar yayıncı tarafından alınmıştır. support.google.com/admanager/answer/4584891 adresine göz atın.
inventorypartnerdomain	Hayır	string	BidRequest.inventorypartnerdomain	Uygulamadaki reklam envanterinin bir kısmına sahip olan iş ortağının (uygulama sahibinin alanı) alanı. İş ortağının ads.txt veya app-ads.txt dosyası burada barındırılır. Daha fazla bilgiyi http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf adresinde bulabilirsiniz.

Uygulama

Reklam destekli içerik, web sitesi yerine tarayıcı dışında bir uygulama (genellikle mobil cihazlarda) ise bu nesne eklenmelidir. Teklif isteği hem App hem de Site nesnesi içermemelidir. En azından bir Uygulama Kimliği veya paketi sağlanması yararlı olur, ancak bu zorunlu değildir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Exchange'deki uygulama kimliği. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
name	Hayır	string	BidRequest.Mobile.app_name	2,3 2,4 2,5		Uygulama adı (yayıncının isteği üzerine takma ad verilebilir)
domain	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Uygulamanın, reklamveren tarafı engellemesi için kullanılan alan adı. Örneğin, "oyunum.foo.com".
cat	Hayır	Dize dizisi	BidRequest.Mobile.app_category_ids	2,3 2,4 2,5		Not: Bu alandaki değerler artık çıkartılmıştır. Uygulamanın IAB içerik kategorileri dizisi. Enum'a ContentCategory bakın.
sectioncat	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		Uygulamanın mevcut bölümünü açıklayan IAB içerik kategorileri dizisi. Enum'a bakın: ContentCategory.
pagecat	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		Uygulamanın mevcut sayfasını veya görünümünü tanımlayan bir IAB içerik kategorileri dizisi. Enum'a bakın ContentCategory.
ver	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Uygulama sürümü.
bundle	Hayır	string	BidRequest.Mobile.app_id	2,3 2,4 2,5		Uygulamaya özel ve exchange'den bağımsız olması gereken, platforma özgü bir uygulama tanımlayıcısı. Android'de bu ad bir paket veya paket adı olmalıdır (örneğin, com.foo.mygame). iOS'ta sayısal kimliktir.
privacypolicy	Hayır	bool	Desteklenmiyor	2,3 2,4 2,5		Sitenin gizlilik politikası olup olmadığını gösterir (0 = hayır, 1 = evet).
paid	Hayır	bool	Desteklenmiyor	2,3 2,4 2,5		0 = uygulama ücretsizdir, 1 = uygulama ücretli bir sürümdür.
publisher	Hayır	Publisher nesne	Teklif İsteği	2,3 2,4 2,5		Uygulamanın Publisher nesnesiyle ilgili ayrıntılar.
content	Hayır	Content nesne	Teklif İsteği	2,3 2,4 2,5		Uygulamadaki Content ile ilgili ayrıntılar.
keywords	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Bu uygulama hakkındaki virgülle ayrılmış anahtar kelime listesi. Not: OpenRTB 2.2, alternatif uygulama olarak bir dizi dizeye izin vermiştir, ancak bu tekrar CSV içeriği olan kesinlikle tek bir dize olduğu 2.3 ve sonraki sürümlerde düzeltilmiştir. Alternatif temsili kullanan bazı OpenRTB 2.2 exchange'lerle uyumluluk için JSON'un özel olarak işlenmesi gerekebilir.
storeurl	Hayır	string	BidRequest.url'si	2,3 2,4 2,5		Yüklü bir uygulamanın uygulama mağazası URL'si.
ext	Hayır	AppExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.app] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için Uygulama mesajındaki ext alanıyla erişirsiniz.

Uygulama Ekstresi

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
installed_sdk	Hayır	Yüklü Sdk	BidRequest.Mobile.installed_sdk	Genellikle teklif verenin SDK'sı olması nedeniyle teklif verenin erişebildiği, yayıncının uygulamasında yüklü olan SDK'nın kimliği ve bilgisi.
inventorypartnerdomain	Hayır	string	BidRequest.inventorypartnerdomain	Uygulamadaki reklam envanterinin bir kısmına sahip olan iş ortağının (uygulama sahibinin alanı) alanı. İş ortağının ads.txt veya app-ads.txt dosyası burada barındırılır. Daha fazla bilgiyi http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf adresinde bulabilirsiniz.
Yüklü Sdk
id	Evet	string	BidRequest.Mobile.YüklüSdk.id	Yüklü SDK'nın tanımlayıcısı.
sdk_version	Evet	Sürüm	BidRequest.Mobile.YüklüSdk.sdk_version	Yüklü SDK'nın sürümü.
adapter_version	Evet	Sürüm	BidRequest.Mobile.YüklüSdk.adapter_version	Bağdaştırıcının, yüklü SDK ile iletişim kuran sürümü.
Sürüm
major	Hayır	int32 [int32]	Desteklenmiyor	Varsayılan = -1.
minor	Hayır	int32 [int32]	Desteklenmiyor	Varsayılan = -1.
micro	Hayır	int32 [int32]	Desteklenmiyor	Varsayılan = -1.

Yayıncıyım

Bu nesne, reklamın gösterileceği medyanın yayıncısını tanımlar. Yayıncı, genellikle bir OpenRTB işleminde satıcıdır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Hayır	string	BidRequest.publisher_id	2,3 2,4 2,5		Web mülkü kodunun yayıncı kodu son eki tarafından tanımlandığı şekilde exchange'e özel yayıncı kimliği. Örneğin pub-123, ca-pub-123 web mülkü kodunun yayıncı kodudur.
name	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Yayıncı adı (yayıncının isteği üzerine takma adla değişebilir)
cat	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		Uygulamanın IAB içerik kategorileri dizisi. Enum'a ContentCategory bakın.
domain	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Yayıncının en üst düzey alan adı (örneğin, "yayıncı.com")
ext	Hayır	PublisherExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.publisher] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için Yayıncı mesajındaki ext alanıyla erişirsiniz.

Yayıncı Ekstresi

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
country	Hayır	string	BidRequest .publisher_country	Yayıncının fatura adresi ülkesi. Bu, coğrafi_ölçüt_kimliğinde kullanıcının algılanan ülkesinden veya web sitesinin barındırıldığı ülkeden farklı olabilir. Ülke kodlarının tam listesine de bakın.
host_publisher_id	Hayır	string	BidRequest.host_publisher_id	Ana makine yayıncısının kimliği. Doldurulduğunda, ana makine yayıncısının gelir paylaşımına katıldığını ve kimliğin ads.txt dosyasını yetkilendirmek için kullanılabileceğini belirtir.

İçerik

Bu nesne, gösterimin görüntüleneceği içeriği (ortak kullanılan veya ortak olmayan içerik) tanımlar. Birleştirilmiş içerik gösterim içerdiği ve yayıncının genel içeriğiyle eşleşmediği durumlarda bu nesne faydalı olabilir. Exchange, sendikasyon işleminin bir sonucu olarak içeriğin çalıştırıldığı sayfa hakkında bilgi sahibi olabilir veya olmayabilir. Örnek olarak, bilinmeyen bir web mülkü veya cihazda bir iframe'e yerleştirilmiş video gösterimi bulunabilir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		İçeriği benzersiz şekilde tanımlayan kimlik.
episode	Hayır	int32 [int32]	Desteklenmiyor	2,3 2,4 2,5		İçerik bölümü numarası (genellikle video içeriği için geçerlidir).
title	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		İçerik başlığı. Video örnekleri: "Arama Komitesi" (televizyon), "A New Hope" (film) veya "Endgame" (web için yapılmıştır). Video olmayan örnek: "Antarktik Buzulu Neden Bu Kadar Hızlı Eriyor?" (Zaman dergisi makalesi).
series	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		İçerik serisi. Video örnekleri: "Ofis" (televizyon), "Star Wars" (film) veya "Arby 'N' The Chief" (web için yapılmıştır). Video olmayan örnek: "Ecocent" (Zaman Dergisi blogu)
season	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		İçerik sezonu; genellikle video içeriği için (örneğin, "3. Sezon").
artist	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Sanatçının içerikle bağlantısı
genre	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		İçeriği en iyi tanımlayan tür (ör. rock, pop vb.).
album	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		İçeriğin ait olduğu albüm; genellikle ses içindir.
isrc	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		ISO-3901'e uygun Uluslararası Standart Kayıt Kodu.
url	Hayır	string	(Yalnızca App.content) BidRequest.url	2,3 2,4 2,5		Satın alma tarafı bağlama veya incelemeye yönelik içeriğin URL'si.
cat	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		İçeriği açıklayan bir dizi IAB içerik kategorisi. Enum'a ContentCategory bakın.
prodq	Hayır	Prodüksiyon Kalitesi	Desteklenmiyor	2,4 2,5		Prodüksiyon kalitesi.
keywords	Hayır		Desteklenmiyor	2,3 2,4 2,5		İçeriği açıklayan anahtar kelimelerin virgülle ayrılmış listesi. Not: OpenRTB 2.2, alternatif uygulama olarak bir dizi dizeye izin verir. Ancak bu, CSV içeriği olan kesinlikle tek bir dize olan 2.3 ve sonraki sürümlerde düzeltilmiştir. Alternatif temsili kullanan bazı OpenRTB 2.2 exchange'lerle uyumluluk için JSON'un özel olarak işlenmesi gerekebilir.
contentrating	Hayır	string	BidRequest.detected_content_label 39: "DV_G", 40: "DV_PG", 41: "DV_T", 42: "DV_MA", 43: "DV_UNRATED"	2,3 2,4 2,5		Not: Bu alandaki değerler artık çıkartılmıştır. İçerik derecelendirmesi (örneğin, MPAA).
userrating	Hayır	string	(Yalnızca App.content) BidRequest.Mobile.app_rating	2,3 2,4 2,5		İçeriğin kullanıcı puanı (örneğin, yıldız sayısı, beğeni sayısı vb.).
context	Hayır	İçerikBağlamı	Desteklenmiyor	2,3 2,4 2,5		İçerik türü (oyun, video, metin vb.).
context_22	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		OpenRTB <= 2.2 uyumluluğu; 2.3 ve sonraki sürümler için bağlam kullanın.
livestream	Hayır	bool	BidRequest.Video.is_livestream	2,3 2,4 2,5		0 = canlı değil, 1 = içerik yayında (ör. akış, canlı blog).
sourcerelationship	Hayır	bool	Desteklenmiyor	2,3 2,4 2,5		0 = dolaylı, 1 = doğrudan.
producer	Hayır	string	BidRequest.Video	2,3 2,4 2,5		İçerik yapımcısıyla ilgili ayrıntılar.
len	Hayır	int32 [int32]	BidRequest.Video.ContentÖzellikler.duration_seconds	2,3 2,4 2,5		İçeriğin saniye cinsinden uzunluğu. Video veya ses için uygundur.
qagmediarating	Hayır	QAGMediaPuanı	Desteklenmiyor	2,3 2,4 2,5		QAG kurallarına göre medya derecelendirmesi.
embeddable	Hayır	bool	Desteklenmiyor	2,3 2,4 2,5		İçeriğin yerleştirilmiş olup olmadığının göstergesi (örneğin, gömülebilir bir video oynatıcı). Burada 0 = hayır, 1 = evet olur.
language	Hayır	string	BidRequest.detected_dil	2,3 2,4 2,5		ISO-639-1-alpha-2 kullanılan içerik dili.

Yapımcı

Bu nesne, reklamın gösterileceği içeriğin yapımcısını tanımlar. Bu, özellikle içeriğin birleştirilmesi ve farklı yayıncılar aracılığıyla dağıtılabilmesi, dolayısıyla yapımcının ve yayıncının aynı tüzel kişi olmayabileceği durumlarda yararlıdır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		İçerik üretici veya oluşturucu kimliği. İçerik ortak kullanıma sunulduysa ve yerleştirme etiketleri kullanılarak bir sitede yayınlanabiliyorsa yararlıdır.
name	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		İçerik üretici veya oluşturucu adı (ör. "Warner Bros").
cat	Hayır	Dize dizisi	Desteklenmiyor	2,3 2,4 2,5		İçerik üreticiyi tanımlayan bir dizi IAB içerik kategorisi. Enum'a ContentCategory bakın.
domain	Hayır	string	BidRequest.Video.description_url	2,3 2,4 2,5		İçerik üreticinin en üst düzey alanı (ör. "prodüktör.com").

Cihaz

Bu nesne, kullanıcının etkileşimde bulunduğu cihazla ilgili bilgiler sağlar. Cihaz bilgileri donanımı, platformu, konumu ve operatör verilerini içerir. Cihaz, bir mobil cihaz, masaüstü bilgisayar, set üstü kutu veya başka bir dijital cihaza işaret edebilir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
dnt	Hayır	bool	Desteklenmiyor; Çerez Kılavuzu'na bakın: google_error=1:	2,3 2,4 2,5		Tarayıcı tarafından üstbilgide belirlenen standart "Do Not Track" seçeneği. Burada 0 = izleme sınırsız, 1 = izlemez. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
ua	Hayır	string	BidRequest.user_agent	2,3 2,4 2,5		Tarayıcı kullanıcı aracısı dizesi. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
ip	Hayır	string	BidRequest.ip (AdX, ilk 3 sekizliği kısaltır; OpenRTB: "X.X.X.0")	2,3 2,4 2,5		Cihaza en yakın IPv4 adresi. OpenRTB spesifikasyonu tarafından ÖNERİLİR
geo	Hayır	Geo nesne	Teklif İsteği	2,3 2,4 2,5		Kullanıcının bir Geo nesnesi tarafından tanımlanan geçerli konumu olduğu düşünülen konum. OpenRTB spesifikasyonu tarafından ÖNERİLİR.
didsha1	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Donanım cihazı kimliği (ör. IMEI); SHA1 üzerinden karma oluşturma işlemi uygulanır.
didmd5	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Donanım cihaz kimliği (ör. IMEI); MD5 üzerinden karma oluşturma işlemi uygulanır.
dpidsha1	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Platform cihaz kimliği (örneğin, Android kimliği); SHA1 üzerinden karma oluşturma işlemi uygulanır
dpidmd5	Hayır	string	BidRequest.Mobile.hashed_idfa - AdX ikili programdır, OpenRTB taban16'dır (küçük harf onaltılıktır) Bu, ifa'nın karma işlemi uygulanmış sürümüdür. Mobil SDK sürümüne bağlı olarak dpidmd5 veya a ise kullanılabilir.	2,3 2,4 2,5		Platform cihaz kimliği (örneğin, Android kimliği); MD5 üzerinden karma oluşturma işlemi uygulanır.
ipv6	Hayır	string	BidRequest.ip'si - AdX ilk 6 sekiz biti kısaltır: OpenRTB "X:X:X:::::" şeklindedir	2,3 2,4 2,5		Cihaza en yakın IPv6 adresi.
carrier	Hayır	string	BidRequest.Device.carrier_id Kimlikleri, Authorized Buyers protokolündekiyle aynı Ölçüt Kimliklerine ait olur. Mobil operatörler listesine bakın.	2,3 2,4 2,5		Operatör veya İSS (örneğin "VERIZON"). Teklif verenlere öncelikle yayınlanması gereken, exchange tarafından seçilen dize adlarını kullanır.
language	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		ISO-639-1-alpha-2 kullanan tarayıcı dili.
make	Hayır	string	BidRequest.Cihaz.brand	2,3 2,4 2,5		Cihazın markası (örneğin, "Apple").
model	Hayır	string	BidRequest.Cihaz.model	2,3 2,4 2,5		Cihaz modeli (örneğin, "iPhone")
os	Hayır	string	BidRequest.Cihaz.platform	2,3 2,4 2,5		Cihazın işletim sistemi (örneğin, "iOS")
osv	Hayır	string	BidRequest.Cihaz.os_version	2,3 2,4 2,5		Cihazın işletim sistemi sürümü
hwv	Hayır	string	BidRequest.Cihaz.hardware_sürümü	2,3 2,4 2,5		Cihazın donanım sürümü (ör. iPhone 5S için "5S")
w	Hayır	int32 [int32]	BidRequest.Cihaz.screen_width	2,3 2,4 2,5		Ekranın piksel cinsinden fiziksel genişliği.
h	Hayır	int32 [int32]	BidRequest.Cihaz.screen_height	2,3 2,4 2,5		Ekranın piksel cinsinden fiziksel yüksekliği.
ppi	Hayır	int32 [int32]	Desteklenmiyor	2,3 2,4 2,5		Doğrusal inç başına piksel cinsinden ekran boyutu.
pxratio	Hayır	double	BidRequest.Cihaz.screen_pixel_ratio_millis / 1.000	2,3 2,4 2,5		Fiziksel piksellerin cihazdan bağımsız piksellere oranı.
js	Hayır	bool	Desteklenmiyor	2,3 2,4 2,5		0 = hayır, 1 = evet olacak şekilde JavaScript desteği.
geofetch	Hayır	bool	Desteklenmiyor	2,4 2,5		Geolocation API'nin banner'da çalışan JavaScript kodunda 0 = hayır, 1 = evet yanıtıyla kullanılabilir olup olmadığını belirtir.
connectiontype	Hayır	Bağlantı Türü	Desteklenmiyor	2,3 2,4 2,5		Ağ bağlantısı türü
devicetype	Hayır	CihazTürü	BidRequest.Cihaz.device_type	2,3 2,4 2,5		Genel cihaz türü.
flashver	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Tarayıcı tarafından desteklenen Flash sürümü.
ifa	Hayır	string	BidRequest.Mobile.advertising_id - AdX ikili programdır, OpenRTB 36 karakterli bir UUID'dir (Android kimliği: küçük harf, IDFA: tümü büyük harf). ifa, Android kimliği veya Apple'ın IDFA'sı olup dpidmd5 ya da ifa mobil SDK sürümüne bağlı olarak kullanılabilirse.	2,3 2,4 2,5		Açıkça reklamveren kullanımı için onaylanan kimlik (örneğin, karma oluşturma işlemi uygulanmamış).
macsha1	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Cihazın MAC adresi; SHA1 üzerinden karma oluşturma işlemi uygulanır.
macmd5	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Cihazın MAC adresi; MD5 üzerinden karma oluşturma işlemi uygulanır
lmt	Hayır	bool	BidRequest.Cihaz.limit_ad_tracking	2,3 2,4 2,5		"Reklam İzlemeyi Sınırla", işletim sistemi veya cihaz ayarlarına dayalı olarak ticari olarak onaylanmış bir sinyaldir. Burada false, izlemenin sınırsız olduğunu, true ise izlemenin ticari yönergelere göre sınırlandırılması gerektiğini belirtir. Bu sinyal, iOS Uygulama İzleme Şeffaflığı da dahil olmak üzere kullanıcı yüzeylerindeki kullanıcı kararlarını yansıtır. Ayrıca lmt ve App Tracking Transparency kılavuzu ile Android reklam kimliğine bakın.
mccmnc	Hayır	string	Desteklenmiyor	2.5		Birleştirilmiş MM-MNC kodu olarak mobil operatör (örneğin, "310-005" ABD'de Verizon Wireless CDMA'yı tanımlar). Daha fazla örnek için https://en.wikipedia.org/wiki/Mobile_country_code adresine bakın. Ayrıştırma belirsizliğini ortadan kaldırmak için MM ve MNC bölümleri arasındaki kısa çizginin gerekli olduğunu unutmayın.
ext	Hayır	DeviceExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.device] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için Cihaz mesajındaki ext alanıyla erişirsiniz.

Cihaz Ekstresi

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
session_id	Hayır	string	BidRequest.session_id	CTV/OTT cihazlarda kısa süreli kullanıcı oturumunu temsil eder ve maksimum oturum süresi 6 saattir. Reklam kişiselleştirme için session_id kullanımına hiçbir zaman izin verilmez. session_id, yalnızca sıklık sınırı, rakip hariç tutma veya ilgili amaçlar için kullanılabilir. Bu alanda web için güvenli Base64 alfabesi bulunur.
atts	Hayır	int32 [int32]	BidRequest.Cihaz.app_tracking_authorization_status	(Yalnızca iOS) 0 = belirlenmemiş 1 = kısıtlanmış 2 = reddedildi 3 = yetkilendirilmiştir. Uygulamanın uygulama izleme yetkisi durumunu temsil eden bir tam sayı. Bu değer, ATTrackingManager'dan alınır ve olduğu gibi sağlanır. iOS'in uygulama izleme yetkilendirmesi durumu hakkında daha fazla bilgi için bu makaleyi inceleyin.
user_agent_data	Hayır	UserAgent nesne	BidRequest.user_agent_data	Kullanıcı aracısı bilgileri

KullanıcıAracısı

Kullanıcı aracısı bilgileri Bu alan, User-Agent üstbilgisinden veya Sec-CH-UA üstbilgilerinden çıkarılan kullanıcı aracısı hakkındaki bilgilerle doldurulur.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
browser	Hayır	BrandVersion nesne	BidRequest.user_agent_data.browser	Tarayıcıyı tanımlar.
platform	Hayır	BrandVersion nesne	BidRequest.user_agent_data.platform	Platformu tanımlar.
mobile	Hayır	bool	BidRequest.user_agent_data.mobil	Temsilci "mobil cihazlar için optimize edilmiş" içeriği tercih ediyorsa doğru değerini döndürür. Cihazla ilgili ayrıntılı bilgiler için BidRequest.device alanına bakın. Bu bilgi, bu alanla tutarlı olabilir veya olmayabilir (örneğin, cep telefonundaki tarayıcı "Masaüstü site" isteğinde bulunabilir).
architecture	Hayır	string	BidRequest.user_agent_data.durumu	Cihaz mimarisi (ör. "x86" veya "kol").
bitness	Hayır	string	BidRequest.user_agent_data.bitness	Cihazın bit hızı, ör. 64 bit mimari için "64".
model	Hayır	string	BidRequest.user_agent_data.model	Cihaz modeli.

BrandVersion nesnesi

Tarayıcı veya platform için üçlü (marka, sürüm)

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
brand	Hayır	string	BidRequest.user_agent_data.brand	Marka tanımlayıcısı (ör. "Chrome" veya "Windows").
version	Hayır	string	BidRequest.user_agent_data.version	Sürüm, gerekirse bileşenlere bölünmüştür (ör. {"85", "1"} = v55.1).

Coğrafi

Bu nesne, bir coğrafi konum belirtmek için çeşitli yöntemler içerir. Bir Device nesnesine bağlı olduğunda, cihazın konumunu kullanıcının geçerli konumu olarak da yorumlanabilecek şekilde gösterir. Bir User nesnesine bağlı olduğunda, kullanıcının ana tabanının konumunu belirtir (örneğin, kullanıcının mevcut konumu değil). lat/lon özellikleri yalnızca tür özelliğinde gösterilen doğrulukla uyumlu ise iletilmelidir. Örneğin, posta kodu gibi bir coğrafi bölgenin centroid'i iletilmemelidir.

Google'ın OpenRTB uygulamasında, genel coğrafi konum bilgileri, reklam isteğinin geldiği cihazın IP adresine göre tahmin edilir. Bu bilgiler teklif isteğine genellikle her zaman değil, lat/lon ifadesiyle dahil edilir. Burada dairenin merkez noktası, accuracy yarıçapındadır. Coğrafi konum hakkında daha fazla bilgi için Coğrafi hedefleme kılavuzunu inceleyin.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
lat	Hayır	double	BidRequest.[encrypted_]hyperlocal_set. center_point.Enlem	2,3 2,4 2,5		-90,0 ile +90,0 arası enlem ve güney konumu.
lon	Hayır	double	BidRequest.[encrypted_]yerel mesafe_set.center_point.boylam	2,3 2,4 2,5		-180,0 ile +180,0 arasındaki boylam. Negatifin batıdır.
country	Hayır	string	BidRequest.geo_criteria_id ile coğrafi-tablo.csv	2,3 2,4 2,5		ISO-3166-1 Alpha-3 kullanılan ülke.
region	Hayır	string	BidRequest.geo_criteria_id ile coğrafi-tablo.csv	2,3 2,4 2,5		ISO-3166-2 kullanan bölge kodu; ABD'de ise 2 harfli eyalet kodu.
regionfips104	Hayır	string		2,3 2,4 2,5		FIPS 10-4 notasyonunun kullanıldığı ülke bölgesi. OpenRTB bu özelliği desteklese de 2008'de NIST tarafından geri çekilmiştir.
metro	Hayır	string	BidRequest.geo_criteria_id - coğrafi-tablo.csv, şehirler-dma-regions.csv	2,3 2,4 2,5		Google metro kodu; Nielsen TPA'larına benzer, ancak tam olarak aynı değildir. Kodlara giden bağlantı için Coğrafi Hedefleme sayfasına bakın.
city	Hayır	string	BidRequest.geo_criteria_id ile coğrafi-tablo.csv	2,3 2,4 2,5		Birleşmiş Milletler Ticaret ve Taşıma Konumları Kodu'nu "city": "San Antonio" biçiminde kullanan şehir.Kodların bağlantısı için Ek A'ya bakın.
zip	Hayır	string	BidRequest.postal_code BidRequest.postal_code_önek	2,3 2,4 2,5		Posta kodu.
type	Hayır	YerTürü		2,3 2,4 2,5		Konum verilerinin kaynağı; enlem/boylam iletilirken önerilir.
accuracy	Hayır	int32 [int32]	Desteklenmiyor	2,4 2,5		Enlem cinsinden tahmini konum doğruluğu; enlem/boylam değeri belirtildiğinde ve bir cihazın konum hizmetlerinden türetildiğinde önerilir (örneğin, type = 1). Bu, cihazdan bildirilen doğruluk düzeyidir. Kesin yorum için OS'ye özel dokümanlara (örneğin, Android, iOS) bakın. Google: Merkez noktasının enlem/boylam olarak tanımlandığı ve bir cihazın konumuna yakın olan dairenin metre cinsinden yarıçapı. Bu alan, IP'ye dayalı yaklaşık coğrafi konuma göre doldurulur.
lastfix	Hayır	int32 [int32]	Desteklenmiyor	2,4 2,5		Bu coğrafi konum düzeltmesinin oluşturulmasından bu yana geçen saniye sayısı. Cihazların, birden çok getirme işlemindeki konum verilerini önbelleğe alabileceğini unutmayın. İdeal olarak, bu değer, düzeltmenin yapıldığı zamana ait olmalıdır.
ipservice	Hayır	Konum Hizmeti	Desteklenmiyor	2,4 2,5		Varsa IP adresinden coğrafi konumu belirlemek için kullanılan hizmet veya sağlayıcı (ör. = 2).
utcoffset	Hayır	int32 [int32]	BidRequest.timezone_offset	2,3 2,4 2,5		UTC saat diliminden +/- dakika cinsinden yerel saat.

Kullanıcı

Bu nesne, cihazın gerçek kullanıcısı hakkında bilinen veya türetilen bilgileri (örneğin, reklamcılık kitlesi) içerir. Kullanıcı kimliği bir exchange yapısıdır ve rotasyona veya diğer gizlilik politikalarına tabi olabilir. Ancak bu kullanıcı kimliği, sıklık sınırı ve yeniden hedefleme için makul bir şekilde sunulabilecek kadar uzun bir süre boyunca tutarlı olmalıdır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Hayır	string	BidRequest.[kısıtlı_usage_]google_user_id	2,3 2,4 2,5		Kullanıcının Exchange'e özel kimliği. En az bir id veya buyerid önerilir
buyeruid	Hayır	string	BidRequest.[restricteded_usage_]hosted_match_data - AdX ikili programdır, OpenRTB web güvenli Base64'tür (dolgusuz)	2,3 2,4 2,5		Kullanıcının exchange'i tarafından alıcı olarak eşlendiği kullanıcıya özel alıcı kimliği. En az bir buyerid veya id önerilir.
gender	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		"M" erkek, "F" kadın, "O" Diğer olarak cinsiyet. (Null, bilinmeyeni belirtir)
keywords	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Anahtar kelimelerin, ilgi alanlarının veya niyetin virgülle ayrılmış listesi. Not: OpenRTB 2.2, alternatif uygulama olarak bir dizi dizeye izin vermiştir ancak bu sorun, CSV içeriği içeren kesinlikle tek bir dizenin olduğu 2.3 ve sonraki sürümlerde düzeltilmiştir. Alternatif temsili kullanan bazı OpenRTB 2.2 exchange'lerle uyumluluk için JSON'un özel olarak işlenmesi gerekebilir.
customdata	Hayır	string	BidRequest.[restricteded_usage_]hosted_match_data - AdX ikili programdır, OpenRTB web güvenli Base64'tür (dolgusuz)	2,3 2,4 2,5		Exchange'in çerezinde teklif veren veri kümesini iletmeyi sağlayan isteğe bağlı özellik. Dize, Base85 çerez güvenli karakterlerinden oluşmalı ve herhangi bir biçimde olmalıdır. "Çıkış karakterli" tırnak işaretlerini dahil etmek için uygun JSON kodlaması kullanılmalıdır.
geo	Hayır	Geo nesne	Desteklenmiyor	2,3 2,4 2,5		Kullanıcının bir Geo nesnesi tarafından tanımlanan ana tabanının konumu. Bu konum, her zaman geçerli konum olmayabilir.
data	Hayır	Data nesne dizisi	BidRequest.detected_vertical	2,3 2,4 2,5		Not: Bu alandaki değerler artık çıkartılmıştır. Ek içerik verileri. Her bir Data nesnesi farklı bir veri kaynağını temsil eder. segment.id, sayfanın exchange tarafından algılanan temasını referans alır. segment.value, algılanan temanın ağırlığına karşılık gelir. Bu, sayfanın algılanan sektörle daha alakalı olduğunu gösteren daha yüksek bir ağırlıktır.
ext	Hayır	UserExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.user] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için Kullanıcı mesajındaki ext alanıyla erişirsiniz.

Kullanıcı Uzantısı

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
consented_providers_settings	Hayır	ConsentedProvidersSettings nesne	BidRequest.AdSlot.consented_providers_settings	Yayıncının Google'a AEA kullanıcısının kişisel verilerinin reklam kişiselleştirme için Google'ın AB Kullanıcı Rızası Politikası uyarınca kullanımına izin verdiğini belirttiği reklam teknolojisi sağlayıcılar hakkındaki bilgiler. Bu alan yalnızca RegsExt.gdpr doğru olduğunda doldurulur.
consent	Hayır	string	BidRequest.AdSlot.ConsentedProvidersSettings.tcf_consent_string	Yayıncının IAB Rıza Yönetimi Platformu'ndan (CMP) getirilen web için güvenli, 64 kodlu IAB Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) v2 izin dizesi. Dizenin yapısı, IAB TCF v2 tarafından tanımlanır. Yayıncı, TCF 2. sürüm için bir CMP ile entegrasyon yaptıysa ve bu CMP, GDPR'nin bu reklam isteği için geçerli olduğunu belirtir ve geçerli bir izin dizesi sağlarsa bu alan doldurulur. Google TCF v2 entegrasyonu hakkında daha fazla bilgi için bu makaleye göz atın. İzin dizesinde listelenen sağlayıcılar hakkında ayrıntılı bilgi için vendor-list.consensu.org/v2/vendor-list.json adresindeki IAB Küresel Katılımcı Listesi'ne bakın.
eids	Hayır	ExtendedId nesne dizisi	BidRequest.AdSlot.secure_signals	Yayıncı tarafından seçilen güvenli sinyalleri iletmek için kullanılan standart uzantı.

ConsentedProviderSettings

Yayıncının Google'a AEA kullanıcısının kişisel verilerinin reklam kişiselleştirme için Google'ın AB Kullanıcı Rızası Politikası uyarınca kullanımına izin verdiğini belirttiği reklam teknolojisi sağlayıcılar hakkındaki bilgiler. Bu alan yalnızca RegsExt.gdpr doğru olduğunda doldurulur.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
consented_providers	Hayır	int64 dizisi	BidRequest.AdSlot.consented_providers	Yayıncının AEA'da AEA'daki kullanıcılarına yasal olarak geçerli şekilde izin verdiklerini belirttiği reklam teknolojisi sağlayıcılara (ATP'ler) karşılık gelen kimlik grubudur. 1) Yasal olarak gerekli olduğu durumlarda çerez veya başka yerel depolama bilgilerinin kullanımı ve 2) kişisel verilerin Google'ın AB Kullanıcı Rızası Politikası'na uygun olarak ATP tarafından kişiselleştirilmesi için kişisel verilerin toplanması, paylaşılması ve kullanılması. Bir yayıncı, kullanıcı rızasını yönetmek için IAB Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) 2. sürümü kullanıyorsa bu, Ek İzin dizesi aracılığıyla izin verilen ATP grubudur (Google'ın Ek İzin modu hakkında ayrıntılı bilgi için bu makaleye göz atın). TCF v2 izin dizesi üzerinden izin verilen ATP'ler, UserExt.consent alanında gösterilir. Bir ATP kimliği ile ATP adı arasındaki bir eşleme, provider.csv'de yayınlanır.

UzatılmışKimlik

Yayıncı tarafından iletilen güvenli sinyaller.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
source	Hayır	string	BidRequest.AdSlot.SecureSignal.source	Sinyalin kaynağı (sağlayıcı).
uids	Hayır	Bir ExtendedIdUid nesnesine sahip dizi	Yok	Güvenli sinyal.

UzatılmışKimlik

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
id	Hayır	string	BidRequest.AdSlot.SecureSignal.data	Güvenli sinyal.

Veriler

data ve segment nesneleri birlikte ek içerik verilerinin belirtilmesine olanak tanır. Bu veriler, id alanında belirtildiği gibi exchange'in kendisinden veya üçüncü taraf sağlayıcılardan alınan birden fazla kaynaktan gelebilir. Teklif isteği, birden fazla sağlayıcıdan veri nesnelerini karıştırabilir. Kullanılan veri sağlayıcılar, exchange'lerin teklif verenlerden önce yayınlanması gerekir.

Bu, algılanan sektörleri alıcıya göndermek için kullanılır. Bu işlem, Open Bidding için yayıncıdan alıcıya anahtar/değer çiftleri göndermek için de kullanılır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Hayır	string	Destekleniyor	2,3 2,4 2,5		Veri sağlayıcının Exchange'e özel kimliği.
name	Hayır	string	Destekleniyor	2,3 2,4 2,5		Veri sağlayıcısının exchange'e özel adı.
segment		Segment nesne dizisi	Destekleniyor	2,3 2,4 2,5		Gerçek veri değerlerini içeren Segment nesneleri dizisi.

Segment

data ve segment nesneleri birlikte ek içerik verilerinin belirtilmesine olanak tanır. Bu veriler, id alanında belirtildiği gibi exchange'in kendisinden veya üçüncü taraf sağlayıcılardan alınan birden fazla kaynaktan gelebilir. Teklif isteği, birden fazla sağlayıcıdan Data nesneyi karıştırabilir. Kullanılan belirli veri sağlayıcılar, teklif verenler arasındaki bir exchange tarafından yayınlanmalıdır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Hayır	string	Destekleniyor	2,3 2,4 2,5		Veri sağlayıcıya özel veri segmenti kimliği.
name	Hayır	string	Destekleniyor	2,3 2,4 2,5		Veri sağlayıcıya özel veri segmentinin adı.
value		string	Destekleniyor	2,3 2,4 2,5		Veri segmenti değerinin dize gösterimi.

Kayıtlar

Bu nesne, istek için geçerli olan tüm yasal, resmi veya endüstriyel düzenlemeleri içerir. coppa seçeneği, isteğin Amerika Birleşik Devletleri Federal Ticaret Komisyonu'nun ABD Çocukların Çevrimiçi Gizliliğini Koruma Yasası'nın ("COPPA") düzenlemelerine uygun olup olmadığını gösterir. Daha fazla bilgi için Bölüm 7.1'i inceleyin.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
coppa	Hayır	string	BidRequest.user_data_treatment / TAG_FOR_CHILD_DIRECTED_TREATMENT	2,3 2,4 2,5		Bu isteğin ABD FTC'si tarafından oluşturulan COPPA düzenlemelerine tabi olup olmadığını belirten seçenek. Burada 0 = hayır, 1 = evet.
ext	Hayır	RegsExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.regs] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için Regs mesajındaki ext alanıyla erişirsiniz.

Normal İfade

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
gdpr	Hayır	bool	BidRequest.AdSlot.regs_gdpr	Bu alan, aşağıdaki iki durumdan birinde doğru olarak ayarlanır: Google, geçerli bir IAB Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) v2 izin dizesi alır ve Kullanıcı Rızası Yönetim Platformu, bu reklam isteği için GDPR'nin geçerli olduğunu belirtir. Google, IAB TCF v2 izin dizesini almaz ve Google'ın mevcut bilgilerine göre bu gösterim, AEA kullanıcılarına sunulur. GDPR hakkında yasal rehberlik teşkil etmez.
lgpd	Hayır	bool	BidRequest.AdSlot.regs_lgpd	Bu alan, Google'ın sahip olduğu bilgilere göre Brezilya'daki bir kullanıcıya sunulacağında "doğru" olarak ayarlanır. LGPD ile zorunlu kılınan isteklerde yayınlanmasına izin verilen reklam teknolojisi sağlayıcıların listesi için https://storage.googleapis.com/adx-rtb-dictionaries/lgpd-providers.csv adresine bakın. LGPD hakkında daha fazla bilgi edinmek için bu makaleyi inceleyin.

Teklif yanıtı değişkenleri ve tanımları

Bu bölümde, teklif yanıtı değişkenleri ve tanımları açıklanmaktadır.

BidResponse

Bu nesne, üst düzey teklif yanıtı nesnesidir (örneğin, adsız dış JSON nesnesi). id özelliği, günlük kaydı amacıyla teklif isteği kimliğini yansıtır. Benzer şekilde, bidid teklif verenler için isteğe bağlı bir yanıt izleme kimliğidir. Belirtilirse teklif veren kazanırsa bir sonraki kazanma bildirimi çağrısına dahil edilebilir. Bir gösterim için en az bir teklif içeren en az bir seatbid nesnesi gerekir. Diğer özellikler isteğe bağlıdır. Bir "no-bid" ifadesini ifade etmek için HTTP 204 ile boş bir yanıt döndürün. Alternatif olarak, teklif veren exchange'e teklif vermeme nedenini iletmek isterse nbr özelliğinde bir neden kodu içeren yalnızca BidResponse nesnesi döndürülür.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Evet	string	Herhangi bir alanla eşleştirilmemiştir ancak BidRequest.id ile doğrulanmıştır.	2,3 2,4 2,5		Bunun yanıtlandığı teklif isteğinin kimliği. OpenRTB spesifikasyonu tarafından GEREKLİ.
seatbid	Hayır	Seatbid nesne dizisi	BidResponse.Ad	2,3 2,4 2,5		Seatbid nesne dizisi; teklif yapılacaksa 1+ gerekir.
bidid	Hayır	string	BidResponse.debug_string	2,3 2,4 2,5		Teklif veren, günlük kaydı/izlemeye yardımcı olmak için yanıt kimliği oluşturdu.
cur	Hayır	string	BidResponse.Ad.AdSlot.currency	2,3 2,4 2,5		ISO-4217 alfa kodlarını kullanarak teklif para birimi. Bu alan doldurulursa teklifi yorumlamak için belirtilen para birimi kullanılır. Aksi takdirde, aşağıdaki öncelik düzeyinde belirlenen varsayılan teklif para birimi kullanılır: GZT hesap ayarlarında yapılandırılmışsa teklif veren düzeyindeki para birimi. Alıcı düzeyindeki para birimi. Alıcı, doldurulmuşsa BidResponse.seatbid.bid.ext.billing_id uzantısı alanında belirtilen faturalandırma kimliğine göre belirlenir. Aksi takdirde, teklif isteğinde gönderilen tek faturalandırma kimliğini temel alır. Alıcı hesabın para birimi, hesap oluşturulurken belirlenir ve Teknik Hesap Yöneticisi ile iletişime geçilerek kontrol edilebilir.
customdata	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Teklif verenin exchange'in çerezinde veri ayarlamasına olanak tanıyan isteğe bağlı özellik. Dize, Base85 çerez güvenli karakterlerinden oluşmalı ve herhangi bir biçimde olmalıdır. "Çıkış karakterli" tırnak işaretlerini dahil etmek için uygun JSON kodlaması kullanılmalıdır.
nbr	Hayır	TeklifNedeni Yok	Desteklenmiyor	2,3 2,4 2,5		Teklif vermeme nedeni.
ext	Hayır	BidResponseExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.bid_response] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için BidResponse mesajındaki ext alanıyla erişirsiniz.

TeklifYanıtExt

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
processing_time_ms	Hayır	int32 [int32]	BidResponse.processing_time_ms	Bu değeri, isteği aldığınız andan yanıtı döndürüldüğü ana kadar milisaniye cinsinden işleme süresine ayarlayın.

Koltuk teklifi

Teklif yanıtında, her biri farklı bir teklif veren kullanıcı adına ve her biri bir veya daha fazla ayrı teklif içeren birden fazla SeatBid nesnesi bulunabilir. İstekte birden fazla gösterim sunulursa bir koltuk, kazanabileceği gösterimleri kabul etmeye istekli olup olmadığını (varsayılan) veya yalnızca grup olarak tümünü kazanabildiyse yalnızca kazanmak isteyip istemediğini belirtmek için grup özelliğini kullanabilir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
bid	Hayır	Bid nesne dizisi	BidResponse.Reklam	2,3 2,4 2,5		Her biri bir gösterimle ilgili olan 1+ Bid nesnesinden oluşan dizi. Birden fazla teklif aynı gösterimle ilgili olabilir.
seat	Hayır	string	BidResponse.Ad. AdSlot.buyer_reporting_id	2,3 2,4 2,5		Adına bu teklifin yapıldığı alıcı koltuğunun kimliği (örneğin, reklamveren, ajans).
group	Hayır	bool	Desteklenmiyor	2,3 2,4 2,5		0 = gösterimler tek tek kazanılabilir; 1 = gösterimler grup olarak kazanılmalıdır. Varsayılan = yanlış

Teklif

SeatBid nesnesi, her biri impid özelliği aracılığıyla teklif isteğindeki belirli bir gösterimle ilişkili olan ve bu gösterimi belirli bir fiyat karşılığında satın almak için bir teklif oluşturan bir veya daha fazla Bid nesnesi içerir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Destekleniyor		Uygulama ayrıntıları
				sürüm	Google tarafından sunulur
id	Evet	string	Herhangi bir alanla eşleştirilmemiştir ancak BidRequest.id ile doğrulanmıştır.	2,3 2,4 2,5		Bunun yanıtlandığı teklif isteğinin kimliği. OpenRTB spesifikasyonu tarafından GEREKLİ.
impid	Evet	string	BidResponse.Ad.AdSlot.id	2,3 2,4 2,5		İlgili teklif isteğindeki Imp nesnesinin kimliği. OpenRTB spesifikasyonu tarafından gerekli.
price	Evet	double	BidResponse.Ad.AdSlot.max_cpm_micros * 1.000.000	2,3 2,4 2,5		Gerçek işlem yalnızca bir birim gösterim için olsa da teklif fiyatı BGBM olarak ifade edilir. Tür, kayan nokta olduğunu belirtirken, para birimlerini işlerken tam sayı matematiğinin kesinlikle önerildiğini unutmayın (örneğin, Java'da BigDeimal). OpenRTB spesifikasyonu tarafından gerekli.
adid	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Teklif kazanırsa yayınlanacak önceden yüklenmiş bir reklamın kimliği.
nurl	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Teklif kazanırsa exchange tarafından çağrılan kazanma bildirimi URL'si; isteğe bağlı olarak reklam işaretleme sunma yöntemi. DoubleClick, kazanma bildirimlerini desteklemiyor. Snippet'in gösterim URL'sinde %%WINNING_PRICE%% veya ${AUCTION_PRICE} kullanın.
adm	Hayır	string	BidResponse.Ad.html_snippet, BidResponse.Ad.video_url, BidResponse.Ad.video_vast_xml veya BidResponse.Ad.native_ad	2,3 2,4 2,5		Teklifin kazanması durumunda reklam işaretlemenin aktarılmasına ilişkin isteğe bağlı yöntem; işaretlemenin her ikisine de dahil edilmesi durumunda kazanma işaretinin yerini alır. Yerel reklam teklifleri için tam olarak {adm, adm_native} kullanılmalıdır. Bu, JSON serileştirme için OpenRTB uyumlu alandır.
adm_native	Hayır	DoğalYanıt	BidResponse.Ad.native_ad	2,3 2,4 2,5		Yerel reklam yanıtı. Yerel reklam teklifleri için tam olarak {adm, adm_native} kullanılmalıdır. Bu alan, Protobuf serileştirme işlemi için kullanılan alandır.
adomain	Hayır	Dize dizisi	BidResponse.Ad.click_through_url	2,3 2,4 2,5		Engellenenler listesi kontrolü için reklamveren alanı (örneğin, "adalanadi.com"). Bu, reklam öğelerini dönüşümlü yayınlama durumu için bir dizi olabilir. Exchange'ler yalnızca bir alana izin verilmesini zorunlu kılabilir. OpenRTB spesifikasyonu yalnızca adomain alan adlarına izin verir. Authorized Buyers da tam URL'leri destekler. Bunun taranabilir bir alan adı veya URL olması gerektiğini unutmayın. Yerel reklamlar için adomain yerine BidResponse.seatbid[].bid[].adm_native.link.url kullanmanızı öneririz.
bundle	Hayır	string	BidResponse.Ad.advertised_app_id	2,3 2,4 2,5		Uygulamanın Apple App Store, Google Play gibi bir uygulama mağazasındaki mağaza kimliği. CTV uygulama mağazaları için beklenen dizeler hakkında daha fazla bilgi için OTT/CTV Mağazası Tarafından Atanmış Uygulama Tanımlama Kuralları'nı inceleyin. Google Play Store'daki mobil uygulamalar için com.foo.mygame gibi paket veya paket adları olmalıdır. Apple App Store'daki uygulamalar için sayısal bir kimlik olmalıdır. Google: Uygulama tanıtım türlerine özel özelliklerden yararlanmak için bu alana ek olarak bid.ext.app_promotion_type alanını ayarlayın.
iurl	Hayır	string	Desteklenmiyor	2,3 2,4 2,5		Reklam kalitesi/güvenlik kontrolü için kampanya içeriğini temsil eden bir resme önbellek bozmayan URL.
cid	Hayır	string	BidResponse.Ad.AdSlot.billing_id	2,3 2,4 2,5		Reklam kalitesi kontrolüne yardımcı olan kampanya kimliği; iurl değerini temsil etmesi gereken reklam öğelerinin toplanması. Ön hedeflemedeki faturalandırma kimliğiyle eşleşir. Alıcının billing_id değerlerinden birine ayarlanmazsa teklif yanıtı geçersiz olarak kabul edilir. İstekte birden fazla billing_id belirtilmişse veya teklif verenin etkin alt lisansları varsa yanıtta reklam öğeleri gönderilirken cid gereklidir.
crid	Hayır	string	BidResponse.Ad.buyer_creative_id	2,3 2,4 2,5		Reklam kalitesi kontrolüne yardımcı olacak reklam öğesi kimliği.
cat	Hayır	Dize dizisi	BidResponse.Ad.category	2,3 2,4 2,5		Reklam öğesinin IAB içerik kategorileri.
attr	Hayır	CreativeAttribute nesne dizisi	BidResponse.Ad.attribute	2,3 2,4 2,5		Reklam öğesini açıklayan özellik grubu. OpenRTB'de bid.attr (OpenRTB) veya bid.ext.attribute (AdX) olarak tanımlanabilir.
api	Hayır	APIFramework	Bid.api, VPAID ve MRAID sürümlerine karşılık gelen 1, 2, 3 ve 5 özelliklerinin tanımlanmasını destekler	2,3 2,4 2,5		Varsa, işaretleme için API gerekir.
protocol	Hayır	Protokol	Desteklenmiyor	2,3 2,4 2,5		Mümkünse işaretlemenin video yanıtı protokolü.
qagmediarating	Hayır	QAGMediaPuanı	Desteklenmiyor	2,3 2,4 2,5		QAG yönergelerine göre reklam öğesi medyası derecelendirmesi.
dealid	Hayır	string	BidResponse.Ad.AdSlot.deal_id (veya teklif veren bir üçüncü taraf exchange ise BidResponse.Ad.AdSlot.exchange_deal_id)	2,3 2,4 2,5		Bu teklif özel pazar yeri doğrudan anlaşmasıyla ilgiliyse teklif isteğinden deal.id referansı.
w	Hayır	int32 [int32]	BidResponse.Ad.width - yalnızca gösterim çok boyutluysa gereklidir	2,3 2,4 2,5		Reklam öğesinin, cihazdan bağımsız piksel (DIPS) cinsinden genişliği.
h	Hayır	int32 [int32]	BidResponse.Ad.height - yalnızca gösterim çok boyutluysa gereklidir	2,3 2,4 2,5		Reklam öğesinin cihazdan bağımsız piksel (DIPS) cinsinden yüksekliği.
exp	Hayır	int32 [int32]	Desteklenmiyor	2,4 2,5		Teklif verenin açık artırma ve gerçek gösterim arasında beklemeye hazır olduğu saniye sayısına dair bilgilendirme.
burl	Hayır	string	gösterim_tracking_url	2.5		Kazanan bir teklif exchange'e özel iş politikasına (örneğin, genellikle yayınlanan, görüntülenen vb.) göre faturalandırılabilir hale geldiğinde exchange tarafından çağrılan faturalandırma bildirimi URL'si. Değiştirme makroları kullanılabilir. BidExt.impression_tracking_url, yinelenen faturalandırma bildirimi URL'leri listesini kabul ettiğini unutmayın. Kullanım alanınız birden fazla faturalandırma URL'si gerektiriyorsa burl yerine bu uzantıyı kullanın.
lurl	Hayır	string	Desteklenmiyor	2.5		Bir teklifin kaybolduğu bilindiğinde exchange tarafından çağrılan kayıp bildirimi URL'si. Değiştirme makroları kullanılabilir. Exchange'e özel politika, kayıp bildirimlerinin desteklenmesini veya kazanan temizleme fiyatlarının açıklanmasını engelleyebilir. Bu durumda ${AUCTION_PRICE} makroları kaldırılır (ör. sıfır uzunlukta bir dizeyle değiştirilir).
tactic	Hayır	string	Desteklenmiyor	2.5		Alıcıların, teklifleri gönderildikleri taksoniğe raporlamak için teklifleri etiketlemesini sağlayan taktik kimliği. Taktik kimliğinin özel kullanımı ve anlamı, alıcı ile exchange'ler arasında bir öncelik taşımalıdır.
language	Hayır	string	Desteklenmiyor	2.5		ISO-639-1-alpha-2 kullanılan reklam öğesinin dili. Reklam öğesinde dilsel içerik (ör. yalnızca şirket logosu içeren bir banner) yoksa standart olmayan "xx" kodu da kullanılabilir.
wratio	Hayır	int32 [int32]	Desteklenmiyor	2.5		Boyutu oran olarak ifade ederken reklam öğesinin göreli genişliği. Esnek reklamlar için gereklidir.
hratio	Hayır	int32 [int32]	Desteklenmiyor	2.5		Boyutu oran olarak ifade ederken reklam öğesinin göreli yüksekliği. Esnek reklamlar için gereklidir.
ext	Hayır	BidExt nesne	Desteklenmiyor	2,3 2,4 2,5		OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.bid] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için Teklif mesajındaki ext alanıyla erişirsiniz.

Teklif Ekstresi

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
impression_tracking_url	Hayır	Dize dizisi	BidResponse.Ad.impression_tracking_url	Gösterim oluşturulduğunda çağrılacak URL'ler. Bu özellik, tüm envanter türleri ve biçimler için desteklenir. OpenRTB 2.5'te Bid.burl, benzer standart alandır.
ad_choices_destination_url	Hayır	string	BidResponse.Ad.ad_choices_destination_ URL'si	Bir reklam tercihlerini veya kapsam dışında kalma sayfasını bağlayın. Varsa yerel reklam öğesine standart bir AdChoices simgesi eklenir ve bu URL'ye bağlanır. Bu, yerel reklamlar için desteklenir ancak teklif yanıtında yerel mesajın bir parçası değildir.
click_tracking_url	Hayır	string	BidResponse.Ad.click_tracking_URL'si	Kullanıcı reklamı tıkladığında aranacak URL'ler. Şu anda yalnızca yerel reklamlar ve yayıncı tarafından yönetilen reklam öğelerine sahip Programatik Garantili anlaşmalar için desteklenir. Yayıncı tarafından yönetilen durumlarda, bu tıklama izleyiciler teklif veren sunucusuna sunucuya gönderilir. Diğer tüm durumlarda bunlar kullanıcının cihazından gönderilir. Yayıncı tarafından yönetilen reklam öğeleri hakkında daha fazla bilgi için Yayıncı tarafından yönetilen reklam öğeleri bölümüne bakın.
bidder_name	Hayır	string	BidResponse.Ad.teklif veren_adı	Authorized Buyers teklif verenleri (Ad Manager'da gerçek zamanlı teklif verme sağlayan üçüncü taraf exchange'ler) için exchange'in reklamı sağlamak üzere çağırdığı teklif verenin adı. Bu, rastgele bir UTF8 metnidir ancak teklif vereni tanımlamak için yeterli olmalı ve aynı teklif veren için tutarlı olarak aynı değere ayarlanmalıdır.
exchange_deal_type	Hayır	Enum ExchangeDealType	BidResponse.Ad.AdSlot.exchange_deal_type	OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3; varsayılan = OPEN_AUCTION
attribute	Hayır	int32 dizisi	BidResponse.Ad.özelliği	Kimliklerin listesi için alıcı-beyan edilebilir-reklam öğesi-özellikleri.txt konusuna bakın. Bildirilebilir özelliklerin tümünün çeşitli battr alanlarındaki BidRequest'ten gelmediğini unutmayın. Birçok teklif veren, ekran genişliğinin ve yüksekliğinin tamamını kaplamak için dinamik olarak yeniden boyutlandırılan "değişken" ("duyarlı" veya "boyutsuz" olarak da bilinir) özelliği için bu özelliği bildirir. Daha fazla bilgi için Geçiş Reklamları kılavuzundaki açıklamaya bakın.
amp_ad_url	Hayır	string	BidResponse.Ad.amp_ad_url	AMPHTML reklamı alınacak URL. Şunlardan yalnızca biri ayarlanmalıdır: html_snippet, video_url, amp_ad_url, local_ad.
sdk_rendered_ad	Hayır	SdkRenderedAd nesne	BidResponse.Ad.sdk_rendered_ad	Alıcı tarafından bilinen bir SDK tarafından oluşturulacak reklam. Bu, yalnızca BidRequest bir AppExt.YüklüSdk alt mesajı içerdiğinde kullanılabilir.
event_notification_token	Hayır	EventNotificationToken nesne	BidResponse.Ad.etkinlik_bildirimi_jetonu	Teklif verenler tarafından gönderilen soruna ait gerçek zamanlı geri bildirime dahil edilecek, sorun giderme amacıyla ayarlanan bir jetondur. Jetonun içeriği günlüğe kaydedilmez.
restricted_category	Hayır	int32 dizisi	BidResponse.Ad.restricted_category	Bu snippet'ten gösterilebilecek reklamlar için tüm kısıtlanmış kategoriler. Kimliklerin listesi için ad-restricted-category.txt adresini inceleyin.
billing_id	Hayır	int64	BidResponse.Ad.AdSlot.billing_id	Bu gösterimin ilişkilendirileceği faturalandırma kimliği. Değer, bu gösterim için gönderilen yinelenen BidRequest.Imp.ImpExt.billing_id alanında olmalıdır. BidRequest.Imp.ImpExt.billing_id uzunluğu tam olarak 1 ise ve teklif verenin etkin alt lisansları yoksa bu alan gerekli değildir ve içeriği yoksayılır.
third_party_buyer_token	Hayır	string	BidResponse.Ad.Adslot.third_party_buyer_token	Open Bidding olarak exchange bir aracı ise son üçüncü taraf alıcı bilgilerini tanımlamak için kullanılır. Bu, üçüncü taraf alıcıdan elde edilir ve teklif yanıtında değiştirmeden Google'a iletilmelidir.
buyer_reporting_id	Hayır	string	BidResponse.Ad.Adslot.buyer_reporting_id	Alıcı, harcama yöntemini ve geçersiz trafik metriklerini Sorgu Aracı'ndaki IVT şeffaflık raporunda ayırmak için kullanılacak kimliği beyan etti. 1.000'den az gösterime sahip kimliklerin, metriklerin dökümünü almak için kullanılmayacağını unutmayın. 64 bayttan uzun kimlikler yok sayılır.
skadn	Hayır	SKAdNetworkResponse nesne	BidResponse.Ad.skadn	Reklamverenin SKAdNetwork bilgileri, iOS 14 ve üzeri sürümlerde uygulama yükleme ilişkilendirmesini destekler. Apple'ın SKAdNetwork API'si, reklamverenlerin başarılı bir yüklemenin ardından reklam ağına bir geri gönderme göndererek reklam odaklı uygulama yüklemesini ölçmesine yardımcı olur. Bir yüklemenin reklam gösterimiyle ilişkilendirilebilmesi için reklam ağlarının ağ kimliklerini ve imzalı reklamveren bilgilerini göndermeleri gerekir. Daha fazla bilgi için bu makaleyi inceleyin.
app_promotion_type	Hayır	enum	BidResponse.Ad.app_promotion_type	seatbid.bid.bundle alanında, reklamı yapılan uygulamaya karşılık gelen uygulama tanıtımının türü. Reklamı yapılan uygulama belirtilmemişse bu alan yok sayılır. Bu alan olmadan bundle alanı ayarlandığında, bu alan OTHER olarak ayarlanmış gibi değerlendirilir.
Sdk Tarafından Oluşturulan Reklam
id	Hayır	string	BidResponse.ad[].sdk_rendered_ad.id	Reklamı oluşturacak SDK'nın tanımlayıcısı. İlgili teklif isteğinde gönderilen bir BidRequest.app.ext.installed_sdk.id ile eşleşmelidir.
rendering_data	Hayır	string	BidResponse.ad[].sdk_rendered_ad.rendering_data	Reklamı oluşturmak için SDK'ya aktarılacak veriler. Bu veriler hem yayıncı hem de Google için şeffaf değildir.
declared_ad	Hayır	DelcaredAd	BidResponse.ad[].sdk_rendered_ad.declared_ad	Reklam SDK'sı ve özel engellemelerle oluşturulan yayıncı reklamları için reklam öğesi taramasını, sınıflandırmayı ve zorunlu kılmayı destekleyen reklam öğeleri tanımlandı. Yalnızca bir html_snippet, video_url, video_vast_xml veya native_response ayarlayın.
Etkinlik Bildirimi Jetonu
payload	Hayır	string	BidResponse.ad[].event_notification_token	Jetonun içeriği (128 bayttan uzunsa yoksayılır).
SKAdNetworkYanıt
version	Hayır	string	BidResponse.ad[].skadn.version	Reklamveren tarafından desteklenen SKAdNetwork sürümü. İmzanın reklamveren tarafından nasıl oluşturulduğunu belirtmek için de kullanılır. Bu, BidRequest.imp.ext.skad.versions sürümlerinden biriyle eşleşmelidir.
network	Hayır	string	BidResponse.ad[].skadn.network	İmzada kullanılan reklam ağı tanımlayıcısı. Bu öğe, BidRequest.imp.ext.skad.skadnetids içindeki öğelerden biriyle eşleşmelidir.
campaign	Hayır	string	BidResponse.ad[].skadn.campaign	Kampanya kimliği Apple'ın spesifikasyonlarıyla uyumludur. SKAdNetwork 3.0 ve önceki sürümlerde kullanılır. SKAdNetwork 4.0 ve sonraki sürümlerde BidResponse.imp.ext.skad.sourceidentifier alanıyla değiştirilir.
sourceidentifier	Hayır	string	BidResponse.ad[].skadn.source_identifier	Reklam ağlarının reklam kampanyasını temsil etmek için tanımladığı dört basamaklı bir tam sayı. SKAdNetwork 4.0 ve sonraki sürümlerde kullanılır ve BidResponse.imp.ext.skad.campaign alanının yerini alır.
itunesitem	Hayır	string	BidResponse.ad[].skadn.itunesitem	Apple'ın uygulama mağazasında reklamverenin uygulamasının kimliği.
productpageid	Hayır	string	BidResponse.ad[].skadn.product_page_id	Gösterilecek özel ürün sayfasının kimliği (iOS 15 veya üstü için). Belirtilmezse varsayılan ürün sayfası gösterilir. Özel ürün sayfaları hakkında daha ayrıntılı bilgi için bu makaleyi inceleyin.
fidelities	Hayır	Fidelity nesne dizisi	BidResponse.ad[].skadn.fidelities	Sürüm 2.2'den itibaren SKAdNetwork API, SKAdNetwork imzasının fidelity-type parametresi tarafından belirtilen birden fazla reklam sunma seçeneğini destekler. Bu, desteklenen her doğruluk türü için farklı olacak imzayı oluşturmak üzere kullanılan parametreleri içerir. Daha fazla bilgi için bu makaleyi inceleyin.
nonce	Hayır	string	BidResponse.ad[].skadn.nonce	İmza oluşturmak için kullanılmak üzere reklamveren tarafından oluşturulan benzersiz tamamen küçük harfli UUID. Not: Bu alan, birden fazla kalite türünü desteklemek için BidResponse.bid.ext.skadn.fidelities.nonce alanının lehine kullanımdan kaldırılacaktır.
sourceapp	Hayır	string	BidResponse.ad[].skadn.sourceapp	Apple'ın uygulama mağazasındaki yayıncı uygulamasının kimliği. Bu, BidRequest.imp.ext.skad.sourceapp kimliği ile eşleşmelidir.
timestamp	Hayır	string	BidResponse.ad[].skadn.timestamp	İmza oluşturulurken kullanılan milisaniye cinsinden milisaniye cinsinden süre. Not: Bu alan, birden fazla doğruluk türünü desteklemek için BidResponse.bid.ext.skadn.fidelities.timestamp alanı yerine kullanımdan kaldırılacaktır.
signature	Hayır	string	BidResponse.ad[].skadn.signature	SKAdNetwork imzası. Not: Bu alan, birden fazla doğruluk türünü desteklemek için BidResponse.bid.bidtexs.skadn.fidelities.signature alanının yerine kullanımdan kaldırılacaktır.
skoverlay	Hayır	SKOverlay nesne	BidResponse.ad[].skadn.skoverlay	Bu seçenekler, reklamı yapılan uygulamayı öneren SKOverlay'in nasıl sunulacağını gösterir. iOS 14 ve üzeri sürümler tarafından desteklenir.

Bildirilen Reklam nesnesi

Reklam SDK'sı ve özel engellemelerle oluşturulan yayıncı reklamları için reklam öğesi taramasını, sınıflandırmayı ve zorunlu kılmayı destekleyen reklam öğeleri tanımlandı.

Yalnızca bir html_snippet, video_url, video_vast_xml veya native_response ayarlayın.

Üst öğe

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
html_snippet	Hayır	string	BidResponse.ad[].sdk_rendered_ad.declared_ad.html_snippet	SDK tarafından oluşturulan reklamın HTML snippet'i temsilcisi.
video_url	Hayır	string	BidResponse.ad[].sdk_rendered_ad.declared_ad.video_url	SDK tarafından oluşturulan reklamda kullanılan VAST öğesinin URL'si.
video_vast_xml	Hayır	string	BidResponse.ad[].sdk_rendered_ad.declared_ad.video_vast_xml	SDK tarafından oluşturulan özel reklamı oluşturmak için kullanılan VAST dokümanı. Bu doküman, VAST 2.0 veya 3.0 standardına uygun olmalıdır.
native_response	Hayır	NativeResponse	BidResponse.ad[].sdk_rendered_ad.declared_ad.native_response	Yerel reklamın içeriği. Yerel reklamlar, alıcı SDK'sı tarafından oluşturulan birden fazla yapı taşından oluşur. OpenRTB Native 1.2 standart NativeResponse tanımıyla eşleşmelidir. NativeResponse.assets.img.type gerekli.
click_through_url	Hayır	string	BidResponse.ad[].sdk_rendered_ad.declared_ad.click_through_url	SDK tarafından oluşturulan reklamın son açılış sayfaları.

Doğruluk

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
fidelity	Hayır	SKAdNetworkFidelityType	BidResponse.ad[].skadn.fidelity_type	İzlenecek ilişkilendirmenin doğruluk türü. Varsayılan = STOREKIT_RENDERED_ADS. VIEW_THROUGH_ADS = 0; Bir reklamın en az 3 saniye boyunca görüntülenmesinden sonraki 24 saat içinde uygulama yüklemeleri için ilişkilendirme. SKAdnetwork sürüm 2.2 ve sonraki sürümlerde desteklenir. Daha fazla bilgi için bu makaleyi inceleyin. STOREKIT_RENDERED_ADS = 1; Mağaza Tıklaması ile oluşturulan App Store ürün sayfasından başlatılan ve reklam tıklamalarıyla sağlanan uygulama yüklemeleri ilişkilendirmesi. Tüm SKAdNetwork sürümleri için desteklenir. Daha fazla bilgi için bu makaleyi inceleyin.
nonce	Hayır	string	BidResponse.ad[].skadn.nonce	İmza oluşturmak için kullanılmak üzere reklamveren tarafından oluşturulan benzersiz tamamen küçük harfli UUID.
timestamp	Hayır	string	BidResponse.ad[].skadn.timestamp	İmza oluşturulurken kullanılan milisaniye cinsinden milisaniye cinsinden süre.
signature	Hayır	string	BidResponse.ad[].skadn.signature	SKAdNetwork imzası.

SK Yer Paylaşımı

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
delay	Hayır	int32 [int32]	BidResponse.ad[].skadn.skoverlay.delay_seconds	Yer paylaşımını sunmadan önce reklam başladıktan sonra saniye cinsinden gecikme. Bu alan 0 olarak ayarlanırsa yer paylaşımı, reklam başlar başlamaz gösterilir. Bu alan ayarlanmadan bırakılırsa reklam için yer paylaşımı gösterilmez.
endcarddelay	Hayır	int32 [int32]	BidResponse.ad[].skadn.skoverlay.endcard_delay_seconds	Yer paylaşımını sunmadan önce bitiş kartı gösterildikten sonra saniye cinsinden gecikme. (Bu alan yalnızca ödüllü veya geçiş video reklam öğeleri için geçerlidir.) Bu alan 0 olarak ayarlanırsa yer paylaşımı, bitiş kartı gösterildikten hemen sonra gösterilir. Bu alan ayarlanmadan bırakılırsa bitiş kartı için yer paylaşımı gösterilmez. Hem delay hem de endcarddelay ayarlanırsa reklam sona erdiğinde yer paylaşımı otomatik olarak kapatılır ve bitiş kartı gösterildikten sonra tekrar gösterilir.
dismissible	Hayır	bool	BidResponse.ad[].skadn.skoverlay.dismissible	Bu yer paylaşımının kullanıcı tarafından kapatılıp kapatılamayacağını belirtir. Varsayılan olarak true değerini alır.

Yerel teklif değişkenleri, tanımlar ve uzantılar

Doğal İstek

Native nesnesi, bu teklif isteği aracılığıyla teklif için kullanılabilecek yerel reklamcılık fırsatını tanımlar. Açık artırma için sunulan gösterim bir yerel reklam biçimiyse doğrudan gösterim nesnesine dahil edilmelidir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
ver	Evet	string	OpenRTB 2.5 için "1.2".	Kullanımdaki Yerel İşaretleme sürümünün sayısı.
layout	Hayır	Düzen kimliği	Desteklenmiyor	Yerel reklam biriminin Düzen Kimliği. Kullanımdan kaldırılacak olan, OpenRTB Native 1.0 tarafından 1.1'de isteğe bağlıdır.
adunit	Hayır	Reklam Birimi Kimliği	Desteklenmiyor	Yerel reklam biriminin Reklam birimi kimliği. Bu, IAB Core 6 yerel reklam birimlerinden birine karşılık gelir. OpenRTB Native 1.0 tarafından ÖNERİLİR; kullanımdan kaldırılması için 1.1'de isteğe bağlıdır.
context	Hayır	Bağlam Türü	Desteklenmiyor	Reklamın gösterildiği bağlam.
contextsubtype	Hayır	BağlamAlt Türü	Desteklenmiyor	Reklamın gösterildiği daha ayrıntılı bir bağlam.
plcmttype	Hayır	YerleşimTürü	NativeAdTemplate.native_placement_type	Sunulan reklam biriminin tasarımı/biçimi/düzeni.
plcmtcnt	Hayır	int32 [int32]	Desteklenmiyor	Bu Layout'taki özdeş yerleşimlerin sayısı.
seq	Hayır	int32 [int32]	Desteklenmiyor	İlk reklam için 0, ikinci reklam için 1 vb. Bunun genellikle plcmtcnt ile birlikte KULLANILMADIĞINI unutmayın. Birden çok özdeş yerleşim için açık artırma (bu durumda plcmtcnt>1, seq=0) yapar veya feed'deki farklı öğeler için ayrı açık artırmalar düzenlersiniz (bu durumda plcmtcnt=1, seq>=1).
assets	Hayır	Asset nesne dizisi	NativeAdTemplate nesnesinde destekleniyor. OpenRTB öğeleri alanı, AdX proto native_ad_template alanıyla eşlenir. Bire bir eşleme değildir. Google AdX protokolü aynı mesajı, NativeAdTemplate nesnesi aracılığıyla iletir. required_fields ve recommended_fields alanları ise teklif verene hangi öğelerin gerekli olduğunu veya önerildiğini bildirir. NativeAdTemplate, image_width gibi diğer alanları da içerir. OpenRTB'deki assets alanındaki bilgiler, AdX'teki birden fazla alan üzerinden ifade edilir.	Tüm teklifler, Exchange tarafından tanımlanan öğe dizisine uygun olmalıdır. OpenRTB Yerel spesifikasyonu tarafından gerekli: en az 1 öğe.
aurlsupport	Hayır	bool	Desteklenir.	Tedarik kaynağının / gösteriminin, bir öğe nesnesi yerine Asseturl döndürmeyi destekleyip desteklemediği. 0 veya alan yoksa böyle bir destek sunulmaz. 1.2 sürümünde uygulandı
durlsupport	Hayır	bool	Desteklenir.	Tedarik kaynağının / gösteriminin, öğe nesnesi yerine DCO URL'si döndürmeyi destekleyip desteklemediğini öğrenin. 0 veya alan yoksa böyle bir destek sunulmaz. 1.2 sürümünde uygulanmıştır. Beta özelliği.
eventtrackers	Hayır	EventTrackers	OpenRTB 1.2 sürümü, IMPRESSION ve IMG izlemeyi destekler. OMSDK yerel için etkinleştirilmişse JS destekleniyor	Desteklenen etkinlik izleme türünü belirtir. 1.2 sürümünde uygulandı
privacy	Hayır	bool	Desteklenmiyor	Yerel reklam, alıcıya özel gizlilik bildirimini desteklediğinde 1 olarak ayarlanır. Yerel reklam özel gizlilik bağlantılarını desteklemiyorsa veya destek bilinmiyorsa 0 (veya alan yok) olarak ayarlayın. ÖNERİLİR ve 1.2 sürümünde uygulanır. Gönderdiğimiz tüm yerel istekler bir gizlilik URL'sini desteklediğinden bu, yerel istekler için her zaman dolaylı olarak "1"dir.
ext	Hayır	NativeRequestExt nesne	Destekleniyor	OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.native_ext] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için NativeRequest mesajındaki ext alanıyla erişirsiniz.

Yerel Talep Harici

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
style_id	Hayır	int32 [int32]	BidRequest.AdSlot. native_ad_template[0].style_id	Yerel reklamın oluşturulduğu belirli bir stil, HTML ve CSS için genel olarak farklı kimlik.
style_height	Hayır	int32 [int32]	BidRequest.AdSlot. native_ad_template[0] .style_height	style_layout_type Pixel ise bu değer, yerel reklamın oluşturulmasından sonra tüm reklamın yüksekliğidir.
style_width	Hayır	int32 [int32]	BidRequest.AdSlot. native_ad_template[0] .style_width	style_layout_type değeri Pixel ise bu değer, oluşturma işleminden sonra yerel reklamın tamamının genişliğidir.
style_layout_type	Hayır	enum LayoutType	BidRequest.AdSlot. native_ad_template[0] .style_layout_type	Enum LayoutType: PIXEL = 0; (Varsayılan) FLUID = 1;

Öğe

Oluşturma istemcisi adına Exchange tarafından istenen veya desteklenen her öğenin ana kapsayıcı nesnesi. Gerekli tüm nesneler bu şekilde işaretlenmelidir. Her nesnede {title,img,video,data} nesnelerinden yalnızca biri bulunmalıdır. Diğer tüm öğeler boş olmalıdır. Yanıtın uyumlu hale getirilebilmesi için id, Asset dizisi içinde benzersiz olmalıdır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
id	Evet	int32 [int32]	1..N, ilk NativeAdTemplate içindeki önerilen veya gerekli alanlara karşılık gelen, belirtilmemiş bir sırada N öğe için.	Exchange tarafından atanan benzersiz öğe kimliği. Genellikle dizi için bir sayaçtır. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.
required	Hayır	bool	BidRequest.AdSlot.native_ad_template[0]. gerekli_alanlar	Öğe gerekiyorsa "true" olarak ayarlayın.
title	Hayır	İstek Başlığı	HEADLINE türündeki BidRequest.AdSlot.native_ad_template[0]	Başlık öğeleri için Title nesne. OpenRTB Yerel spesifikasyonu tarafından ÖNERİLİR. Bir Title, Image, Data, Video.
img	Hayır	İstek Resmi	ANA/IMAGE, ICON/APP_ICON, LOGO/LOGO türleri için BidRequest.AdSlot.native_ad_template[0]	Resim öğeleri için Image nesnesi. OpenRTB Yerel spesifikasyonu tarafından ÖNERİLİR. Bir Title, Image, Data, Video.
video	Hayır	Video	BidRequest.AdSlot.NativeAdTemplate.required_fields	Video öğeleri için Video nesne. Video içi reklamların Yerel reklamlar kapsamında olmadığını unutmayın. Yerel reklamlar, reklam öğesinin kendisi olarak bir video içerebilir. Teklif istekleri, NativeRequest.assets[].required değerini true olarak ayarlayıp bir NativeRequest.assets[].video belirterek Yerel Yanıt'ta videonun gerekli olduğunu gösterebilir. OpenRTB Yerel spesifikasyonu tarafından ÖNERİLİR. Bir Title, Image, Data, Video.
data	Hayır	Veriler	BidRequest.AdSlot.native_ad_template[0] türleri CTATEXT/CALL_TO_ACTION, DESC/Body, SPONSORED/REKLAMVEREN, FİYAT/FİYAT, RATING/STAR_RATING	Puanlar, fiyatlar vb. için Data nesnesi. OpenRTB Yerel spesifikasyonu tarafından ÖNERİLİR. Bir Title, Image, Data, Video.

Başlık

Title nesnesi, Yerel reklamın başlık öğesi için kullanılır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
len	Hayır	int32 [int32]	BidRequest.AdSlot.native_ad_template[0].headline_max_safe_length	Başlık öğesindeki metnin maksimum uzunluğu. Değerin 25, 90, 140 olması önerilir. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.

Resim

Image nesnesi, Yerel reklamın resim öğeleri için kullanılır.

Desteklenmiyor

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
type	Hayır	ImageAssetType	BidRequest.AdSlot.native_ad_template[0] alan türü	Yayıncı tarafından desteklenen resim öğesinin tür kimliği. Yayıncı bu bilgileri uygun bir biçimde gösterebilir.
w	Hayır	int32 [int32]	Desteklenmiyor	Resmin piksel cinsinden genişliği.
h	Hayır	int32 [int32]	Desteklenmiyor	Resmin piksel cinsinden yüksekliği.
wmin	Hayır	int32 [int32]	BidRequest.AdSlot.native_ad_template[0] türü: ANA/IMAGE:image_width LOGO/LOGO: logo_width ICON/APP_ICON: app_icon_width	Resmin piksel cinsinden istenen minimum genişliği. Bu seçenek, istemci tarafından resimlerin yeniden ölçeklendirilmesi için kullanılmalıdır. w veya wmin iletilmeli. Yalnızca w eklenmişse bunun tam bir şart olarak kabul edilmesi gerekir. OpenRTB Yerel spesifikasyonu tarafından ÖNERİLİR.
hmin	Hayır	int32 [int32]	BidRequest.AdSlot.native_ad_template[0] türü: ANA/IMAGE:image_height LOGO/LOGO: logo_height ICON/APP_ICON: app_icon_height	Resmin piksel cinsinden istenen minimum yüksekliği. Bu seçenek, istemci tarafından resimlerin yeniden ölçeklendirilmesi için kullanılmalıdır. h veya hmin iletilir. Yalnızca h eklenmişse bunun tam bir şart olarak kabul edilmesi gerekir. OpenRTB Yerel spesifikasyonu tarafından ÖNERİLİR.
mimes	Hayır	string		Desteklenen içerik MIME türlerinin izin verilenler listesi. Popüler MIME türleri "image/jpg" ve "image/gif"leri içerir ancak bunlarla sınırlı değildir. Entegrasyon dokümanlarında her Exchange'in entegrasyon dokümanlarında desteklenen türlerin kendi listesi olmalıdır. Daha fazla bilgi ve tüm IETF RFC'lerine bağlantılar için Wikipedia MIME sayfasına bakın. Boşsa tüm türlere izin verildiğini varsayalım.

Video

Video nesnesi, Yerel reklamın video öğeleri için kullanılır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
mimes	Evet	Dize dizisi	BidRequest.Video.allowed_video_formatları	İçerik MIME türleri desteklenir. Popüler MIME türleri arasında Windows Media için "video/x-mswmv", Flash Video için "video/x-flv" veya "video/mp4" bulunur, ancak bunlarla sınırlı değildir. Yerel Flash'ın sıklıkla desteklenmediğini unutmayın. OpenRTB Yerel spesifikasyonu tarafından gerekli: en az 1 öğe.
minduration	Evet	int32 [int32]	BidRequest.Video.min_ad_duration	Saniye cinsinden minimum video reklam süresi. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.
maxduration	Evet	int32 [int32]	BidRequest.Video.max_ad_duration	Saniye cinsinden maksimum video reklam süresi. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.
protocols	Evet	Protocol enum dizisi	BidRequest.Video.protokolleri	Yayıncının teklif yanıtında kabul edebileceği bir dizi video protokolü. OpenRTB Yerel spesifikasyonu tarafından gerekli: en az 1 öğe. Örnekler: VAST_1_0 = 1; VAST_2_0 = 2; VAST_3_0 = 3;

Veriler

Data nesnesi; Yerel Derecelendirme'nin Puanlar, Yorum Sayısı, Yıldızlar, İndirme sayısı, açıklamalar gibi temel olmayan tüm öğeleri için kullanılır. Ayrıca, bu dokümanın yazıldığı sırada tasarlanmamış Yerel öğelerin geleceği için de geneldir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
type	Evet	VeriÖğeTürü	BidRequest.AdSlot.native_ad_template[0] alan türü	Yayıncı tarafından desteklenen öğenin tür kimliği. Yayıncı bu bilgileri uygun bir biçimde görüntüleyebilir. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.
len	Hayır	int32 [int32]	BidRequest.AdSlot.native_ad_template[0] türü: DESC/Gövde: body_max_safe_length CTATEXT/CALL_TO_ACTION: harekete_geçirme_maks_güvenli_uzunluk SPONSORED/REKLAMVEREN: reklamveren_max_safe_length FİYAT/FİYAT: price_max_safe_length	Öğenin yanıtındaki metnin maksimum uzunluğu. Not: RATING/STAR_RATING için kullanılmıyor, AdX'in çift 0..5

Etkinlikİzleyiciler

EventTrackers nesnesi, teklif verenin teklif yanıtında izlenmek isteyebileceği etkinlik türlerini ve her etkinlik türü için ne tür izlemelerin bulunduğunu belirtir ve isteğe bir dizi olarak dahil edilir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
event	Evet	EtkinlikTürü	Desteklenmiyor	İzleme için kullanılabilecek etkinlik türü. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.
methods	Evet	Etkinlikİzleme Yöntemi	Desteklenmiyor	Söz konusu etkinlik için kullanılabilen izleme türü dizisi. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.

DoğalYanıt

Yerel yanıt nesnesi, yerel bir yanıtı tanımlayan üst düzey JSON nesnesidir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
ver	Hayır	string	OpenRTB 2.3 için "1.0"; OpenRTB 2.4 için "1.1"	Kullanımdaki Yerel İşaretleme sürümünün sürümü.
assets	Hayır	Öğe dizisi	BidResponse.Ad.native_ad[0]. Tüm öğeler, tek bir NativeAd'in alanlarıyla eşleştirilir.	Yerel reklam öğelerinin listesi.
link	Evet	Bağlantı	BidResponse.Ad.native_ad[0]	Hedef Bağlantısı.OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.
imptrackers	Hayır	Dize dizisi	BidResponse.Ad.impression_tracking_url	1x1 resim veya 204 yanıtı döndürmesi beklenen gösterim izleme URL'leri dizisi. Genellikle yalnızca 3. taraf izleyiciler kullanılırken geçirilir. %%WINNING_PRICE%% makrosu veya ${AUCTION_PRICE} kullanın.
jstracker	Hayır	string	Desteklenmiyor	İsteğe bağlı JavaScript gösterim izleyici. Desteklenebilecek gösterim sırasında yürütülecek script etiketlerini içerir.
eventtrackers	Hayır	EventTracker nesne dizisi	BidResponse.Ad.impression_tracking_url ve BidResponse.Ad.impression_tracking_resource	YerelRequest'te desteklenen desteklenen yöntemlere yanıt olarak reklamla birlikte çalıştırılan yanıt etkinliği izleyicileri dizisi. Gösterim izleyicileri ve jstracker'ların yerini alır. 1.2 sürümünde uygulanmıştır.

Etkinlikİzleyici

Etkinlik izleyicileri yanıtı, bir nesne dizisidir ve teklif verenin izlemek istediği etkinlik türlerini ve bunları izlemek için kullanılacak URL'leri/bilgileri belirtir. Teklif veren, yalnızca istekte kullanılabilir olarak belirtilen yöntemlerle yanıt vermelidir. Çoğu JavaScript izleyicinin gösterim zamanında yüklenmesini beklemeyi unutmayın. Bu nedenle, alıcının diğer etkinliklerde JavaScript izleyicilerle yanıt vermesi genellikle önerilmez ancak bunun uygunluğu, her alıcıya bağlıdır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
event	Evet	tam sayı	Desteklenmiyor	İzlenecek etkinlik türü.
method	Evet	tam sayı	Desteklenmiyor	İstenen izleme türü.
url	Hayır	text (metin)	BidResponse.Ad.impression_tracking_url ve BidResponse.Ad.impressionTrackingResource.script_url	Resmin veya js'nin URL'si. Resim veya js için gerekli, özel için isteğe bağlıdır.
customdata	Hayır	Anahtar:değer çiftleri içeren nesne.	Desteklenmiyor	Exchange ile bireysel olarak kabul edilmek için bir özel anahtar/değer çifti dizisi; örneğin, bir izleme şirketi ile TTP'nin hesap numarası; örneğin, {"accountnumber":"123"}.
ext	Hayır	EventTrackerExt nesne	Desteklenmiyor	OpenRTB/Protobuf için bu nesneye [com.google.doubleclick.eventtrackers] uzantı anahtarıyla erişebilirsiniz (tam yol, proto kitaplığı oluşturmak için kullanılan dile göre değişir). OpenRTB/JSON için EventTracker mesajındaki ext alanıyla erişirsiniz.

Etkinlik İzleyici

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
context	Hayır	Sıralama bağlamı dizisi	BidResponse.Ad.ImpressionTrackingResource.bağlam	Oluşturma için ek bağlam sağlandı. BİLİNMİYOR = 0; OMID = 1; Şu anda desteklenmiyor.
verification_parameters	Hayır	string	BidResponse.Ad.impressionTrackingResource.doğrulama_parametreleri	Yüklendiğinde kaynağa aktarılacak kaynakla ilişkili parametreler. Parametrelerin biçimi komut dosyası satıcısına bağlıdır.
vendor_key	Hayır	string	BidResponse.Ad.impressionTrackingResource.vendor_key	Doğrulama komut dosyası sağlayıcısını benzersiz şekilde tanımlamak için kullanılır.

Bağlantı

"Harekete geçirici mesaj" öğeleri veya Yerel reklamdaki diğer bağlantılar için kullanılır. Bu nesne, üst Asset nesnesindeki eş nesneyle ilişkilendirilmelidir. Eş nesne etkinleştirildiğinde (tıklandığında) işlem, kullanıcıyı bağlantının konumuna götürmelidir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
url	Hayır	string	BidResponse.ad[].native_ad.click_link_url	Tıklanabilir bağlantının açılış URL'si.
clicktrackers	Hayır	Dize dizisi	(NativeResponse.link) BidResponse.Ad.NativeAd.click_tracking_url[0]	URL’nin tıklanmasıyla tetiklenecek üçüncü taraf izleyici URL'leri. Google tıklama izleyicileri, HTTP 30x'i teklif verenin izleyicisine yönlendirir. Birden fazla tıklama izleyiciye izin verilir.
fallback	Hayır	string	Desteklenmiyor	Derin bağlantı için yedek URL. url ile sağlanan URL, cihaz tarafından desteklenmiyorsa kullanılmalıdır.

Öğe

İstekteki Asset nesnesine karşılık gelir. Oluşturma istemcisi adına Exchange tarafından istenen veya desteklenen her öğe için ana kapsayıcı nesnesi. Gerekli tüm nesneler bu şekilde işaretlenir. Nesnelerde {title,img,video,data} nesnelerinden yalnızca biri bulunmalıdır. Diğerlerinin boş olması gerekir. Yanıtın uyumlu hale getirilebilmesi için kimlik, Öğe dizisinde benzersiz olmalıdır.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
id	Evet	int32 [int32]	Desteklenmiyor	Exchange tarafından atanan benzersiz öğe kimliği, istekteki öğe kimliklerinden biriyle eşleşmelidir OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.
required	Hayır	bool	Desteklenmiyor	Öğe gerekiyorsa 1 olarak ayarlayın. (teklif veren, görüntülenmesi gerekir)
title	Hayır	Başlık	AdX: BidResponse.Ad.native_ad[0] / BAŞLIK	Bir Title, Image, Data, Video Başlık öğeleri için başlık nesnesi.
img	Hayır	Resim	BidResponse.Ad.native_ad[0] / IMAGE|LOGO|APP_ICON	Bir Title, Image, Data, Video Resim öğeleri için Image nesnesi.
video	Hayır	Video	BidResponse.Ad.NativeAd.video_url veya BidResponse.Ad.NativeAd.video_vast_xml	Bu, VAST XML içeren bir dize veya NativeResponse.assets[].video.vasttag özelliği aracılığıyla bir VAST dokümanının URL'si olabilir. Video öğeleri için Video nesne. Video içi reklamların Yerel reklamlar kapsamında olmadığını unutmayın. Yerel reklamlar, reklam öğesinin kendisi olarak bir video içerebilir.
data	Hayır	Veriler	BidResponse.Ad.native_ad[0] / GÖVDE|CALL_TO_ACTION|REKLAM|STAR_RATING_PRICE_STORE	Bir Title, Image, Data, Video. Puanlar, fiyatlar vb. için Data nesnesi.
link	Hayır	Bağlantı	BidResponse.Ad.native_ad[0]	Harekete geçirici mesajlar için nesne bağlayın. Bu bağlantı, nesne içindeki diğer doldurulan alanla ilişkilendirilir.

Başlık

İstekteki Title nesnesine karşılık gelen değeri doldurur.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
text	Evet	string	BidResponse.Ad.native_ad[0].headline	Metin öğesiyle ilişkilendirilmiş metin. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.

Resim

İstekteki Image nesnesine karşılık gelir. Doğal reklamın tüm simgeleri (ör. Simgeler, Ana Resim) için kullanılacak Image nesnesi.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
url	Evet	string	İstek öğesi türü için BidResponse.Ad.native_ad[0]: ANA/RESİM: image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: logo.url	Resim öğesinin URL'si. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.
w	Hayır	int32 [int32]	İstek öğesi türü için BidResponse.Ad.native_ad[0]: ANA/RESİM: image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: logo.url	Resmin piksel cinsinden genişliği. OpenRTB Yerel spesifikasyonu tarafından ÖNERİLİR.
h	Hayır	int32 [int32]	İstek öğesi türü için BidResponse.Ad.native_ad[0]: ANA/RESİM: image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: logo.url	Resmin piksel cinsinden yüksekliği.

Video

İstekteki Video nesnesine karşılık gelir, ancak uygun bir VAST etiketinin bir değer olarak değerini içerir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
vasttag	Evet	string	Desteklenmiyor	VAST XML. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.

Veriler

İstekteki Data nesnesine karşılık gelen değeri doldurur. Data nesnesi; Yerel Derecelendirme'nin Puanlar, Yorum Sayısı, Yıldızlar, İndirilenler, Fiyat sayısı gibi çeşitli çeşitli öğeleri için kullanılır. Ayrıca, bu belgenin yazıldığı sırada henüz tasarlanmamış olan gelecekteki Yerel öğeler için de geneldir.

Özellik	Her zaman başarılı	Type	Authorized Buyers'daki eş değeri	Uygulama ayrıntıları
label	Hayır	string	Desteklenmiyor	Gösterilecek veri türünün isteğe bağlı biçimlendirilmiş dize adı.
value	Evet	string	OpenRTB/AdX istek öğesi türü için BidResponse.Ad.native_ad[0]: CTATEXT/CALL_TO_ACTION: harekete geçirici mesaj DESC/Body: gövde SPONSORED/ADVERTISER: reklamveren PRICE/PRICE: fiyat RATING/STAR_RATING: star_rating (AdX, çift 0,.5 gerektirir)	Görüntülenecek verilerin biçimlendirilmiş dizesi. "5 yıldız" veya "10 ABD doları" gibi biçimlendirilmiş bir değer veya "5 üzerinden 3,4 yıldız" içerebilir. OpenRTB Yerel spesifikasyonu tarafından GEREKLİ.

Örnekler

• Örnek teklif istekleri
• Örnek teklif yanıtları