تبلیغات ویدیویی

این راهنما نیازمندی‌های یکپارچه‌سازی، پیکربندی و فیلدهای پروتکل OpenRTB مربوطه را که ممکن است هنگام ارائه پیشنهادات برای موجودی ویدیو استفاده کنید، تشریح می‌کند. پروتکل Google RTB منسوخ شده است و در این راهنما مورد توجه قرار نخواهد گرفت. برای کسب اطلاعات در مورد تبلیغات ویدیویی در پروتکل Google RTB، به راهنمای تبلیغات ویدیویی در Google RTB مراجعه کنید.

گوگل از تبلیغات ویدئویی درون جریانی، بومی و بینابینی پشتیبانی می کند. برای جزئیات بیشتر در مورد آن قالب‌ها، به راهنمای قالب‌های تبلیغات داخلی و بینابینی مراجعه کنید.

الزامات خریدار

پروتکل RTB

این راهنما به طور کلی به فرمت Protobuf اشاره می کند، اما نام فیلدها و مسیرها بین آن و فرمت JSON معادل هستند، مگر اینکه خلاف آن ذکر شده باشد.

می‌توانید پروتو OpenRTB و برنامه‌های افزودنی OpenRTB ویژه Google را در صفحه پروتوها و داده‌های مرجع پیدا کنید. برای اطلاعات بیشتر در مورد توسعه یک مناقصه، به پردازش درخواست و ایجاد پاسخ مراجعه کنید.

بررسی خلاقانه

Google توصیه می‌کند که خلاقیت‌ها را قبل از مناقصه برای تأیید ارسال کنید. می‌توانید از منبع Creatives API Bidding Real-time برای شروع فرآیند بررسی استفاده کنید.

پیکربندی پیش هدف گذاری

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

ماکروها

می توانید ماکروها را در پیوند URL ویدیو یا VAST XML مشخص شده در BidResponse.seatbid.bid.adm مشخص کنید. علاوه بر این، اگر URL ویدیویی را مشخص کنید، می‌توانید ماکروها را نیز در سند VAST XML پیوند داده شده قرار دهید. ماکروهای زیر برای خلاقیت های ویدیویی پشتیبانی می شوند:

  • %%CACHEBUSTER%%
  • %%WINNING_PRICE%%
  • %%SITE%%

ماکروهای کلیک مانند CLICK_URL_ESC پشتیبانی نمی‌شوند، زیرا Authorized Buyers ردیاب‌های کلیک خود را در یک پوشش VAST قرار می‌دهند. برای اطلاعات بیشتر در مورد ماکروهای پشتیبانی شده، به تعیین ماکروها مراجعه کنید.

جزئیات فراخوان

می‌توانید از فیلد BidRequest.imp.video OpenRTB استفاده کنید تا تشخیص دهید که آیا درخواست پیشنهادی دریافتی برای موجودی ویدیوی درون جریانی یا بین‌المللی است یا خیر و اطلاعات اضافی مربوط به ویدیو را در مورد درخواست بیابید. علاوه بر این، برای موجودی آگهی‌های بومی، می‌توانید از BidRequest.imp.native.{request/request_native}.assets.video برای اطلاعات مشابه ویدیویی استفاده کنید.

BidRequest.{app/site}.content.producer.domain

نشانی وب، با حذف پارامترها، صفحه ای که محتوای ویدیو را توصیف می کند. ناشر این URL را به Google ارسال می کند. به عنوان مثال:

http://www.publisher.com/watchpagelink
banner.vcm
اگر روی true تنظیم شود، می‌توان آگهی همراه را انتخاب کرد تا پس از پایان پخش آگهی ویدیویی، به‌عنوان سرپوش پایانی (کارت اطلاعات) در شکاف ویدیو ارائه شود. در غیر این صورت، آگهی همراه به عنوان سرپوش پایانی ارائه نمی شود.
BidRequest.imp.rwdd
اگر روی true تنظیم شود، نشان می‌دهد که کاربر برای مشاهده آگهی ویدیویی پاداشی دریافت می‌کند. جوایز معمولی ممکن است خواندن یک مقاله اضافی به صورت رایگان، دریافت یک زندگی اضافی در یک بازی یا دریافت یک جلسه موسیقی بدون آگهی با حمایت مالی باشد.
BidRequest.imp.video.maxduration

حداکثر مدت زمان مجاز بر حسب ثانیه از آگهی که باید برگردید. وقتی تنظیم نشده باشد، حداکثر مدت زمان وجود ندارد. وقتی BidRequest.imp.video.skip true باشد، این می تواند متفاوت رفتار کند. برای جزئیات بیشتر، حداکثر مدت زمان ویدیوی قابل رد شدن را ببینید.

BidRequest.imp.video.maxseq

حداکثر تعداد تبلیغات در پاد ویدیو. اگر تنظیم نشده باشد، جایگاه آگهی بخشی از یک پاد ویدیو نیست.

تعداد واقعی تبلیغات ویدیویی نشان داده شده می تواند کمتر یا مساوی با این مقدار باشد اما نمی تواند از آن بیشتر شود.

BidRequest.imp.video.minduration
حداقل مدت زمان آگهی بر حسب ثانیه که باید برگردید. وقتی تنظیم نشده باشد، حداقل مدت زمان وجود ندارد.
BidRequest.imp.video.plcmt
محل پخش ویدیو را توضیح می دهد.
PLCMT_UNKNOWN مکان نامشخص یا غیرقابل تعیین است.
PLCMT_INSTREAM تبلیغات پیش از پخش، میان پخش و پس از پخش که قبل، در حین یا بعد از پخش محتوای ویدیویی که مصرف کننده درخواست کرده پخش می شود. ویدیوی درون جریانی باید به طور پیش‌فرض در شروع پخش‌کننده روی «صدا روشن» تنظیم شود، یا اینکه کاربر به‌صراحت قصد تماشای محتوای ویدیو را داشته باشد. در حالی که ممکن است محتوای دیگری در اطراف پخش کننده وجود داشته باشد، محتوای ویدیویی باید در کانون بازدید کاربر باشد. باید محتوای اصلی در صفحه باقی بماند و تنها پخش کننده ویدیویی که در هنگام پخش قابلیت پخش صدا را دارد. اگر پخش‌کننده به شناور/چسبنده تبدیل شود، تماس‌های تبلیغاتی بعدی باید اندازه پخش‌کننده به‌روز شده را دقیقاً نشان دهند.
PLCMT_ACCOMPANYING_CONTENT تبلیغات پیش از پخش، میان‌پول و پس از پخش که قبل، حین یا بعد از پخش محتوای ویدیویی پخش می‌شوند. پخش‌کننده ویدیو قبل، بین یا بعد از پاراگراف‌های متن یا محتوای گرافیکی بارگیری و پخش می‌شود و تنها زمانی که وارد درگاه دید شود شروع به پخش می‌کند. محتوای همراه فقط باید با ورود به نمای نمایش شروع به پخش کند. ممکن است در حین خارج شدن از صفحه به پخش کننده شناور/چسبنده تبدیل شود.
PLCMT_INTERSTITIAL تبلیغات ویدیویی که بدون محتوای ویدیویی پخش می شوند. در حین پخش، باید تمرکز اصلی صفحه باشد و قسمت اعظم نمای را اشغال کند و نمی توان آن را خارج از دید اسکرول کرد. این می تواند در مکان هایی مانند ویدیوی درون برنامه ای یا نمایش اسلاید باشد.
PLCMT_NO_CONTENT_STANDALONE تبلیغات ویدیویی که بدون پخش محتوای ویدیویی پخش می شوند. این می تواند در مکان هایی مانند نمایش اسلاید، فیدهای بومی، درون محتوا یا چسبنده/شناور باشد.
BidRequest.imp.video.playbackmethod
نحوه پخش آگهی ویدیویی را شرح می دهد. روش پخش بر اساس بهترین اندازه گیری موجود، پخش خودکار یا کلیک برای پخش تعیین می شود.
AUTO_PLAY_SOUND_ON در بارگذاری صفحه با صدا روشن شروع می شود.
AUTO_PLAY_SOUND_OFF در بارگذاری صفحه با صدای خاموش شروع می شود.
CLICK_TO_PLAY با کلیک با صدا روشن شروع می شود.
MOUSE_OVER با حرکت ماوس با صدا روشن شروع می شود.
ENTER_SOUND_ON ورود به ویوپورت را با صدا روشن آغاز می کند.
ENTER_SOUND_OFF ورود به ویوپورت را با صدای خاموش به طور پیش فرض آغاز می کند.
BidRequest.imp.video.skip
اگر true ، نشان می‌دهد که پخش‌کننده اجازه می‌دهد ویدیو رد شود یا تبلیغات قابل رد شدن مجاز است. در غیر این صورت، نشان می دهد که تبلیغات قابل رد شدن مجاز نیستند.
BidRequest.imp.video.startdelay

مقدار 0 به معنای قبل از پخش، -1 به معنای میان فیلم و -2 به معنای پس از پخش است.

هر مقدار مثبت دیگر زمان بر حسب ثانیه از شروع ویدیو تا نقطه نمایش آگهی است.

این سیگنال‌ها مختص خلاقیت‌های ویدیویی نیستند، اما خواندن آن‌ها برای پیشنهاد دهندگان بسیار ارزشمند است:

BidRequest.device.ifa
این فیلد یک UUID 36 کاراکتری است که فقط هنگام استفاده از SSL تنظیم می شود و هش نمی شود. این نسخه رمزگذاری نشده BidRequest.device.dpidm5 است. برای دستگاه‌های iOS، دارای شناسه تبلیغ‌کنندگان (IDFA) با تمام حروف بزرگ است. برای دستگاه های اندرویدی، دارای شناسه اندروید (ADID) با تمام حروف کوچک است. برای دستگاه‌های تلویزیون متصل، حاوی شناسه‌های منحصربه‌فرد آن‌ها است (به عنوان مثال، Roku's RIDA).
BidRequest.device.devicetype
نوع دستگاه را مشخص می کند.
MOBILE نام مستعار منسوخ برای HIGHEND_PHONE یا TABLET.
PERSONAL_COMPUTER شامل دستگاه های رومیزی و لپ تاپ می باشد.
CONNECTED_TV شامل تلویزیون های متصل (یعنی تلویزیون های هوشمند) و دستگاه های متصل (مانند Roku، Apple TV و غیره) می شود.
HIGHEND_PHONE شامل دستگاه های تلفن رده بالا
TABLET شامل دستگاه های تبلت است.
CONNECTED_DEVICE شامل دستگاه های مخصوص بازی است.
SET_TOP_BOX شامل دستگاه های ست تاپ باکس می باشد.
OOH_DEVICE شامل دستگاه های تبلیغاتی خارج از منزل به عنوان مثال، بیلبوردهای دیجیتال.
BidRequest.device.make
نام تجاری (مانند نوکیا یا سامسونگ) دستگاه را مشخص می کند.
BidRequest.device.model
مدل دقیق دستگاه (مانند N70 یا Galaxy) را در صورت موجود بودن مشخص می‌کند، در غیر این صورت شامل یک مدل عمومی مانند "iphone" یا "ipad" است.
BidRequest.imp.metric
وقتی Metric.type روی completion_rate تنظیم می‌شود، Metric.value کسری در محدوده [0.0، 1.0] خواهد بود که نشان‌دهنده نرخ تکمیل تاریخی برای تبلیغات ویدیویی ارائه‌شده در جایگاه آگهی است. مقدار پیش‌فرض -1.0 نشان می‌دهد که داده‌های نرخ تکمیل تاریخی در دسترس نیست.
BidRequest.imp.video.poddur
مدت زمان بر حسب ثانیه از کل وقفه تبلیغاتی، شامل تمام اسلات‌هایی که پاد از آن تشکیل شده است. این مقدار روی مقدار مشخص شده در فراداده ویدیویی ارائه شده توسط ناشر ویدیو تنظیم شده است.

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

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

BidRequest.imp.ext.allowed_vendor_type
فروشندگان مجاز برای لیست شناسه ها، فایل vendors.txt را در مستندات فنی ببینید. به عنوان مثال، 309 = واحد ویدئو DFA.
BidRequest.imp.video.mimes
یک لیست مجاز که انواع MIME محتوای پشتیبانی شده را برای تبلیغات ارائه شده در پاسخ به درخواست پیشنهاد توضیح می دهد. به عنوان مثال، "video/mp4". پاسخ پیشنهاد باید حاکی از حمایت حداقل یکی از آنها باشد.
BidRequest.imp.video.protocols
نسخه‌های VAST پشتیبانی‌شده ناشر را برای درخواست‌های آگهی ویدیویی توضیح می‌دهد. حاوی آرایه‌ای از مقادیر enum Protocol ، از جمله: VAST_2_0 ، VAST_3_0 ، VAST_2_0_WRAPPER ، VAST_3_0_WRAPPER ، VAST_4_0 ، VAST_4_0_WRAPPER ، و موارد دیگر.
BidRequest.imp.video.companionad
این فیلد شامل آرایه ای از اشیاء Banner است که در صورت موجود بودن تبلیغات همراه را نشان می دهد.
BidRequest.site.page

URL صفحه تماشای ویدیو یا نشانی اینترنتی صفحه ای که ویدیو در آن جاسازی شده است. به عنوان مثال:

http://www.publisher.com/watchpagelink

هنگام پاسخ به درخواست ویدیو، پیشنهاد دهنده باید URL تغییر مسیر VAST یا VAST XML را در قسمت BidResponse.seatbid.bid.adm برگرداند. پاسخ پیشنهادی همچنین باید حاوی بیانیه مناسب برای تبلیغ ویدیویی باشد. در زیر عصاره ای از یک پاسخ پیشنهادی ویدیویی مناسب است:

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

فیلدهای مهم در یک پاسخ پیشنهادی ویدیویی به شرح زیر است:

BidResponse.seatbid.bid.ext.attribute
ویژگی های تبلیغاتی که ممکن است از این قطعه نشان داده شوند. برای لیست شناسه ها به فایل buyer-declarable-creative-attributes.txt مراجعه کنید. ما بررسی می‌کنیم که هیچ یک از این ویژگی‌ها با ویژگی‌هایی که ناشر در درخواست پیشنهاد قیمت مجاز نکرده است، مطابقت نداشته باشد. به عنوان مثال، اگر هر یک از فیلدها شامل 30 باشد، نشان می‌دهد که آگهی برای ارائه به پشتیبانی VPAID نیاز دارد.
BidResponse.seatbid.bid.adm

برای تبلیغات ویدیویی، این نشانی اینترنتی تغییر مسیر VAST آگهی ویدیویی است. به عنوان مثال:

http://ad.doubleclick.net/pfadx/N270.132652.1516607168321/B3442378.3;dcadv=1379578;sz=0x0;ord=79879;dcmt=text/xml

از طرف دیگر، این ممکن است VAST XML خام باشد.

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

فرمت های ویدیویی

چگونه خریداران می توانند ویدیو را اضافه کنند

جداول زیر روش‌هایی را نشان می‌دهد که خریداران می‌توانند ویدیو را در خلاقیت‌ها و مکان‌هایی که می‌توانند به ترتیب برای برنامه وب و موبایل ارائه کنند، قرار دهند.

وب

ویدیو خلاق درون جریان (همه) در فید/مقاله در فید/مقاله بومی بینابینی درون بنر

VPAID + VAST

وسیع

MRAID + JS

JS سفارشی

بومی + VAST

اپلیکیشن موبایل

ویدیو خلاق درون جریان (همه) در فید/مقاله در فید/مقاله بومی بینابینی درون بنر

VPAID + VAST

وسیع

MRAID + JS

JS سفارشی

بومی + VAST

کلید: قالب/تکنولوژی در دسترس نیست

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

ویدیوی خلاقانه در این مکان در دسترس نیست

سیگنال های پیشنهادی OpenRTB

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

وب دسکتاپ و موبایل

فرمت ویدیویی سیگنال های توصیه شده (فقط سیگنال های مربوط به ویدیو) سیگنال های مرتبط (فقط سیگنال های مربوط به ویدیو)

Instream (VPAID)

شئ VIDEO موجود و
video.placement = INSTREAM &


Instream (بدون VPAID)

شئ VIDEO موجود و
video.placement = INSTREAM &
video.api = 1 VPAID 1.0 or 2:VPAID 2.0


غیر درون جریانی

شیء VIDEO موجود است

video.linearity: linear
قرار دادن بستگی به واقعی دارد
قرار دادن، مقادیر به شرح زیر است
Video.startdelay = 0


در خوراک

شئ VIDEO موجود و
video.placement = IN-FEED


در مقاله

شئ VIDEO موجود و
video.placement = IN-ARTICLE


بومی

شیء بومی موجود و


درون بنر

شیء ویدیویی موجود نیست و
banner.battr ≠ 6 ویدیو درون بنر (پخش خودکار) و
banner.battr ≠ 7 ویدیوی درون بنر (از طریق کاربر)


اپلیکیشن موبایل

فرمت ویدیویی جزئیات درخواست پیشنهاد (فقط جزئیات مربوط به ویدیو)

در جریان

شئ VIDEO موجود و
video.placement = INSTREAM &

video.api = 1 VPAID 1.0 یا 2 : VPAID 2.0

غیر درون جریانی

شیء VIDEO موجود است

video.linearity: linear
قرار دادن بستگی به واقعی دارد
قرار دادن، مقادیر به شرح زیر است
Video.startdelay = 0


در خوراک

شئ VIDEO موجود و
video.placement = IN-FEED


در مقاله

شئ VIDEO موجود و
video.placement = IN-ARTICLE


بومی

شیء بومی موجود و


بینابینی (VAST)

شئ VIDEO موجود و
video.placement = INTERSTITIAL


بینابینی (بدون VAST)

شئ VIDEO موجود و
video.placement = INTERSTITIAL

فیلتر شده

درون بنر (MRAID)

شیء ویدیویی موجود نیست و
banner.battr ≠ 6 ویدیو درون بنر (پخش خودکار) و
banner.battr ≠ 7 ویدیوی درون بنر (از طریق کاربر)


درون بنر

(بدون MRAID)

شیء ویدیویی موجود نیست و
banner.battr ≠ 6 ویدیو درون بنر (پخش خودکار) و
banner.battr ≠ 7 ویدیوی درون بنر (از طریق کاربر)


چگونه ناشران می‌توانند ویدیو را مجاز/غیر مجاز کنند

جدول زیر روش‌هایی را نشان می‌دهد که ناشران می‌توانند ویدیو را در مکان‌های خود مجاز/غیر مجاز کنند.

گزینه میخانه فرمت های قابل اجرا در درخواست مناقصه به عنوان شرح داده شده است

یک واحد ویدیوی درون جریانی را مشخص کنید

درون جریان (همه)

شیء ویدیویی موجود و
video.placement = INSTREAM

VPAID را انتخاب کنید

وب درون جریانی

شیء ویدیویی موجود و
video.api = 1 (VPAID 1.0) یا 2 (VPAID 2.0)

IBV را انتخاب کنید

درون بنر

بینابینی

banner.battr ≠ 6 ویدیوی درون بنر (پخش خودکار) و/یا 7 ویدیوی درون بنر (از سوی کاربر)

شرکت در ( دستورالعمل )

در خوراک

در مقاله

شیء ویدیویی موجود و
video.placement = IN-FEED یا IN-ARTICLE

شرکت در غیر جریانی ( دستورالعمل‌ها )

بومی

شیء بومی موجود است

مسدود کردن ویدیوهای بینابینی

اپلیکیشن بینابینی

شیء VIDEO وجود ندارد

موارد لبه

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

1

بسته شدن سفارشی با تأخیر با استفاده از MRAID

برای موارد بینابینی، بستن آگهی می‌تواند با استفاده از MRAID برای خریدار اعلان ارسال کند، حتی اگر از بستن سفارشی استفاده نکرده باشد.


خریدار مجاز X اعمال شده همیشه در بالای هر بسته سفارشی ظاهر می شود، حتی اگر بسته سفارشی پس از 5 ثانیه در زیر ظاهر شود.


واژه نامه

به واژه نامه ویدیویی خریداران مجاز مراجعه کنید.

فیلدهای مرتبط برای قالب‌های Instream و Nonstream

به OpenRTB 2.5 مراجعه کنید (شروع از صفحه 47)

BidRequest.Video.
Placement
در جریان mWeb

1 : در جریان
2 : درون بنر

mApp

1 : در جریان
2 : درون بنر

غیر درون جریانی mApp Interstitial

5 : بینابینی

Native

3 : در مقاله
4 : در خوراک

Rewarded

is_rewarded_inventory : OpenRTB Extension bool

linearity

نشان می دهد که آیا قالب باید خطی، غیرخطی، و غیره باشد. اگر هیچ یک مشخص نشده است، فرض کنید که همه مجاز هستند.

در جریان mWeb

1 : LINEAR (در جریان)

mApp

1 : LINEAR (در جریان)

غیر درون جریانی mApp Interstitial

2 : INTERSTITIAL

Native

3 : IN_FEED
5 : IN_ARTICLE

videoad_start_delay
در جریان mWeb

>0: start delay in seconds
0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

mApp

>0: start delay in seconds
0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

غیر درون جریانی Rewarded

>0: start delay in seconds
0: PRE_ROLL
-1: GENERIC_MID_ROLL
-2: GENERIC_POST_ROLL

منبع ارزش درخواست پیشنهاد

OpenRTB
شیء		 فیلدها خریداران مجاز
/تبادل
مناقصه
غیر درون جریانی		 مقادیر نمونه چه کسی آن را تعیین می کند؟
/جایی که این مقدار حاصل می شود
از؟
شیء
ویدئو میمز بله ["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 همیشه است
امن