هنگام مراجعه به این صفحه، مشخصات OpenRTB 2.6 را دردسترس داشته باشید.
Display and Video 360 از همه فیلدهای مشخصات OpenRTB پشتیبانی نمیکند، و ممکن است تفاوتهای ظریفی وجود داشته باشد. بخشهای این سند حاوی اطلاعات و توصیههایی ویژه پیادهسازی Display و Video 360 است. شما باید همچنین از دستورالعملهای ارائهشده در مشخصات OpenRTB پیروی کنید، مگر اینکه دستورالعمل دیگری به شما داده شود.
برخیاز فیلدها پشتیبانی نمیشوند، اما همچنان تجزیه میشوند. این فیلدها باید بهدرستی قالببندی شوند اما بر نتیجه پیشنهاد قیمت تأثیر نمیگذارند.
مشخصات درخواست قیمت پیشنهادی
درخواست قیمت پیشنهادی یک درخواست HTTP Post با بدنه درخواست قیمت پیشنهادی
شیء است. قالب بدنه در سرصفحه Content-Type تعریف شده است.
پاسخ مربوطه یا یک HTTP 204 بدون بدنه برای پیشنهاد قیمت صفر، یا یک HTTP 200 با بدنه پاسخ پیشنهاد قیمت است.
اگر درخواست قیمت پیشنهادی بدفرم باشد، ممکن است یک HTTP 200 با بدنه پاسخ
پیشنهاد قیمت با فیلد nbr پرشده برگردانده شود.
قالب پاسخ توسط سرایند Accept کنترل میشود.
قالب JSON
وقتی نوع MIME پذیرفتهشدهای ارائه نشود، از قالب پیشفرض استفاده میشود.
درخواستها و پاسخهای JSON از مشخصات OpenRTB 2.6 «سازمان تبلیغات تعاملی» (IAB) پیروی میکنند. اسناد زیر افزونهها و پشتیبانی فیلد را شرح میدهد.
سرصفحه Content-Type: application/json نشاندهنده درخواست قیمت پیشنهادی JSON است،
Accept: application/json نشاندهنده این است که پاسخهای قیمت پیشنهادی باید در قالب JSON باشد.
قالب Protobuf
توجه: پشتیبانی از Protobuf در مرحله بتا است، درصورت تمایل لطفاً با DV360 تماس بگیرید.
درخواستها و پاسخهای JSON از مشخصات OpenRTB 2.6 Protobuf «سازمان تبلیغات تعاملی» پیروی میکنند.
افزونهها پشتیبانی محدودی دارند، اگر علاقهمندید با DV360 تماس بگیرید.
سرایند Content-Type: application/x-protobuf را برای نشان دادن درخواست قیمت پیشنهادی Protobuf ارسال کنید و Accept: application/x-protobuf را برای دریافت پاسخهای قیمت پیشنهادی Protobuf تنظیم کنید.
شیء درخواست قیمت پیشنهادی
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | الزامی. شناسه یکتای درخواست قیمت پیشنهادی. از این اطلاعات میتوان برای شناسایی درخواستهای فردی برای مدت بسیار محدودی پساز ارائه آنها استفاده کرد. |
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 |
Regs | اختیاری. |
ext |
افزونههای درخواست قیمت پیشنهادی | اختیاری. |
افزونههای درخواست قیمت پیشنهادی
| فیلد | نوع | جزئیات |
|---|---|---|
schain |
زنجیره تأمین |
یکپارچهسازیهای جدید باید
از فیلد BidRequest.source.schain در
منبع استفاده کنند.
|
purch |
عدد صحیح |
پارامتر «ترافیک خریداریشده» ترافیکی است که از داراییهای دیگر بهغیراز داراییهای تحت مالکیت، اکتسابی، یا فعالیتهای ترغیبشده دیگر هدایت میشود. این براساس مشخصات جدید MRC IVT 2.0 است.
این مورد در گزارشهای روبهروی خریدار منبع ترافیک ناشر نامیده میشود و یکی از مقادیر زیر را خواهد داشت : |
gdemsignals |
رشته | یک لکه سیگنال SCAR API از GMA SDK. اگر ترافیک «کیت توسعه نرمافزار GMA» باشد توصیه میشود، درغیراینصورت ممنوع است. |
disable_gma_format |
قطع توپ |
اگر gdemsignals ارائه شده باشد اختیاری است، درغیراینصورت ممنوع است.0 (پیشفرض): وقتی gdemsignals تکمیل میشود،
پاسخ قیمت پیشنهادی adm یک لکه json است.1: بهجای blob json، برچسب آگهی نیز ارائه خواهد شد. |
شیء منبع
| فیلد | نوع | جزئیات |
|---|---|---|
fd |
عدد صحیح | نهاد مسئول تصمیم فروش ظهور نهایی0 (پیشفرض): «تبادل» تصمیم میگیرد.1: منبع بالادستی تصمیم میگیرد.
|
tid |
رشته | پشتیبانی نمیشود. |
pchain |
رشته | پشتیبانی نمیشود. |
schain |
زنجیره تأمین |
تقریباً در همه موارد الزامی است.
این فیلد نسبتبه ارائه |
ext |
افزونههای منبع | اختیاری. |
شیء افزونههای منبع
این افزونه بسیار توصیه میشود زیرا بر نحوه گزارش اندازهگیریهای رؤیتپذیری در DV3 به مشتری تأثیر میگذارد. اگر نام شریک OMID در فهرست گواهینامه IAB نباشد، طبق الزامات MRC باید سنجههای رؤیتپذیری را جدا از سنجههای دارای گواهینامه MRC گزارش کنیم. بیشتر بدانید.
| فیلد | نوع | جزئیات |
|---|---|---|
omidpn |
رشته | شناسه یکپارچهسازی «کیت توسعه نرمافزار OM». این همان پارامتر «نام» در شیء «شریک OMID» است. |
omidpv |
رشته | نسخه یکپارچهسازی OM SDK. این همان پارامتر «versionString» از شیء «شریک OMID» است. |
schain |
زنجیره تأمین |
یکپارچهسازیهای جدید باید بهجای آن از فیلد
schain در
منبع استفاده کنند.
|
شیء Regs
| فیلد | نوع | جزئیات |
|---|---|---|
coppa |
عدد صحیح | 0 (پیشفرض): «قانون محافظت از حریم خصوصی آنلاین کودکان» (COPPA) برای این درخواست اعمال نمیشود.1: این درخواست مشمول «قانون حفاظت از حریم خصوصی آنلاین کودکان» (COPPA) میشود. |
gdpr |
رشته | پرچمی که نشان میدهد آیا درخواست مشمول مقررات «مقررات عمومی حفاظت از دادهها» است یا نه، ۰ = نه، ۱ = بله، حذف نشاندهنده نامشخص بودن است.
برای جزئیات بیشتر، اسناد «مقررات عمومی حفاظت از دادهها» در DV360 را ببینید.
فقط یکی از regs.gdpr و regs.ext.gdpr
موردانتظار است.
|
us_privacy |
رشته | سیگنالهای مربوط به حریم خصوصی مصرفکننده را تحت مقررات حریم خصوصی ایالات متحده
ارسال میکند. مشخصات رشته حریم خصوصی ایالات متحده را ببینید.
وقتی رشته us_privacy را در درخواست قیمت پیشنهادی دریافت میکنیم و
رشته IAB نشان میدهد که کاربر انصراف داده است، Display &
Video 360 درخواست را برای پیشنهادهای قیمت شخصیسازیشده واجدشرایط نمیداند.
ما سیگنال IAB را به فروشندگان دیگر منتقل نمیکنیم.
فقط یکی از |
gpp |
رشته | شامل رشته موافقت «پروتکل
حریم خصوصی جهانی» است. DV360 فقط برخیاز بخشهای GPP را میپذیرد،
ازجمله «ملی ایالات متحده»، «کالیفرنیا»، و غیره. بخشهای IAB Europe TCF پذیرفته نمیشود؛
درعوض از user.consent
یا user.ext.consent استفاده کنید. |
gpp_sid |
آرایه عدد صحیح | آرایه بخش(های) رشته موافقت «پروتکل جهانی رازداری» که باید برای این تراکنش اعمال شود. |
ext |
افزونههای Regs | اختیاری. |
شیء افزونههای مقررات
| فیلد | نوع | جزئیات |
|---|---|---|
gdpr |
عدد صحیح | پرچمی که نشان میدهد آیا درخواست مشمول مقررات «مقررات عمومی حفاظت از دادهها» است یا نه، همانطور که در regs.gdpr
بالا توضیح داده شده است. فقط یکی از regs.gdpr و regs.ext.gdpr
موردانتظار است.
|
us_privacy |
رشته | به regs.us_privacy
اسناد مراجعه کنید. فقط یکی از regs.us_privacy،
regs.ext.us_privacy، و user.ext.us_privacy
موردانتظار است.
|
شیء Imp
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | شناسه یکتای این ظهور در چارچوب درخواست قیمت پیشنهادی (معمولاً مقدار با ۱ شروع میشود و تا n برای n ظهور افزایش مییابد). |
metric |
شیء | پشتیبانی نمیشود. |
banner |
برنمای آگهی | برای فرصتهای آگهی برنمایی الزامی است. |
video |
ویدیو | برای فرصتهای آگهی ویدیویی الزامی است. |
audio |
صدا | برای فرصتهای آگهی صوتی الزامی است. |
native |
بومی | برای فرصتهای آگهی بومی الزامی است. |
pmp |
Pmp | معاملههای بازار خصوصی که برای این ظهور مؤثر است. |
displaymanager |
رشته | نام شریک میانجیگری آگهی، فناوری کیت توسعه نرمافزار، یا پخشکننده مسئول پردازش آگهی (معمولاً ویدیو یا تلفن همراه). برخیاز سرورهای آگهی از آن برای سفارشیسازی کد آگهی براساس شریک استفاده میکنند. برای ویدیو و/یا برنامهها توصیه میشود. |
displaymanagerver |
رشته | نسخه شریک میانجیگری آگهی، فناوری کیت توسعه نرمافزار، یا پخشکننده مسئول برای پرداز آگهی (معمولاً ویدیو یا تلفن همراه). برخیاز سرورهای آگهی از آن برای سفارشیسازی کد آگهی براساس شریک استفاده میکنند. برای ویدیو و/یا برنامهها توصیه میشود. |
instl |
عدد صحیح |
0 (پیشفرض): بینابینی نیست.1: آگهی بینابینی یا تمامصفحه است.
|
tagid |
رشته | شناسه جای آگهی یا برچسب آگهی خاصی که برای شروع مزایده استفاده شده است. این کار میتواند برای اشکالزدایی هرگونه مشکل یا برای بهینهسازی توسط خریدار مفید باشد. |
bidfloor |
شناور | حداقل قیمت پیشنهادی برای این ظهور که برحسب «هزارظهوربها» بیان شده است. |
bidfloorcur |
رشته |
واحد پول بااستفاده از کدهای الفبایی ISO-4217 مشخص شده است. |
clickbrowser |
عدد صحیح |
نوع مرورگری را که پساز کلیک کردن روی عنصر خلاقانه در برنامه باز میشود نشان میدهد. توجه داشته باشید که «کنترلگر نمای Safari» در دستگاههای iOS 9.x برای اهداف این فیلد بهعنوان مرورگر بومی درنظر گرفته میشود. |
secure |
عدد صحیح |
اگر این ظهور به نشانی وب HTTPS ایمن یا نشانی وب HTTP ناامن نیاز دارد.0 (پیشفرض):ناامن1: امن
|
iframebuster |
آرایه رشته | |
exp |
عدد صحیح | انقضای قیمت پیشنهادی توسط DV 360 بدون توجه به مقدار ارسالی توسط شریک در این فیلد تنظیم میشود. رویدادهای ظهور که پساز پنجره کهنگی ظهور (معمولاً ۱ ساعت) دریافت میشوند بهعنوان کهنه کنار گذاشته میشوند و DV360 آنها را قابلصدور صورتحساب درنظر نمیگیرد. |
rwdd |
عدد صحیح |
نشان میدهد که آیا کاربر برای مشاهده آگهی پاداش دریافت میکند یا نه.0 (پیشفرض): پاداش داده نشد1: پاداش داده شد
معمولاً، پیادهسازیهای آگهی ویدیویی به کاربران اجازه میدهد مقاله خبری اضافی را بهصورت رایگان بخوانند، جان اضافی در بازی دریافت کنند، یا جلسه موسیقی بدون آگهی تحت حمایت مالی دریافت کنند. پاداش معمولاً پساز تکمیل آگهی ویدیویی توزیع میشود. |
شیء افزونه Imp
| فیلد | نوع | جزئیات |
|---|---|---|
bcrid |
رشته | فهرست شناسههای طرحآگهی که باید مسدود شود. |
شیء برنما
| فیلد | نوع | جزئیات |
|---|---|---|
format |
پایه قالب | فهرستی از قالبهای پشتیبانیشده. |
w |
عدد صحیح |
format استفاده کنید.
|
h |
عدد صحیح |
format استفاده کنید.
|
wmax |
عدد صحیح | پشتیبانی نمیشود. |
hmax |
عدد صحیح | پشتیبانی نمیشود. |
wmin |
عدد صحیح | پشتیبانی نمیشود. |
hmin |
عدد صحیح | پشتیبانی نمیشود. |
btype |
آرایه عدد صحیح |
فهرستی از انواع آگهی برنمایی در فهرست مسدودشده:
|
battr |
آرایه عدد صحیح | از مقادیر زیر پشتیبانی میکند:
|
pos |
عدد صحیح |
جایگاه آگهی:
|
mimes |
آرایه رشته |
پشتیبانی نمیشود.
DV360 از نوشتار/html برای همه عناصر خلاقانه برنمایی استفاده خواهد کرد. |
topframe |
عدد صحیح |
0 (پیشفرض): برنما در iframe ارائه میشود.1: پشتیبانی نمیشود: بنر در قاب بالا ارائه میشود.
|
expdir |
آرایه عدد صحیح |
1: چپ2: راست3: بالا4: پایین5: تمامصفحه ازهم بازشدنی
|
api |
آرایه عدد صحیح |
چارچوبهای API پشتیبانیشده
|
id |
رشته |
شناسهای برای شیء برنمایشی که باید در ظهور یکتا باشد.
وقتی از |
vcm |
عدد صحیح |
فقط برای 0: همزمان با ویدیو خلاقانه، نمایان است.1: برنما یک کارت پایانی پساز ویدیو است.
|
قالببندی شیء
| فیلد | نوع | جزئیات |
|---|---|---|
w |
عدد صحیح | عرض به پیکسلهای مستقل از دستگاه (DIPS). |
h |
عدد صحیح | ارتفاع به پیکسلهای مستقل از دستگاه (DIPS). |
wratio |
عدد صحیح | پشتیبانی نمیشود. |
hratio |
عدد صحیح | پشتیبانی نمیشود. |
wmin |
عدد صحیح | پشتیبانی نمیشود. |
مورد ویدیو
ما قویاً توصیه میکنیم که جای آگهی ویدیویی را در درخواست قیمت پیشنهادی مشخص کنید. فیلد جای آگهی که وجود ندارد بهعنوان جای آگهی ناشناخته طبقهبندی میشود. برای جزئیات بیشتر، مقاله مربوط به هدفیابی براساس جایگاه را ببینید.
| فیلد | نوع | جزئیات |
|---|---|---|
mimes |
آرایه رشته |
حداقل یک نوع MIME لازم است.
|
minduration |
عدد صحیح | حداقل مدت ویدیو به ثانیه، پیشفرض بدون حداقل است. |
maxduration |
عدد صحیح | حداکثر مدت زمان ویدیو برحسب ثانیه، پیشفرض بدون حداکثر است. |
protocols |
آرایه عدد صحیح |
حداقل یک پروتکل پشتیبانیشده لازم است.
|
w |
عدد صحیح | عرض پخشکننده ویدیو به پیکسلهای مستقل از دستگاه (DIPS). |
h |
عدد صحیح | ارتفاع پخشکننده ویدیو به پیکسلهای مستقل از دستگاه (DIPS). |
startdelay |
عدد صحیح | شروع تأخیر برحسب ثانیه برای جایگاههای آگهی پیشاز پخش، میانویدیویی، یا پساز پخش. |
placement |
عدد صحیح | بهشدت توصیه میشود که جای آگهی (و/یا) جایگاه ویدیو را در درخواست قیمت پیشنهادی مشخص کنید.
اگر هر دو فیلد وجود نداشته باشد، بهعنوان جای آگهی ناشناخته طبقهبندی خواهد شد.
|
plcmt |
عدد صحیح | بهشدت توصیه میشود که جای آگهی (و/یا) جایگاه ویدیو را در درخواست قیمت پیشنهادی مشخص کنید.
اگر هر دو فیلد وجود نداشته باشد، بهعنوان جای آگهی ناشناخته طبقهبندی خواهد شد.
توجه: برای اینکه جای آگهی ویدیو/ظهور بهعنوان «درجشده در جاریسازی» (جای آگهی یا نوع جای آگهی ۱) درنظر گرفته شود، جای آگهیها/ظهورهای ویدیو باید روی «صدا روشن» تنظیم شده باشند و در «روش بازپخش» بهدرستی علامتگذاری شوند (مقادیر ۱، ۳، ۴، و ۵ همه واجدشرایط هستند).
توجه: اگر هم plcmt: Accompanying Content (2) بهعنوان placement: In Article (3)درنظر گرفته میشود plcmt: No Content/Standalone (4) بهعنوان placement: In feed (4)درنظر گرفته میشود placement: In Banner در plcmt هیچ نگاشت ندارد
|
linearity |
عدد صحیح | پشتیبانی نمیشود. |
skip |
عدد صحیح |
اگر پخشکننده ویدیو اجازه دهد آگهی رد شود.
|
skipmin |
عدد صحیح | پشتیبانی نمیشود. |
skipafter |
عدد صحیح | پشتیبانی نمیشود. |
sequence |
عدد صحیح | اگر چندین ظهور آگهی در یک درخواست قیمت پیشنهادی ارائه شود، شماره ترتیب امکان ارائه هماهنگ چندین عنصر خلاقانه را فراهم میکند. |
battr |
آرایه عدد صحیح | مشخصههای طرحآگهی مسدودشده. |
maxextended |
عدد صحیح |
حداکثر مدت آگهی ویدیویی گسترده، درصورت مجاز بودن افزونه.
|
minbitrate |
عدد صحیح | حداقل نرخ بیت برحسب کیلوبیت در ثانیه. |
maxbitrate |
عدد صحیح | حداکثر نرخ بیت برحسب کیلوبیت در ثانیه. |
boxingallowed |
عدد صحیح |
نشان میدهد که آیا تبدیل محتوای ۴:۳ به پنجره ۱۶:۹ مجاز است یا خیر
|
playbackmethod |
آرایه عدد صحیح |
روشهای بازپخش که ممکن است درحال استفاده باشند. اگر هیچکدام مشخص نشده باشند، از هر روشی میتوان استفاده کرد.
|
playbackend |
عدد صحیح |
رویدادی که باعث پایان یافتن بازپخش میشود.
|
delivery |
آرایه عدد صحیح | روشهای ارسال پشتیبانیشده. اگر هیچکدام مشخص نشده باشد، فرض میشود که همه پشتیبانی میشوند.
|
pos |
عدد صحیح |
جایگاه آگهی در صفحهنمایش.
|
companionad |
آرایه برنما | آگهیهای همپا، درصورت وجود. |
api |
آرایه عدد صحیح |
|
companiontype |
آرایه عدد صحیح | پشتیبانی نمیشود. |
maxseq |
عدد صحیح | حداکثر تعداد آگهیهایی که در یک واحد آگهی ویدیویی پویا برگردانده میشود. |
poddur |
آرایه عدد صحیح | حداکثر طول یک واحد ویدیویی پویا برحسب ثانیه. |
افزونه پشتیبانیشده برای شیء ویدیو
| فیلد | نوع | جزئیات |
|---|---|---|
rewarded |
عدد صحیح | این فیلد برای نشان دادن اینکه آیا درخواستها پاداش دارند یا نه استفاده میشود. این باید
بهصورت عدد صحیح ارسال شود.
|
شیء صوتی
| فیلد | نوع | جزئیات |
|---|---|---|
mimes |
آرایه رشته |
حداقل یک نوع MIME لازم است.
|
minduration |
عدد صحیح | حداقل مدت آگهی به ثانیه. |
maxduration |
عدد صحیح | حداکثر مدت آگهی به ثانیه. |
protocols |
آرایه عدد صحیح |
|
startdelay |
عدد صحیح | تأخیر شروع برحسب ثانیه برای جایگاههای آگهی پیشپخش، میانویدیویی، یا پساز پخش.
|
sequence |
عدد صحیح | پشتیبانی نمیشود. |
battr |
آرایه عدد صحیح | پشتیبانی نمیشود. |
maxextended |
عدد صحیح | پشتیبانی نمیشود. |
minbitrate |
عدد صحیح | حداقل نرخ بیت برحسب کیلوبیت در ثانیه. |
maxbitrate |
عدد صحیح | حداکثر نرخ بیت برحسب کیلوبیت در ثانیه. |
delivery |
آرایه عدد صحیح | پشتیبانی نمیشود. |
companionad |
آرایه شیء برنما | هریک از جای آگهیهای خلاقانه همراه برنمایی. |
api |
آرایه عدد صحیح |
فهرست چارچوبهای API پشتیبانیشده برای این ظهور.
|
companiontype |
آرایه عدد صحیح | پشتیبانی نمیشود. |
maxseq |
آرایه عدد صحیح | پشتیبانی نمیشود. |
feed |
عدد صحیح |
نوع فید صوتی. به فهرست: انواع فید در AdCOM 1.0 مراجعه کنید.
|
stitched |
عدد صحیح | پشتیبانی نمیشود. |
nvol |
عدد صحیح | پشتیبانی نمیشود. |
شیء بومی
برای جزئیات بیشتر، مشخصات آگهیهای بومی DV360 را ببینید.
| فیلد | نوع | جزئیات |
|---|---|---|
request |
رشته | شیء json بومی کدبندیشده رشته. |
ver |
رشته |
1.0: پشتیبانی نمیشود1.1: پشتیبانی نمیشود1.2
|
api |
آرایه عدد صحیح |
فهرست چارچوبهای API پشتیبانیشده برای این ظهور.
|
battr |
آرایه عدد صحیح | پشتیبانی نمیشود. |
شیء PMP
| فیلد | نوع | جزئیات |
|---|---|---|
private_auction |
عدد صحیح |
0 (پیشفرض): همه قیمتهای پیشنهادی مجاز است1: فقط معاملههای خوب
|
deals |
آرایه شیء معامله | معاملههایی که باید اضافه شود. |
شیء معامله
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | شیء PMP نمیتواند بیشاز یک شیء معامله در هر شناسه داشته باشد. |
bidfloor |
دوتایی |
حداقل قیمت پیشنهادی برای این ظهور در «هزارظهوربها».
اگر |
bidfloorcur |
رشته |
واحد پول بااستفاده از کدهای الفبایی ISO-4217 مشخص شده است.
اگر مشخص نشده باشد، بهطور پیشفرض روی ارز درخواست قیمت پیشنهادی تنظیم میشود. |
at |
عدد صحیح |
اگر مشخص نشده باشد، پیشفرض bid_request.at مطابقت است.
|
wseat |
آرایه رشته |
شناسههای شریک شرکای واجدشرایط برای معامله.
بدون صندلی به معنای بدون محدودیت صندلی است. |
wadomain |
آرایه رشته |
دامنههای تبلیغکننده مجاز به پیشنهاد قیمت دادن برای این معامله.
بدون صندلی به معنای بدون محدودیت دامنه است. |
guar |
عدد صحیح |
این فیلد برای نشان دادن اینکه آیا معامله یک معامله تضمینی است یا خیر استفاده میشود. این باید بهعنوان عدد صحیح ارسال شود.
برای اینکه DV360 معاملههای تضمینی را بپذیرد، مبادله باید در فهرست مجازها قرار گیرد؛ برای درخواست این کار، تماس بگیرید. اگر مبادله شما درحالحاضر از سازوکار دیگری برای نشان دادن معاملههای تضمینشده با DV360 استفاده میکند، برای بحث درباره انتقال به این افزونه ترجیحی، تماس بگیرید.
|
ext |
افزونههای معامله | اختیاری. |
افزونه پشتیبانیشده برای شیء معامله خوب
| فیلد | نوع | جزئیات |
|---|---|---|
guaranteed |
عدد صحیح |
این فیلد برای نشان دادن اینکه آیا معامله یک معامله تضمینی است یا خیر استفاده میشود. این باید بهعنوان عدد صحیح ارسال شود.
برای اینکه DV360 معاملههای تضمینی را بپذیرد، مبادله باید در فهرست مجازها قرار گیرد؛ برای درخواست این کار، تماس بگیرید. اگر مبادله شما درحالحاضر از سازوکار دیگری برای نشان دادن معاملههای تضمینشده با DV360 استفاده میکند، برای بحث درباره انتقال به این افزونه ترجیحی، تماس بگیرید.
توصیه میشود بهجای این فیلد از |
شیء سایت
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | شناسه سایت در مبادله. |
name |
رشته | پشتیبانی نمیشود. |
domain |
رشته |
دامنه سایت.
توصیه میشود نشانی وب کامل را در site.page ارسال کنید، نه اینکه فقط site.domain را تکمیل کنید. |
cat |
آرایه رشته | پشتیبانی نمیشود. |
sectioncat |
آرایه رشته | پشتیبانی نمیشود. |
pagecat |
آرایه رشته | پشتیبانی نمیشود. |
page |
رشته |
نشانی وب کامل جایی که ظهور باید نشان داده شود.
توصیه میشود نشانی وب کامل را برای اهداف هدفیابی ارسال کنید. |
ref |
رشته | نشانی وب ارجاعدهندهای که باعث پیمایش به صفحه کنونی شده است. |
search |
رشته | پشتیبانی نمیشود. |
mobile |
عدد صحیح | پشتیبانی نمیشود. |
privacypolicy |
عدد صحیح | پشتیبانی نمیشود. |
publisher |
هدف ناشر | جزئیات مربوط به ناشر سایت. |
content |
محتوای شیء | جزئیات مربوط به محتوای درون یک سایت. |
keywords |
رشته (قالب CSV) | پشتیبانی نمیشود. |
ext |
افزونههای سایت | افزونههای مربوط به شیء سایت. |
شیء افزونه سایت
| فیلد | نوع | جزئیات |
|---|---|---|
inventorypartnerdomain |
رشته | برای همرسانی فضای آگهی تلویزیون متصلشده استفاده میشود، به برنامه افزودن توضیحدهنده IAB CTV مراجعه کنید. |
شیء برنامه
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | شناسه برنامه در مبادله. |
name |
رشته |
نامهای برنامهها که ممکن است به درخواست ناشران نام مستعار داشته باشند.
نامهای برنامه برای درخواستهای بدون کیت توسعه نرمافزار (بیشتر تلویزیونهای متصل) میتواند مستقیماً توسط ناشر در درخواست ارائه شود. |
bundle |
رشته |
الزامی.
برای iOS، باید شناسه فروشگاه برنامه عددی باشد. شناسه دسته سبک DNS معکوس را نمیپذیریم. برای برنامه تلویزیونهای هوشمند، توصیه میکنیم شناسه برنامه تعریفشده در فروشگاه را ارسال کنید. لطفاً از رهنمودهای شناسه اختصاصدادهشده فروشگاه IAB OTT/CTV که اخیراً منتشر شده است پیروی کنید. |
domain |
رشته | دامنه، برای مثال mygame.foo.com |
storeurl |
رشته | برای درستیسنجی app-ads.txt و اعتبارسنجی فروشگاه برنامه تلویزیون اینترنتپذیر الزامی است. |
cat |
آرایه رشته | پشتیبانی نمیشود. |
sectioncat |
آرایه رشته | پشتیبانی نمیشود. |
pagecat |
آرایه رشته | پشتیبانی نمیشود. |
ver |
رشته | پشتیبانی نمیشود. |
privacypolicy |
عدد صحیح | پشتیبانی نمیشود. |
paid |
عدد صحیح | پشتیبانی نمیشود. |
publisher |
هدف ناشر | اطلاعات مربوط به ناشر برنامه. |
content |
محتوای شیء | اطلاعات مربوط به محتوای برنامه. |
keywords |
رشته (قالب csv) | پشتیبانی نمیشود. |
ext |
افزونههای برنامه | افزونههای مربوط به شیء برنامه. |
شیء افزونه برنامه
| فیلد | نوع | جزئیات |
|---|---|---|
inventorypartnerdomain |
رشته | برای همرسانی فضای آگهی تلویزیون متصلشده استفاده میشود، به برنامه افزودن توضیحدهنده IAB CTV مراجعه کنید. |
هدف محتوا
توصیه میکنیم این مشخصهها را درصورت دردسترس بودن ارسال کنید.
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | شناسهای که محتوا را بهصورت یکتا شناسایی میکند. |
episode |
عدد صحیح | شماره قسمت محتوا (معمولاً برای محتوای ویدیویی). |
title |
رشته | برای درخواستهای تلویزیونهای هوشمند، ویدیو، و صوتی توصیه میشود. |
series |
رشته | برای درخواستهای تلویزیونهای هوشمند، ویدیو، و صوتی توصیه میشود. |
season |
رشته | برچسبی برای فصل محتوا. |
artist |
رشته | هنرمند ذکرشده در محتوا. |
genre |
رشته | ژانری که محتوا را به بهترین نحو توصیف میکند. DV360 توصیه میکند که این سیگنال برای درخواستهای تلویزیونهای هوشمند، ویدیو، و صدا ارائه شود.
DV360 از چند طبقهبندی مقادیر ژانر ویدیو برای این فیلد پشتیبانی میکند: |
album |
رشته | آلبومی که محتوا به آن تعلق دارد، معمولاً برای صدا. |
isrc |
رشته | کد استاندارد بینالمللی ضبط صدا مطابق با ISO-3901. |
producer |
شیء تولیدکننده | جزئیات درباره تولیدکننده محتوا. |
url |
رشته | نشانی وب محتوا. |
cat |
آرایه رشته | دستههای محتوای IAB که محتوا را توصیف میکنند. |
prodq |
عدد صحیح |
کیفیت تولید:
|
videoquality |
عدد صحیح | پشتیبانی نمیشود. |
context |
عدد صحیح |
نوع محتوا:
|
contentrating |
رشته | برای «صدا و ویدیو/تلویزیونهای متصل» توصیه میشود، زیرا تصمیمگیری درباره این مشخصه را شروع خواهیم کرد. |
userrating |
رشته | تعداد ستارهها، پسندیدنها، و غیره… |
qagmediarating |
عدد صحیح |
ردهبندی رسانه براساس [دستورالعملهای QAG](http://www.iab.net/ne_guidelines).
|
keywords |
رشته (قالب csv) | پشتیبانی نمیشود. |
livestream |
عدد صحیح |
اگر محتوا، محتوای جاریسازی زنده باشد.
|
sourcerelationship |
عدد صحیح |
|
len |
عدد صحیح |
طول محتوا به ثانیه.
برای درخواستهای تلویزیون/ویدیو و صوتی توصیه میشود. |
language |
رشته (ISO-639-1-alpha-2) | زبان محتوا. |
embeddable |
عدد صحیح |
نشانگر اینکه آیا محتوا قابلجاسازی است یا خیر (برای مثال، پخشکننده ویدیو قابلجاسازی)
|
data |
آرایه اشیاء داده | دادههای تکمیلی. |
شیء تولیدکننده
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | پشتیبانی نمیشود. |
name |
رشته | پشتیبانی نمیشود. |
cat |
آرایه رشته | پشتیبانی نمیشود. |
domain |
رشته | دامنه سطح بالای تولیدکننده. |
شیء داده
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | شناسه ارائهدهنده داده. |
name |
رشته | نام مبادله برای ارائهدهنده داده. |
segment |
آرایهای از اشیا «بخش» | مقادیر واقعی دادهها. |
ext |
افزونههای داده | افزونههای مربوط به شیء «داده». |
افزونههای پشتیبانیشده برای شیء داده
| فیلد | نوع | جزئیات |
|---|---|---|
segtax |
عدد صحیح | شناسه ردهبندی، برای جزئیات بیشتر ردهبندیهای بخش را ببینید. |
segclass |
رشته | نسخه طبقهبندیکنندهای که شناسههای بخش را در طبقهبندی تولید کرده است. |
شیء بخش
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | شناسه بخش داده که مختص ارائهدهنده داده است. |
name |
رشته | نام بخش مخاطب براساس دادهها. |
value |
رشته | مقدار بخش مخاطب براساس دادهها. |
هدف ناشر
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | الزامی. |
name |
رشته | پشتیبانی نمیشود. |
cat |
آرایه رشته | پشتیبانی نمیشود. |
domain |
رشته | پشتیبانی نمیشود. |
هدف دستگاه
| فیلد | نوع | جزئیات |
|---|---|---|
ua |
رشته | الزامی. |
sua |
شیء UserAgent | اطلاعات ساختاریافته عامل کاربر. |
geo |
شیء جغرافیایی | مکان دستگاه. |
dnt |
عدد صحیح |
پرچم «ردیابی نشود» همانگونه که در سرصفحه مرورگر تنظیم شده است.
|
lmt |
عدد صحیح |
سیگنال «محدود کردن ردیابی آگهی» بهصورت تجاری تأیید شده است.
|
ip |
رشته |
درصورت استفاده از IPv4 الزامی است.
اگر نشانی IP کوتاه شده است، باید در |
ipv6 |
رشته |
درصورت استفاده از IPv6 الزامی است.
اگر نشانی IP کوتاه شده است، باید در |
devicetype |
عدد صحیح | برای همه انواع فضای آگهی بهشدت توصیه میشود. برای بهبود تشخیص نوع دستگاه استفاده میشود. |
make |
رشته | |
model |
رشته | |
os |
رشته |
سیستمعامل دستگاه.
این فیلد به حروف بزرگ و کوچک حساس نیست. |
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
درخواست قیمت پیشنهادی کوتاه شده است یا نه.
پیشفرض این است که نشانی IP کوتاه نشود و اگر نشانی IP کوتاه شده باشد، این فیلد الزامی است. اگر اعلام نشود، ممکن است درخواست قیمت پیشنهادی بهعنوان ترافیک نامعتبر طبقهبندی شود. |
ifa_type |
رشته |
نشان دهید که فیلد device.ifa از کجا آمده است، آیا از خود دستگاه ارائه شده است یا ناشر یا «پلاتفرم سمت عرضه» در زنجیره تأمین آن را تولید کردهاند.
|
attestation_token |
رشته (کدبندی base64) | یک کد گواهی براساس دستگاه برای مبادلاتی که از آن سطح اعتبارسنجی دستگاه پشتیبانی میکنند. |
atts |
عدد صحیح |
(فقط iOS) عدد صحیحی که برای نشان دادن وضعیت مجوز ردیابی برنامه برنامه ارسال میشود.
|
cdep |
رشته |
برچسب منسوخ شدن کوکیهای طرف سوم Chrome.
آزمایش تسهیلشده با Chrome و مشخصات انجمن IAB را ببینید |
شیء UserAgent
| فیلد | نوع | جزئیات |
|---|---|---|
browsers |
آرایهای از اشیاء نسخه نمانام | هر شیء BrandVersion مؤلفه مرورگر یا نرمافزار مشابهی را شناسایی میکند. |
platform |
شیء «نسخه نمانام» | پلاتفرم را شناسایی میکند. |
mobile |
عدد صحیح |
0 (پیشفرض): عامل محتوای «میز کار» یا «کامل» را ترجیح میدهد.
1: نماینده محتوای «تلفن همراه» را ترجیح میدهد.
|
architecture |
رشته | معماری دستگاه، برای مثال، «x86» یا «arm». |
bitness |
رشته | بیت دستگاه، برای مثال «۶۴» برای معماری ۶۴ بیتی. |
model |
رشته | مدل دستگاه. |
source |
عدد صحیح | منبع دادههای استفادهشده برای ایجاد این شیء، به فهرست: منبع عامل کاربر مراجعه کنید. هنگام ارسال شیء UserAgent توصیه میشود. |
شیء BrandVersion
| فیلد | نوع | جزئیات |
|---|---|---|
brand |
رشته | شناسه نمانام، برای مثال، «Chrome» یا «Windows». الزامی. |
version |
آرایه رشته | ترتیبی از عناصر نسخه، بهترتیب نزولی سلسلهمراتبی (اصلی، جزئی، میکرو، و غیره). |
شیء جغرافیایی
| فیلد | نوع | جزئیات |
|---|---|---|
lat |
دوتایی | پشتیبانی نمیشود. |
lon |
دوتایی | پشتیبانی نمیشود. |
type |
عدد صحیح | پشتیبانی نمیشود. |
accuracy |
عدد صحیح | پشتیبانی نمیشود. |
lastfix |
عدد صحیح | پشتیبانی نمیشود. |
ipservice |
عدد صحیح | پشتیبانی نمیشود. |
country |
رشته | پشتیبانی نمیشود. |
region |
رشته | پشتیبانی نمیشود. |
regionfips104 |
رشته | پشتیبانی نمیشود. |
metro |
رشته | پشتیبانی نمیشود. |
city |
رشته | پشتیبانی نمیشود. |
zip |
رشته | پشتیبانی نمیشود. |
utcoffset |
عدد صحیح | پشتیبانی نمیشود. |
شیء کاربر
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | اگر Google جدول مطابقت شناسه را میزبانی کند، پشتیبانی میشود. |
buyeruid |
رشته | اگر میزبان SSP جدول مطابقت شناسه را میزبانی کند، پشتیبانی میشود. |
yob |
عدد صحیح | برای هدفیابی جمعیتشناسی توصیه میشود. |
gender |
رشته | برای هدفیابی جمعیتشناسی توصیه میشود. |
keywords |
رشته (CSV) | پشتیبانی نمیشود. |
customdata |
رشته | پشتیبانی نمیشود. |
geo |
شیء جغرافیایی | پشتیبانی نمیشود. |
data |
آرایه اشیاء داده | دادههای تکمیلی. |
consent |
رشته (web-safe base64) |
وقتی مقررات «مقررات عمومی حفاظت از دادهها» (GDPR) اعمال میشود، این مشخصه حاوی ساختار داده «رشته موافقت» «چارچوب شفافسازی و کسب موافقت» «سازمان تبلیغات تعاملی» (IAB) است.
مقدار یک رشته باینری کدبندیشده با قالب ۶۴پایهای وبامن بااستفاده از
قالب IAB است.
اسناد «مقررات عمومی حفاظت از دادهها» در DV360 توضیح میدهد که DV360 چگونه از این سیگنال استفاده میکند.
فقط یکی از user.consent و user.ext.consent
موردانتظار است.
|
eids |
آرایهای از اشیا شناسه گسترده | نمونههای شناسه گسترده ارائهشده توسط مبادله. |
ext |
افزونههای کاربر | افزونههای مربوط به شیء کاربر. |
افزونههای پشتیبانیشده برای شیء کاربر
| فیلد | نوع | جزئیات |
|---|---|---|
consent |
رشته (web-safe base64) |
رشته موافقت با «مقررات کلی حفاظت از داده»، همانگونه که در
user.consent بالا توضیح داده شده است.
فقط یکی از user.consent و user.ext.consent
موردانتظار است.
|
eids |
آرایهای از اشیا شناسه گسترده | نمونههای شناسه گسترده ارائهشده توسط مبادله. |
consented_providers_settings.consented_providers |
شیء بیرونی (consented_providers_settings) که آرایه «عدد صحیح» داخلی (consented_providers) را میپیچد. | وقتی موافقت «مقررات عمومی حفاظت از دادهها» ازطریق «چارچوب شفافسازی و کسب موافقت» جمعآوری میشود، این فیلد فهرست ارائهدهندگان فناوری تبلیغات را که کاربر با آنها موافقت کرده است و در «چارچوب شفافسازی و کسب موافقت» شرکت نمیکنند نشان میدهد. به «مشخصات فنی موافقت اضافی Google» مراجعه کنید. |
us_privacy |
رشته | به regs.us_privacy
اسناد مراجعه کنید. فقط یکی از regs.us_privacy،
regs.ext.us_privacy، و user.ext.us_privacy
موردانتظار است.
|
شیء شناسه گسترده
| فیلد | نوع | جزئیات |
|---|---|---|
source |
رشته | ارائهدهنده شناسه |
uids |
آرایهای از اشیا شناسه یکتای شناسه گسترده | شناسههای واقعی |
شیء UID شناسه گسترده
| فیلد | نوع | جزئیات |
|---|---|---|
id |
رشته | خود شناسه. |
atype |
عدد صحیح | نوع عامل کاربر مرتبط با این شناسه. |
شیء زنجیره تأمین
| فیلد | نوع | جزئیات |
|---|---|---|
complete |
عدد صحیح | 0 (پیشفرض): زنجیره تأمین ناقص است.1: زنجیره تأمین تا ناشر کامل است.
|
ver |
رشته | الزامی. مقدار با قالب «اصلی.فرعی» قالببندی میشود، برای مثال، نسخه ۱.۰ رشته «۱.۰» است. |
nodes |
پایه گره زنجیره تأمین | الزامی. در زنجیره تأمین کامل، گره اول نشاندهنده سیستم تبلیغات اولیه و شناسه فروشنده درگیر در تراکنش است، یعنی مالک سایت، برنامه، یا رسانه دیگر. در زنجیره تأمین ناقص، نشاندهنده اولین گره شناختهشده است. آخرین گره نشاندهنده نهادی است که این درخواست قیمت پیشنهادی را ارسال میکند. |
شیء گره زنجیره تأمین
| فیلد | نوع | جزئیات |
|---|---|---|
asi |
رشته | نام دامنه متعارف سیستم «پلاتفرم سمت عرضه» (SSP)، «تبادل»، «پوشش سرایند»، و غیره که پیشنهاددهندگان قیمت به آن متصل میشوند. این ممکن است دامنه عملیاتی سیستم باشد،
اگر با دامنه شرکتی مادر متفاوت باشد،
برای تسهیل کردن جستجوهای WHOIS و IP معکوس بهمنظور تعیین مالکیت واضح
سیستم نماینده.
این مقدار باید همان مقداری باشد که برای شناسایی فروشندگان در فایل ads.txt استفاده میشود، درصورتیکه چنین فایلی وجود داشته باشد. |
sid |
رشته | شناسه منسوب به حساب فروشنده یا توزیعکننده در
سیستم تبلیغات. این باید حاوی همان مقداری باشد که در
تراکنشها (یعنی درخواستهای قیمت پیشنهادی OpenRTB) در فیلد مشخصشده توسط
«پلاتفرم عرضه»/ مبادله استفاده میشود.
معمولاً در OpenRTB، این publisher.id است. برای OpenDirect، معمولاً شناسه سازمان ناشر است. طول آن باید به ۶۴ نویسه محدود شود. |
rid |
رشته | OpenRTB RequestId درخواست همانگونه که توسط این فروشنده صادر شده است. |
name |
رشته | نام شرکت (نهاد حقوقی) که برای موجودی
معاملهشده تحت seller_id دادهشده به آن پرداخت میشود. این مقدار اختیاری است و اگر در فایل sellers.json سیستم تبلیغات وجود دارد نباید اضافه شود. |
domain |
رشته | نام دامنه کسبوکار نهادی که این گره نمایندگی میکند.
این مقدار اختیاری است و اگر در فایل sellers.json سیستم تبلیغات وجود دارد نباید اضافه شود. |
hp |
عدد صحیح | نشان میدهد که آیا این گره در جریان پرداخت برای فضای آگهی دخیل خواهد بود یا نه.
برای نسخه ۱.۰ SupplyChain، این دارایی همیشه باید ۱ باشد. بهطور صریح لازم است که اضافه شود زیرا انتظار میرود نسخههای آینده مشخصات گرههای مدیریت پرداخت غیرنقدی را معرفی کنند. پیادهسازان باید مطمئن شوند که از این فیلد پشتیبانی میکنند و هنگام ساختن اشیای SupplyChain در درخواستهای قیمت پیشنهادی که به سیستم تبلیغات پاییندستی ارسال میشود، آن را منتشر میکنند. |
مشخصات پاسخ قیمت پیشنهادی
شیء BidResponse
| مشخصه | پشتیبانی میشود | جزئیات پیادهسازی | همیشه باموفقیت |
|---|---|---|---|
| id | اگر خطای تجزیه رخ دهد، این مقدار ممکن است بهجای شناسه درخواست قیمت پیشنهادی «۰» باشد. | بله | |
| پیشنهاد قیمت براساس جایگاه | |||
| bidid | |||
| cur | اگر خطای تجزیه رخ دهد، این مورد منتقل نمیشود. برای ترافیک درخواست قیمت پیشنهادی معتبر همیشه cur ارائه میشود. | بله | |
| customdata | |||
| nbr |
این مورد فقط درصورتی اضافه میشود که مشکلی در درخواست قیمت پیشنهادی پیدا شده باشد. مقادیر ممکن عبارتاند از:2: درخواست نامعتبر12: نقض مجوز Ads.txt16: SupplyChain ناقص17: گره SupplyChain مسدودشدهتوجه: وقتی نقض خاصی از (app-)ads.txt یا SupplyChain شناسایی شود، یکی از کدهای ۱۲، ۱۶، یا ۱۷ در بخشی (۱٪) از پاسخها درج خواهد شد. کد ۲ برای همه درخواستهای نامعتبر دیگر پر خواهد شد. درخواستهایی که شامل NBR هستند شبیه این خواهند بود: {
"id": "0",
"nbr": 2,
"ext": {
"err": "Bid request body was empty.",
"errHelp": "https://.../ortb-spec"
}
} |
||
| ext | اگر مشکلی در درخواست قیمت پیشنهادی وجود داشته باشد، ext ممکن است حاوی اطلاعاتی برای کمک به تشخیص خطا باشد، درصورت پشتیبانی. |
افزونههای پشتیبانیشده برای شیء BidResponse
| مشخصه | جزئیات پیادهسازی |
|---|---|
| خطا | شرحی قابلخواندن برای انسان از خطای درخواست قیمت پیشنهادی. پاسخ موارد شامل:
|
| errHelp | پیوندی به این صفحه. |
شیء Seatbid
| مشخصه | پشتیبانی میشود | جزئیات پیادهسازی | همیشه باموفقیت |
|---|---|---|---|
| قیمت پیشنهادی | بله | ||
| صندلی | بله | ||
| گروه |
هدف قیمت پیشنهادی
| مشخصه | پشتیبانی میشود | جزئیات پیادهسازی | همیشه باموفقیت |
|---|---|---|---|
| id | بله | ||
| imp-id | بله | ||
| قیمت | بله | ||
| nurl | |||
| گره | |||
| lurl | |||
| adm | |||
| adid | |||
| adomain | |||
| بستهای | |||
| iurl | |||
| cid | بله | ||
| crid | بله | ||
| تاکتیک | |||
| cat | |||
| مشخصه | |||
| api | |||
| پروتکل | |||
| qagmediarating | |||
| زبان | |||
| dealid | |||
| هفته | |||
| ساعت | |||
| wratio | |||
| hratio | |||
| exp |
افزونههای پشتیبانیشده برای هدف قیمت پیشنهادی
| مشخصه | جزئیات پیادهسازی |
|---|---|
apis |
DV360 درصورتیکه هم OMID و هم MRAID پشتیبانی شوند، seatbid.bid.apis را ارسال خواهد کرد. DV360 هم OMID_1 و هم MRAID را بهعنوان آرایه عدد صحیح تنظیم خواهد کرد. |
گزینههای ارائه آگهی
در بخش ۴.۳ مشخصات OpenRTB، دو گزینه مختلف ارائه وجود دارد:
- نشانهگذاری در اعلان برنده شدن ارائه شد
- نشانهگذاری در قیمت پیشنهادی ارائه شد
DV360 از هر دو گزینه پشتیبانی میکند.
- برای آگهی برنمایی، DV360 همیشه نشانهگذاری را در فیلد
admبرمیگرداند. نشانهگذاری ارائه شده در اعلان برنده اختیاری است. - برای آگهی ویدیویی/صوتی که از پروتکل VAST استفاده میکند، DV360 از برگرداندن VAST XML در
فیلد
admیا در پاسخ اعلان برنده براساس الزامات شرکای مبادله پشتیبانی میکند.
برای اطلاع از مزایا و معایب این دو گزینه، به مشخصات OpenRTB مراجعه کنید.
روالهای مطلوب
بهشدت توصیه میشود که از «شناسه شریک» Display and Video 360 بهعنوان شناسه جایگاه استفاده کنید. استفاده از شناسه جایگاه ویژه مبادله توصیه نمیشود.
مطمئن شوید که ناشران شما فایلهای ads.txt یا برنامههایی با فایلهای app-ads.txt منسوب دارند و شما را در فایل بهعنوان فروشنده مجاز یا فروشنده مجدد فهرست میکنند. بیشتر بدانید.
همچنین مطمئن شوید که اطلاعات یکسانی در درخواستهای پیشنهاد قیمت ارسال میشود. برای مثال،
app.bundle باید با اطلاعات دستگاه همراه و
app.storeurl سازگار باشد.
تلویزیون اینترنتپذیر
در انتقال device.ifa و device.lmt، از دستورالعملهای IAB OTT IFA پیروی کنید. همچنین باید
device.ext.ifa_type را برای پیروی از رهنمودها پیادهسازی کنید. همه قابلیتهای حدگذاری بسامد و هدفیابی مخاطب در تلویزیونهای
متصل به اینترنت به حضور IFA نیاز دارند.
همچنین از دستورالعملهای شناسه اختصاصدادهشده فروشگاه IAB OTT/CTV که اخیراً منتشر شده است پیروی کنید—این دستورالعملها نحوه انتقال app.bundle برای برنامههای CTV را تعریف میکند—که عمدتاً از شناسه تعریفشده فروشگاه برنامه استفاده میکند.
اندازهگیری Active View
Active View یک فناوری Google است که برای اندازهگیری اینکه آیا یک ظهور قابلمشاهده بوده است یا نه و برای چه مدت استفاده میشود. «نمای فعال» از OMID برای آگهیهای مصور و ویدیویی استفاده میکند. برای فعال کردن اندازهگیری بااستفاده از OMID، مبادلهها باید فیلدهای زیر را به درخواستهای OpenRTB اضافه کنند تا DV360 از پشتیبانی کارخواه از OMID مطلع شود.
- الزامی: «چارچوب میانای برنامهسازی کاربردی» (
Video.api=7برایWeb Video OMSDK،Native.api=7برایNative App OMSDK،Banner.api=7یاAudio.api=7) را به درخواستهای پیشنهاد قیمت اضافه کنید. این برای فعال کردن اندازهگیری بااستفاده از OMID در Active View الزامی است. - توصیه میشود: افزودن
omidpnوomidpvبهSource.Extبهشدت توصیه میشود زیرا بر نحوه گزارش شدن اندازهگیریهای رؤیتپذیری در DV360 به مشتری تأثیر خواهد گذاشت. اگر نام شریک OMID در فهرست گواهینامه IAB نباشد، طبق الزامات MRC باید سنجههای رؤیتپذیری را جدا از سنجههای دارای گواهینامه MRC گزارش کنیم. بیشتر بدانید.
اندازهگیری Active View برای «آگهیهای بومی»
برای فعال کردن اندازهگیری «نمای فعال» برای «آگهیهای بومی»، DV360 از مبادلهها و ناشران میخواهد مراحل بیشتری را انجام دهند.
آگهیهای تصویری بومی: DV360
eventtrackersزیر را در پاسخ پیشنهاد قیمت در زیر شیءadm.nativeاضافه میکند:"eventtrackers": [ { "event": 555, "method": 2, "url": "https://pagead2.googlesyndication.com/pagead/managed/js/activeview/current/rx_omid.js", "ext": { "vendorKey": "doubleclickbygoogle.com-omid-dsp", "verification_parameters": "" } } ]تبادلها باید ردیابهای رویداد اضافی را به ناشران منتقل کنند و ناشران باید مراحل زیر را انجام دهند:
- OMSDK را نصب کنید.
- هنگام پرداز کردن آگهیهای بومی، OMSDK را بار کنید.
- جاوا اسکریپت را در
eventtrackers.urlبا پارامترهای دادهشده اجرا کنید.
آگهیهای ویدیویی بومی: DV360 با افزودن افزونه استاندارد
AdVerificationsدر VAST XML، امکان اندازهگیری رؤیتپذیری را فراهم میکند:<Extension type="AdVerifications"> <AdVerifications> <Verification vendor="doubleclickbygoogle.com-omid-video"> <JavaScriptResource apiFramework="omid" browserOptional="true"> <![CDATA[ https://www.googletagservices.com/activeview/js/current/rx_omid_video.js ]]> </JavaScriptResource> <VerificationParameters> <![CDATA[ {"activeview_flags":"...","activeview_metadata":"...", ...} ]]> </VerificationParameters> <TrackingEvents> <Tracking event="verificationNotExecuted"> <![CDATA[ https://ade.googlesyndication.com/ddm/activity/... ]]> </Tracking> </TrackingEvents> </Verification> </AdVerifications> </Extension>ناشرانی که ازقبل از اندازهگیری رؤیتپذیری آگهی ویدیویی پشتیبانی میکنند، نیازی به اقدام اضافی ندارند. درغیراینصورت، ناشران باید افزونه جدید را در پخشکننده ویدیو خود مدیریت کنند یا آن را نادیده بگیرند.
مقررات هوش مصنوعی اتحادیه اروپا برای «بومی» در «طرف سوم»
برای اینکه تبلیغکنندگان بتوانند از مقررات شفافسازی نوظهور پیروی کنند. مقررات هوش مصنوعی در اتحادیه اروپا، هند، و ایالت نیویورک ایجاب میکند که آگهیهایی که داراییهای خاصی را که با هوش مصنوعی تولید یا ویرایش شدهاند دارند، شفافسازیهایی را ارائه دهند تا مصرفکنندگان را مطلع کنند که آگهیها با هوش مصنوعی ساخته شدهاند. از ژوئیه ۲۰۲۶، Display & Video 360 (DV360) به تبلیغکنندگان اجازه میدهد برچسبی اضافه کنند که نشان دهد عنصر خلاقانه بااستفاده از هوش مصنوعی تولید یا اصلاح شده است تا به تبلیغکنندگان کمک کند از مقررات جدید شفافسازی هوش مصنوعی پیروی کنند.
تبلیغکنندگان میتوانند این برچسبها را مستقیماً به عناصر خلاقانه خود اضافه کنند یا از تنظیم برچسب هوش مصنوعی ازطریق رابط کاربری و API «Display & Video 360» استفاده کنند. درباره نحوه استفاده از تنظیمات برچسب محتوای هوش مصنوعی برای برچسبگذاری آگهیهایتان بیشتر بدانید.
برای آگهیهایی که Google ارائه میکند، استراتژی رعایت استاندارد ما از یک برچسب هوش مصنوعی پیشکلیک حداقلی و یک شفافسازی پسکلیک در پنل About This Ad (ATA) استفاده میکند.
برای قالبهای آگهی بومی در 3PE، Google بر پرداز نهایی آگهی کنترل ندارد. در این موارد، این سیگنال گواهی بهعنوان بخشی از پاسخ آگهی برای مبادله یا ناشران منتشر خواهد شد تا آگهی نهایی را بههمراه برچسب یا شفافسازی هوش مصنوعی ارائه دهند. این سیگنال بخشی از فیلد adm.native.ext
پاسخ «آگهی بومی» خواهد بود. فیلد جدید adm.native.ext در
قالب زیر است:
"ext" {
"should_disclose_ai": "true",
"ai_disclosure_url": ""
}
-
should_disclosure_ai(درست یا نادرست) نشان میدهد که آیا آگهی نهایی باید برچسب هوشواره داشته باشد یا نه. - فیلد
ai_disclosure_urlممکن است وجود داشته باشد یا نداشته باشد. فقط زمانی کهshould_disclosure_aiروی درست تنظیم شده باشد و فیلد نشانی وبnative.privacyخالی باشد، این عنصر وجود خواهد داشت. در این مورد، کلیک کردن روی برچسب هوش مصنوعی باید کاربر را به نشانی وبی که در آن فیلد ارائه شده است هدایت کند. درغیراینصورت، کلیک کردن روی برچسب هوش مصنوعی باید کاربر را به فیلد نشانی وب استانداردnative.privacyهدایت کند.
این نشانها باید به ناشران منتقل شوند تا بتوانند آگهی را با برچسب هوش مصنوعی ارائه دهند.
پرسشگان
- آیا DV360 از افزونههای سفارشی مبادله پشتیبانی میکند؟
- بله، علاوهبر افزونههای فهرستشده در این مشخصات، Display و Video 360 ممکن است از افزونههای سفارشی نیز بهصورت موردی پشتیبانی کنند. توصیه میشود افزونه سفارشی را درطول دوره یکپارچهسازی مشخص و آزمایش کنید.
- آیا DV360 از ویدیو پاداشدار پشتیبانی میکند؟
- بله، افزونه ویدیو پاداشدار را برای ما ارسال کنید.
- بخش زیادی از فضای آگهی من بهعنوان جمعیتشناسی ناشناخته نشان داده میشود، چگونه پوشش جمعیتشناسی را بهبود دهم؟
-
user.yobوuser.genderرا در درخواستهای قیمت پیشنهادی به DV360 تکمیل کنید تا پوشش افزایش یابد. - آیا DV360 برای هر منطقه نقطه پایانی دارد؟
- نه، ما از یک نقطه پایانی واحد در سطح جهانی استفاده میکنیم و درخواستها را بهطور خودکار به نزدیکترین مرکز داده هدایت میکنیم، بنابراین نقطه پایانی خاص منطقهای نداریم که بتوانیم ارائه دهیم.
- الزامات درخواستهای سرور به سرور (s2s) چیست؟
- برای درخواست افزوده شدن به فهرست مجاز ما، با ماتماس بگیرید. «عامل کاربر» مشتری باید بازارسال شود و مطمئن شوید که در پاسخ به واکشی VAST سرور به سرور، کوکیها غیرفعال/نادیده گرفته میشوند.
- آیا DV360 از OMID پشتیبانی میکند؟
- تا زمانی که OMID در زمان درخواست قیمت پیشنهادی بهعنوان OMID-فعال اعلام شود، میتوانیم رؤیتپذیری را بااستفاده از OMID اندازهگیری کنیم. جزئیات مربوط به این موضوع در صفحات ۲۴-۲۵ خلاصه شده است.
- از کدام نسخه «بومی» پشتیبانی میکنید؟ آیا الزامات «بومی» دارید؟
- ما فقط از Native Ver1.2 پشتیبانی میکنیم. مشخصات بومی.
- آیا DV360 از درخواستهای قیمت پیشنهادی که بهصورت GZIP ارسال میشوند پشتیبانی میکند؟
- DV360 میتواند درخواستهای قیمت پیشنهادی فشردهشده با gzip را دریافت کند و اگر سرایند Accept-Encoding نشان دهد که از پاسخهای فشردهشده با gzip پشتیبانی میشود، با پاسخهای فشردهشده با gzip پاسخ خواهد داد.
- آیا DV360 از DBURL پشتیبانی میکند؟
- درحالحاضر نه.
- آیا DV360 از اعلان ازدست دادن پشتیبانی میکند؟
- بله، DV360 فیلد
bid.lurlرا در پاسخهای پیشنهاد قیمت تکمیل میکند. اگر پیشنهاد قیمت برنده نشود، ممکن است تبادل این نشانی وب را با دلیلی پینگ کند و آن دلیل به تبلیغکنندگان نشان داده خواهد شد. این دلایل میتواند به تبلیغکنندگان توصیه کند چگونه در آینده از ضرر جلوگیری کنند. - آیا DV360 برای هدفیابی به App.name نیاز دارد؟
- نه، DV360 از App.name برای مرجع استفاده میکند اما برای هدفیابی الزامی نیست،
App.bundleبرای هدفیابی استفاده میشود. - آیا DV360 میتواند از چندین اندازه آگهی که در یک درخواست قیمت پیشنهادی ارسال شده است پشتیبانی کند؟
- بله، همه اندازههای طرحآگهی واجدشرایط را در banner.format درنظر خواهیم گرفت.
- آیا DV360 از چندین قالب در یک درخواست قیمت پیشنهادی پشتیبانی میکند؟
- ما از درخواستهای قیمت پیشنهادی چند قالبی پشتیبانی محدودی داریم، اما درحال کار روی بهبود آن هستیم. ما از قالبهای ویدیویی و نمایشی برای آگهیهای بینابینی پشتیبانی میکنیم، اما درحالحاضر از قالبهای نمایشی و بومی پشتیبانی نمیکنیم. اگر درخواستهای پیشنهاد قیمت چند قالبی ارسال میکنید، لطفاً برای درخواست آزمایش با ما تماس بگیرید.
- آیا DV360 از انواع ظهور مختلط در یک درخواست پشتیبانی میکند؟
- درحالحاضر فقط از میانآگهیهای ویدیویی/برنمایی پشتیبانی میکنیم. درحال کار روی بومی/برنمایشی و ویدیویی/برنمایشی هستیم. اگر ترکیبهای دیگری وجود دارد، لطفاً با تیم ما تماس بگیرید.
- آیا چندین جایگاه میتوانند هرکدام چندین پیشنهاد قیمت را برای یک یا چند فرصت ظهور در همان درخواست ارسال کنند؟
- بله.
- آیا DV360 راهحل یا نیاز خاصی درخصوص محدود کردن یا نمایش یک تبلیغکننده برای چندین فرصت ظهور در یک درخواست دارد؟
- DV360 این الزام را اعمال میکند که هر آگهیدهنده فقط میتواند برای حداکثر یک فرصت ظهور برای هر درخواست پیشنهاد قیمت دهد. انتظار داریم «پلاتفرمهای سمت عرضه» اشیای 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" }
تماس با ما
اگر سؤال یا مشکلی دارید، با تیم پشتیبانی صرافی ما تماس بگیرید.