گوگل ایما . 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