DV360 OpenRTB Spesifikasyonu

Bu sayfaya danışırken OpenRTB 2.6 Şartnamesi'ni 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 almaktadı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, teklif isteği nesnesinin gövdesine sahip bir HTTP Post isteğidir. Gövdenin biçimi, Content-Type üstbilgisinde tanımlanır.

İlgili yanıt, teklif verilmediyse 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 üst bilgisi 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 bir JSON teklif isteğini, Accept: application/json üstbilgisi 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 için sınırlı destek sunulur. İ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 aynı anda olamaz.
app Uygulama Uygulama istekleri için gereklidir.
app ve site aynı anda olamaz.
device Cihaz Zorunlu.
user Kullanıcı Zorunlu.
test Tamsayı Desteklenmez.
at Tamsayı 1: Reklamverenin teklif tutarının alındığı ilk fiyat açık artırması.
2 (varsayılan): Reklamverenin, ikinci en yüksek teklif verenin teklifinin biraz üzerinde ücretlendirildiği ikinci fiyat açık artırması.
3: Taban fiyat istekte yer alır ve rakip tekliflerle ilgisi yoktur.
tmax Tamsayı İsteğe bağlıdır. Varsayılan olarak entegrasyon başına özeldir.
wseat Dize dizisi İzin verilen alıcı koltuklarının listesi.
Tüm reklamverenlerin teklif vermesine izin verilmediği sürece önerilir.
Ayarlanmamış olması, kısıtlama olmadığı anlamına gelir.
bseat Dize dizisi Teklifleri engellenmesi gereken alıcı koltuklarının listesi. Listelenen alıcıların anlaşmalara ve herkesin katılabileceği 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 birimi desteklemeniz önemle tavsiye edilir.
wlang Dize dizisi Desteklenmez.
bcat Dize dizisi IAB içerik kategorileri kullanılarak 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ı zorunlu.
regs Regs İsteğe bağlı.
ext Teklif isteği uzantıları İsteğe bağlı.

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 - Teklif isteklerinde değer gönderilmedi. 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ıyorsa isteğe bağlıdır, aksi takdirde yasaktır.
0 (varsayılan): gdemsignals doldurulduğunda teklif yanıtı adm 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 tüm durumlarda 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ı.

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 sertifikalı metriklerden ayrı olarak raporlanmasını zorunlu kılar. Daha fazla bilgi

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'taki 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.
ext Yönetmelik uzantıları İsteğe bağlı.

Regs extensions object

Alan Tür Ayrıntılar
gdpr Tamsayı Teklif isteğinin AEA bölgesinden gelip gelmediğini belirtin.
0 (varsayılan): AEA dışı bölge.
1: AEA bölgesi,
Daha fazla bilgi için GDPR için Kullanıcı Rızası Alınmış Sağlayıcı Çözümü başlıklı makaleyi inceleyin.
us_privacy Dize us_privacy dizesini uygulamak için lütfen IAB Tech Lab tarafından sağlanan teknik spesifikasyona uyun.

Teklif isteğinde us_privacy dizesini aldığımızda ve IAB dizesi kullanıcının kapsam dışında kalmayı seçmediğini gösterdiğinde Display & Video 360, bu tür istekler için teklif verir. IAB sinyalini diğer tedarikçi firmalara iletmeyiz. IAB dizesinde kullanıcının kapsam dışında kalmayı seçtiği belirtiliyorsa Google bu tür istekler için teklif vermez.

Nesneye ait gösterim

Alan Tür Ayrıntılar
id Dize Teklif isteği bağlamında bu gösterimin benzersiz tanımlayıcısıdır (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 gereklidir.
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 reklam kodunu iş ortağına göre ö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ı (genellikle video veya mobil) oluşturmaktan sorumlu oynatıcının sürümü. Bazı reklam sunucuları tarafından reklam kodunu iş ortağına göre ö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, sorun giderme 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ı

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 geçerlilik süresi, DV360 tarafından bu alanda iş ortağı tarafından gönderilen değer dikkate alınmadan ayarlanır. Gösterim eskime aralığından (genellikle 1 saat) sonra alınan gösterim etkinlikleri eski 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 ek can kazanmasına veya sponsorlu bir reklam içermeyen müzik oturumu elde etmesine olanak tanır. Ödül genellikle video reklam tamamlandıktan sonra dağıtılır.

Gösterim uzantısı nesnesi

Alan Tür Ayrıntılar
bcrid Dize Engellenmesi gereken reklam öğesi kimliklerinin listesi.
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 kullanılması önerilir.
h Tamsayı

h ve w, format alanında birleştirilir.

Bunun yerine format kullanılması ö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: Sesin otomatik oynatılması
2: Sesin kullanıcı tarafından başlatılması
3: Otomatik genişletilebilir
4: Tıklama ile başlatılan genişletilebilir
5: Fareyle üzerine gelindiğinde başlatılan genişletilebilir
6: Banner'da otomatik oynatılan video
7: Banner'da kullanıcı tarafından başlatılan video
8: Pop-up (üzerine/altına/çıkışta)
9: Kışkırtıcı veya imalı
10: "Sinir bozucu" (ör. titrek, yanıp sönen, titreşen, aşırı animasyonlu, yüzler)
11: Anketler
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: Katlanma çizgisinin üstünde
2: Desteklenmiyor: Katlanma çizgisinin altında olabilir
3: Katlanma çizgisinin altında
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 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 sonra gösterilen bir bitiş kartıdır.

Nesneyi biçimlendirme

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

Video nesnesi

Teklif isteğinde video yerleşiminin belirtilmesini önemle tavsiye ederiz. Eksik bir yerleşim alanı, bilinmeyen yerleşim olarak sınıflandırılır. Daha fazla bilgi için konum hedefleme ile ilgili makaleye bakı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ı Bir 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ı Video oynatıcının cihazdan bağımsız pikseller (DIPS) cinsinden genişliği.
h Tamsayı Video oynatıcının cihazdan bağımsız pikseller (DIPS) cinsinden yüksekliği.
startdelay Tamsayı Videodan önce, videonun ortasında veya videodan sonra gösterilen reklam yerleşimleri için başlangıç gecikmesi (saniye).
placement Tamsayı Teklif isteğinde plcmt (ve/veya) video 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 yerleşim türü 1) olarak kabul edilebilmesi için video yerleşimleri/gösterimleri "ses açık" olarak ayarlanmalı ve oynatma yönteminde doğru şekilde belirtilmelidir (1, 3, 4 ve 5 değerleri uygundur).
plcmt Tamsayı Teklif isteğinde plcmt (ve/veya) video 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 yerleşim türü 1) olarak kabul edilebilmesi için video yerleşimleri/gösterimleri "ses açık" olarak ayarlanmalı ve oynatma yönteminde doğru şekilde belirtilmelidir (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): Uzatmaya izin verilmez
-1: Uzatmaya izin verilir ve süre sınırı yoktur
>0: maxduration değerinin ötesinde desteklenen uzatılmış oynatma süresi (saniye cinsinden).

minbitrate Tamsayı Kb/sn cinsinden minimum bit hızı.
maxbitrate Tamsayı Kbps cinsinden maksimum bit hızı.
boxingallowed Tamsayı 4:3 içeriklerin 16:9 penceresinde letter-boxing'e izin verilip verilmediğini gösterir.

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 yerleşim alt türü sinyali vermelidir.
playbackend Tamsayı Oynatmanın sona ermesine neden olan etkinlik.

1: Video tamamlandı veya kullanıcı tarafından sonlandırıldı
2: Görüntü alanı terk edildi veya kullanıcı tarafından sonlandırıldı
3: Görüntü alanı terk edildiğinde, 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: Katlanma çizgisinin üstünde
2: Desteklenmiyor: Katlanma çizgisinin altında olabilir
3: Katlanma çizgisinin altında
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 tamsayı 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, videonun ortasında veya videodan sonra gösterilen reklam yerleşimleri için başlangıç gecikmesi (saniye).

-2: Videodan sonra gösterilen reklam
-1: Videonun ortasında gösterilen reklam
0: Videodan önce gösterilen reklam
>0: Videonun ortasında gösterilen reklam

sequence Tamsayı Desteklenmez.
battr Tam sayı dizisi Desteklenmez.
maxextended Tamsayı Desteklenmez.
minbitrate Tamsayı Kb/sn cinsinden minimum bit hızı.
maxbitrate Tamsayı Kbps 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ü.

1: Müzik hizmeti
2: Yayın
3: Podcast

stitched Tamsayı Desteklenmez.
nvol Tamsayı Desteklenmez.

Yerel nesne

Daha fazla bilgi için DV360 doğal reklam özelliklerine bakın.

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 Fırsat nesnesi dizisi Dahil edilecek fırsatlar.

Fırsat nesnesi

Alan Tür Ayrıntılar
id Dize PMP 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 olur.

at Tamsayı Belirtilmezse varsayılan olarak bid_request.at ile 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.

Koltuk olmaması, koltuk 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. Bu isteği göndermek 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: Garantili

ext Fırsat uzantıları İsteğe bağlı.

Anlaşma 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. Bu isteği göndermek 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: Garantili

Bu alan yerine deal.guar kullanılması önerilir.

Site nesnesi

Alan Tür Ayrıntılar
id Dize Exchange'deki sitenin kimliği.
name Dize Desteklenmez.
domain Dize Sitenin alan adı.

site.domain öğesini doldurmak yerine site.page öğesine 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ıyla ilgili 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 Uygulama adları (yayıncı isteği üzerine takma ad kullanılabilir).

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 stilindeki 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ı (ör. 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 özellikleri iletmenizi ö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 istekler 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 tür listesi (İndir)
  • IAB TV/Film/Spor kategorileri (İndir)
  • Nielsen'ın Gracenote Video Türü Taksonomisi
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ı Prodüksiyon 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 vermeye başlayacağı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österir (ör.yerleştirilebilir bir video oynatıcı).

0: Yerleştirilemez
1: Yerleştirilebilir

data Veri nesneleri dizisi Ek veriler.

Yapımcı 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ı'na bakın.
segclass Dize Sınıflandırıcının, sınıflandırma içindeki segment kimliklerini üreten 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 "İzlemeyi Engelle" 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 bir Android cihazı tanımlar.
[anything else]: Sorunları tespit 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.

Aksi 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 zincirindeki 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: STP 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 kodlaması) Bu düzeyde cihaz doğrulamasını destekleyen değişimler için cihaz tabanlı bir onay jetonu.
atts Tamsayı (Yalnızca iOS) Uygulamanın uygulama izleme yetkilendirme durumunu temsil etmek için iletilen bir tam sayı.

0: Belirlenmedi
1: Kısıtlanmış
2: Reddedildi
3: Yetkilendirilmiş

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: User-Agent 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 hiyerarşik olarak azalan düzende sıralanması (ana, alt, 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 tablosuna ev sahipliği yapı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.
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 güvenli Base64) IAB izin dizesi.

Kullanıcının hangi bilgilerin toplanmasına izin verdiği ve hangi sağlayıcıların bu bilgileri kullanmasına izin verildiğiyle ilgili meta verileri içerir.

Değer, özel ikili biçim kullanan web güvenli base64 kodlu bir ikili dizedir.

us_privacy Dize Kullanıcı, CCPA veya benzer yasalarla ilgili uygunluk bilgilerini gördüyse
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 alınmış reklam teknolojisi sağlayıcıları listelenir. "Google Ek İzin için teknik spesifikasyon" başlıklı makaleyi inceleyin.
eids Genişletilmiş kimlik nesneleri dizisi Exchange tarafından sağlanan genişletilmiş kimlik örnekleri.

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ı 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 biçimlendirilir. Örneğin, 1.0 sürümü "1.0" dizesidir.
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, temsilci 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, işlemlerinde (ör.OpenRTB teklif istekleri) kullanılan değerle aynı değeri içermelidir. Bu değer, STP/exchange tarafından belirtilen alanda yer alır.

Bu, OpenRTB'de genellikle publisher.id'dir. OpenDirect için bu genellikle yayıncının kuruluş kimliğidir.

Uzunluğu 64 karakterle sınırlı olmalıdır.

rid Dize Bu satıcı tarafından verilen isteğin OpenRTB RequestId'si.
name Dize Belirli bir seller_id altında gerçekleştirilen envanter işlemi için ödeme yapılan şirketin (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ün temsil ettiği 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ı belirtir.

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. Spesifikasyonun 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 nesneleri 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 başarılı
id Bir ayrıştırma hatası oluşursa bu değer, teklif isteği kimliği yerine "0" olabilir. Evet
seatbid
bidid
cur Bir ayrıştırma hatası oluşursa bu değer iletilmez. Geçerli teklif isteği trafiği için her zaman para birimi sağlanır. Evet
customdata
nbr Bu yalnızca teklif isteğiyle ilgili bir sorun bulunursa eklenir. 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 hatayı teşhis etmeye 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 metni boştu.
  • Teklif isteği, söz konusu borsa 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 başarılı
teklif evet
kullanıcı başına lisans evet
grup

Teklif nesnesi

Özellik Destekleniyor Uygulama ayrıntıları Her zaman başarılı
id evet
impid evet
fiyat evet
nurl
burl
lurl
adm
adid
adomain
grup
iurl
cid evet
crid evet
taktik
Cat
özlk
api
protokolü
qagmediarating
language
dealid
w
sa.
wratio
hratio
exp

Teklif nesnesi için desteklenen uzantılar

Özellik Uygulama ayrıntıları
apis DV360, hem OMID hem de MRAID destekleniyorsa seatbid.bid.apis 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:

  • Kazanma bildiriminde yayınlanan işaretleme
  • Teklifte yayınlanan 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/ses reklamı için DV360, VAST XML'nin adm alanında veya borsa iş ortaklarının şartlarına göre kazanma bildirimi yanıtında döndürülmesini destekler.

Bu iki seçeneğin avantajları ve dezavantajları hakkında bilgi edinmek için OpenRTB spesifikasyonuna bakın.

En iyi uygulamalar

Koltuk kimliği olarak Display & Video 360 iş ortağı kimliğinin kullanılması önemle tavsiye edilir. Exchange'e özgü koltuk kimliğinin kullanılması önerilmez.

Yayıncılarınızın ads.txt dosyaları veya ilişkili app-ads.txt dosyaları olan uygulamaları olduğundan ve sizi dosyada yetkili satıcı ya da bayi olarak listelediklerinden 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 değerlerini iletirken IAB OTT IFA kurallarına uyun. Yönergelerle uyumlu olmak için device.ext.ifa_type öğesini 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ülenebilir olduğunu ö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 yapılmasını sağlamak için borsaların, OpenRTB isteklerine aşağıdaki alanları eklemesi gerekir. Böylece DV360, istemcinin OMID desteğini bilir.

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öneminde ö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 özellikler 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 beyan edildiği sürece OMID kullanarak görüntülenebilirliği ölçebiliriz. Bu konuyla ilgili ayrıntılar 24-25. sayfalarda özetlenmiştir.
Native'in hangi sürümünü destekliyorsunuz? Do you have any Native requirements?
Yalnızca Native Ver1.2 desteklenir. Yerel şartname.
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, kazanma/kaybetme bildirimini destekliyor mu?
Şu anda bu mümkün değildir. Bu özelliği desteklememizin yararlı olacağını düşünüyorsanız lütfen daha fazla ayrıntı vererek bizimle iletişime geçin.
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 öğesi boyutlarını dikkate alırız.
DV360, aynı teklif isteğinde birden fazla biçimi destekliyor mu?
Çok biçimli 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 yerel reklamları desteklemiyoruz. Çok biçimli 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 uygulama yerleştirir. 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 spesifikasyonuna bakın. 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.