مشخصات DV360 OpenRTB

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

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

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

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

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

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

اگر یک درخواست پیشنهاد بد شکل باشد، یک 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 حداقل 1 شی imp مورد نیاز است.

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

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

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

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

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

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

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

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

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

شی منبع

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

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

ext پسوند منبع اختیاری.

شیء پسوند منبع

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

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

رگس شی

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

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

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

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

شی Imp

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

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

clickbrowser عدد صحیح

نشان دهنده نوع مرورگر است که با کلیک بر روی خلاقیت در یک برنامه باز شده است.
0 (پیش فرض): تعبیه شده
1 : بومی

توجه داشته باشید که Safari View Controller در دستگاه‌های iOS 9.x یک مرورگر بومی برای اهداف این زمینه در نظر گرفته می‌شود.

secure عدد صحیح اگر این نمایش به نشانی اینترنتی HTTPS ایمن یا نشانی اینترنتی HTTP ناامن نیاز دارد.
0 (پیش فرض): ناامن
1 : امن
iframebuster آرایه رشته ای
exp عدد صحیح انقضای پیشنهاد توسط DV 360 بدون توجه به ارزش ارسال شده توسط شریک در این زمینه تنظیم می شود. رویدادهای نمایشی دریافت شده پس از پنجره کهنگی نمایش (معمولاً 1 ساعت) به‌عنوان قدیمی کنار گذاشته می‌شوند و توسط 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 : تبلیغات IFrame

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 آرایه رشته ای حداقل یک نوع میم مورد نیاز است.

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 : VAST 1.0
2 : VAST 2.0
3 : VAST 3.0
4 : بسته بندی VAST 1.0
5 : بسته بندی VAST 2.0
6 : بسته بندی VAST 3.0
7 : VAST 4.0
8 : VAST 4.0 Wrapper
9 : DAAST 1.0
10 : DAAST 1.0 Wrapper

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

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

توجه: برای در نظر گرفتن In-Stream (Placement یا Plcmt نوع 1)، مکان‌ها/برداشت‌های ویدیو باید روی «صدا روشن» تنظیم شوند و در روش پخش به درستی علامت‌گذاری شوند (مقادیر 1، 3، 4 و 5 همگی واجد شرایط هستند).
plcmt عدد صحیح اکیداً توصیه می شود که plcmt (و/یا) قرار دادن ویدیو را در درخواست مناقصه مشخص کنید. از دست دادن هر دو فیلد به عنوان یک مکان ناشناخته طبقه بندی می شود.

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

توجه: برای در نظر گرفتن In-Stream (Placement یا Plcmt نوع 1)، مکان‌ها/برداشت‌های ویدیو باید روی «صدا روشن» تنظیم شوند و در روش پخش به درستی علامت‌گذاری شوند (مقادیر 1، 3، 4 و 5 همگی واجد شرایط هستند).

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

نکته: 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 عدد صحیح نشان می دهد که آیا ارسال نامه از محتوای 4:3 در یک پنجره 16:9 مجاز است یا خیر

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

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

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

توجه: همه نمایش‌های نمایشی با صدای پیش‌فرض خاموش (روش پخش 2، 6 یا 0) باید یک مکان خارج از جریان از نوع 2، 3، 4 یا 5 (oRTB 2.5) یا نوع فرعی Plcmt 2، 3، یا 4 را نشان دهند.
playbackend عدد صحیح رویدادی که باعث پایان پخش می شود.

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

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

1 : جریان
2 : مترقی

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

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

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

0 (پیش فرض): ناشناخته
1 : VPAID 1
2 : VPAID 2
3 : MRAID 1
4 : ORMMA
5 : MRAID 2
6 : MRAID 3
7 : OMID 1 - برای فعال کردن اندازه گیری با استفاده از OMID برای نمای فعال مورد نیاز است.
8 : SIMID 1

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

پسوند پشتیبانی شده برای شی ویدیو

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

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

شیء صوتی

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

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

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

3 : VAST 3.0
6 : بسته بندی VAST 3.0
7 : VAST 4.0
8 : VAST 4.0 Wrapper

startdelay عدد صحیح تأخیر شروع در چند ثانیه برای آگهی‌های قبل از پخش، میان‌پول یا پس از پخش.

-2 : پس از رول
-1 : اواسط رول
0 : پیش رول
>0 : اواسط فیلم

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

7 : امید V1

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

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

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

شی بومی

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

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

7 : امید V1

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

شیء PMP

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

شی معامله

میدان تایپ کنید جزئیات
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 رشته دامنه سایت.

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

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

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

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

شی پسوند سایت

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

شی برنامه

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

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

bundle رشته مورد نیاز.

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

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

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

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

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

شیء محتوا

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

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

0 (پیش فرض): ناشناخته
1 : حرفه ای
2 : Prosumer
3 : کاربر ایجاد شده است

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

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

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

1 : همه مخاطبان
2 : 12+
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 پسوند داده ها برنامه های افزودنی برای شی Data.

پسوندهای پشتیبانی شده برای شی داده

میدان تایپ کنید جزئیات
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 : در یک درخواست برنامه ، ترافیک 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 : Android TV
rida : روکو
afai : آمازون فایر
idfa : Apple tvOS
msai : Xbox/Microsoft
dpid : شناسه پلت فرم دستگاه عمومی
ppid : شناسه ارائه شده توسط ناشر
sspid : شناسه ارائه شده توسط SSP
sessionid : شناسه جلسه کوتاه مدت (فقط fcapping)

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

0 : مشخص نیست
1 : محدود
2 : تکذیب شد
3 : مجاز

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

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

شی UserAgent

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

شی BrandVersion

میدان تایپ کنید جزئیات
brand رشته شناسه برند، به عنوان مثال، "Chrome" یا "Windows". مورد نیاز.
version آرایه رشته ای دنباله ای از اجزای نسخه، به ترتیب سلسله مراتبی نزولی (مهم، جزئی، خرد، و غیره).

شی ژئو

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

شی کاربر

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

پسوندهای پشتیبانی شده برای شی کاربر

میدان تایپ کنید جزئیات
consent رشته (پایه امن وب 64) رشته رضایت IAB.

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

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

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

شیء ID توسعه یافته

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

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

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

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

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

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

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

شی گره زنجیره تامین

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

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

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

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

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

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

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

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

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

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

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

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

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

مشخصات پاسخ به مناقصه

شی BidResponse

صفت پشتیبانی می شود جزئیات پیاده سازی همیشه گذشت
شناسه اگر خطای تجزیه رخ دهد، ممکن است به جای شناسه درخواست پیشنهاد، "0" باشد. بله
مناقصه صندلی
پیشنهاد داد
درمان اگر خطای تجزیه رخ دهد، این خطا ارسال نمی شود. برای درخواست پیشنهاد معتبر، ترافیک همیشه ارائه می شود. بله
داده های سفارشی
nbr این فقط در صورتی شامل می شود که مشکلی در درخواست پیشنهاد پیدا شود. مقادیر ممکن عبارتند از:
2 : درخواست نامعتبر
12 : نقض مجوز Ads.txt
16 : زنجیره تامین ناقص
17 : گره زنجیره تامین مسدود شده است
توجه: هنگامی که نقض خاصی از (app-)ads.txt یا SupplyChain تشخیص داده شود، یکی از کدهای 12، 16 یا 17 روی کسری (1%) از پاسخ‌ها پر می‌شود. کد 2 برای تمام درخواست های نامعتبر دیگر پر می شود.
درخواست‌هایی که شامل NBR می‌شوند شبیه به این خواهند بود: 
{
  "id": "0",
  "nbr": 2,
  "ext": {
    "err": "Bid request body was empty.",
    "errHelp": "https://.../ortb-spec"
  }
}
داخلی اگر مشکلی در درخواست پیشنهاد وجود داشته باشد، متن ممکن است حاوی اطلاعاتی باشد که به تشخیص خطا کمک کند، در صورت پشتیبانی.

پسوندهای پشتیبانی شده برای شی BidResponse

صفت جزئیات پیاده سازی
اشتباه کن

شرحی قابل خواندن توسط انسان از خطا در درخواست مناقصه. موارد پاسخ عبارتند از:

  • متن درخواست پیشنهاد خالی بود.
  • درخواست پیشنهاد به واحد پولی که برای صرافی خاص فهرست شده بود نبود.
  • درخواست پیشنهاد شامل یک نوع میم پذیرفته شده نیست.
errHelp لینکی به این صفحه

شیء Seatbid

صفت پشتیبانی می شود جزئیات پیاده سازی همیشه گذشت
مناقصه بله
صندلی بله
گروه

شی پیشنهاد

صفت پشتیبانی می شود جزئیات پیاده سازی همیشه گذشت
شناسه بله
ناتوان بله
قیمت بله
nurl
برف
لول کردن
adm
adid
دامنه
بسته نرم افزاری
iurl
cid بله
کرید بله
تاکتیک
گربه
attr
api
پروتکل
قاگ واسطه
زبان
معامله شد
w
ساعت
wratio
hratio
انقضا

پسوندهای پشتیبانی شده برای شی bid

صفت جزئیات پیاده سازی
apis اگر هر دو OMID و MRAID پشتیبانی شوند، DV360 seatbid.bid.apis را ارسال می کند. DV360 هر دو OMID_1 و MRAID را به عنوان یک آرایه عدد صحیح تنظیم می کند.

گزینه های سرویس تبلیغات

در بخش 4.3 از مشخصات OpenRTB ، دو گزینه ارائه خدمات مختلف وجود دارد:

  • علامت گذاری روی اعلان برد ارائه شد
  • Markup در مناقصه خدمت کرد

DV360 از هر دو گزینه پشتیبانی می کند.

  • برای تبلیغات بنر، DV360 همیشه نشانه گذاری را در قسمت adm برمی گرداند. نشانه گذاری ارائه شده در اطلاعیه برد اختیاری است.
  • برای تبلیغات ویدیویی/صوتی با استفاده از پروتکل VAST، DV360 از بازگرداندن VAST XML در قسمت adm یا در پاسخ به اخطار برنده بر اساس الزامات شرکای تبادل پشتیبانی می‌کند.

برای دانستن مزایا و معایب این دو گزینه به مشخصات OpenRTB مراجعه کنید.

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

به شدت توصیه می شود از شناسه شریک Display و Video 360 به عنوان شناسه صندلی استفاده کنید. استفاده از شناسه صندلی مخصوص تعویض توصیه نمی شود.

اطمینان حاصل کنید که ناشران شما فایل‌های ads.txt یا برنامه‌هایی با فایل‌های app-ads.txt مرتبط دارند و شما را در فایل به‌عنوان فروشنده یا فروشنده مجاز فهرست می‌کنند. بیشتر بدانید .

همچنین اطمینان حاصل کنید که اطلاعات منسجم در درخواست‌های پیشنهاد ارسال می‌شود. برای مثال، app.bundle باید با اطلاعات دستگاه همراه و app.storeurl سازگار باشد.

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

در عبور device.ifa و device.lmt به دستورالعمل های IAB OTT IFA پایبند باشید. همچنین باید device.ext.ifa_type پیاده سازی کنید تا با دستورالعمل ها مطابقت داشته باشید. تمام قابلیت‌های محدود کردن فرکانس CTV و هدف‌گیری مخاطبان ما به حضور IFA نیاز دارد.

همچنین به دستورالعمل‌های IAB OTT/CTV Store Assigned ID که اخیراً منتشر شده است، - این نشان می‌دهد که app.bundle چگونه باید برای برنامه‌های CTV ارسال شود - عمدتاً با استفاده از شناسه تعریف‌شده فروشگاه برنامه.

اندازه گیری نمای فعال

Active View یک فناوری Google است که برای اندازه‌گیری اینکه آیا یک نمایش قابل مشاهده است و برای چه مدت استفاده می‌شود. Active View از OMID برای تبلیغات نمایشی و ویدیویی استفاده می کند. برای فعال کردن اندازه‌گیری با استفاده از OMID، صرافی‌ها باید فیلدهای زیر را در درخواست‌های OpenRTB اضافه کنند تا DV360 از پشتیبانی مشتری از OMID مطلع شود.

  • مورد نیاز: یک چارچوب API ( Video.api=7 برای OMSDK ) به درخواست‌های پیشنهاد اضافه کنید. این برای فعال کردن اندازه گیری با استفاده از OMID برای نمایش فعال اجباری است.
  • توصیه می‌شود: افزودن omidpn و omidpv به Source.Ext بسیار توصیه می‌شود زیرا بر نحوه گزارش‌دهی اندازه‌گیری‌های قابلیت مشاهده در DV360 به مشتری تأثیر می‌گذارد. اگر نام شریک OMID در فهرست گواهینامه IAB نباشد ، MRC از ما خواسته است که معیارهای قابلیت مشاهده را جداگانه از معیارهای تأیید شده MRC گزارش دهیم. بیشتر بدانید .

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

آیا DV360 پسوندهای سفارشی را مبادله می کند؟
بله، علاوه بر برنامه‌های افزودنی ذکر شده در این مشخصات، Display and Video 360 ممکن است به صورت موردی از برنامه‌های افزودنی سفارشی نیز پشتیبانی کند. توصیه می شود در طول دوره ادغام، پسوند سفارشی را مشخص و آزمایش کنید.
آیا DV360 از ویدیوی پاداش پشتیبانی می کند؟
بله، پسوند ویدیوی پاداش را برای ما ارسال کنید.
بسیاری از موجودی من به عنوان اطلاعات جمعیتی ناشناخته نشان داده می شود، چگونه می توانم پوشش جمعیتی را بهبود بخشم؟
برای افزایش پوشش ، user.yob و user.gender در درخواست پیشنهاد به DV360.
آیا DV360 برای هر منطقه دارای نقاط پایانی است؟
نه ، ما از یک نقطه پایانی واحد در سطح جهان استفاده می کنیم و به طور خودکار درخواست ها را به نزدیکترین مرکز داده هدایت می کنیم ، بنابراین هیچ نقطه پایانی منطقه ای وجود ندارد که بتوانیم ارائه دهیم.
الزامات درخواست های سرور به سرور (S2S) چیست؟
به درخواست علاوه بر لیست اجازه ما مراجعه کنید . عامل کاربر مشتری باید ارسال شود و اطمینان حاصل کند که کوکی ها در پاسخ به یک S2S گسترده از آنها غیرفعال و نادیده گرفته می شوند.
آیا DV360 از OMID پشتیبانی می کند؟
ما قادر به اندازه گیری قابلیت مشاهده با استفاده از OMID هستیم تا زمانی که در زمان درخواست پیشنهاد به عنوان امید فعال شود. جزئیات مربوط به این موضوع در صفحات 24-25 خلاصه شده است.
از کدام نسخه از بومی پشتیبانی می کنید؟ آیا نیازهای بومی دارید؟
ما فقط از بومی Ver1.2 پشتیبانی می کنیم. مشخصات بومی .
آیا درخواست های پیشنهادی DV360 به عنوان GZIP ارسال شده است؟
DV360 می تواند درخواست های پیشنهادات فشرده شده GZIP را دریافت کند ، و اگر عنوان رمزگذاری پذیرش نشانگر پشتیبانی از آن باشد ، با پاسخ های فشرده شده GZIP پاسخ خواهد داد.
آیا DV360 از Dburl پشتیبانی می کند؟
در حال حاضر نه.
آیا DV360 از اعلان ضرر پیروز پشتیبانی می کند؟
در حال حاضر نه. اگر فکر می کنید پشتیبانی از آن برای ما مفید خواهد بود ، لطفاً با جزئیات بیشتر در این زمینه دسترسی پیدا کنید.
آیا DV360 برای هدف قرار دادن به App.Name نیاز دارد؟
خیر ، DV360 با استفاده از App.Name برای مرجع اما برای هدف قرار دادن لازم نیست ، App.bundle برای هدف قرار دادن استفاده می شود.
آیا DV360 می تواند از چندین اندازه تبلیغاتی ارسال شده در یک درخواست پیشنهادی پشتیبانی کند؟
بله ، ما همه اندازه های خلاقانه واجد شرایط را در Banner.Format در نظر خواهیم گرفت.
آیا DV360 در همان درخواست پیشنهاد از قالب های مختلف پشتیبانی می کند؟
ما از درخواست های پیشنهادی چند فرمت پشتیبانی محدودی داریم ، اما در تلاش برای بهبود هستیم. ما از قالب های نمایش و ویدیویی برای بینابینی پشتیبانی می کنیم ، اما در حال حاضر از نمایشگر و بومی پشتیبانی نمی کنیم. اگر در حال ارسال درخواست پیشنهادات چند فرمت هستید ، لطفاً برای درخواست آزمایش مراجعه کنید.
آیا DV360 در همان درخواست از انواع برداشت مختلط پشتیبانی می کند؟
در حال حاضر ما فقط از بینابینی های ویدیو/بنر پشتیبانی می کنیم. ما در حال کار بر روی بومی/بنر و فیلم/بنر هستیم. اگر ترکیبات دیگری وجود دارد ، لطفاً به تیم ما دسترسی پیدا کنید .
آیا می توان چندین صندلی را در هر یک یا چند فرصت تصور در همان درخواست ارسال کرد؟
بله.
آیا DV360 در مورد پوشش یا نمایش همان تبلیغ کننده برای چندین فرصت از چنین تصور در همان درخواست ، راه حل یا نیاز خاصی دارد؟
DV360 اجرای این امر را انجام می دهد که یک تبلیغ کننده فقط می تواند برای هر درخواست یک فرصت IMP را پیشنهاد دهد. ما انتظار داریم SSP ها به طور معناداری از اشیاء IMP استفاده کنند. به عنوان مثال ، همه در همان صفحه ، همه در یک برنامه و غیره.
آیا DV360 در همان درخواست پیشنهاد از چندین برداشت پشتیبانی می کند؟
DV360 در حال حاضر از چندین اشیاء صوتی برداشت پشتیبانی می کند. با این حال ، ما باید هر مبادله ای را که مایل به استفاده از این ویژگی است ، آزمایش و فعال کنیم. برای اطلاعات بیشتر به مشخصات درخواست پیشنهاد مراجعه کنید. ما در حال گسترش این موضوع به قالب های دیگر هستیم: 
{
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"
}

با ما تماس بگیرید

اگر سؤال یا مسئله ای دارید ، به تیم پشتیبانی مبادله ما دسترسی پیدا کنید .