مشخصات DV360 OpenRTB

هنگام مراجعه به این صفحه، مشخصات OpenRTB 2.6 را در دسترس داشته باشید.

Display and Video 360 از همه فیلدهای مشخصات OpenRTB پشتیبانی نمی‌کند و ممکن است تفاوت‌های ظریفی در آن اعمال شود. بخش‌هایی از این سند حاوی اطلاعات و توصیه‌های خاص برای پیاده‌سازی Display and Video 360 است. شما همچنین باید دستورالعمل‌های ارائه شده در مشخصات OpenRTB را دنبال کنید، مگر اینکه خلاف آن ذکر شده باشد.

برخی از فیلدها پشتیبانی نمی‌شوند، اما همچنان تجزیه می‌شوند. این فیلدها باید به درستی قالب‌بندی شوند، اما بر نتیجه مناقصه تأثیری نخواهند داشت.

مشخصات درخواست پیشنهاد قیمت

یک درخواست پیشنهاد، یک درخواست HTTP Post با بدنه‌ی شیء درخواست پیشنهاد است. قالب بدنه در هدر Content-Type تعریف شده است.

پاسخ مربوطه یا یک HTTP 204 بدون بدنه برای no-bid است، یا یک HTTP 200 با بدنه پاسخ bid .

اگر درخواست پیشنهاد ناقص باشد، ممکن است یک HTTP 200 با بدنه پاسخ پیشنهاد که فیلد nbr در آن پر شده است، بازگردانده شود.

قالب پاسخ توسط سرآیند Accept کنترل می‌شود.

فرمت JSON

قالب پیش‌فرض زمانی استفاده می‌شود که هیچ نوع MIME پذیرفته‌شده‌ای ارائه نشده باشد.

درخواست‌ها و پاسخ‌های JSON از مشخصات IAB OpenRTB 2.6 پیروی می‌کنند. مستندات زیر، افزونه‌ها و پشتیبانی میدانی را شرح می‌دهد.

هدر Content-Type : application/json نشان دهنده درخواست پیشنهاد JSON است، Accept : application/json نشان می‌دهد که پاسخ‌های پیشنهاد باید در قالب JSON باشند.

قالب پروتوباف

توجه: پشتیبانی Protobuf در مرحله بتا است، در صورت تمایل با DV360 تماس بگیرید.

درخواست‌ها و پاسخ‌های JSON از مشخصات IAB OpenRTB 2.6 Protobuf پیروی می‌کنند.

افزونه‌ها پشتیبانی محدودی دارند، در صورت تمایل با DV360 تماس بگیرید.

هدر Content-Type : application/x-protobuf برای نشان دادن درخواست پیشنهاد Protobuf ارسال کنید و Accept : application/x-protobuf برای دریافت پاسخ‌های پیشنهاد Protobuf تنظیم کنید.

شیء درخواست پیشنهاد

میدان نوع جزئیات
id رشته الزامی است.
شناسه منحصر به فرد درخواست پیشنهاد. این شناسه می‌تواند برای شناسایی درخواست‌های منفرد برای مدت زمان بسیار محدودی پس از ارائه آنها استفاده شود.
imp آرایه Imp حداقل یک شیء imp مورد نیاز است.

برای غلاف‌های صوتی، بیش از یک شیء imp پشتیبانی می‌شود.
برای موارد استفاده دیگر (مثلاً چندین اسلات مستقل در صفحه) از اولین شیء imp استفاده می‌شود و بقیه حذف می‌شوند.

site سایت برای درخواست‌های وب‌سایت الزامی است.
site و app کاملاً مستقل از هم هستند.
app برنامه برای درخواست برنامه مورد نیاز است.
app و site کاملاً مستقل از هم هستند.
device دستگاه الزامی است.
user کاربر الزامی است.
test عدد صحیح پشتیبانی نمی‌شود.
at عدد صحیح 1 : حراج با قیمت اول که در آن مبلغ پیشنهادی از تبلیغ‌کننده دریافت می‌شود.
2 (پیش‌فرض): حراج قیمت دوم که در آن تبلیغ‌کننده کمی بالاتر از دومین پیشنهاددهنده‌ی برتر قیمت‌گذاری می‌شود.
3 : قیمت پایه در درخواست ذکر شده است و هیچ ارتباطی با پیشنهادات رقابتی ندارد.
tmax عدد صحیح اختیاری، پیش‌فرض برای هر ادغام سفارشی است.
wseat آرایه رشته‌ای فهرست صندلی‌های مجاز خریدار.
توصیه می‌شود مگر اینکه به همه تبلیغ‌کنندگان اجازه پیشنهاد قیمت داده شود.
تنظیم نشده به معنای عدم محدودیت است.
bseat آرایه رشته‌ای فهرست جایگاه‌های خریدارانی که پیشنهادهایشان باید مسدود شود. خریداران فهرست‌شده از پیشنهاد قیمت در معاملات و حراج عمومی منع خواهند شد.
allimps عدد صحیح پشتیبانی نمی‌شود.
cur آرایه رشته‌ای

اختیاری است، اما اکیداً توصیه می‌شود. پیش‌فرض به ازای هر ادغام است.

ارز درخواست پیشنهاد قیمت باید با یکی از ارزهای ثبت شده در طول ادغام مطابقت داشته باشد.

اکیداً توصیه می‌شود که از یک ارز واحد در هر صرافی پشتیبانی شود.
wlang آرایه رشته‌ای پشتیبانی نمی‌شود.
bcat آرایه رشته‌ای دسته‌های تبلیغ‌کنندگان مسدود شده با استفاده از دسته‌های محتوای IAB.
عدم تنظیم به معنای عدم مسدود بودن دسته‌ها است.
badv آرایه رشته‌ای تبلیغ‌کننده مسدود شده را بر اساس دامنه ارائه شده توسط تبلیغ‌کننده مشخص کنید.
لغو تنظیم هیچ تبلیغ‌کننده مسدود شده‌ای نیست.
bapp آرایه رشته‌ای پشتیبانی نمی‌شود.
source منبع نیمه مورد نیاز برای schain .
regs رگ‌ها اختیاری.
ext تمدید درخواست پیشنهاد قیمت اختیاری.

شیء تمدید درخواست پیشنهاد

میدان نوع جزئیات
schain زنجیره تامین ادغام‌های جدید باید به جای آن از فیلد BidRequest.source.schain در Source استفاده کنند.
purch عدد صحیح پارامتر ترافیک خریداری‌شده، ترافیکی است که از دارایی‌هایی غیر از فعالیت‌های تحت مالکیت، اکتسابی یا سایر فعالیت‌های تشویقی هدایت می‌شود.
این مطابق با مشخصات جدید MRC IVT 2.0 است.

این در گزارش‌دهی خریدار ، منبع ترافیک ناشر نامیده می‌شود و یکی از مقادیر زیر را خواهد داشت:
0 (پیش‌فرض): نامشخص - مقدار در درخواست‌های پیشنهاد ارسال نشده است. قادر به ثبت مقدار نیست؛
1 : خریداری شده - ترافیک از املاکی غیر از املاک تحت تملک (فعالیت خریداری شده یا با انگیزه‌های دیگر) هدایت می‌شود.
2 : ارگانیک - ورود مستقیم به آدرس اینترنتی، جستجوی سایت یا دانلود برنامه.

gdemsignals رشته یک حباب سیگنال API SCAR از GMA SDK.
اگر ترافیک GMA SDK باشد، توصیه می‌شود، در غیر این صورت ممنوع است.
disable_gma_format عدد صحیح اگر gdemsignals ارائه شده باشد، اختیاری و در غیر این صورت ممنوع است.
0 (پیش‌فرض): وقتی gdemsignals پر می‌شود، پاسخ پیشنهاد adm یک json blob است.
1 : به جای json blob، یک تگ ad نیز ارائه خواهد شد.

شیء منبع

میدان نوع جزئیات
fd عدد صحیح نهاد مسئول تصمیم نهایی فروش تبلیغات محیطی
0 (پیش‌فرض): صرافی تصمیم می‌گیرد.
1 : یک منبع بالادستی تصمیم می‌گیرد.
tid رشته پشتیبانی نمی‌شود.
pchain رشته پشتیبانی نمی‌شود.
schain زنجیره تامین تقریباً در همه موارد لازم است.

این فیلد نسبت به ارائه schain از طریق افزونه‌های درخواست پیشنهاد یا افزونه‌های منبع ترجیح داده می‌شود.

ext افزونه‌های منبع اختیاری.

شیء افزونه‌های منبع

این افزونه اکیداً توصیه می‌شود زیرا بر نحوه گزارش اندازه‌گیری‌های قابلیت مشاهده در DV3 به مشتری تأثیر می‌گذارد. اگر نام شریک OMID در فهرست گواهینامه IAB نباشد، MRC ما را ملزم می‌کند که معیارهای قابلیت مشاهده را جدا از معیارهای دارای گواهینامه MRC گزارش کنیم. اطلاعات بیشتر .

میدان نوع جزئیات
omidpn رشته شناسه‌ی یکپارچه‌سازی OM SDK. این همان پارامتر "name" برای شیء OMID Partner است.
omidpv رشته نسخه یکپارچه‌سازی OM SDK. این همان پارامتر "versionString" از شیء OMID Partner است.
schain زنجیره تامین ادغام‌های جدید باید به جای آن از فیلد schain در Source استفاده کنند.

شیء Regs

میدان نوع جزئیات
coppa عدد صحیح 0 (پیش‌فرض): COPPA برای این درخواست قابل اجرا نیست.
1 : این درخواست مشمول قانون COPPA می‌شود.
ext پسوندهای Regs اختیاری.

شیء پسوندهای Regs

میدان نوع جزئیات
gdpr عدد صحیح مشخص کنید که آیا درخواست پیشنهاد از منطقه EEA است یا خیر.
0 (پیش‌فرض): منطقه غیر EEA.
1 : منطقه اقتصادی اروپا،
برای جزئیات بیشتر به راهکار ارائه‌دهنده‌ی رضایت‌بخش برای GDPR مراجعه کنید.
us_privacy رشته لطفاً برای پیاده‌سازی رشته us_privacy مشخصات فنی ارائه شده توسط آزمایشگاه فناوری IAB را دنبال کنید.

وقتی رشته us_privacy را در درخواست پیشنهاد قیمت دریافت کنیم و وقتی رشته IAB نشان دهد که کاربر انصراف نداده است، Display & Video 360 برای چنین درخواست‌هایی پیشنهاد قیمت می‌دهد. ما سیگنال IAB را به سایر فروشندگان ارسال نمی‌کنیم. وقتی رشته IAB نشان دهد که کاربر انصراف داده است، گوگل برای چنین درخواست‌هایی پیشنهاد قیمت نمی‌دهد.

شیء Imp

میدان نوع جزئیات
id رشته یک شناسه منحصر به فرد برای این نمایش در چارچوب درخواست پیشنهاد (معمولاً مقدار با ۱ شروع می‌شود و برای n نمایش تا n افزایش می‌یابد).
metric شیء پشتیبانی نمی‌شود.
banner بنر برای فرصت‌های تبلیغات بنری مورد نیاز است.
video ویدئو برای فرصت‌های تبلیغات ویدیویی مورد نیاز است.
audio صوتی برای فرصت‌های تبلیغات صوتی مورد نیاز است.
native بومی برای فرصت‌های تبلیغات بومی مورد نیاز است.
pmp پی ام پی معاملات بازار خصوصی در واقع برای این تصور مؤثر هستند.
displaymanager رشته نام شریک واسطه‌گری تبلیغات، فناوری SDK یا پخش‌کننده مسئول رندر کردن تبلیغات (معمولاً ویدیو یا موبایل). توسط برخی از سرورهای تبلیغاتی برای سفارشی‌سازی کد تبلیغ توسط شریک استفاده می‌شود. برای ویدیو و/یا برنامه‌ها توصیه می‌شود.
displaymanagerver رشته نسخه‌ای از شریک واسطه‌گری تبلیغات، فناوری SDK یا پخش‌کننده‌ای که مسئول رندر کردن تبلیغات (معمولاً ویدیو یا موبایل) است. توسط برخی از سرورهای تبلیغاتی برای سفارشی‌سازی کد تبلیغ توسط شریک استفاده می‌شود. برای ویدیو و/یا برنامه‌ها توصیه می‌شود.
instl عدد صحیح 0 (پیش‌فرض): بینابینی نیست.
1 : تبلیغ بینابینی یا تمام صفحه است.
tagid رشته شناسه‌ای برای محل قرارگیری تبلیغ یا برچسب تبلیغی خاص که برای شروع حراج استفاده شده است. این می‌تواند برای رفع هرگونه مشکل یا برای بهینه‌سازی توسط خریدار مفید باشد.
bidfloor شناور حداقل پیشنهاد برای این نمایش که به صورت CPM بیان می‌شود.
bidfloorcur رشته

ارز با استفاده از کدهای آلفای ISO-4217 مشخص شده است.

clickbrowser عدد صحیح

نوع مرورگری را که با کلیک روی دکمه‌ی «خلاصه» در یک برنامه باز می‌شود، نشان می‌دهد.
0 (پیش‌فرض): جاسازی‌شده
1 : بومی

توجه داشته باشید که کنترلر نمای سافاری در دستگاه‌های iOS 9.x برای اهداف این فیلد، یک مرورگر بومی در نظر گرفته می‌شود.

secure عدد صحیح اگر این برداشت به یک URL امن HTTPS یا یک URL ناامن HTTP نیاز داشته باشد.
0 (پیش‌فرض): ناامن
1 : امن
iframebuster آرایه رشته‌ای
exp عدد صحیح انقضای پیشنهاد توسط DV 360 بدون توجه به مقدار ارسال شده توسط شریک در این فیلد تعیین می‌شود. رویدادهای نمایش که پس از پنجره‌ی ماندگاری نمایش (معمولاً ۱ ساعت) دریافت می‌شوند، به عنوان قدیمی کنار گذاشته می‌شوند و توسط DV360 قابل پرداخت در نظر گرفته نمی‌شوند.
rwdd عدد صحیح نشان می‌دهد که آیا کاربر برای مشاهده تبلیغ پاداش دریافت می‌کند یا خیر.
0 (پیش‌فرض): پاداش داده نمی‌شود
1 : پاداش داده شده

معمولاً، پیاده‌سازی تبلیغات ویدیویی به کاربران اجازه می‌دهد یک مقاله خبری اضافی را به صورت رایگان بخوانند، یک امتیاز اضافی در یک بازی دریافت کنند یا یک جلسه موسیقی بدون تبلیغات با حمایت مالی دریافت کنند. این پاداش معمولاً پس از اتمام تبلیغ ویدیویی توزیع می‌شود.

شیء پسوند Imp

میدان نوع جزئیات
bcrid رشته فهرست شناسه‌های خلاق که باید مسدود شوند.
میدان نوع جزئیات
format قالب‌بندی آرایه فهرستی از فرمت‌های پشتیبانی‌شده.
w عدد صحیح

h و w در فیلد format ادغام می‌شوند.

توصیه می‌شود به جای آن از format استفاده کنید.
h عدد صحیح

h و w در فیلد format ادغام می‌شوند.

توصیه می‌شود به جای آن از format استفاده کنید.
wmax عدد صحیح پشتیبانی نمی‌شود.
hmax عدد صحیح پشتیبانی نمی‌شود.
wmin عدد صحیح پشتیبانی نمی‌شود.
hmin عدد صحیح پشتیبانی نمی‌شود.
btype آرایه عدد صحیح فهرستی از انواع تبلیغات بنری مسدود شده:

1 : تبلیغات متنی HTML
2 : بنرهای تبلیغاتی HTML
3 : تبلیغات جاوا اسکریپت
4 : تبلیغات آی‌فریم

battr آرایه عدد صحیح مقادیر زیر را پشتیبانی کنید:

1 : پخش خودکار صدا
2 : کاربر صوتی آغاز به کار کرد
3 : خودکار قابل ارتقا
4 : کلیک قابل گسترش آغاز شد
5 : رول‌اور قابل ارتقا آغاز شد
6 : پخش خودکار ویدیو در بنر
7 : کاربر ویدئوی موجود در بنر را آغاز کرد
8 : پاپ (بالا/پایین/در هنگام خروج)
9 : تحریک‌آمیز یا وسوسه‌انگیز
10 : «آزاردهنده»، مثال: لرزان، چشمک‌زن، سوسو زدن، انیمیشن شدید، شکلک‌ها
11 : نظرسنجی‌ها
12 : فقط متن
13 : تعامل با کاربر (بازی‌ها)
14 : سبک پنجره‌ی محاوره‌ای یا هشدار ویندوز
15 : دارای دکمه روشن/خاموش صدا
16 : می‌توان از تبلیغ صرف‌نظر کرد
17 : فلش

pos عدد صحیح موقعیت آگهی:

0 (پیش‌فرض): ناشناخته
1 : بالای خط تا
2 : پشتیبانی نمی‌شود: احتمالاً در پایین تاخوردگی
3 : زیر خط تا
4 : سربرگ
5 : پاورقی
6 : نوار کناری
7 : تمام صفحه

mimes آرایه رشته‌ای پشتیبانی نمی‌شود.

DV360 برای تمام بنرهای تبلیغاتی از متن/html استفاده خواهد کرد.

topframe عدد صحیح 0 (پیش‌فرض): بنر در یک iframe ارائه می‌شود.
1 : پشتیبانی نمی‌شود: بنر در کادر بالا نمایش داده می‌شود.
expdir آرایه عدد صحیح 1 : چپ
2 : راست
3 : بالا
4 : پایین
5 : تمام صفحه قابل گسترش
api آرایه عدد صحیح چارچوب‌های API پشتیبانی‌شده

1 : چپ
2 : راست
3 : بالا
4 : پایین
5 : تمام صفحه قابل گسترش

id رشته یک شناسه برای شیء بنر و باید در تصویر منحصر به فرد باشد.

زمانی که اشیاء banner با یک شیء ویدیویی استفاده می‌شوند، توصیه می‌شود.

vcm عدد صحیح

فقط مربوط به banner است که با یک شیء ویدیویی استفاده می‌شود.

0 : بنر همزمان با ویدیوی تبلیغاتی قابل مشاهده است.
1 : بنر، کارت پایان بازی بعد از ویدیو است.

شیء قالب‌بندی

میدان نوع جزئیات
w عدد صحیح عرض بر حسب پیکسل‌های مستقل از دستگاه (DIPS).
h عدد صحیح ارتفاع بر حسب پیکسل‌های مستقل از دستگاه (DIPS).
wratio عدد صحیح پشتیبانی نمی‌شود.
hratio عدد صحیح پشتیبانی نمی‌شود.
wmin عدد صحیح پشتیبانی نمی‌شود.

شیء ویدیویی

ما اکیداً توصیه می‌کنیم که در درخواست پیشنهاد، محل قرارگیری ویدیو را مشخص کنید. عدم وجود فیلد محل قرارگیری به عنوان محل قرارگیری ناشناخته طبقه‌بندی می‌شود. برای جزئیات بیشتر به مقاله مربوط به هدف‌گذاری موقعیتی مراجعه کنید.

میدان نوع جزئیات
mimes آرایه رشته‌ای حداقل یک نوع mime مورد نیاز است.

video/flv یا video/x-f4v
video/mp4 ، video/x-mp4 ، یا application/mp4
video/webm یا video/x-webm
video/x-ms-wmv
video/3gpp
video/ogg یا application/ogg
application/javascript یا application/x-javascript

minduration عدد صحیح حداقل مدت زمان ویدیو بر حسب ثانیه، پیش‌فرض حداقلی ندارد.
maxduration عدد صحیح حداکثر مدت زمان یک ویدیو بر حسب ثانیه، پیش‌فرض حداکثری ندارد.
protocols آرایه عدد صحیح حداقل یک پروتکل پشتیبانی شده مورد نیاز است.

1 : گسترده ۱.۰
2 : گسترده ۲.۰
3 : گسترده ۳.۰
4 : بسته‌بندی گسترده ۱.۰
5 : بسته‌بندی گسترده ۲.۰
6 : بسته‌بندی گسترده ۳.۰
7 : گسترده ۴.۰
8 : بسته‌بندی گسترده ۴.۰
9 : داست ۱.۰
10 : بسته‌بندی DAAST 1.0

w عدد صحیح عرض پخش‌کننده ویدیو بر حسب پیکسل‌های مستقل از دستگاه (DIPS).
h عدد صحیح ارتفاع پخش‌کننده ویدیو بر حسب پیکسل‌های مستقل از دستگاه (DIPS).
startdelay عدد صحیح تأخیر شروع نمایش تبلیغات (بر حسب ثانیه) برای قبل از پخش، اواسط پخش یا بعد از پخش.
placement عدد صحیح اکیداً توصیه می‌شود که در درخواست پیشنهاد قیمت، محل قرارگیری ویدیو (و/یا محل قرارگیری ویدیو) مشخص شود. عدم وجود هر دو فیلد به عنوان محل قرارگیری نامشخص طبقه‌بندی خواهد شد.

0 (پیش‌فرض): ناشناخته
1 : در جریان
2 : در بنر
3 : در مقاله
4 : در خوراک
5 : شناور

توجه: برای اینکه نمایش/نمایش ویدیو در حالت In-Stream (Placement یا Plcmt Type 1) قرار گیرد، باید روی «sound on» تنظیم شده باشد و به درستی در Playback Method (مقادیر ۱، ۳، ۴ و ۵) علامت‌گذاری شده باشد.
plcmt عدد صحیح اکیداً توصیه می‌شود که در درخواست پیشنهاد قیمت، محل قرارگیری ویدیو (و/یا محل قرارگیری ویدیو) مشخص شود. عدم وجود هر دو فیلد به عنوان محل قرارگیری نامشخص طبقه‌بندی خواهد شد.

0 (پیش‌فرض): ناشناخته
1 : در جریان
2 : محتوای همراه
3 : بینابینی
4 : بدون محتوا/مستقل

توجه: برای اینکه نمایش/نمایش ویدیو در حالت In-Stream (Placement یا Plcmt Type 1) قرار گیرد، باید روی «sound on» تنظیم شده باشد و به درستی در Playback Method (مقادیر ۱، ۳، ۴ و ۵) علامت‌گذاری شده باشد.

توجه: در صورت ارائه هر دو مورد plcmt و placement ، اولویت با plcmt خواهد بود. برای مهاجرت به plcmt به راهنمای IAB مراجعه کنید.

توجه: plcmt: Accompanying Content (2) به placement: In Article (3)
plcmt: No Content/Standalone (4) به placement: In feed (4)
placement: In Banner هیچ نگاشتی در plcmt وجود ندارد
linearity عدد صحیح پشتیبانی نمی‌شود.
skip عدد صحیح اگر پخش‌کننده‌ی ویدیو اجازه‌ی رد شدن از تبلیغ را بدهد.

0 (پیش‌فرض): قابل رد شدن نیست
1 : قابل رد شدن

skipmin عدد صحیح پشتیبانی نمی‌شود.
skipafter عدد صحیح پشتیبانی نمی‌شود.
sequence عدد صحیح اگر چندین نمایش آگهی در یک درخواست پیشنهاد قیمت ارائه شود، شماره ترتیب امکان تحویل هماهنگ چندین آگهی تبلیغاتی را فراهم می‌کند.
battr آرایه عدد صحیح ویژگی‌های خلاقانه مسدود شده.
maxextended عدد صحیح حداکثر مدت زمان تبلیغ ویدیویی طولانی، در صورت مجاز بودن تمدید.

0 (پیش‌فرض): افزونه مجاز نیست
-1 : تمدید مجاز است و هیچ محدودیت زمانی اعمال نمی‌شود
>0 : تعداد ثانیه‌های پخش طولانی که فراتر از مقدار حداکثر مدت زمان پشتیبانی می‌شوند.

minbitrate عدد صحیح حداقل نرخ بیت بر حسب کیلوبیت بر ثانیه
maxbitrate عدد صحیح حداکثر نرخ بیت بر حسب کیلوبیت بر ثانیه
boxingallowed عدد صحیح نشان می‌دهد که آیا قرار دادن محتوای ۴:۳ در یک پنجره ۱۶:۹ با استفاده از کادربندی حروف مجاز است یا خیر.

0 : مجاز نیست
1 (پیش‌فرض): مجاز

playbackmethod آرایه عدد صحیح روش‌های پخشی که ممکن است مورد استفاده قرار گیرند. اگر هیچ کدام مشخص نشده باشند، می‌توان از هر روشی استفاده کرد.

0 (پیش‌فرض): ناشناخته
1 : پخش خودکار، صدا روشن
2 : پخش خودکار، صدا قطع می‌شود
3 : برای پخش کلیک کنید
4 : ماوس را روی آن ببرید
5 : شروع به ورود به نمای دید، صدا روشن است
6 : شروع به ورود به نمای دید، صدا قطع می‌شود

توجه: تمام نمایش‌هایی که صدای پیش‌فرض آنها خاموش است (روش پخش ۲، ۶ یا ۰) باید نشان‌دهنده‌ی قرارگیری خارج از جریان نوع ۲، ۳، ۴ یا ۵ (oRTB 2.5) یا زیرگروه Plcmt نوع ۲، ۳ یا ۴ باشند.
playbackend عدد صحیح رویدادی که باعث پایان پخش می‌شود.

1 : تکمیل ویدیو یا خاتمه دسترسی کاربر
2 : خروج از نمای دید یا خاتمه کاربر
3 : هنگام خروج از نمای دید، به صورت یک پنجره شناور ادامه می‌یابد تا زمانی که کامل شود یا کاربر از کار بیفتد.

delivery آرایه عدد صحیح روش‌های تحویل پشتیبانی‌شده. اگر هیچ‌کدام مشخص نشده باشد، فرض کنید همه پشتیبانی می‌شوند.

1 : پخش جریانی
2 : مترقی

pos عدد صحیح موقعیت تبلیغ روی صفحه نمایش

0 (پیش‌فرض): ناشناخته
1 : بالای خط تا
2 : پشتیبانی نمی‌شود: احتمالاً در پایین تاخوردگی
3 : زیر خط تا
4 : سربرگ
5 : پاورقی
6 : نوار کناری
7 : تمام صفحه

companionad آرایه بنر تبلیغات همراه، در صورت وجود.
api آرایه عدد صحیح

0 (پیش‌فرض): ناشناخته
1 : وی‌پی‌ای‌دی ۱
2 : وی‌پی‌ای‌دی ۲
3 : ام‌آر‌آی‌دی ۱
4 : اورما
5 : ام‌آر‌آی‌دی ۲
6 : ام‌آر‌آی‌دی ۳
7 : OMID 1 - برای فعال کردن اندازه‌گیری با استفاده از OMID برای نمای فعال، مورد نیاز است.
8 : سیمید ۱

companiontype آرایه عدد صحیح پشتیبانی نمی‌شود.
maxseq عدد صحیح حداکثر تعداد تبلیغاتی که می‌توان در یک پاد ویدیویی پویا نمایش داد.
poddur آرایه عدد صحیح حداکثر طول یک پاد ویدیویی پویا بر حسب ثانیه.

افزونه پشتیبانی شده برای شیء ویدیویی

میدان نوع جزئیات
rewarded عدد صحیح این فیلد برای نشان دادن این است که آیا درخواست‌ها مورد ارزیابی قرار می‌گیرند یا خیر. این باید به صورت یک عدد صحیح ارسال شود.

0 (پیش‌فرض): پاداش داده نمی‌شود
1 : پاداش داده شده

شیء صوتی

میدان نوع جزئیات
mimes آرایه رشته‌ای حداقل یک نوع mime مورد نیاز است.

audio/m4a ، audio/mp4 ، یا audio/x-m4a
audio/mpeg یا audio/mp3
audio/ogg یا audio/x-ogg

minduration عدد صحیح حداقل مدت زمان تبلیغ (ثانیه)
maxduration عدد صحیح حداکثر مدت زمان تبلیغ (ثانیه)
protocols آرایه عدد صحیح

3 : گسترده ۳.۰
6 : بسته‌بندی گسترده ۳.۰
7 : گسترده ۴.۰
8 : بسته‌بندی گسترده ۴.۰

startdelay عدد صحیح تأخیر شروع نمایش تبلیغات (بر حسب ثانیه) برای قبل از پخش، اواسط پخش یا بعد از پخش.

-2 : پست رول
-1 : اواسط رول
0 : پیش رول
>0 : اواسط چرخش

sequence عدد صحیح پشتیبانی نمی‌شود.
battr آرایه عدد صحیح پشتیبانی نمی‌شود.
maxextended عدد صحیح پشتیبانی نمی‌شود.
minbitrate عدد صحیح حداقل نرخ بیت بر حسب کیلوبیت بر ثانیه
maxbitrate عدد صحیح حداکثر نرخ بیت بر حسب کیلوبیت بر ثانیه
delivery آرایه عدد صحیح پشتیبانی نمی‌شود.
companionad آرایه شیء بنر هرگونه بنر همراه با اسلات‌های خلاقانه.
api آرایه عدد صحیح فهرست چارچوب‌های API پشتیبانی‌شده برای این برداشت.

7 : امید نسخه ۱

companiontype آرایه عدد صحیح پشتیبانی نمی‌شود.
maxseq آرایه عدد صحیح پشتیبانی نمی‌شود.
feed عدد صحیح نوع منبع صوتی.

1 : سرویس موسیقی
2 : پخش
3 : پادکست

stitched عدد صحیح پشتیبانی نمی‌شود.
nvol عدد صحیح پشتیبانی نمی‌شود.

شیء بومی

برای جزئیات بیشتر به مشخصات تبلیغات بومی DV360 مراجعه کنید.

میدان نوع جزئیات
request رشته شیء json بومی کدگذاری شده با رشته.
ver رشته 1.0 : پشتیبانی نمی‌شود
1.1 : پشتیبانی نمی‌شود
1.2
api آرایه عدد صحیح فهرست چارچوب‌های API پشتیبانی‌شده برای این برداشت.

7 : امید نسخه ۱

battr آرایه عدد صحیح پشتیبانی نمی‌شود.

شیء PMP

میدان نوع جزئیات
private_auction عدد صحیح 0 (پیش‌فرض): همه پیشنهادها مجاز است
1 : فقط معاملات
deals آرایه شیء Deal معاملاتی که باید لحاظ شوند.

شیء معامله

میدان نوع جزئیات
id رشته شیء PMP نمی‌تواند بیش از یک شیء معامله در هر شناسه داشته باشد.
bidfloor دو برابر حداقل پیشنهاد برای این نمایش در CPM

اگر at=3 ، الزامی است.

bidfloorcur رشته ارز با استفاده از کدهای آلفای ISO-4217 مشخص شده است.

اگر مشخص نشده باشد، به طور پیش‌فرض از واحد پول درخواست پیشنهاد استفاده می‌کند.

at عدد صحیح اگر مشخص نشده باشد، پیش‌فرض با bid_request.at مطابقت دارد.

1 : قیمت اول
2 : قیمت دوم
3 : قیمت ثابت

wseat آرایه رشته‌ای مدارک شناسایی شرکای واجد شرایط برای انجام معامله.

نداشتن صندلی به معنای نداشتن محدودیت صندلی است.

wadomain آرایه رشته‌ای دامنه‌های تبلیغ‌کننده مجاز به پیشنهاد قیمت در این معامله هستند.

نداشتن صندلی به معنای نداشتن محدودیت دامنه است.

guar عدد صحیح این فیلد برای اعلام این است که آیا معامله تضمین شده است یا خیر. این باید به صورت یک عدد صحیح ارسال شود.

برای اینکه DV360 بتواند معاملات تضمین‌شده را بپذیرد، باید یک صرافی در فهرست مجاز قرار گرفته باشد؛ برای درخواست این موضوع با ما تماس بگیرید .

اگر صرافی شما در حال حاضر از مکانیزم متفاوتی برای نشان دادن معاملات تضمین‌شده با DV360 استفاده می‌کند، برای بحث در مورد انتقال به این افزونه ترجیحی با ما تماس بگیرید .

0 (پیش‌فرض): تضمین‌شده نیست
1 : تضمین شده

ext تمدید قرارداد اختیاری.

افزونه پشتیبانی شده برای شیء معامله

میدان نوع جزئیات
guaranteed عدد صحیح این فیلد برای اعلام این است که آیا معامله تضمین شده است یا خیر. این باید به صورت یک عدد صحیح ارسال شود.

برای اینکه DV360 بتواند معاملات تضمین‌شده را بپذیرد، باید یک صرافی در فهرست مجاز قرار گرفته باشد؛ برای درخواست این موضوع با ما تماس بگیرید .

اگر صرافی شما در حال حاضر از مکانیزم متفاوتی برای نشان دادن معاملات تضمین‌شده با DV360 استفاده می‌کند، برای بحث در مورد انتقال به این افزونه ترجیحی با ما تماس بگیرید .

0 (پیش‌فرض): تضمین‌شده نیست
1 : تضمین شده

توصیه می‌شود به جای این فیلد از deal.guar استفاده کنید.

شیء سایت

میدان نوع جزئیات
id رشته شناسه سایت در صرافی.
name رشته پشتیبانی نمی‌شود.
domain رشته دامنه سایت.

توصیه می‌شود به جای اینکه فقط site.domain را پر کنید، یک URL کامل در site.page ارسال کنید.

cat آرایه رشته‌ای پشتیبانی نمی‌شود.
sectioncat آرایه رشته‌ای پشتیبانی نمی‌شود.
pagecat آرایه رشته‌ای پشتیبانی نمی‌شود.
page رشته آدرس اینترنتی (URL) کامل که قرار است نمایش داده شود.

توصیه می‌شود برای اهداف هدفمند، آدرس کامل URL را ارسال کنید.

ref رشته آدرس اینترنتی ارجاع‌دهنده‌ای که باعث هدایت به صفحه فعلی شده است.
search رشته پشتیبانی نمی‌شود.
mobile عدد صحیح پشتیبانی نمی‌شود.
privacypolicy عدد صحیح پشتیبانی نمی‌شود.
publisher شیء ناشر جزئیات مربوط به ناشر سایت.
content شیء محتوا جزئیات مربوط به محتوای درون یک سایت.
keywords رشته (با فرمت CSV) پشتیبانی نمی‌شود.
ext افزونه‌های سایت افزونه‌هایی برای شیء سایت.

شیء افزونه سایت

میدان نوع جزئیات
inventorypartnerdomain رشته برای اشتراک‌گذاری موجودی CTV استفاده می‌شود، به توضیحات اضافه شده در اپلیکیشن IAB CTV مراجعه کنید.

شیء برنامه

میدان نوع جزئیات
id رشته شناسه برنامه در صرافی.
name رشته نام برنامه‌ها، که ممکن است بنا به درخواست ناشران، نام مستعار داشته باشند.

نام برنامه برای درخواست‌های بدون SDK (عمدتاً تلویزیون‌های متصل) می‌تواند توسط ناشر مستقیماً در درخواست ارائه شود.

bundle رشته الزامی است.

برای iOS، لازم است شناسه فروشگاه برنامه عددی باشد. ما شناسه بسته به سبک DNS معکوس را نمی‌پذیریم.

برای اپلیکیشن CTV، توصیه می‌کنیم شناسه اپلیکیشن تعریف‌شده توسط فروشگاه را وارد کنید. لطفاً به دستورالعمل‌های شناسه اختصاص‌یافته به فروشگاه IAB OTT/CTV که اخیراً منتشر شده است، پایبند باشید.

domain رشته دامنه، برای مثال mygame.foo.com
storeurl رشته برای تأیید app-ads.txt و اعتبارسنجی فروشگاه برنامه Connected TV مورد نیاز است.
cat آرایه رشته‌ای پشتیبانی نمی‌شود.
sectioncat آرایه رشته‌ای پشتیبانی نمی‌شود.
pagecat آرایه رشته‌ای پشتیبانی نمی‌شود.
ver رشته پشتیبانی نمی‌شود.
privacypolicy عدد صحیح پشتیبانی نمی‌شود.
paid عدد صحیح پشتیبانی نمی‌شود.
publisher شیء ناشر اطلاعات مربوط به ناشر برنامه.
content شیء محتوا اطلاعات مربوط به محتوای برنامه.
keywords رشته (با فرمت csv) پشتیبانی نمی‌شود.
ext افزونه‌های برنامه افزونه‌هایی برای شیء app.

شیء افزونه برنامه

میدان نوع جزئیات
inventorypartnerdomain رشته برای اشتراک‌گذاری موجودی CTV استفاده می‌شود، به توضیحات اضافه شده در اپلیکیشن IAB CTV مراجعه کنید.

شیء محتوا

توصیه می‌کنیم در صورت وجود، این ویژگی‌ها را ارسال کنید.

میدان نوع جزئیات
id رشته یک شناسه منحصر به فرد که محتوا را مشخص می‌کند.
episode عدد صحیح شماره قسمت محتوا (معمولاً برای محتوای ویدیویی).
title رشته برای درخواست‌های CTV، ویدئو و صدا توصیه می‌شود.
series رشته برای درخواست‌های CTV، ویدئو و صدا توصیه می‌شود.
season رشته برچسبی برای فصل محتوا.
artist رشته این هنرمند اعتبار محتوا را به خود اختصاص داد.
genre رشته ژانری که به بهترین شکل محتوا را توصیف می‌کند. DV360 توصیه می‌کند این سیگنال را برای درخواست‌های CTV، ویدیو و صدا ارائه دهید.
DV360 از چند طبقه‌بندی مقادیر ژانر ویدیویی برای این فیلد پشتیبانی می‌کند:
  • فهرست ژانرهای گوگل ( دانلود )
  • دسته بندی تلویزیون/فیلم/ورزش IAB ( دانلود )
  • طبقه‌بندی ژانر ویدیویی گریس‌نوت نیلسن
album رشته آلبومی که محتوا به آن تعلق دارد، معمولاً برای فایل‌های صوتی.
isrc رشته کد استاندارد بین‌المللی ضبط مطابق با ISO-3901.
producer شیء تولیدکننده جزئیات مربوط به تولیدکننده محتوا.
url رشته آدرس اینترنتی (URL) محتوا.
cat آرایه رشته‌ای دسته بندی های محتوای IAB که محتوا را توصیف می کنند.
prodq عدد صحیح کیفیت تولید:

0 (پیش‌فرض): نامشخص
1 : حرفه‌ای
2 مصرف‌کننده‌ی حرفه‌ای
3 : تولید شده توسط کاربر

videoquality عدد صحیح پشتیبانی نمی‌شود.
context عدد صحیح نوع محتوا:

1 : ویدئو
2 : بازی
3 : موسیقی
4 : کاربرد
5 : متن
6 : سایر
7 : ناشناس

contentrating رشته برای صدا و تصویر/سی‌تی‌وی توصیه می‌شود، زیرا ما در حال تصمیم‌گیری در مورد این ویژگی هستیم.
userrating رشته تعداد ستاره‌ها، لایک‌ها و...
qagmediarating عدد صحیح رتبه‌بندی رسانه بر اساس [دستورالعمل‌های QAG] (http://www.iab.net/ne_guidelines).

1 : همه مخاطبان
2 : ۱۲+
3 : بالغ

keywords رشته (با فرمت csv) پشتیبانی نمی‌شود.
livestream عدد صحیح اگر محتوا، محتوای پخش زنده باشد.

0 : پخش زنده نیست
1 : محتوا زنده است

sourcerelationship عدد صحیح

0 : غیرمستقیم
1 : مستقیم

len عدد صحیح طول محتوا بر حسب ثانیه.

برای درخواست‌های CTV/ویدئو و صدا توصیه می‌شود.

language رشته (ISO-639-1-alpha-2) زبان محتوا.
embeddable عدد صحیح نشانگر اینکه آیا محتوا قابل جاسازی است یا خیر (مثلاً یک پخش‌کننده ویدیوی قابل جاسازی)

0 : قابل جاسازی نیست
1 : قابل جاسازی

data آرایه‌ای از اشیاء داده‌ای داده‌های اضافی.

شیء تولیدکننده

میدان نوع جزئیات
id رشته پشتیبانی نمی‌شود.
name رشته پشتیبانی نمی‌شود.
cat آرایه رشته‌ای پشتیبانی نمی‌شود.
domain رشته بالاترین سطح دامنه تولیدکننده.

شیء داده

میدان نوع جزئیات
id رشته شناسه ارائه دهنده داده.
name رشته نام مبادله برای ارائه دهنده داده.
segment آرایه‌ای از اشیاء سگمنت مقادیر واقعی داده‌ها
ext افزونه‌های داده افزونه‌هایی برای شیء داده.

افزونه‌های پشتیبانی‌شده برای شیء داده

میدان نوع جزئیات
segtax عدد صحیح شناسه طبقه‌بندی، برای جزئیات بیشتر به طبقه‌بندی‌های بخش مراجعه کنید.
segclass رشته نسخه‌ای از طبقه‌بندی‌کننده که شناسه‌های بخش را در طبقه‌بندی تولید کرده است.

شیء قطعه‌ای

میدان نوع جزئیات
id رشته شناسه‌ای از بخش داده که مختص ارائه‌دهنده داده است.
name رشته نام بخش داده.
value رشته مقدار بخش داده.

شیء ناشر

میدان نوع جزئیات
id رشته الزامی است.
name رشته پشتیبانی نمی‌شود.
cat آرایه رشته‌ای پشتیبانی نمی‌شود.
domain رشته پشتیبانی نمی‌شود.

شیء دستگاه

میدان نوع جزئیات
ua رشته الزامی است.
sua شیء UserAgent اطلاعات ساختاریافته‌ی عامل کاربر.
geo شیء جغرافیایی محل قرارگیری دستگاه.
dnt عدد صحیح پرچم «ردیابی نشود» همانطور که در هدر مرورگر تنظیم شده است.

0 : ردیابی بدون محدودیت است
1 : ردیابی نکنید

lmt عدد صحیح سیگنال Limit Ad Tracking از نظر تجاری تأیید شده است.

0 : ردیابی بدون محدودیت است
1 : ردیابی باید طبق دستورالعمل‌های تجاری محدود شود

ip رشته در صورت IPv4 بودن الزامی است.

اگر آدرس IP کوتاه شده باشد، باید در device.ext.truncated_ip اعلام شود.

ipv6 رشته در صورت IPv6 بودن الزامی است.

اگر آدرس IP کوتاه شده باشد، باید در device.ext.truncated_ip اعلام شود.

devicetype عدد صحیح برای همه نوع موجودی اکیداً توصیه می‌شود. برای بهبود تشخیص نوع دستگاه استفاده می‌شود.
make رشته
model رشته
os رشته سیستم عامل دستگاه.

ios : در یک درخواست App ، این مورد ترافیک IOS را شناسایی می‌کند.
android : اگر ua یا sua دستگاه اندروید را شناسایی نکنند، آن را شناسایی می‌کند.
[anything else] : در تشخیص برای جداسازی مشکلات استفاده می‌شود.

این فیلد به حروف بزرگ و کوچک حساس نیست.

osv رشته پشتیبانی نمی‌شود.
hwv رشته نسخه سخت‌افزاری دستگاه.
h عدد صحیح ارتفاع فیزیکی صفحه نمایش بر حسب پیکسل.
w عدد صحیح عرض فیزیکی صفحه نمایش بر حسب پیکسل.
ppi عدد صحیح پشتیبانی نمی‌شود.
pxratio دو برابر نسبت پیکسل‌های فیزیکی به پیکسل‌های مستقل از دستگاه.
js عدد صحیح پشتیبانی نمی‌شود.
geofetch عدد صحیح پشتیبانی نمی‌شود.
flashver رشته پشتیبانی نمی‌شود.
language رشته (ISO-639-1-alpha-2) زبان دستگاه.
carrier رشته پشتیبانی نمی‌شود.
mccmnc رشته پشتیبانی نمی‌شود.
connectiontype عدد صحیح نوع اتصال شبکه
ifa رشته شناسه‌ای که برای استفاده‌ی علنی تبلیغ‌کننده مجاز است.
didsha1 رشته پشتیبانی نمی‌شود.
didmd5 رشته پشتیبانی نمی‌شود.
dpidsha1 رشته پشتیبانی نمی‌شود.
dpidmd5 رشته پشتیبانی نمی‌شود.
macsha1 رشته پشتیبانی نمی‌شود.
macmd5 رشته پشتیبانی نمی‌شود.
ext افزونه‌های دستگاه افزونه‌هایی برای شیء دستگاه.

افزونه پشتیبانی شده برای شیء دستگاه

اگر ip تغییر کرده یا قطع شده است، اکیداً توصیه می‌کنیم افزونه‌های زیر را ارسال کنید تا از اعلام ترافیک به عنوان ترافیک نامعتبر جلوگیری شود.

میدان نوع جزئیات
truncated_ip عدد صحیح مشخص کنید که آیا آدرس IP در فیلد device.ip درخواست پیشنهاد کوتاه شده است یا خیر.

0 : کوتاه نشده
1 : کوتاه شده

پیش‌فرض کوتاه نشده است و در صورت کوتاه شدن آدرس IP، لازم است.

اگر درخواست پیشنهاد اعلام نشود، ممکن است به عنوان ترافیک نامعتبر طبقه‌بندی شود.

ifa_type رشته منشأ فیلد device.ifa را مشخص کنید، اینکه آیا از خود دستگاه ارائه شده یا توسط ناشر یا SSP در زنجیره تأمین تولید شده است.

aaid تی‌وی
rida : روکو
afai : آتش‌سوزی آمازون
idfa : اپل تی‌وی او اس
msai : ایکس‌باکس/مایکروسافت
dpid : شناسه عمومی پلتفرم دستگاه
ppid : شناسه ارائه شده توسط ناشر
sspid : شناسه ارائه شده توسط SSP
sessionid : شناسه جلسه کوتاه مدت (فقط برای پوشش‌دهی)

attestation_token رشته (رمزگذاری base64) یک توکن تایید هویت مبتنی بر دستگاه برای صرافی‌هایی که از آن سطح از اعتبارسنجی دستگاه پشتیبانی می‌کنند.
atts عدد صحیح (فقط iOS) یک عدد صحیح که برای نمایش وضعیت مجوز ردیابی برنامه ارسال می‌شود.

0 : مشخص نشده است
1 : محدود شده
2 : رد شد
3 : مجاز

cdep رشته برچسب منسوخ شدن کوکی‌های شخص ثالث کروم.

به آزمایش تسهیل‌شده با کروم و مشخصات انجمن IAB مراجعه کنید

شیء UserAgent

میدان نوع جزئیات
browsers آرایه‌ای از اشیاء BrandVersion هر شیء BrandVersion یک مرورگر یا یک جزء نرم‌افزاری مشابه را شناسایی می‌کند.
platform شیء BrandVersion پلتفرم را مشخص می‌کند.
mobile عدد صحیح 0 (پیش‌فرض): عامل محتوای «دسکتاپ» یا «کامل» را ترجیح می‌دهد.
1 : عامل، محتوای «موبایل» را ترجیح می‌دهد.
architecture رشته معماری دستگاه، برای مثال، "x86" یا "arm".
bitness رشته میزان بیت دستگاه، برای مثال، "۶۴" برای معماری ۶۴ بیتی.
model رشته مدل دستگاه.
source عدد صحیح برای منبع داده‌ای که برای ایجاد این شیء استفاده شده است، به List: User-Agent Source مراجعه کنید. هنگام ارسال شیء UserAgent توصیه می‌شود.

شیء BrandVersion

میدان نوع جزئیات
brand رشته شناسه برند، برای مثال، «کروم» یا «ویندوز». الزامی است.
version آرایه رشته‌ای دنباله‌ای از اجزای نسخه، به ترتیب سلسله مراتبی نزولی (اصلی، فرعی، خرد و غیره).

شیء جغرافیایی

میدان نوع جزئیات
lat دو برابر پشتیبانی نمی‌شود.
lon دو برابر پشتیبانی نمی‌شود.
type عدد صحیح پشتیبانی نمی‌شود.
accuracy عدد صحیح پشتیبانی نمی‌شود.
lastfix عدد صحیح پشتیبانی نمی‌شود.
ipservice عدد صحیح پشتیبانی نمی‌شود.
country رشته پشتیبانی نمی‌شود.
region رشته پشتیبانی نمی‌شود.
regionfips104 رشته پشتیبانی نمی‌شود.
metro رشته پشتیبانی نمی‌شود.
city رشته پشتیبانی نمی‌شود.
zip رشته پشتیبانی نمی‌شود.
utcoffset عدد صحیح پشتیبانی نمی‌شود.

شیء کاربر

میدان نوع جزئیات
id رشته اگر گوگل جدول تطابق شناسه را میزبانی کند، پشتیبانی می‌شود.
buyeruid رشته در صورتی پشتیبانی می‌شود که SSP میزبان جدول تطابق شناسه باشد.
yob عدد صحیح برای هدف قرار دادن جمعیت‌شناسی توصیه می‌شود.
gender رشته برای هدف قرار دادن جمعیت‌شناسی توصیه می‌شود.
keywords رشته (CSV) پشتیبانی نمی‌شود.
customdata رشته پشتیبانی نمی‌شود.
geo شیء جغرافیایی پشتیبانی نمی‌شود.
data آرایه‌ای از اشیاء داده‌ای داده‌های اضافی.
eids آرایه‌ای از اشیاء شناسه توسعه‌یافته نمونه‌های شناسه توسعه‌یافته ارائه شده توسط صرافی.
ext افزونه‌های کاربری افزونه‌هایی برای شیء کاربر.

افزونه‌های پشتیبانی‌شده برای شیء کاربر

میدان نوع جزئیات
consent رشته (web-safe base64) رشته رضایت IAB.

شامل فراداده‌هایی در مورد اطلاعاتی است که کاربر به جمع‌آوری آنها رضایت داده است و اینکه کدام فروشندگان مجاز به استفاده از آن اطلاعات هستند.

مقدار، یک رشته دودویی کدگذاری شده base64 و سازگار با وب است که از یک قالب دودویی سفارشی استفاده می‌کند.

us_privacy رشته اگر کاربر شاهد رعایت قوانین CCPA یا قوانین مشابه بوده باشد.
consented_providers_settings . consented_providers شیء بیرونی (consented_providers_settings) که یک آرایه عدد صحیح داخلی (consented_providers) را در بر می‌گیرد. وقتی رضایت GDPR از طریق TCF جمع‌آوری می‌شود، این فیلد ارائه‌دهندگان فناوری تبلیغاتی مورد رضایت کاربر را که در TCF شرکت نمی‌کنند، فهرست می‌کند. به « مشخصات فنی رضایت تکمیلی Google » مراجعه کنید.
eids آرایه‌ای از اشیاء شناسه توسعه‌یافته نمونه‌های شناسه توسعه‌یافته ارائه شده توسط صرافی.

شیء شناسه توسعه‌یافته

میدان نوع جزئیات
source رشته ارائه دهنده شناسه
uids آرایه‌ای از اشیاء UID با شناسه توسعه‌یافته شناسه‌های واقعی

شیء شناسه توسعه‌یافته UID

میدان نوع جزئیات
id رشته خودِ شناسه.
atype عدد صحیح نوع عامل کاربری مرتبط با این شناسه.

شیء زنجیره تأمین

میدان نوع جزئیات
complete عدد صحیح 0 (پیش‌فرض): زنجیره تأمین ناقص است.
1 : زنجیره تأمین تا ناشر کامل است.
ver رشته الزامی است.
مقدار به صورت "major.minor" قالب‌بندی شده است، برای مثال، نسخه ۱.۰ رشته "۱.۰" است.
nodes آرایه گره زنجیره تامین الزامی است.

در یک زنجیره تأمین کامل، گره اول نشان دهنده سیستم تبلیغات اولیه و شناسه فروشنده درگیر در معامله، یعنی مالک سایت، اپلیکیشن یا رسانه دیگر است.

در یک زنجیره تأمین ناقص، این اولین گره شناخته شده را نشان می‌دهد. آخرین گره نشان دهنده نهادی است که این درخواست پیشنهاد را ارسال می‌کند.

شیء گره زنجیره تأمین

میدان نوع جزئیات
asi رشته نام دامنه متعارف سامانه SSP، Exchange، Header Wrapper و غیره که پیشنهاددهندگان به آن متصل می‌شوند. این دامنه می‌تواند دامنه عملیاتی سامانه باشد، اگر با دامنه شرکت مادر متفاوت باشد، تا جستجوی WHOIS و IP معکوس را برای تعیین مالکیت قطعی سامانه نماینده تسهیل کند.

این باید همان مقداری باشد که برای شناسایی فروشندگان در فایل ads.txt در صورت وجود، استفاده می‌شود.

sid رشته شناسه مرتبط با حساب فروشنده یا نماینده فروش در سیستم تبلیغات. این شناسه باید حاوی همان مقداری باشد که در تراکنش‌ها (یعنی درخواست‌های پیشنهاد OpenRTB) در فیلد مشخص شده توسط SSP/صرافی استفاده می‌شود.

معمولاً در OpenRTB، این publisher.id است. برای OpenDirect معمولاً شناسه سازمان ناشر است.

باید به طول ۶۴ کاراکتر محدود شود.

rid رشته شناسه درخواست OpenRTB مربوط به درخواستی که توسط این فروشنده صادر شده است.
name رشته نام شرکت (شخص حقوقی) که هزینه موجودی معامله شده تحت شناسه فروشنده (seller_id) داده شده به آن پرداخت می‌شود.

این مقدار اختیاری است و اگر در فایل sellers.json سیستم تبلیغاتی وجود داشته باشد، نباید وارد شود.

domain رشته نام دامنه تجاری نهادی که توسط این گره نمایش داده می‌شود.

این مقدار اختیاری است و اگر در فایل sellers.json سیستم تبلیغاتی وجود داشته باشد، نباید وارد شود.

hp عدد صحیح نشان می‌دهد که آیا این گره در جریان پرداخت موجودی کالا دخیل خواهد بود یا خیر.

1 : سیستم تبلیغاتی در فیلد asi به فروشنده در فیلد sid که مسئول پرداخت به گره قبلی در زنجیره است، پول پرداخت می‌کند.
0 : این گره در جریان پرداخت موجودی کالا دخیل نیست.

برای نسخه ۱.۰ از SupplyChain، این ویژگی همیشه باید ۱ باشد. صراحتاً لازم است که این ویژگی گنجانده شود زیرا انتظار می‌رود نسخه‌های آینده این مشخصات، گره‌های مدیریت غیرپرداخت را معرفی کنند.

مجریان باید اطمینان حاصل کنند که از این فیلد پشتیبانی می‌کنند و هنگام ساخت اشیاء SupplyChain در درخواست‌های مناقصه ارسال شده به یک سیستم تبلیغاتی پایین‌دستی، آن را به سمت جلو منتشر می‌کنند.

مشخصات پاسخ به پیشنهاد

شیء BidResponse

ویژگی پشتیبانی شده جزئیات پیاده‌سازی همیشه گذشت
شناسه اگر خطای تجزیه رخ دهد، ممکن است به جای شناسه درخواست پیشنهاد، '0' باشد. بله
پیشنهاد صندلی
بیدید
فعلی اگر خطای تجزیه رخ دهد، این مورد پذیرفته نمی‌شود. برای درخواست پیشنهاد قیمت معتبر، همیشه جریان ترافیک ارائه می‌شود. بله
داده‌های سفارشی
نبر این مورد فقط در صورتی لحاظ می‌شود که مشکلی در درخواست پیشنهاد قیمت مشاهده شود. مقادیر ممکن عبارتند از:
2 : درخواست نامعتبر
12 : نقض مجوز Ads.txt
16 : زنجیره تأمین ناقص
17 : گره زنجیره تامین مسدود شده
توجه: هنگامی که تخلف خاصی از (app-)ads.txt یا SupplyChain تشخیص داده شود، یکی از کدهای ۱۲، ۱۶ یا ۱۷ روی کسری (۱٪) از پاسخ‌ها اعمال می‌شود. کد ۲ برای سایر درخواست‌های نامعتبر اعمال خواهد شد.
درخواست‌هایی که شامل NBR می‌شوند، شبیه به این خواهند بود: 
{
  "id": "0",
  "nbr": 2,
  "ext": {
    "err": "Bid request body was empty.",
    "errHelp": "https://.../ortb-spec"
  }
}
خارجی If there is a problem with the bid request ext may contain information to help diagnose the error, where supported.

Supported extensions for BidResponse object

Attribute Implementation details
خطا

A human readable description of the error with the bid request. Response cases include:

  • Bid request body was empty.
  • Bid request was not in a currency allowlisted for the particular exchange.
  • Bid request did not contain an accepted mime type.
errHelp A link to this page.

Seatbid object

Attribute پشتیبانی شده Implementation details Always passed
bid بله
صندلی بله
گروه

Bid object

Attribute پشتیبانی شده Implementation details Always passed
شناسه بله
impid بله
price بله
nurl
burl
lurl
adm
adid
adomain
bundle
iurl
سید بله
crid بله
تاکتیک
گربه
attr
API
پروتکل
qagmediarating
زبان
dealid
دبلیو
ح
wratio
hratio
exp

Supported extensions for bid object

Attribute Implementation details
apis DV360 will send seatbid.bid.apis if both OMID and MRAID are supported. DV360 will set both OMID_1 and MRAID as an integer array.

Ad serve options

In section 4.3 of the OpenRTB specification , there are two different serving options:

  • Markup served on the win notice
  • Markup served in the bid

DV360 supports both options.

  • For Banner ad, DV360 always returns markup in the adm field. Markup served on win notice is optional.
  • For Video/Audio ad using VAST protocol, DV360 supports returning VAST XML in the adm field or in the response of win notice based on requirements from exchange partners.

Refer to the OpenRTB specification to know the pros and cons of these two options.

بهترین شیوه‌ها

It is highly recommended to use the Partner ID of Display and Video 360 as the seat ID. The use of exchange-specific seat ID is not recommended.

Ensure your publishers have ads.txt files, or applications with app-ads.txt files associated, and they list you in the file as an authorized seller or reseller. Learn more .

Also ensure consistent information is passed in bid requests. For example, the app.bundle must be consistent with the mobile device information and app.storeurl .

تلویزیون متصل

Adhere to the IAB OTT IFA guidelines in passing device.ifa and device.lmt . You should also implement device.ext.ifa_type to be compliant with the guidelines. All of our CTV frequency capping and audience targeting capabilities will require the presence of an IFA.

Also adhere to the recently published IAB OTT/CTV Store Assigned ID guidelines —this defines how app.bundle should be passed for CTV apps—largely using the app store defined ID.

Active View measurement

Active View is a Google technology used to measure if an impression was viewable and for how long. Active View uses OMID for both display and video ads. To enable measurement using OMID, exchanges must add the following fields in OpenRTB requests so that DV360 knows the client's support of OMID.

  • Required: Add an API Framework ( Video.api=7 for OMSDK ) to bid requests. This is mandatory for Active View to enable measurement using OMID.
  • Recommended: Adding omidpn and omidpv to Source.Ext is highly recommended because it will impact how viewability measurements are reported in DV360 to the customer. If the OMID partner name is not on the IAB certification list, we are required by MRC to report the viewability metrics separately from the MRC certified metrics. Learn more .

سوالات متداول

Does DV360 Support exchange custom extensions?
Yes, in addition to the extensions listed in this specification, Display and Video 360 may also support custom extensions on a case-by-case basis. It is recommended to specify and test the custom extension during the integration period.
Does DV360 support rewarded video?
Yes, send us the rewarded video extension .
A lot of my inventory is showing up as demographics unknown, how do I improve demographic coverage?
Populate user.yob and user.gender in bid requests to DV360 to increase coverage.
Does DV360 have endpoints for each region?
No, we use a single endpoint globally and we automatically route requests to the nearest data center, so there's no region-specific endpoint we can provide.
What are the requirements for server-to-server (s2s) requests?
Reach out to request addition to our allowlist. The client User Agent has to be forwarded, and ensure that cookies are disabled/ignored in the response to an s2s VAST fetch.
Does DV360 support OMID?
We are able to measure viewability using OMID as long as it is declared as OMID-enabled at bid request time. Details about this are summarized on pages 24-25 .
Which version of Native do you support? Do you have any Native requirements?
We only support Native Ver1.2. Native specification .
Does DV360 support bid requests sent as GZIP?
DV360 can receive gzip compressed bid requests, and will respond with gzip compressed responses if Accept-Encoding header indicates it's supported.
Does DV360 support DBURL?
Not at the moment.
Does DV360 support win loss notification?
Not at the moment. If you think it would be useful for us to support it please reach out with more details.
Does DV360 require App.name for targeting?
No, DV360 using App.name for reference but it is not required for targeting, App.bundle is used for targeting.
Can DV360 support multiple ad sizes sent in a single bid request?
Yes, we will consider all eligible creative sizes in banner.format.
Does DV360 support multiple formats in the same bid request?
We have limited support for multi-format bid requests, but are working on improving. We support display & video formats for interstitials, but do not currently support display & native. If you are sending multi-format bid requests, please reach out to request a test.
Does DV360 support mixed impression types in the same request?
Currently we only support video/banner interstitials. We are working on native/banner & video/banner. If there are other combinations please reach out to our team.
Can multiple seats each send multiple bids on one or more of such impression opportunities in the same request?
Yes.
Does DV360 have a solution or particular need regarding capping or displaying the same advertiser for multiple such impression opportunities in the same request?
DV360 places enforcement that one advertiser can only bid up to one imp opportunities for each request. We expect SSPs to group imp objects meaningfully; eg, all on the same page, all in the same app, etc.
Does DV360 support multiple impressions in the same bid request?
DV360 currently supports multiple impression audio objects. However, we will need to test/enable each exchange that would like to use this feature. See bid request specification for more information. We are working on expanding this to other formats: 
{
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"
}

تماس با ما

If you have any questions or issues, reach out to our exchange support team.