DV360 OpenRTB Spesifikasyonu

Önemli Nokta: Teklif isteklerinin DV360 OpenRTB spesifikasyonuna uygun olduğunu doğrulayın.

Uyarı: Mevcut entegrasyonlar, uyumsuz uzantı spesifikasyonları kullanıyor olabilir.

Bu sayfaya danışırken OpenRTB 2.6 Spesifikasyonu'nu yanınızda bulundurun.

Display & Video 360, OpenRTB spesifikasyonundaki her alanı desteklemez ve nüanslar geçerli olabilir. Bu belgenin bazı bölümlerinde Display & Video 360 uygulamasına özel bilgiler ve öneriler yer alır. Aksi belirtilmedikçe OpenRTB spesifikasyonunda sunulan yönergeleri de uygulamanız gerekir.

Bazı alanlar desteklenmez ancak yine de ayrıştırılır. Bu alanlar doğru şekilde biçimlendirilmelidir ancak teklif sonucunu etkilemez.

Teklif isteği spesifikasyonu

Teklif isteği, gövdesinde teklif isteği nesnesi bulunan bir HTTP Post isteğidir. Gövdenin biçimi Content-Type üstbilgisinde tanımlanır.

İlgili yanıt, teklif verilmeyen bir istek için gövdesi olmayan bir HTTP 204 veya teklif yanıtı gövdesine sahip bir HTTP 200'dür.

Bir teklif isteği hatalı biçimlendirilmişse nbr alanı doldurulmuş bir bid response gövdesiyle HTTP 200 döndürülebilir.

Yanıt biçimi, Accept üstbilgisi tarafından kontrol edilir.

JSON Biçimi

Kabul edilen bir MIME türü sağlanmadığında varsayılan biçim kullanılır.

JSON istekleri ve yanıtları IAB OpenRTB 2.6 Spesifikasyonu'na uygundur. Aşağıdaki belgelerde uzantılar ve alan desteği açıklanmaktadır.

Content-Type: application/json üstbilgisi, JSON teklif isteğini, Accept: application/json ise teklif yanıtlarının JSON biçiminde olması gerektiğini gösterir.

Protobuf Biçimi

NOT: Protobuf desteği beta sürümündedir. İlgileniyorsanız lütfen DV360 ile iletişime geçin.

JSON istekleri ve yanıtları IAB OpenRTB 2.6 Protobuf Spesifikasyonu'na uygundur.

Uzantılar sınırlı destek sunar. İlgileniyorsanız DV360 ile iletişime geçin.

Protobuf teklif isteğini belirtmek için Content-Type: application/x-protobuf başlığını gönderin ve Protobuf teklif yanıtları almak için Accept: application/x-protobuf başlığını ayarlayın.

Teklif isteği nesnesi

Alan	Tür	Ayrıntılar
id	Dize	Zorunlu. Teklif isteğinin benzersiz kimliği. Bu, sunulduktan sonra çok sınırlı bir süre boyunca tek tek istekleri tanımlamak için kullanılabilir.
imp	Imp dizisi	En az 1 imp nesnesi gereklidir. Ses kapsüllerinde birden fazla imp nesnesi desteklenir. Diğer kullanım alanlarında (ör. sayfada birden fazla bağımsız alan) ilk imp nesnesi kullanılır, geri kalanı atılır.
site	Site	Web sitesi istekleri için gereklidir. site ve app özellikleri aynı anda kullanılamaz.
app	Uygulama	Uygulama istekleri için gereklidir. app ve site özellikleri aynı anda kullanılamaz.
device	Cihaz	Zorunlu.
user	Kullanıcı	Zorunlu.
test	Tamsayı	Desteklenmez.
at	Tamsayı	1: Reklamverenin teklif tutarının ücretlendirildiği ilk fiyat açık artırması. 2 (varsayılan): Reklamverenin, ikinci en yüksek teklif verenin teklifinin hemen üzerinde bir ücret ödediği ikinci fiyat açık artırması. 3: Taban fiyat istekte yer alır ve rekabet eden tekliflerle ilgisi yoktur.
tmax	Tamsayı	İsteğe bağlıdır, varsayılan olarak entegrasyona göre özeldir.
wseat	Dize dizisi	İzin verilen alıcı koltuklarının listesi. Tüm reklamverenlerin teklif vermesine izin verilmediği sürece önerilir. Ayarlanmamış, kısıtlama olmadığını gösterir.
bseat	Dize dizisi	Tekliflerinin engellenmesi gereken alıcı koltuklarının listesi. Listelenen alıcıların anlaşmalara ve açık artırmaya teklif vermesi engellenir.
allimps	Tamsayı	Desteklenmez.
cur	Dize dizisi	İsteğe bağlıdır ancak kesinlikle önerilir. Varsayılan olarak entegrasyon başına bir tane oluşturulur. Teklif isteğindeki para birimi, entegrasyon sırasında kaydedilen para birimlerinden biriyle eşleşmelidir. Borsa başına tek para birimini desteklemeniz önemle tavsiye edilir.
wlang	Dize dizisi	Desteklenmez.
bcat	Dize dizisi	IAB içerik kategorilerini kullanarak engellenen reklamveren kategorileri. Ayarlanmadığında engellenen kategori yoktur.
badv	Dize dizisi	Engellenen reklamvereni, reklamveren tarafından sağlanan alana göre belirtin. Ayarlanmamış, engellenen reklamveren olmadığı anlamına gelir.
bapp	Dize dizisi	Desteklenmez.
source	Kaynak	schain için yarı zorunludur.
regs	Regs	İsteğe bağlıdır.
ext	Teklif isteği uzantıları	İsteğe bağlıdır.

Teklif isteği uzantıları nesnesi

Alan	Tür	Ayrıntılar
schain	Tedarik zinciri	yeni entegrasyonlarda bunun yerine Kaynak bölümündeki BidRequest.source.schain alanı kullanılmalıdır.
purch	Tamsayı	Satın alınan trafik parametresi, sahip olunanlar, edinilenler veya başka şekilde teşvik edilen etkinlikler dışındaki mülklerden yönlendirilen trafiktir. Bu, yeni MRC IVT 2.0 Spesifikasyonu'na göre belirlenir. Bu, alıcıya yönelik raporlarda Yayıncı Trafik Kaynağı olarak adlandırılır ve aşağıdaki değerlerden birine sahip olur : 0 (varsayılan): Tanımsız - Değer, teklif isteklerinde gönderilmez. Değer yakalanamıyor; 1: Satın alınan: Sahip olunanlar dışındaki mülklerden yönlendirilen trafik (edinilen veya başka şekilde teşvik edilen etkinlikler). 2: Organik: Doğrudan URL girişi, site arama veya uygulama indirme.
gdemsignals	Dize	GMA SDK'dan bir SCAR API sinyal blobu. GMA SDK trafiği varsa önerilir, aksi takdirde yasaktır.
disable_gma_format	int	gdemsignals sağlanırsa isteğe bağlıdır, aksi takdirde yasaktır. 0 (varsayılan): gdemsignals doldurulduğunda teklif yanıtı adm'si bir JSON blob'udur. 1: JSON blob'u yerine bir reklam etiketi de sağlanır.

Kaynak nesnesi

Alan	Tür	Ayrıntılar
fd	Tamsayı	Nihai gösterim satışı kararından sorumlu tüzel kişi 0 (Varsayılan): Borsa karar verir. 1: Yukarı akış kaynağı karar verir.
tid	Dize	Desteklenmez.
pchain	Dize	Desteklenmez.
schain	Tedarik zinciri	Neredeyse her durumda gereklidir. Bu alan, schain değerinin teklif isteği uzantıları veya kaynak uzantıları aracılığıyla sağlanmasına tercih edilir.
ext	Kaynak uzantıları	İsteğe bağlıdır.

Kaynak uzantıları nesnesi

Bu uzantı, DV3'teki görünürlük ölçümlerinin müşteriye nasıl raporlandığını etkilediği için önemle tavsiye edilir. OMID iş ortağı adı IAB sertifikası listesinde YOKSA MRC, görüntülenebilirlik metriklerinin MRC onaylı metriklerden ayrı olarak raporlanmasını zorunlu kılar. Daha fazla bilgi edinin.

Alan	Tür	Ayrıntılar
omidpn	Dize	OM SDK entegrasyonunun tanımlayıcısı. Bu, OMID iş ortağı nesnesinin "name" parametresiyle aynıdır.
omidpv	Dize	OM SDK entegrasyonunun sürümü. Bu, OMID iş ortağı nesnesinin "versionString" parametresiyle aynıdır.
schain	Tedarik zinciri	yeni entegrasyonlarda bunun yerine Kaynak bölümündeki schain alanı kullanılmalıdır.

Regs object

Alan	Tür	Ayrıntılar
coppa	Tamsayı	0 (varsayılan): COPPA bu istek için geçerli değildir. 1: Bu istek COPPA'ya tabidir.
gdpr	Dize	İsteğin GDPR tüzüklerine tabi olup olmadığını belirten işaret. 0 = hayır, 1 = evet, atlama bilinmediğini gösterir. Daha fazla bilgi için DV360'ın GDPR belgelerine bakın. Yalnızca bir regs.gdpr ve regs.ext.gdpr bekleniyor.
us_privacy	Dize	ABD gizlilik yönetmeliği kapsamındaki tüketici gizliliğiyle ilgili sinyalleri iletir. ABD Gizlilik Dizesi özelliklerini inceleyin. Teklif isteğinde us_privacy dizesini aldığımızda ve IAB dizesi kullanıcının kapsam dışında kalmayı seçtiğini gösterdiğinde Display & Video 360, isteğin kişiselleştirilmiş teklifler için uygun olmadığını kabul eder. IAB sinyalini diğer tedarikçi firmalara iletmeyiz. Yalnızca bir regs.us_privacy, user.us_privacy ve user.ext.us_privacy bekleniyor.
gpp	Dize	Küresel Gizlilik Protokolü'nün izin dizesini içerir. DV360, ABD Ulusal ve Kaliforniya dahil olmak üzere yalnızca bazı GPP bölümlerini kabul eder. IAB Europe TCF bölümleri kabul edilmez. Bunun yerine user.consent veya user.ext.consent kullanın.
gpp_sid	Tam sayı dizisi	Bu işlem için uygulanması gereken Küresel Gizlilik Protokolü izin dizesinin bölümlerinin dizisi.
ext	Regs uzantıları	İsteğe bağlıdır.

Regs extensions object

Alan	Tür	Ayrıntılar
gdpr	Tamsayı	İsteğin, yukarıdaki regs.gdpr bölümünde açıklandığı gibi GDPR yönetmeliklerine tabi olup olmadığını belirten işaret. Yalnızca bir regs.gdpr ve regs.ext.gdpr değeri bekleniyor.
us_privacy	Dize	regs.us_privacy belgelerine göz atın. Yalnızca bir regs.us_privacy, regs.ext.us_privacy ve user.ext.us_privacy bekleniyor.

Gösterim nesnesi

Alan	Tür	Ayrıntılar
id	Dize	Teklif isteği bağlamında bu gösterimin benzersiz tanımlayıcısı (genellikle değer 1 ile başlar ve n gösterim için n'ye kadar artar).
metric	Nesne	Desteklenmez.
banner	Banner	Banner reklam fırsatları için zorunludur.
video	Video	Video reklam fırsatları için gereklidir.
audio	Ses	İşitsel reklam fırsatları için gereklidir.
native	Yerel	Doğal reklam fırsatları için gereklidir.
pmp	Pmp	Bu gösterim için geçerli olan özel pazar yeri anlaşmaları.
displaymanager	Dize	Reklamın oluşturulmasından sorumlu reklam uyumlulaştırma iş ortağının, SDK teknolojisinin veya oynatıcının adı (genellikle video veya mobil). Bazı reklam sunucuları tarafından iş ortağına göre özel reklam kodunu özelleştirmek için kullanılır. Video ve/veya uygulamalar için önerilir.
displaymanagerver	Dize	Reklam uyumlulaştırma iş ortağının, SDK teknolojisinin veya reklamı oluşturmaktan sorumlu oynatıcının (genellikle video veya mobil) sürümü. Bazı reklam sunucuları tarafından iş ortağına göre özel reklam kodunu özelleştirmek için kullanılır. Video ve/veya uygulamalar için önerilir.
instl	Tamsayı	0 (varsayılan): Geçiş reklamı değil. 1: Reklam, geçiş reklamı veya tam ekran reklamdır.
tagid	Dize	Açık artırmayı başlatmak için kullanılan belirli reklam yerleşiminin veya reklam etiketinin tanımlayıcısı. Bu, sorunların hata ayıklaması veya alıcı tarafından optimizasyon için yararlı olabilir.
bidfloor	Kayan	Bu gösterim için BGBM cinsinden ifade edilen minimum teklif.
bidfloorcur	Dize	ISO-4217 alfa kodları kullanılarak belirtilen para birimi.
clickbrowser	Tamsayı	Bir uygulamada reklam öğesi tıklandığında açılan tarayıcının türünü gösterir. 0 (varsayılan): yerleştirilmiş 1: yerel iOS 9.x cihazlardaki Safari View Controller'ın bu alan açısından yerel tarayıcı olarak kabul edildiğini unutmayın.
secure	Tamsayı	Bu gösterim için güvenli bir HTTPS URL'si mi yoksa güvenli olmayan bir HTTP URL'si mi gerekiyor? 0 (varsayılan):insecure 1: secure
iframebuster	Dize dizisi
exp	Tamsayı	Teklifin süresi dolma tarihi, bu alanda bir iş ortağı tarafından gönderilen değer dikkate alınmadan DV360 tarafından ayarlanır. Gösterim bayatlığı aralığından (genellikle 1 saat) sonra alınan gösterim etkinlikleri bayat olarak kabul edilir ve DV360 tarafından faturalandırılabilir olarak değerlendirilmez.
rwdd	Tamsayı	Kullanıcının reklamı görüntülediği için ödül alıp almadığını gösterir. 0 (varsayılan): Ödül verilmedi 1: Ödül verildi Genellikle video reklam uygulamaları, kullanıcıların ücretsiz olarak ek bir haber makalesi okumasına, oyunda ekstra can kazanmasına veya sponsorlu reklamsız müzik oturumu elde etmesine olanak tanır. Ödül genellikle video reklam tamamlandıktan sonra dağıtılır.

Imp uzantısı nesnesi

Alan	Tür	Ayrıntılar
bcrid	Dize	Engellenmesi gereken reklam öğesi kimliklerinin listesi.

Banner nesnesi

Alan	Tür	Ayrıntılar
format	Biçim dizisi	Desteklenen biçimlerin listesi.
w	Tamsayı	h ve w, format alanında birleştirilir. Bunun yerine format kullanmanız önerilir.
h	Tamsayı	h ve w, format alanında birleştirilir. Bunun yerine format kullanmanız önerilir.
wmax	Tamsayı	Desteklenmez.
hmax	Tamsayı	Desteklenmez.
wmin	Tamsayı	Desteklenmez.
hmin	Tamsayı	Desteklenmez.
btype	Tam sayı dizisi	Engellenen banner reklam türlerinin listesi: 1: HTML metin reklamlar 2: HTML banner reklamlar 3: JavaScript reklamlar 4: IFrame reklamlar
battr	Tam sayı dizisi	Aşağıdaki değerler desteklenir: 1: Audio auto play 2: Audio user initiated 3: Expandable automatic 4: Expandable click initiated 5: Expandable rollover initiated 6: Video in banner auto play 7: Video in banner user initiated 8: Pop(over/under/on-exit) 9: Provocative or suggestive 10: "Annoying", Eg: Shaky, Flashing, Flickering, Extreme Animation, Smileys 11: Surveys 12: Yalnızca metin 13: Kullanıcı etkileşimli (oyunlar) 14: Windows iletişim kutusu veya uyarı stili 15: Ses açma/kapama düğmesi var 16: Reklam atlanabilir 17: Flash
pos	Tamsayı	Reklamın konumu: 0 (varsayılan): Bilinmiyor 1: ekranın üst kısmı 2: Desteklenmiyor: ekranın alt kısmı olabilir 3: ekranın alt kısmı 4: Başlık 5: Altbilgi 6: Kenar çubuğu 7: Tam ekran
mimes	Dize dizisi	Desteklenmez. DV360, tüm banner reklam öğeleri için text/html kullanır.
topframe	Tamsayı	0 (varsayılan): Banner bir iframe'de yayınlanır. 1: Desteklenmiyor: Banner, üst çerçevede yayınlanır.
expdir	Tam sayı dizisi	1: Sol 2: Sağ 3: Yukarı 4: Aşağı 5: Genişletilebilir Tam Ekran
api	Tam sayı dizisi	Desteklenen API Çerçeveleri 1: Sol 2: Sağ 3: Yukarı 4: Aşağı 5: Genişletilebilir Tam Ekran
id	Dize	Banner nesnesinin tanımlayıcısıdır ve gösterimde benzersiz olmalıdır. banner nesneleri bir video nesnesiyle kullanıldığında önerilir.
vcm	Tamsayı	Yalnızca video nesnesiyle kullanılan bir banner için geçerlidir. 0: Banner, video reklam öğesiyle aynı anda görünür. 1: Banner, videodan sonraki bitiş kartıdır.

Nesneyi biçimlendirme

Alan	Tür	Ayrıntılar
w	Tamsayı	Cihazdan bağımsız piksel (DIP) cinsinden genişlik.
h	Tamsayı	Cihazdan bağımsız piksel (DIPS) cinsinden yükseklik.
wratio	Tamsayı	Desteklenmez.
hratio	Tamsayı	Desteklenmez.
wmin	Tamsayı	Desteklenmez.

Video nesnesi

Teklif isteğinde video yerleşimini belirtmenizi önemle tavsiye ederiz. Eksik bir yerleşim alanı, bilinmeyen yerleşim olarak sınıflandırılır. Daha ayrıntılı bilgi için konum hedefleme hakkındaki makaleye göz atın.

Alan	Tür	Ayrıntılar
mimes	Dize dizisi	En az bir MIME türü gereklidir. video/flv veya video/x-f4v video/mp4, video/x-mp4 veya application/mp4 video/webm veya video/x-webm video/x-ms-wmv video/3gpp video/ogg veya application/ogg application/javascript veya application/x-javascript
minduration	Tamsayı	Videonun saniye cinsinden minimum süresi. Varsayılan olarak minimum süre yoktur.
maxduration	Tamsayı	Videonun saniye cinsinden maksimum süresi. Varsayılan olarak maksimum süre yoktur.
protocols	Tam sayı dizisi	En az bir desteklenen protokol gereklidir. 1: VAST 1.0 2: VAST 2.0 3: VAST 3.0 4: VAST 1.0 sarmalayıcı 5: VAST 2.0 sarmalayıcı 6: VAST 3.0 sarmalayıcı 7: VAST 4.0 8: VAST 4.0 sarmalayıcı 9: DAAST 1.0 10: DAAST 1.0 sarmalayıcı
w	Tamsayı	Cihazdan bağımsız pikseller (DIPS) cinsinden video oynatıcı genişliği.
h	Tamsayı	Cihazdan bağımsız pikseller (DIP) cinsinden video oynatıcı yüksekliği.
startdelay	Tamsayı	Videodan önce, ara reklam veya videodan sonra gösterilen reklam yerleşimleri için başlangıç gecikmesi (saniye).
placement	Tamsayı	Teklif isteğinde videonun plcmt (ve/veya) yerleşiminin belirtilmesi önemle tavsiye edilir. Her iki alanın da eksik olması, bilinmeyen yerleşim olarak sınıflandırılır. 0 (varsayılan): Bilinmiyor 1: Yayın içi 2: Banner'da 3: Makale içinde 4: Feed'de 5: Kayar Not: Yayın içi (yerleşim veya plcmt türü 1) olarak kabul edilebilmesi için video yerleşimlerinin/gösterimlerinin "ses açık" olarak ayarlanması ve oynatma yönteminde doğru şekilde sinyal verilmesi gerekir (1, 3, 4 ve 5 değerleri uygundur).
plcmt	Tamsayı	Teklif isteğinde videonun plcmt (ve/veya) yerleşiminin belirtilmesi önemle tavsiye edilir. Her iki alanın da eksik olması, bilinmeyen yerleşim olarak sınıflandırılır. 0 (varsayılan): Bilinmiyor 1: Yayın içi 2: Eşlik eden içerik 3: Geçiş reklamı 4: İçerik yok/Bağımsız Not: Yayın içi (yerleşim veya plcmt türü 1) olarak kabul edilebilmesi için video yerleşimlerinin/gösterimlerinin "ses açık" olarak ayarlanması ve oynatma yönteminde doğru şekilde sinyal verilmesi gerekir (1, 3, 4 ve 5 değerleri uygundur). Not: Hem plcmt hem de placement sağlanırsa plcmt öncelikli olur. plcmt'ye geçişle ilgili IAB Kılavuzu'na bakın. Not: plcmt: Accompanying Content (2), placement: In Article (3) olarak kabul edilir. plcmt: No Content/Standalone (4), placement: In feed (4) olarak kabul edilir. placement: In Banner, plcmt içinde eşlenmemiştir.
linearity	Tamsayı	Desteklenmez.
skip	Tamsayı	Video oynatıcının reklamın atlanmasına izin verip vermeyeceği. 0 (varsayılan): Atlanamayan 1: Atlanabilir
skipmin	Tamsayı	Desteklenmez.
skipafter	Tamsayı	Desteklenmez.
sequence	Tamsayı	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.
battr	Tam sayı dizisi	Engellenen reklam öğesi özellikleri.
maxextended	Tamsayı	Uzantıya izin veriliyorsa maksimum uzatılmış video reklam süresi. 0 (varsayılan): Uzantıya izin verilmez -1: Uzantıya izin verilir ve süre sınırı uygulanmaz >0: maxduration değerinin ötesinde desteklenen ek oynatma süresi (saniye cinsinden).
minbitrate	Tamsayı	Kb/sn cinsinden minimum bit hızı.
maxbitrate	Tamsayı	Kb/sn cinsinden maksimum bit hızı.
boxingallowed	Tamsayı	4:3 içeriklerin 16:9 pencerede letterbox biçiminde gösterilmesine izin verilip verilmediğini belirtir. 0: İzin verilmez 1 (varsayılan): İzin verilir
playbackmethod	Tam sayı dizisi	Kullanımda olabilecek oynatma yöntemleri. Hiçbiri belirtilmemişse herhangi bir yöntem kullanılabilir. 0 (varsayılan): Bilinmiyor 1: Otomatik oynatma, ses açık 2: Otomatik oynatma, ses kapalı 3: Oynatmak için tıklayın 4: Fareyle üzerine gelme 5: Görüntü alanına girildiğinde başlatma, ses açık 6: Görüntü alanına girildiğinde başlatma, ses kapalı Not: Varsayılan ses kapalıyken (2, 6 veya 0 oynatma yöntemi) tüm gösterimler, 2, 3, 4 veya 5 türünde bir yayın dışı yerleşim (oRTB 2.5) ya da 2, 3 veya 4 türünde bir Plcmt Subtype sinyali vermelidir.
playbackend	Tamsayı	Oynatmanın sona ermesine neden olan etkinlik. 1: Videonun tamamlanması veya kullanıcı tarafından sonlandırılması 2: Görüntü alanından ayrılma veya kullanıcı tarafından sonlandırma 3: Görüntü alanından ayrılma durumunda, tamamlanana veya kullanıcı tarafından sonlandırılana kadar kayan pencere olarak devam eder
delivery	Tam sayı dizisi	Desteklenen yayınlanma yöntemleri. Hiçbiri belirtilmemişse hepsinin desteklendiği varsayılır. 1: Akış 2: Aşamalı
pos	Tamsayı	Reklamın ekrandaki konumu. 0 (varsayılan): Bilinmiyor 1: ekranın üst kısmı 2: Desteklenmiyor: ekranın alt kısmı olabilir 3: ekranın alt kısmı 4: Başlık 5: Altbilgi 6: Kenar çubuğu 7: Tam ekran
companionad	Banner dizisi	Varsa tamamlayıcı reklamlar.
api	Tam sayı dizisi	0 (varsayılan): Bilinmiyor 1: VPAID 1 2: VPAID 2 3: MRAID 1 4: ORMMA 5: MRAID 2 6: MRAID 3 7: OMID 1 - Aktif Görüntüleme için OMID kullanılarak ölçümün etkinleştirilmesi gerekir. 8: SIMID 1
companiontype	Tam sayı dizisi	Desteklenmez.
maxseq	Tamsayı	Dinamik video kapsülünde döndürülecek maksimum reklam sayısı.
poddur	Tam sayı dizisi	Dinamik video kapsülünün saniye cinsinden maksimum uzunluğu.

Video nesnesi için desteklenen uzantı

Alan	Tür	Ayrıntılar
rewarded	Tamsayı	Bu alan, isteklerin ödüllü olup olmadığını belirtmek için kullanılır. Bu değer tam sayı olarak gönderilmelidir. 0 (varsayılan): ödül verilmez 1: ödül verilir

Ses nesnesi

Alan	Tür	Ayrıntılar
mimes	Dize dizisi	En az bir MIME türü gereklidir. audio/m4a, audio/mp4 veya audio/x-m4a audio/mpeg veya audio/mp3 audio/ogg veya audio/x-ogg
minduration	Tamsayı	Saniye cinsinden minimum reklam süresi.
maxduration	Tamsayı	Saniye cinsinden maksimum reklam süresi.
protocols	Tam sayı dizisi	3: VAST 3.0 6: VAST 3.0 sarmalayıcı 7: VAST 4.0 8: VAST 4.0 sarmalayıcı
startdelay	Tamsayı	Videodan önce gösterilen reklam, ara reklam veya yayın sonrası video reklam yerleşimleri için başlangıç gecikmesi (saniye). -2: Videodan sonra gösterilen reklam -1: Ara reklam 0: Videodan önce gösterilen reklam >0: Ara reklam
sequence	Tamsayı	Desteklenmez.
battr	Tam sayı dizisi	Desteklenmez.
maxextended	Tamsayı	Desteklenmez.
minbitrate	Tamsayı	Kb/sn cinsinden minimum bit hızı.
maxbitrate	Tamsayı	Kb/sn cinsinden maksimum bit hızı.
delivery	Tam sayı dizisi	Desteklenmez.
companionad	Banner nesnesi dizisi	Tüm banner tamamlayıcı reklam öğesi yuvaları.
api	Tam sayı dizisi	Bu gösterim için desteklenen API çerçevelerinin listesi. 7: Omid V1
companiontype	Tam sayı dizisi	Desteklenmez.
maxseq	Tam sayı dizisi	Desteklenmez.
feed	Tamsayı	Ses feed'inin türü. AdCOM 1.0'daki Liste: Feed Türleri'ne bakın. 1: Müzik akış hizmeti 2: FM/AM yayını (kablosuz olarak yayınlanan ancak online akışla da kullanılabilen canlı içerik) 3: Podcast (bir serideki bölümler halinde dağıtılan orijinal, önceden kaydedilmiş içerik) 4: Radyo programı tekrarı (başlangıçta canlı olarak yayınlanan bir radyo programının kaydedilmiş bölümü) 5: Web radyosu (yalnızca online akışla kullanılabilen, AM/FM yayını olarak sunulmayan canlı içerik) 6: Video oyunu (video oyunlarındaki arka plan sesi) 7: Metin okuma (sesli kitaplar, makaleleri okuyabilen web sitesi eklentisi)
stitched	Tamsayı	Desteklenmez.
nvol	Tamsayı	Desteklenmez.

Yerel nesne

Daha fazla bilgi için DV360 doğal reklam özellikleri başlıklı makaleyi inceleyin.

Alan	Tür	Ayrıntılar
request	Dize	Dize, kodlanmış yerel JSON nesnesi.
ver	Dize	1.0: Desteklenmiyor 1.1: Desteklenmiyor 1.2
api	Tam sayı dizisi	Bu gösterim için desteklenen API çerçevelerinin listesi. 7: Omid V1
battr	Tam sayı dizisi	Desteklenmez.

PMP nesnesi

Alan	Tür	Ayrıntılar
private_auction	Tamsayı	0 (Varsayılan): Tüm tekliflere izin verilir 1: Yalnızca fırsatlar
deals	Anlaşma nesnesi dizisi	Dahil edilecek fırsatlar.

Fırsat nesnesi

Alan	Tür	Ayrıntılar
id	Dize	ÖTS nesnesi, kimlik başına birden fazla anlaşma nesnesi içeremez.
bidfloor	Çift	Bu gösterim için BGBM cinsinden minimum teklif. at=3 ise zorunludur.
bidfloorcur	Dize	ISO-4217 alfa kodları kullanılarak belirtilen para birimi. Belirtilmezse varsayılan olarak teklif isteği para birimi kullanılır.
at	Tamsayı	Belirtilmezse varsayılan olarak bid_request.at eşleşir. 1: İlk fiyat 2: İkinci fiyat 3: Sabit fiyat
wseat	Dize dizisi	Anlaşmaya uygun iş ortaklarının iş ortağı kimlikleri. Lisans olmaması, lisans kısıtlaması olmadığı anlamına gelir.
wadomain	Dize dizisi	Bu anlaşmaya teklif vermesine izin verilen reklamveren alanları. Koltuk olmaması, alan adı kısıtlaması olmadığı anlamına gelir.
guar	Tamsayı	Bu alan, anlaşmanın garantili bir anlaşma olup olmadığını belirtmek için kullanılır. Bu değer tam sayı olarak gönderilmelidir. DV360'ın garantili anlaşmaları kabul etmesi için bir exchange'in izin verilenler listesine eklenmesi gerekir; Bunu talep etmek için bizimle iletişime geçin. Borsanız şu anda DV360 ile garantili anlaşmaları işaretlemek için farklı bir mekanizma kullanıyorsa bu tercih edilen uzantıya geçişi görüşmek üzere bize ulaşın. 0 (varsayılan): Garanti edilmez 1: Garanti edilir
ext	Fırsat uzantıları	İsteğe bağlıdır.

Fırsat nesnesi için desteklenen uzantı

Alan	Tür	Ayrıntılar
guaranteed	Tamsayı	Bu alan, anlaşmanın garantili bir anlaşma olup olmadığını belirtmek için kullanılır. Bu değer tam sayı olarak gönderilmelidir. DV360'ın garantili anlaşmaları kabul etmesi için bir exchange'in izin verilenler listesine eklenmesi gerekir; Bunu talep etmek için bizimle iletişime geçin. Borsanız şu anda DV360 ile garantili anlaşmaları işaretlemek için farklı bir mekanizma kullanıyorsa bu tercih edilen uzantıya geçişi görüşmek üzere bize ulaşın. 0 (varsayılan): Garanti edilmez 1: Garanti edilir Bu alan yerine deal.guar özelliğini kullanmanız önerilir.

Site nesnesi

Alan	Tür	Ayrıntılar
id	Dize	Exchange'deki sitenin kimliği.
name	Dize	Desteklenmez.
domain	Dize	Sitenin alan adı. Yalnızca site.domain değerini doldurmak yerine site.page parametresinde tam bir URL göndermeniz önerilir.
cat	Dize dizisi	Desteklenmez.
sectioncat	Dize dizisi	Desteklenmez.
pagecat	Dize dizisi	Desteklenmez.
page	Dize	Gösterimin gösterileceği tam URL. Hedefleme amacıyla tam URL'nin gönderilmesi önerilir.
ref	Dize	Geçerli sayfaya gidilmesine neden olan yönlendiren URL.
search	Dize	Desteklenmez.
mobile	Tamsayı	Desteklenmez.
privacypolicy	Tamsayı	Desteklenmez.
publisher	Yayıncı nesnesi	Sitenin yayıncısı hakkında ayrıntılar.
content	İçerik nesnesi	Bir sitedeki içerikle ilgili ayrıntılar.
keywords	Dize (CSV biçimi)	Desteklenmez.
ext	Site uzantıları	Site nesnesi için uzantılar.

Site uzantısı nesnesi

Alan	Tür	Ayrıntılar
inventorypartnerdomain	Dize	CTV envanter paylaşımı için kullanılır. IAB CTV uygulama eklemeleri açıklayıcısı bölümüne bakın.

Uygulama nesnesi

Alan	Tür	Ayrıntılar
id	Dize	Exchange'deki uygulama kimliği.
name	Dize	Yayıncı isteği üzerine takma ad verilebilen uygulama adları. SDK'sız istekler (çoğunlukla bağlı TV'ler) için uygulama adları, yayıncı tarafından doğrudan istekte sağlanabilir.
bundle	Dize	Zorunlu. iOS için sayısal uygulama mağazası kimliği olması gerekir. Ters DNS stil paket kimliği kabul edilmez. CTV uygulaması için mağaza tarafından tanımlanan uygulama tanımlayıcısının iletilmesini öneririz. Lütfen kısa süre önce yayınlanan IAB OTT/CTV Mağazası Tarafından Atanmış Kimlik kurallarına uyun.
domain	Dize	Alan adı (örneğin, mygame.foo.com)
storeurl	Dize	app-ads.txt doğrulaması ve bağlı TV uygulama mağazası doğrulaması için gereklidir.
cat	Dize dizisi	Desteklenmez.
sectioncat	Dize dizisi	Desteklenmez.
pagecat	Dize dizisi	Desteklenmez.
ver	Dize	Desteklenmez.
privacypolicy	Tamsayı	Desteklenmez.
paid	Tamsayı	Desteklenmez.
publisher	Yayıncı nesnesi	Uygulama yayıncısı hakkında bilgiler.
content	İçerik nesnesi	Uygulama içeriğiyle ilgili bilgiler.
keywords	Dize (csv biçimi)	Desteklenmez.
ext	Uygulama uzantıları	Uygulama nesnesi için uzantılar.

Uygulama uzantısı nesnesi

Alan	Tür	Ayrıntılar
inventorypartnerdomain	Dize	CTV envanter paylaşımı için kullanılır. IAB CTV uygulama eklemeleri açıklayıcısı bölümüne bakın.

İçerik nesnesi

Mümkün olduğunda bu özelliklerin iletilmesini öneririz.

Alan	Tür	Ayrıntılar
id	Dize	İçeriği benzersiz şekilde tanımlayan bir kimlik.
episode	Tamsayı	İçerik bölüm numarası (genellikle video içerikleri için).
title	Dize	CTV, video ve ses istekleri için önerilir.
series	Dize	CTV, video ve ses istekleri için önerilir.
season	Dize	İçeriğin sezonu için bir etiket.
artist	Dize	İçerikle ilişkilendirilen sanatçı
genre	Dize	İçeriği en iyi tanımlayan tür. DV360, CTV, video ve işitsel istekleri için bu sinyalin sağlanmasını önerir. DV360, bu alan için birkaç video türü değeri sınıflandırmasını destekler: Google'ın tür listesi (İndir) Google'ın ses türleri listesi (İndir) IAB TV/Film/Spor kategorileri (İndir) Nielsen'in Gracenote Video Türü Sınıflandırması
album	Dize	İçeriğin ait olduğu albüm (genellikle ses içerikleri için).
isrc	Dize	ISO-3901'e uygun Uluslararası Standart Kayıt Kodu.
producer	Üretici nesnesi	İçerik üreticiyle ilgili ayrıntılar.
url	Dize	İçeriğin URL'si.
cat	Dize dizisi	İçeriği açıklayan IAB içerik kategorileri.
prodq	Tamsayı	Yapım kalitesi: 0 (Varsayılan): Bilinmiyor 1: Profesyonel 2: Profesyonel tüketici 3: Kullanıcı tarafından oluşturulmuş
videoquality	Tamsayı	Desteklenmez.
context	Tamsayı	İçerik türü: 1: Video 2: Oyun 3: Müzik 4: Uygulama 5: Metin 6: Diğer 7: Bilinmiyor
contentrating	Dize	Bu özellik üzerinde karar verme sürecini başlatacağımız için Ses ve Video/CTV için önerilir.
userrating	Dize	Yıldız sayısı, beğeni sayısı vb.
qagmediarating	Tamsayı	[QAG yönergelerine](http://www.iab.net/ne_guidelines) göre medya derecelendirmesi. 1: Tüm kitleler 2: 12 yaş ve üzeri 3: Yetişkin
keywords	Dize (csv biçimi)	Desteklenmez.
livestream	Tamsayı	İçerik canlı yayın içeriğiyse 0: Canlı değil 1: İçerik canlı
sourcerelationship	Tamsayı	0: Dolaylı 1: Doğrudan
len	Tamsayı	İçeriğin saniye cinsinden uzunluğu. CTV/video ve ses istekleri için önerilir.
language	Dize (ISO-639-1-alpha-2)	İçeriğin dili.
embeddable	Tamsayı	İçeriğin yerleştirilebilir olup olmadığını gösteren işaret (ör. yerleştirilebilir bir video oynatıcı) 0: Yerleştirilemez 1: Yerleştirilebilir
data	Veri nesneleri dizisi	Ek veriler.

Üretici nesnesi

Alan	Tür	Ayrıntılar
id	Dize	Desteklenmez.
name	Dize	Desteklenmez.
cat	Dize dizisi	Desteklenmez.
domain	Dize	Üreticinin en üst düzey alan adı.

Veri nesnesi

Alan	Tür	Ayrıntılar
id	Dize	Veri sağlayıcının kimliği.
name	Dize	Veri sağlayıcının borsa adı.
segment	Segment nesneleri dizisi	Gerçek veri değerleri.
ext	Veri uzantıları	Veri nesnesi için uzantılar.

Veri nesnesi için desteklenen uzantılar

Alan	Tür	Ayrıntılar
segtax	Tamsayı	Sınıflandırma kimliği. Daha fazla bilgi için Segment Sınıflandırmaları bölümüne bakın.
segclass	Dize	Taksonomi içindeki segment kimliklerini oluşturan sınıflandırıcı sürümü.

Segment nesnesi

Alan	Tür	Ayrıntılar
id	Dize	Veri sağlayıcıya özgü veri segmentinin kimliği.
name	Dize	Veri segmentinin adı.
value	Dize	Veri segmentinin değeri.

Yayıncı nesnesi

Alan	Tür	Ayrıntılar
id	Dize	Zorunlu.
name	Dize	Desteklenmez.
cat	Dize dizisi	Desteklenmez.
domain	Dize	Desteklenmez.

Cihaz nesnesi

Alan	Tür	Ayrıntılar
ua	Dize	Zorunlu.
sua	UserAgent nesnesi	Yapılandırılmış kullanıcı aracısı bilgileri.
geo	Coğrafi nesne	Cihazın konumu.
dnt	Tamsayı	Tarayıcının üstbilgisinde ayarlanan Do Not Track işareti. 0: İzleme sınırsızdır 1: İzleme yok
lmt	Tamsayı	Reklam izlemeyi sınırla sinyali ticari olarak onaylanmıştır. 0: İzleme sınırsızdır 1: İzleme, ticari kurallara göre sınırlandırılmalıdır
ip	Dize	IPv4 ise zorunludur. IP adresi kısaltılmışsa device.ext.truncated_ip içinde belirtilmelidir.
ipv6	Dize	IPv6 ise zorunludur. IP adresi kısaltılmışsa device.ext.truncated_ip içinde belirtilmelidir.
devicetype	Tamsayı	Tüm envanter türleri için önemle tavsiye edilir. Cihaz türü tanımayı geliştirmek için kullanılır.
make	Dize
model	Dize
os	Dize	Cihazın işletim sistemi. ios: Uygulama isteğinde bu, iOS trafiğini tanımlar. android: ua veya sua cihazı tanımlamıyorsa Android cihazı tanımlar. [anything else]: Sorunları izole etmek için teşhislerde kullanılır. Bu alan büyük/küçük harfe duyarlı değildir.
osv	Dize	Desteklenmez.
hwv	Dize	Cihazın donanım sürümü.
h	Tamsayı	Ekranın piksel cinsinden fiziksel yüksekliği.
w	Tamsayı	Ekranın piksel cinsinden fiziksel genişliği.
ppi	Tamsayı	Desteklenmez.
pxratio	Çift	Fiziksel piksellerin cihazdan bağımsız piksellere oranı.
js	Tamsayı	Desteklenmez.
geofetch	Tamsayı	Desteklenmez.
flashver	Dize	Desteklenmez.
language	Dize (ISO-639-1-alpha-2)	Cihazın dili.
carrier	Dize	Desteklenmez.
mccmnc	Dize	Desteklenmez.
connectiontype	Tamsayı	Ağ bağlantısı türü
ifa	Dize	Reklamverenin açıkça kullanması için onaylanmış kimlik.
didsha1	Dize	Desteklenmez.
didmd5	Dize	Desteklenmez.
dpidsha1	Dize	Desteklenmez.
dpidmd5	Dize	Desteklenmez.
macsha1	Dize	Desteklenmez.
macmd5	Dize	Desteklenmez.
ext	Cihaz uzantıları	Cihaz nesnesi için uzantılar.

Cihaz nesnesi için desteklenen uzantı

ip değiştirilirse veya kısaltılırsa trafiğin geçersiz trafik olarak bildirilmesini önlemek için aşağıdaki uzantıları göndermenizi önemle tavsiye ederiz.

Alan	Tür	Ayrıntılar
truncated_ip	Tamsayı	Teklif isteğinin device.ip alanındaki IP adresinin kısaltılıp kısaltılmadığını belirtir. 0: Kısaltılmamış 1: Kısaltılmış Varsayılan olarak kısaltılmaz ve IP adresi kısaltılmışsa gereklidir. Bildirilmediği takdirde teklif isteği geçersiz trafik olarak sınıflandırılabilir.
ifa_type	Dize	Cihazın kaynağını belirtin.ifa alanı, cihazın kendisinden mi sağlandığını yoksa tedarik zincirinde yayıncı veya SSP tarafından mı oluşturulduğunu gösterir. aaid: Android TV rida: Roku afai: Amazon Fire idfa: Apple tvOS msai: Xbox/Microsoft dpid: Genel cihaz platformu kimliği ppid: Yayıncı tarafından sağlanan kimlik sspid: SSP tarafından sağlanan kimlik sessionid: Kısa süreli oturum kimliği (yalnızca sıklık sınırlama)
attestation_token	Dize (base64 kodlu)	Bu düzeyde cihaz doğrulamasını destekleyen değişimler için cihaza dayalı bir onay jetonu.
atts	Tamsayı	(Yalnızca iOS) Uygulamanın uygulama takibi yetkilendirme durumunu temsil etmek için iletilen bir tam sayı. 0: Belirlenmedi 1: Kısıtlı 2: Reddedildi 3: Yetkili
cdep	Dize	Chrome üçüncü taraf çerezlerinin desteğinin sonlandırılması etiketi. Chrome destekli test ve IAB Topluluk Spesifikasyonu başlıklı makaleleri inceleyin.

UserAgent nesnesi

Alan	Tür	Ayrıntılar
browsers	BrandVersion nesneleri dizisi	Her BrandVersion nesnesi bir tarayıcıyı veya benzer bir yazılım bileşenini tanımlar.
platform	BrandVersion nesnesi	Platformu tanımlar.
mobile	Tamsayı	0 (varsayılan): Temsilci, "masaüstü" veya "tam" içeriği tercih eder. 1: Temsilci, "mobil" içeriği tercih ediyor.
architecture	Dize	Cihaz mimarisi (ör. "x86" veya "arm")
bitness	Dize	Cihazın bit sayısı (ör. 64 bit mimari için "64").
model	Dize	Cihaz modeli.
source	Tamsayı	Bu nesneyi oluşturmak için kullanılan verilerin kaynağı. Liste: Kullanıcı aracısı kaynağı başlıklı makaleyi inceleyin. UserAgent nesnesi iletilirken önerilir.

BrandVersion nesnesi

Alan	Tür	Ayrıntılar
brand	Dize	Marka tanımlayıcısı (ör. "Chrome" veya "Windows"). Zorunlu.
version	Dize dizisi	Sürüm bileşenlerinin azalan hiyerarşik düzende sıralanması (ana, ara, mikro vb.).

Coğrafi nesne

Alan	Tür	Ayrıntılar
lat	Çift	Desteklenmez.
lon	Çift	Desteklenmez.
type	Tamsayı	Desteklenmez.
accuracy	Tamsayı	Desteklenmez.
lastfix	Tamsayı	Desteklenmez.
ipservice	Tamsayı	Desteklenmez.
country	Dize	Desteklenmez.
region	Dize	Desteklenmez.
regionfips104	Dize	Desteklenmez.
metro	Dize	Desteklenmez.
city	Dize	Desteklenmez.
zip	Dize	Desteklenmez.
utcoffset	Tamsayı	Desteklenmez.

Kullanıcı nesnesi

Alan	Tür	Ayrıntılar
id	Dize	Google, kimlik eşleşmesi tablosunu barındırıyorsa desteklenir.
buyeruid	Dize	SSP, kimlik eşleşmesi tablosunu barındırıyorsa desteklenir.
yob	Tamsayı	Demografik hedefleme için önerilir.
gender	Dize	Demografik hedefleme için önerilir.
keywords	Dize (CSV)	Desteklenmez.
customdata	Dize	Desteklenmez.
geo	Coğrafi nesne	Desteklenmez.
data	Veri nesneleri dizisi	Ek veriler.
consent	Dize (web için güvenli Base64)	GDPR yönetmelikleri yürürlükteyken bu özellik, IAB Şeffaflık ve Kullanıcı Rızası Çerçevesi'nin kullanıcı rızası dizesi veri yapısını içerir. Değer, IAB'nin biçimini kullanan, web için güvenli Base64 kodlu bir ikili dizedir. DV360'ın GDPR belgelerinde, DV360'ın bu sinyali nasıl kullandığı açıklanmaktadır. Yalnızca bir user.consent ve user.ext.consent değeri bekleniyor.
eids	Genişletilmiş kimlik nesneleri dizisi	Exchange tarafından sağlanan genişletilmiş kimlik örnekleri.
ext	Kullanıcı uzantıları	Kullanıcı nesnesi için uzantılar.

Kullanıcı nesnesi için desteklenen uzantılar

Alan	Tür	Ayrıntılar
consent	Dize (web için güvenli Base64)	Yukarıdaki user.consent bölümünde açıklandığı gibi GDPR izin dizesi. Yalnızca bir user.consent ve user.ext.consent değeri bekleniyor.
eids	Genişletilmiş kimlik nesneleri dizisi	Exchange tarafından sağlanan genişletilmiş kimlik örnekleri.
consented_providers_settings.consented_providers	İçerideki bir tam sayı dizisini (consented_providers) sarmalayan dış nesne (consented_providers_settings).	GDPR izni TCF aracılığıyla alındığında bu alanda, TCF'ye katılmayan ve kullanıcı izni almış reklam teknolojisi sağlayıcılar listelenir. "Google Ek İzin Modu için teknik spesifikasyon" başlıklı makaleyi inceleyin.
us_privacy	Dize	regs.us_privacy belgelerine göz atın. Yalnızca bir regs.us_privacy, regs.ext.us_privacy ve user.ext.us_privacy bekleniyor.

Genişletilmiş kimlik nesnesi

Alan	Tür	Ayrıntılar
source	Dize	Tanımlayıcının sağlayıcısı
uids	Extended ID UID nesneleri dizisi	Gerçek tanımlayıcılar

Genişletilmiş kimlik UID nesnesi

Alan	Tür	Ayrıntılar
id	Dize	Tanımlayıcının kendisi.
atype	Tamsayı	Bu kimlikle ilişkili kullanıcı aracısının türü.

Tedarik zinciri nesnesi

Alan	Tür	Ayrıntılar
complete	Tamsayı	0 (varsayılan): Tedarik zinciri tamamlanmamış. 1: Tedarik zinciri, yayıncıya kadar tamamlanmıştır.
ver	Dize	Zorunlu. Değer "major.minor" biçiminde (ör. 1.0 sürümü "1.0" dizesi) olarak biçimlendirilir.
nodes	Tedarik zinciri düğümü dizisi	Zorunlu. Tam bir tedarik zincirinde ilk düğüm, işlemde yer alan ilk reklamcılık sistemini ve satıcı kimliğini (ör. sitenin, uygulamanın veya diğer ortamın sahibi) temsil eder. Eksik bir tedarik zincirinde, bilinen ilk düğümü temsil eder. Son düğüm, bu teklif isteğini gönderen tüzel kişiyi temsil eder.

Tedarik zinciri düğümü nesnesi

Alan	Tür	Ayrıntılar
asi	Dize	Teklif verenlerin bağlandığı STP, exchange, başlık sarmalayıcı gibi sistemin kurallı alan adı. Bu, yetkilendirilmiş sistemin sahipliğini açıkça belirtmek üzere WHOIS ve ters IP aramalarını kolaylaştırmak için sistemin çalışır durumdaki alanı (üst kurumsal alandan farklıysa) olabilir. Bu değer, varsa ads.txt dosyasında satıcıları tanımlamak için kullanılan değerle aynı olmalıdır.
sid	Dize	Reklamcılık sisteminde bulunan satıcı veya bayi hesabıyla ilişkilendirilmiş tanımlayıcı. Bu, STP/exchange tarafından belirtilen alanda işlemler (ör. OpenRTB teklif istekleri) için kullanılan değerle aynı olmalıdır. Genellikle OpenRTB'de bu, publisher.id'dir. OpenDirect için bu genellikle yayıncının kuruluş kimliğidir. Uzunluğu 64 karakteri aşmamalıdır.
rid	Dize	Bu satıcı tarafından verilen istek için OpenRTB RequestId.
name	Dize	Belirli bir seller_id altında gerçekleştirilen envanter işlemleri için ödeme yapılan şirketin (yasal tüzel kişi) adı. Bu değer isteğe bağlıdır ve reklam sisteminin sellers.json dosyasında varsa dahil EDİLMEMELİDİR.
domain	Dize	Bu düğüm tarafından temsil edilen tüzel kişinin işletme alan adı. Bu değer isteğe bağlıdır ve reklam sisteminin sellers.json dosyasında varsa dahil EDİLMEMELİDİR.
hp	Tamsayı	Bu düğümün, envanterin ödeme akışına dahil olup olmayacağını gösterir. 1: asi alanındaki reklam sistemi, zincirdeki önceki düğüme ödeme yapmaktan sorumlu olan sid alanındaki satıcıya ödeme yapar. 0: Bu düğüm, envanterin ödeme akışına dahil değildir. SupplyChain'in 1.0 sürümünde bu özellik her zaman 1 olmalıdır. Şartnamenin gelecekteki sürümlerinde ödeme işleme dışı düğümlerin kullanılması beklendiğinden bu alanın dahil edilmesi açıkça zorunludur. Uygulayıcılar, bu alanı desteklediklerinden ve aşağı akış reklam sistemine gönderilen teklif isteklerinde SupplyChain nesnelerini oluştururken bu alanı yaydıklarından emin olmalıdır.

Teklif yanıtı spesifikasyonu

BidResponse nesnesi

Özellik	Destekleniyor	Uygulama ayrıntıları	Her zaman geçti
id		Bir ayrıştırma hatası oluşursa bu değer, teklif isteği kimliği yerine "0" olabilir.	Evet
seatbid
bidid
cur		Ayrıştırma hatası oluşursa bu değer iletilmez. Geçerli teklif isteği trafiği için cur her zaman sağlanır.	Evet
customdata
nbr		Bu yalnızca teklif isteğiyle ilgili bir sorun bulunursa dahil edilir. Olası değerler şunlardır: 2: Geçersiz İstek 12: Ads.txt Yetkilendirme İhlali 16: Eksik Tedarik Zinciri 17: Engellenen Tedarik Zinciri Düğümü Not: (app-)ads.txt veya Tedarik Zinciri ile ilgili belirli bir ihlal tespit edildiğinde, yanıtların bir kısmına (%1) 12, 16 veya 17 kodlarından biri doldurulur. Diğer tüm geçersiz istekler için 2 kodu doldurulur. NBR içeren istekler aşağıdaki gibi görünür: { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } }
ext		Teklif isteğiyle ilgili bir sorun varsa ext, desteklenen yerlerde hatanın teşhis edilmesine yardımcı olacak bilgiler içerebilir.

BidResponse nesnesi için desteklenen uzantılar

Özellik	Uygulama ayrıntıları
err	Teklif isteğiyle ilgili hatanın kullanıcılar tarafından okunabilir açıklaması. Yanıt örnekleri: Teklif isteği gövdesi boştu. Teklif isteği, söz konusu exchange için izin verilenler listesinde yer alan bir para biriminde değildi. Teklif isteği, kabul edilen bir MIME türü içermiyordu.
errHelp	Bu sayfanın bağlantısı

Seatbid nesnesi

Özellik	Destekleniyor	Uygulama ayrıntıları	Her zaman geçti
teklif			evet
kullanıcı başına lisans			evet
group

Teklif nesnesi

Özellik	Destekleniyor	Uygulama ayrıntıları	Her zaman geçti
id			evet
impid			evet
fiyat			evet
nurl
burl
lurl
adm
adid
adomain
grup
iurl
cid			evet
crid			evet
taktik
Cat
attr
api
protokolü
qagmediarating
language
dealid
w
sa.
wratio
hratio
exp

Teklif nesnesi için desteklenen uzantılar

Özellik	Uygulama ayrıntıları
apis	Hem OMID hem de MRAID destekleniyorsa DV360, seatbid.bid.apis değerini gönderir. DV360, hem OMID_1 hem de MRAID'yi tam sayı dizisi olarak ayarlar.

Reklam sunma seçenekleri

OpenRTB spesifikasyonunun 4.3 bölümünde, iki farklı yayın seçeneği vardır:

• Kazanan bildirimi üzerinde yayınlanan işaretleme
• Teklifte sunulan işaretleme

DV360 her iki seçeneği de destekler.

• Banner reklam için DV360, her zaman adm alanında biçimlendirme döndürür. Kazanma bildiriminde sunulan işaretleme isteğe bağlıdır.
• VAST protokolünü kullanan video/işitsel reklam için DV360, exchange iş ortaklarının şartlarına bağlı olarak VAST XML'nin adm alanında veya kazanma bildirimi yanıtında döndürülmesini destekler.

Bu iki seçeneğin avantajlarını ve dezavantajlarını öğrenmek için OpenRTB spesifikasyonuna bakın.

En iyi uygulamalar

Koltuk kimliği olarak Display & Video 360'ın iş ortağı kimliğini kullanmanız önemle tavsiye edilir. Borsaya özel hesap kimliğinin kullanılması önerilmez.

Yayıncılarınızın ads.txt dosyaları olduğundan veya uygulamalarınızın ilişkili app-ads.txt dosyaları olduğundan ve bu dosyalarda yetkili satıcı ya da bayi olarak listelendiğinizden emin olun. Daha fazla bilgi

Ayrıca, teklif isteklerinde tutarlı bilgiler iletildiğinden emin olun. Örneğin, app.bundle, mobil cihaz bilgileri ve app.storeurl ile tutarlı olmalıdır.

Bağlı TV

device.ifa ve device.lmt parametrelerini iletirken IAB OTT IFA kurallarına uyun. Yönergelerle uyumlu olmak için device.ext.ifa_type de uygulamanız gerekir. Tüm CTV sıklık sınırı ve kitle hedefleme özelliklerimiz için bir IFA'nın bulunması gerekir.

Ayrıca, kısa süre önce yayınlanan IAB OTT/CTV Mağazası Tarafından Atanmış Kimlik kurallarına uyun. Bu kurallar, büyük ölçüde uygulama mağazası tarafından tanımlanan kimlik kullanılarak app.bundle değerinin CTV uygulamaları için nasıl iletileceğini tanımlar.

Aktif Görüntüleme ölçümü

Aktif Görüntüleme, bir gösterimin görüntülenebilir olup olmadığını ve ne kadar süreyle görüntülendiğini ölçmek için kullanılan bir Google teknolojisidir. Aktif Görüntüleme, hem görüntülü hem de video reklamlarda OMID'yi kullanır. OMID kullanılarak ölçümün etkinleştirilmesi için borsaların, DV360'ın istemcinin OMID desteğini bilmesi amacıyla OpenRTB isteklerine aşağıdaki alanları eklemesi gerekir.

• Zorunlu: Teklif isteklerine bir API çerçevesi (Web Video OMSDK için Video.api=7, Native App OMSDK için Native.api=7, Banner.api=7 veya Audio.api=7) ekleyin. Bu, Aktif Görüntüleme'nin OMID kullanılarak ölçüm yapmasını sağlamak için zorunludur.
• Önerilen: omidpn ve omidpv öğelerini Source.Ext'e eklemeniz şiddetle tavsiye edilir. Çünkü bu işlem, DV360'ta müşteriye görünürlük ölçümlerinin nasıl raporlanacağını etkiler. OMID iş ortağı adı, IAB sertifikası listesinde yoksa, MRC tarafından görüntülenebilirlik metriklerini MRC onaylı metriklerden ayrı olarak raporlamamız gerekir. Daha fazla bilgi edinin.

Doğal reklamlar için Aktif Görüntüleme ölçümü

DV360, doğal reklamlar için Aktif Görüntüleme ölçümünü etkinleştirmek üzere yayıncıların ve borsaların ek adımlar atmasını gerektirir.

• Yerel görüntülü reklamlar: DV360, teklif yanıtındaki adm.native nesnesi altına aşağıdaki eventtrackers öğesini ekler:

  "eventtrackers": [
    {
      "event": 555,
      "method": 2,
      "url": "https://pagead2.googlesyndication.com/pagead/managed/js/activeview/current/rx_omid.js",
      "ext": {
        "vendorKey": "doubleclickbygoogle.com-omid-dsp",
        "verification_parameters": ""
      }
    }
  ]
  

  Borsalar, yayıncılara ek etkinlik izleyiciler iletmelidir. Yayıncılar ise aşağıdaki adımları uygulamalıdır:

  1. OMSDK'yı yükleyin.
  2. Doğal reklamlar oluşturulurken OMSDK'yı yükleyin.
  3. eventtrackers.url içinde JavaScript'i verilen parametrelerle yürüt.

• Doğal video reklamlar: DV360, VAST XML'ye standart AdVerifications uzantısını ekleyerek görüntülenebilirlik ölçümünü etkinleştirir:

  <Extension type="AdVerifications">
    <AdVerifications>
      <Verification vendor="doubleclickbygoogle.com-omid-video">
        <JavaScriptResource apiFramework="omid" browserOptional="true">
          <![CDATA[ https://www.googletagservices.com/activeview/js/current/rx_omid_video.js ]]>
        </JavaScriptResource>
        <VerificationParameters>
          <![CDATA[ {"activeview_flags":"...","activeview_metadata":"...", ...} ]]>
        </VerificationParameters>
        <TrackingEvents>
          <Tracking event="verificationNotExecuted">
            <![CDATA[ https://ade.googlesyndication.com/ddm/activity/... ]]>
          </Tracking>
        </TrackingEvents>
      </Verification>
    </AdVerifications>
  </Extension>
  

  Video reklam görünürlüğü ölçümünü zaten destekleyen yayıncıların ek bir işlem yapması gerekmez. Aksi takdirde yayıncıların video oynatıcılarında yeni uzantıyı işlemeleri veya yok saymaları gerekir.

Not: DV360, Güvenli Etkileşimli Medya Arayüzü Tanımı (SIMID) 1.0 Sürümü'nü kullanır. Daha fazla bilgi için IAB Open Measurement SDK sayfasını inceleyin.

3PE'de Native için AB Yapay Zeka Tüzüğü

Reklamverenlerin yeni şeffaflık düzenlemelerine uymasını sağlamak için. Avrupa Birliği, Hindistan ve New York eyaletindeki yapay zeka tüzükleri, yapay zekayla üretilmiş veya düzenlenmiş belirli öğelerin kullanıldığı reklamlarda, bu reklamların yapay zeka ile oluşturulduğu konusunda tüketicileri bilgilendiren açıklamalar bulunmasını zorunlu kılar. Temmuz 2026'dan itibaren Display & Video 360 (DV360), reklamverenlerin gelişmekte olan yapay zeka şeffaflığı düzenlemelerine uymalarına yardımcı olmak için reklam öğesinin yapay zeka kullanılarak oluşturulduğunu veya değiştirildiğini belirten bir etiket eklemelerine olanak tanıyacak.

Reklamverenler bu etiketleri doğrudan reklam öğelerine ekleyebilir veya Display & Video 360 kullanıcı arayüzü ve API'si üzerinden yapay zeka etiketi ayarını kullanabilir. Reklamlarınızı etiketlemek için yapay zeka içerik etiketi ayarlarını kullanma hakkında daha fazla bilgi edinin.

Google tarafından oluşturulan reklamlar için seçtiğimiz uygunluk stratejisinde, tıklama öncesi minimum düzeyde bir yapay zeka etiketi ve tıklama sonrası About This Ad (ATA) panelinde bir açıklama kullanılır.

3PE'deki doğal reklam biçimlerinde Google, reklamın nihai oluşturma işlemini kontrol etmez. Bu gibi durumlarda, bu onay sinyali, nihai reklamı yapay zeka etiketi veya açıklaması içerecek şekilde oluşturmak için borsa ya da yayıncıların reklam yanıtının bir parçası olarak yayılır. Sinyal, doğal reklam yanıtının adm.native.ext alanının bir parçası olur. Yeni alan adm.native.ext aşağıdaki biçimdedir:

  "ext" {
     "should_disclose_ai": "true",
     "ai_disclosure_url": ""
  }

• should_disclosure_ai (doğru veya yanlış), nihai reklamın yapay zeka etiketi içermesi gerekip gerekmediğini gösterir.
• ai_disclosure_url alanı mevcut olabilir veya olmayabilir. Yalnızca should_disclosure_ai doğru olarak ayarlandığında ve native.privacy URL alanı boş olduğunda gösterilir. Bu durumda, yapay zeka etiketini tıklayan kullanıcı, bu alanda sağlanan URL'ye yönlendirilmelidir. Aksi takdirde, yapay zeka etiketini tıklayan kullanıcılar standartnative.privacy URL alanına yönlendirilmelidir.

Bu sinyaller, yayıncılara iletilmelidir. Böylece yayıncılar, yapay zeka etiketli reklamı oluşturabilir.

SSS

DV360, exchange özel uzantılarını destekliyor mu?

Evet, Display & Video 360, bu spesifikasyonda listelenen uzantıların yanı sıra her duruma göre özel uzantıları da destekleyebilir. Entegrasyon dönemi boyunca özel uzantıyı belirtmeniz ve test etmeniz önerilir.

DV360, ödüllü videoyu destekliyor mu?

Evet, ödüllü video uzantısını bize gönderin.

Envanterimin büyük bir kısmı "demografik grup bilinmiyor" olarak gösteriliyor. Demografik kapsamı nasıl iyileştirebilirim?

Kapsamı artırmak için DV360'a gönderilen teklif isteklerinde user.yob ve user.gender alanlarını doldurun.

DV360'ın her bölge için uç noktaları var mı?

Hayır, küresel olarak tek bir uç nokta kullanıyoruz ve istekleri otomatik olarak en yakın veri merkezine yönlendiriyoruz. Bu nedenle, sağlayabileceğimiz bölgeye özgü bir uç nokta yok.

Sunucudan sunucuya (s2s) isteklerle ilgili koşullar nelerdir?

İzin verilenler listemize eklenmek için bize ulaşın. İstemci kullanıcı aracısı yönlendirilmelidir ve sunucudan sunucuya VAST getirme işlemine verilen yanıtta çerezlerin devre dışı bırakıldığından/yoksayıldığından emin olunmalıdır.

DV360, OMID'yi destekliyor mu?

Teklif isteği sırasında OMID etkin olarak bildirildiği sürece OMID kullanarak görüntülenebilirliği ölçebiliriz. Bu konuyla ilgili ayrıntılar 24-25. sayfalarda özetlenmiştir.

Hangi Native sürümünü destekliyorsunuz? Yerel reklamlarla ilgili herhangi bir şartınız var mı?

Yalnızca Native Ver1.2 desteklenir. Yerel özellik.

DV360, GZIP olarak gönderilen teklif isteklerini destekliyor mu?

DV360, gzip ile sıkıştırılmış teklif isteklerini alabilir ve Accept-Encoding başlığı desteklendiğini belirtiyorsa gzip ile sıkıştırılmış yanıtlarla karşılık verir.

DV360, DBURL'yi destekliyor mu?

Şu anda bu mümkün değildir.

DV360, kayıp bildirimi özelliğini destekliyor mu?

Evet, DV360 teklif yanıtlarındaki bid.lurl alanını doldurur. Teklif kaybederse borsa, bu URL'ye bir neden içeren ping gönderebilir ve bu neden reklamverenlere gösterilir. Bu nedenler, reklamverenlere gelecekte kayıpları nasıl önleyecekleri konusunda tavsiyelerde bulunabilir.

DV360, hedefleme için App.name parametresini gerektirir mi?

Hayır, DV360 referans için App.name kullanır ancak hedefleme için gerekli değildir. App.bundle hedefleme için kullanılır.

DV360, tek bir teklif isteğinde gönderilen birden fazla reklam boyutunu destekleyebilir mi?

Evet, banner.format parametresinde uygun tüm reklam boyutu boyutlarını dikkate alırız.

DV360, aynı teklif isteğinde birden fazla biçimi destekliyor mu?

Çok formatlı teklif istekleri için sınırlı destek sunuyoruz ancak bu desteği iyileştirmek için çalışıyoruz. Geçiş reklamları için görüntülü ve video biçimlerini destekliyoruz ancak şu anda görüntülü ve doğal reklamları desteklemiyoruz. Çok formatlı teklif istekleri gönderiyorsanız lütfen test isteğinde bulunmak için bizimle iletişime geçin.

DV360, aynı istekte karma gösterim türlerini destekliyor mu?

Şu anda yalnızca video/banner geçiş reklamları desteklenmektedir. Yerel/banner ve video/banner üzerinde çalışıyoruz. Başka kombinasyonlar varsa lütfen ekibimizle iletişime geçin.

Birden fazla alıcı, aynı istekte bu tür gösterim fırsatlarından bir veya daha fazlası için birden fazla teklif gönderebilir mi?

Evet.

DV360'ın, aynı istekteki birden fazla gösterim fırsatı için aynı reklamverenin sıklık sınırını belirleme veya aynı reklamvereni gösterme konusunda bir çözümü ya da özel bir ihtiyacı var mı?

DV360, bir reklamverenin her istek için yalnızca bir gösterim fırsatı kadar teklif verebileceği bir zorunluluk uygular. SSP'lerin gösterim nesnelerini anlamlı bir şekilde gruplandırmasını bekliyoruz. Örneğin, tümü aynı sayfada, tümü aynı uygulamada vb.

DV360, aynı teklif isteğinde birden fazla gösterimi destekliyor mu?

DV360 şu anda birden fazla gösterim ses nesnesini desteklemektedir. Ancak bu özelliği kullanmak isteyen her borsa için test yapmamız/özelliği etkinleştirmemiz gerekir. Daha fazla bilgi için teklif isteği spesifikasyonunu inceleyin. Bu özelliği diğer biçimlerde de kullanıma sunmak için çalışıyoruz:

{
id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38",
seatbid {
bid {
  id: "0",
  impid: "234232",
  price: 41.373926619828261,
  adid: "123",
  adm: "...",
  adomain: "xxx.com",
  cid: "0",
  crid: "123",
  dealid: "sample-deal-id-1",
  language: "xx",
},
bid {
  id: "1",
  impid: "234255",
  price: 2.34192037470726,
  adid: "234",
  adm: "...",
  adomain: "xyz.com",
  cid: "0",
  crid: "234",
  dealid: "sample-deal-id-2",
  language: "xx",
},
seat: "123456"
},
cur: "EUR"
}

Bize ulaşın

Sorularınız veya sorunlarınız varsa borsa destek ekibimizle iletişime geçebilirsiniz.