با راه اندازی پشتیبانی از تبلیغات ویدیویی، خریداران می توانند موجودی ویدیویی را از طریق خریداران مجاز خریداری کنند. این سند الزامات یکپارچه سازی برای خرید از طریق RTB با استفاده از پروتکل خریداران مجاز را تشریح می کند. برای کسب اطلاعات در مورد پروتکل های موجود به بخش انتخاب پروتکل راهنمای شروع کار مراجعه کنید.
خریداران میتوانند موجودی ویدیویی را در مکانهای مختلف خریداری کنند، که در حال حاضر در جریان هستند و بینابینی. برای جزئیات بیشتر به تبلیغات بینابینی مراجعه کنید.
خریداران جدید RTB باید پیشنهاد دهندگان خود را با استفاده از آخرین بافر پروتکل و اطلاعات ذکر شده در بخشهای زیر توسعه دهند. برای دانلود پروتکل، به صفحه داده مرجع پیشنهاد قیمت در زمان واقعی مراجعه کنید. برای اطلاعات در مورد توسعه یک مناقصه، به پردازش درخواست و ایجاد پاسخ مراجعه کنید.
ماکروهای زیر در خلاقیتهای ویدیویی در جریان پشتیبانی میشوند:
-
%%CACHEBUSTER%%
-
%%WINNING_PRICE%%
-
%%SITE%%
ماکروهای کلیک (مانند CLICK_URL_ESC
) ضروری نیستند زیرا مجاز خریداران ردیاب های کلیک خود را در یک بسته بندی VAST قرار می دهند. بنابراین، ماکروهای کلیکی برای تبلیغات ویدیویی در جریان پشتیبانی نمی شوند. برای اطلاعات بیشتر در مورد ماکروهای پشتیبانی شده، به مشخص کردن ماکروها در بخش Build the Response مراجعه کنید.
پروتکل مناقصه بلادرنگ از یک پیام ویدیویی استفاده میکند که در فایل real-time-bidding-proto.txt تعریف شده است تا درخواستهای ویدیویی را شناسایی کند و اطلاعات ویژه ویدیویی بیشتری درباره درخواست ارائه دهد.
لیست فیلدهای زیر در پیام ویدئویی تودرتو نیز توضیحات و نمونههای مفصلی را ارائه میدهد:
-
description_url
نشانی وب، با حذف پارامترها، صفحه ای که محتوای ویدیو را توصیف می کند. ناشر این URL را به Google ارسال می کند. به عنوان مثال:
http://www.publisher.com/watchpagelink
EndCapSupport
- وقتی فعال باشد، میتوان آگهی همراه را انتخاب کرد تا پس از پایان پخش آگهی ویدیویی، بهعنوان یک سرپوش پایانی (کارت اطلاعات) در شکاف ویدیو ارائه شود.
END_CAP_NOT_ENABLED
آگهی همراه به عنوان سقف پایانی ارائه نمی شود. END_CAP_OPTIONAL
در صورتی که پاسخ حاوی یک بنر همراه واجد شرایط باشد، اما بنر همراه مورد نیاز نیست، درپوش پایانی ارائه میشود. END_CAP_FORBIDDEN
پاسخ با یک آگهی همراه فیلتر شده است. END_CAP_REQUIRED
پاسخ بدون آگهی همراه فیلتر می شود. -
is_embedded_offsite
- اگر روی
true
تنظیم شود، ویدیو در صفحات خارج از دامنه ناشر جاسازی می شود. -
is_rewarded
- اگر روی
true
تنظیم شود، نشان میدهد که کاربر برای مشاهده آگهی ویدیویی پاداشی دریافت میکند. جوایز معمولی ممکن است خواندن یک مقاله اضافی به صورت رایگان، دریافت یک زندگی اضافی در یک بازی یا دریافت یک جلسه موسیقی بدون آگهی با حمایت مالی باشد. -
max_ad_duration
حداکثر مدت زمان مجاز برای آگهی برگشتی بر حسب میلی ثانیه. وقتی روی
0
تنظیم شود، حداکثر مدت زمان وجود ندارد.-
max_ads_in_pod
- حداکثر تعداد تبلیغات در یک پاد ویدیویی خریداران مجاز. یک مقدار غیر صفر نشان می دهد که جایگاه تبلیغات فعلی یک غلاف ویدیویی است که می تواند چندین تبلیغ ویدیویی را نشان دهد. تعداد واقعی تبلیغات ویدیویی نشان داده شده می تواند کمتر یا مساوی با این مقدار باشد اما نمی تواند از آن بیشتر شود.
-
min_ad_duration
- حداقل مدت زمان تبلیغ بر حسب میلی ثانیه که باید برگردید. اگر این تنظیم نشده باشد یا مقدار آن کمتر یا مساوی صفر باشد، حداقل مدت زمان وجود ندارد.
-
Placement
- محل پخش ویدیو را توضیح می دهد.
UNKNOWN_PLACEMENT
مکان نامشخص یا غیرقابل تعیین است. INSTREAM
Instream به این معنی است که تبلیغ قبل، حین یا بعد از سایر محتوای ویدیویی پخش می شود. این شبیه به تبلیغات تلویزیونی سنتی است. محتوای ویدیویی که کاربر در حال تماشای آن است در حین پخش آگهی پخش نمی شود. INTERSTITIAL
بینابینی یعنی تبلیغ ویدیویی در مقابل محتوای غیر ویدیویی (مثلاً یک مقاله خبری یا بازی ویدیویی) پخش میشود. آگهی تمام یا تقریباً تمام فضای صفحه را که محتوا اشغال کرده است را پوشش می دهد و کاربر نمی تواند تا زمانی که آگهی به پایان برسد یا رد نشده باشد، به محتوا ادامه دهد. IN_FEED
فرمت ویدیوی درونفید یک خلاقیت ویدیویی است که نشان میدهد زمانی که کاربر در فید محتوا، معمولاً یک فید برنامه اجتماعی، یک مقاله خبری و غیره پیمایش میکند. ویدیو در فید اصلی و در دید و جریان خواندن کاربر ارائه میشود. . ویدیو مانند ویدیوی درون بنر به طرفین رندر نمی شود. -
skippable_max_ad_duration
- حداکثر مدت زمان تبلیغ بر حسب میلی ثانیه که اگر این تبلیغ قابل رد شدن باشد، باید آن را برگردانید. این به طور کلی با حداکثر مدت زمان مجاز برای تبلیغات غیر قابل رد شدن متفاوت است. اگر این فیلد تنظیم نشده باشد یا دارای مقدار کمتر یا مساوی صفر باشد، هر مدت زمان مجاز است.
-
VideoPlaybackMethod
- نحوه پخش آگهی ویدیویی را شرح می دهد. روش پخش بر اساس بهترین اندازه گیری موجود، پخش خودکار یا کلیک برای پخش تعیین می شود.
AUTO_PLAY_SOUND_ON
به این معنی که تبلیغ به طور خودکار با صدا پخش می شود. AUTO_PLAY_SOUND_OFF
به این معنی است که آگهی به طور خودکار با صدا خاموش پخش می شود. CLICK_TO_PLAY
یعنی تبلیغ تا زمانی که روی آن کلیک نشود پخش نمی شود. -
video_ad_skippable
- این یک مقدار از
SkippableBidRequestType
است که حاوی یکی از مقادیر زیر است:ALLOW_SKIPPABLE
به این معنی که هم تبلیغات قابل رد شدن و هم تبلیغات غیر قابل رد شدن مجاز است. REQUIRE_SKIPPABLE
یعنی فقط تبلیغات قابل رد شدن ممکن است بازگردانده شوند. BLOCK_SKIPPABLE
به این معنی که فقط تبلیغات غیر قابل رد شدن ممکن است بازگردانده شوند. اگر این فیلد تنظیم نشده باشد، پیشفرض، اجازه دادن به تبلیغات قابل رد شدن است.
-
videoad_start_delay
زمان بر حسب میلی ثانیه از شروع ویدیو تا نقطه نمایش تبلیغ. 0 به معنای پیش رول و -1 به معنای پس از چرخش است. هر مقدار مثبت دیگر نشان می دهد که شکاف در وسط ویدیو قرار دارد.
مقدار فقط در صورتی معتبر است که این پارامتر تنظیم شده باشد. وقتی تنظیم نشده باشد، موقعیت نمایش نامشخص است.
این سیگنالها مختص خلاقیتهای ویدیویی نیستند، اما خواندن آنها برای پیشنهاد دهندگان بسیار ارزشمند است:
-
advertising_id
- این فیلد یک UUID 16 بایتی است که فقط هنگام استفاده از SSL تنظیم می شود. این نسخه رمزگذاری نشده
encrypted_advertising_id
است. برای دستگاههای iOS، حاوی شناسه آگهیدهندگان (IDFA) است. برای دستگاه های اندرویدی، حاوی شناسه اندروید (ADID) است. برای دستگاههای تلویزیون متصل، حاوی شناسههای منحصربهفرد آنها است (به عنوان مثال، Roku's RIDA). -
device_type
- نوع دستگاه را مشخص می کند.
UNKNOWN_DEVICE
مقدار پیش فرض این فیلد است. HIGHEND_PHONE
شامل تلفن های همراه با قابلیت فیلمبرداری است. TABLET
شامل دستگاه های تبلت است. PERSONAL_COMPUTER
شامل دستگاه های رومیزی و لپ تاپ می باشد. CONNECTED_TV
شامل تلویزیون های متصل (یعنی تلویزیون های هوشمند) و دستگاه های متصل (مانند Roku، Apple TV و غیره) می شود. GAME_CONSOLE
شامل دستگاه های مخصوص بازی است. -
brand
- نام تجاری (مانند نوکیا یا سامسونگ) دستگاه را مشخص می کند. این فیلد اختیاری است. به طور پیش فرض مشخص نشده است.
-
model
- مدل دقیق دستگاه (مانند N70 یا Galaxy) را مشخص می کند. این فیلد اختیاری است. به طور پیش فرض مشخص نشده است.
-
screen_orientation
- هنگام ارسال درخواست آگهی، جهت دستگاه را مشخص می کند. مقادیر معتبر عبارتند از
LANDSCAPE
,PORTRAIT
, وUNKNOWN_ORIENTATION
. -
viewability
- تخمینی از احتمال قابل مشاهده بودن این اسلات توسط کاربر نهایی بر اساس تعداد دفعاتی که در گذشته قابل مشاهده بوده است ارائه می دهد. به صورت درصد در محدوده [0، 100] بیان می شود. مقدار پیشفرض
-1
نشان میدهد که دادههای قابل مشاهده تاریخی در دسترس نیست. -
content_attributes.duration_seconds
- چند ثانیه (مثلاً 200) ویدیو پخش می شود. این در پیام
ContentAttributes
اعلام شده است. این مقدار روی مقدار مشخص شده در فراداده ویدیویی ارائه شده توسط ناشر ویدیو تنظیم شده است.
درخواست پیشنهاد ویدیویی همچنین حاوی اطلاعاتی در مورد موجودی مانند اطلاعات عمودی، فروشندگان مجاز و کانال است. سایر فیلدهای موجود در درخواست پیشنهاد برای ویدیو نیز اعمال می شود.
فیلدهای عرض و ارتفاع در پیام AdSlot درخواست ویدیو با اندازه پخش کننده تبلیغات ویدیویی مطابقت دارد.
-
allowed_vendor_type
- فروشنده مجاز برای لیست شناسه ها، فایل vendors.txt را در مستندات فنی ببینید. به عنوان مثال، 309 = واحد ویدئو DFA.
-
allowed_video_formats
- فناوریهای ویدیویی مجاز را برای تبلیغاتی که در پاسخ به این درخواست ارائه میشوند، توضیح میدهد. پاسخ باید حاکی از حمایت حداقل یکی از آنها باشد. مقادیر این فیلد تکراری از شمارش VideoFormat آمده است:
VIDEO_FLASH
به ویدیوها با استفاده از فرمت Flash Video (FLV) اجازه می دهد. VIDEO_HTML5
به ویدیوها با استفاده از فرمت ویدیوی HTML5 اجازه می دهد. VPAID_FLASH
به ویدئوها با استفاده از فرمت ویدئویی فلش با تعریف رابط پخش آگهی (VPAID) اجازه میدهد. VPAID_JS
به ویدیوها با استفاده از فرمت ویدیویی جاوا اسکریپت VPAID اجازه می دهد. -
companion_slot
- این فیلد یک پیام CompanionSlot را نشان می دهد که شامل فیلدهای زیر است:
height
ارتفاعات موجود برای این اسلات. width
عرض های موجود برای این اسلات. CreativeFormat
قالب خلاق، قالبهای ممکن برای خلاق را در این اسلات همراه نشان میدهد. -
url
URL صفحه تماشای ویدیو یا نشانی اینترنتی صفحه ای که ویدیو در آن جاسازی شده است. به عنوان مثال:
http://www.publisher.com/watchpagelink
هنگام پاسخ به درخواست ویدیو، پیشنهاد دهنده باید URL تغییر مسیر VAST را در قسمت video_url
برگرداند. پاسخ پیشنهادی همچنین باید حاوی بیانیه مناسب برای تبلیغ ویدیویی باشد. در زیر عصاره ای از یک پاسخ پیشنهادی ویدیویی مناسب آورده شده است:
protocol_version: 1 ad { adslot { id: 1 max_cpm_micros: 50000000 } click_through_url: "http://google.com/" video_url: "http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/ B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml" }
فیلدهای مهم در یک پاسخ پیشنهادی ویدیویی به شرح زیر است:
-
attribute
- همه ویژگیهای تبلیغاتی که ممکن است از این قطعه نشان داده شوند. برای لیست شناسه ها به فایل buyer-declarable-creative-attributes.txt مراجعه کنید. ما بررسی میکنیم که هیچ یک از این ویژگیها در فهرست
excluded_attribute
درخواست پیشنهاد وجود نداشته باشد. فقط در صورتی این فیلد را تنظیم کنید که یک قطعه HTML یا تبلیغ ویدیویی برگردانده شود. به عنوان مثال، تنظیم این فیلد بر روی30
نشان می دهد که تبلیغ برای ارائه به پشتیبانی VPAID نیاز دارد. -
protocol
- نسخههای VAST پشتیبانیشده ناشر را برای درخواستهای آگهی ویدیویی توضیح میدهد و به تبلیغات VAST تا نسخه دادهشده اجازه میدهد. شامل مجموعه ای از پروتکل های تبلیغاتی ویدیویی پشتیبانی شده است. این با رفتار در OpenRTB 2.4 مطابقت دارد و مطابقت دارد. مقادیر زیر ممکن است:
VAST_2_0
،VAST_3_0
،VAST_2_0_WRAPPER
،VAST_3_0_WRAPPER
،VAST_4_0
، وVAST_4_0_WRAPPER
. -
video_url
- URL تغییر مسیر VAST آگهی ویدیویی. به عنوان مثال:
http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml
- چگونه خریداران می توانند ویدیو را اضافه کنند
- سیگنال های OpenRTB برای همه فرمت های ویدئویی توصیه می شود
- سیگنالهای پیشنهادی اولیه خریداران مجاز برای همه فرمتهای ویدیویی
- چگونه ناشران میتوانند ویدیو را مجاز/غیر مجاز کنند
- موارد لبه
برای دریافت موجودی ویدیویی، خریداران RTB باید یک پیکربندی پیشهدفگیری برای RTB داشته باشند که شامل موجودی ویدیو میشود.
جداول زیر روشهایی را نشان میدهد که خریداران میتوانند ویدیو را در خلاقیتها و مکانهایی که میتوانند به ترتیب برای برنامه وب و موبایل ارائه کنند، قرار دهند.
ویدیو خلاق | درون جریان (همه) | در فید/مقاله | در فید/مقاله بومی | بینابینی | درون بنر |
---|---|---|---|---|---|
VPAID + VAST | |||||
وسیع | |||||
MRAID + JS | |||||
JS سفارشی | |||||
بومی + VAST |
اپلیکیشن موبایل
ویدیو خلاق | درون جریان (همه) | در فید/مقاله | در فید/مقاله بومی | بینابینی | درون بنر |
---|---|---|---|---|---|
VPAID + VAST | |||||
وسیع | |||||
MRAID + JS | |||||
JS سفارشی | |||||
بومی + VAST |
کلید: | قالب/تکنولوژی در دسترس نیست | خلاقیت ویدیویی در این مکان پذیرفته شد، مشروط به بلوکهای ناشر | ویدیوی خلاقانه در این مکان در دسترس نیست |
---|
جداول زیر سیگنال های پیشنهادی OpenRTB را برای همه فرمت های ویدیویی برای وب دسکتاپ و موبایل و برنامه موبایل نشان می دهد.
فرمت ویدیویی | سیگنال های توصیه شده (فقط سیگنال های مربوط به ویدیو) | سیگنال های مرتبط (فقط سیگنال های مربوط به ویدیو) |
---|---|---|
Instream (VPAID) | شئ VIDEO موجود و | |
Instream (بدون VPAID) | شئ VIDEO موجود و | |
خارج از جریان | شیء VIDEO موجود است | |
در خوراک | شئ VIDEO موجود و | |
در مقاله | شئ VIDEO موجود و | |
بومی | شیء بومی موجود و | |
درون بنر | شیء ویدیویی موجود نیست و |
فرمت ویدیویی | جزئیات درخواست پیشنهاد (فقط جزئیات مربوط به ویدیو) | |
---|---|---|
در جریان | شئ VIDEO موجود و | |
خارج از جریان | شیء VIDEO موجود است | |
در خوراک | شئ VIDEO موجود و | |
در مقاله | شئ VIDEO موجود و | |
بومی | شیء بومی موجود و | |
بینابینی (VAST) | شئ VIDEO موجود و | |
بینابینی (بدون VAST) | شئ VIDEO موجود و | فیلتر شده |
درون بنر (MRAID) | شیء ویدیویی موجود نیست و | |
درون بنر (بدون MRAID) | شیء ویدیویی موجود نیست و |
جداول زیر سیگنال های اولیه توصیه شده توسط خریداران مجاز را برای همه فرمت های ویدیویی برای وب دسکتاپ و موبایل و برنامه تلفن همراه نشان می دهد.
فرمت ویدیویی | سیگنال های ویدیویی مرتبط توصیه شده | سیگنال های مرتبط با ویدئو |
---|---|---|
Instream (VPAID) | پیام ویدیویی حاضر و | |
Instream (بدون VPAID) | پیام ویدیویی حاضر و | Allowed_video_formats = VIDEO_HTML5 و |
در خوراک | پیام ویدیویی حاضر و | Allowed_video_formats = VIDEO_HTML5 و |
در مقاله | پیام ویدیویی حاضر و | |
بومی | پیام بومی حاضر و | |
درون بنر | | |
جداول زیر سیگنال های توصیه شده AdX را برای همه فرمت های ویدئویی برای وب دسکتاپ و موبایل و اپلیکیشن موبایل نشان می دهد.
فرمت ویدیویی | جزئیات درخواست پیشنهاد مربوط به ویدئو | سیگنال های مرتبط با ویدئو |
---|---|---|
در جریان | پیام ویدیویی حاضر است | |
در خوراک | پیام ویدیویی حاضر و | |
در مقاله | پیام ویدیویی حاضر و | |
بومی | پیام بومی حاضر و | |
بینابینی | پیام ویدیویی حاضر و | |
درون بنر (MRAID) | | |
درون بنر (بدون MRAID) | | |
جداول زیر روشهایی را نشان میدهند که ناشران میتوانند ویدیو را در مکانهای خود مجاز/غیر مجاز کنند و نحوه نمایش آن در درخواست پیشنهاد برای OpenRTB و AdX Proto .
گزینه میخانه | فرمت های قابل اجرا | در درخواست مناقصه به عنوان شرح داده شده است |
---|---|---|
یک واحد ویدیوی درون جریانی را مشخص کنید | درون جریان (همه) | شیء ویدیویی موجود و |
VPAID را انتخاب کنید | وب درون جریانی | شیء ویدیویی موجود و |
IBV را انتخاب کنید | درون بنر بینابینی | |
شرکت در Outstream ( دستورالعملها ) | در خوراک در مقاله | شیء ویدیویی موجود و |
شرکت در Outstream ( دستورالعملها ) | بومی | شیء بومی موجود است |
مسدود کردن ویدیوهای بینابینی | اپلیکیشن بینابینی | شیء VIDEO وجود ندارد |
گزینه میخانه | فرمت های قابل اجرا | در درخواست پیشنهاد به صورت توضیح داده شده است (توجه: اینها همه نشانگرهای گزینه pub در درخواست پیشنهاد هستند - برای سیگنال های توصیه شده به جدول زیر مراجعه کنید) | تنظیم پیش فرض |
---|---|---|---|
یک واحد ویدیوی درون جریانی را مشخص کنید | درون جریان (همه) | پیام ویدیویی حاضر و | n/a |
VPAID را انتخاب کنید | وب درون جریانی | پیام ویدیویی حاضر و | انصراف داد |
IBV را انتخاب کنید | درون بنر بینابینی | | انصراف داد |
شرکت در Outstream ( دستورالعملها ) | در خوراک در مقاله | پیام ویدیویی حاضر و | انصراف داد |
شرکت در Outstream ( دستورالعملها ) | بومی | پیام بومی حاضر و | انصراف داد |
مسدود کردن ویدیوهای بینابینی | اپلیکیشن بینابینی | پیام ویدیویی وجود ندارد و | شرکت کرد |
# | شرح مورد | نظرات | درخواست مناقصه |
---|---|---|---|
1 | بسته شدن سفارشی با تأخیر با استفاده از MRAID | برای موارد بینابینی، بستن آگهی میتواند با استفاده از MRAID برای خریدار اعلان ارسال کند، حتی اگر از بستن سفارشی استفاده نکرده باشد. AdX اعمال شده X همیشه در بالای هر بسته سفارشی ظاهر می شود، حتی اگر بسته سفارشی بعد از 5 ثانیه در زیر ظاهر شود |
به واژه نامه ویدیویی خریداران مجاز مراجعه کنید.
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement |
| ||||
videoad_start_delay |
|
به OpenRTB 2.5 مراجعه کنید (شروع از صفحه 47)
BidRequest.Video. | |||||
---|---|---|---|---|---|
Placement |
| ||||
linearity | نشان می دهد که آیا قالب باید خطی، غیرخطی، و غیره باشد. اگر هیچ یک مشخص نشده است، فرض کنید که همه مجاز هستند.
| ||||
videoad_start_delay |
|
OpenRTB شیء | فیلدها | AdX /تبادل مناقصه خارج از جریان | مقادیر نمونه | چه کسی آن را تعیین می کند؟ /جایی که این مقدار حاصل می شود از؟ |
---|---|---|---|---|
شیء | ||||
ویدیو | میمز | بله | ["application/javascript"، "ویدئو/mp4"]، | گوگل |
حواس پرتی | نه | ناشر پیکربندی شد | ||
حداکثر | بله | ناشر پیکربندی شد | ||
پخش کننده هود | بله | [6] | معمولا ناشر پیکربندی شده است | |
api (MRAID) | بله | [1،2] | گوگل | |
پروتکل ها | بله | [2،3،5،6،7،8] | گوگل | |
خطی بودن | بله | [1] | گوگل | |
قرار دادن | بله | [1] | گوگل | |
عرض پخش کننده | بله | 400,400,300 | گوگل | |
قد بازیکن | بله | 225,300,153 | گوگل | |
تاخیر شروع | بله | 0 | گوگل، پیش فرض 5 ثانیه | |
جست و خیز کردن | بله | 1 | ناشر/گوگل - برای Interstitial => Google - برای Instream => Publisher تصمیم می گیرد که آیا اجازه دهد قابل پرش، غیرقابل پرش یا هر دو. تبلیغات پاداش، همیشه بدون پرش. | |
نرخ بیت دقیقه | خیر | گوگل | ||
حداکثر نرخ بیت | نه | گوگل | ||
pos | بله | 1 | گوگل | |
دستگاه | ||||
نسبت Px | بله | 1 | گوگل | |
برداشت | ||||
امن | بله | 1 | گوگل پیش فرض درست است زیرا adtag همیشه است امن |