کلاس: AdsRequest، کلاس: AdsRequest

سازنده

AdsRequest

New AdsRequest()

اجرا می کند
google.ima.AdsRequestInterface

خواص

adTagUrl

رشته

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

این پارامتر مورد نیاز است.

تبلیغات پاسخ

(سند تهی، رشته ای یا غیر تهی)

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

این پارامتر اختیاری است.

مدت زمان محتوا

(تهی یا عددی)

مدت زمان نمایش محتوا را بر حسب ثانیه مشخص می کند. این در 2 مورد استفاده می شود: 1) AdX Adx Adxing و 2) تصمیم گیری در مورد زمان بارگذاری VMAP postroll.

این پارامتر اختیاری است.

محتوا کلمات کلیدی

(آرایه رشته تهی یا غیر تهی)

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

این پارامتر اختیاری است.

عنوان محتوا

(تهی یا رشته ای)

عنوان محتوای نمایش داده شده را مشخص می کند. در درخواست های AdX استفاده می شود.

این پارامتر اختیاری است.

forceNonLinearFullSlot

بولی

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

linearAdSlotHeight

عدد

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

این پارامتر مورد نیاز است.

linearAdSlotWidth

عدد

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

این پارامتر مورد نیاز است.

liveStreamPrefetchSeconds

عدد

حداکثر مدت زمان انتظار را در چند ثانیه، پس از فراخوانی requestAds، قبل از درخواست URL برچسب آگهی مشخص می کند. این می‌تواند برای تلنگر زدن درخواست‌ها در طول یک رویداد پخش زنده، به منظور کاهش افزایش تعداد درخواست‌ها استفاده شود.

غیرخطی AdSlotHeight

عدد

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

این پارامتر مورد نیاز است.

nonLinearAdSlotWidth

عدد

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

این پارامتر مورد نیاز است.

omidAccessModeRules

شی غیر تهی با ویژگی های رشته ای

شی تنظیمات برای نگاشت فروشندگان تأیید صحت به حالت های دسترسی OMID. کلیدها باید مقادیری در google.ima.OmidVerificationVendor باشند و مقادیر باید مقادیری در google.ima.OmidAccessMode باشند.

URL های اسکریپت تأیید به صورت داخلی با عبارات منظم ارائه شده توسط فروشنده مطابقت داده می شود تا به کلید OmidVerificationVendor حل شود. سپس IMA با استفاده از این شی، حالت دسترسی را برای فروشنده داده شده جستجو می کند.

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

آدرس صفحه

(تهی یا رشته ای)

نشانی اینترنتی کامل صفحه ای را که در درخواست تبلیغات گوگل برای اهداف هدف قرار داده می شود، مشخص می کند. آدرس اینترنتی باید یک آدرس اینترنتی معتبر باشد. اگر مشخص شود، این مقدار برای ماکرو [PAGEURL] VAST استفاده خواهد شد.

این پارامتر اختیاری است.

vastLoadTimeout

عدد

لغو زمان بارگذاری پیش‌فرض VAST در میلی‌ثانیه برای یک بسته‌بندی واحد. زمان پیش‌فرض 5000 میلی‌ثانیه است.

این پارامتر اختیاری است.

مواد و روش ها

setAdWillAutoPlay

setAdWillAutoPlay(autoPlay) باطل را برمی گرداند

به SDK اطلاع می دهد که آیا پخش کننده قصد دارد محتوا و تبلیغ را در پاسخ به اقدام کاربر شروع کند یا اینکه آیا به طور خودکار پخش می شود. تغییر این تنظیم هیچ تاثیری بر پخش آگهی نخواهد داشت.

پارامتر

پخش خودکار

بولی

آیا محتوا و آگهی به صورت خودکار پخش می شود یا اینکه توسط یک اقدام کاربر شروع می شود.

برمی گرداند

void

setAdWillPlayMuted

setAdWillPlayMuted(muted) باطل را برمی گرداند

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

پارامتر

خاموش

بولی

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

برمی گرداند

void

setContinuousPlayback

setContinuousPlayback(ContinuousPlayback) باطل را برمی گرداند

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

پارامتر

پخش مداوم

بولی

اینکه آیا ویدیوی محتوا یکی پس از دیگری به طور مداوم پخش می شود.

برمی گرداند

void