گوگل ایما . AdDisplayContainer
این کلاس نشان دهنده یک ظرف برای نمایش تبلیغات است. SDK به طور خودکار ساختارهایی را در داخل پارامتر containerElement ایجاد می کند تا تبلیغات ویدیویی و همپوشانی را در خود جای دهد.
هنگامی که نمونه ای از این کلاس ایجاد می شود، یک IFRAME در containerElement ایجاد می کند و هسته SDK را بارگذاری می کند. این IFRAME باید حفظ شود تا SDK به درستی کار کند. هنگامی که همه تبلیغات پخش شدند و دیگر نیازی به SDK نیست، از متد destroy() struct برای تخلیه SDK استفاده کنید.
پارامتر containerElement باید عنصری باشد که بخشی از DOM است. برای اینکه تبلیغات به درستی نمایش داده شوند لازم است که containerElement به درستی قرار گیرد. توصیه می شود آن را در بالای پخش کننده ویدیوی محتوا قرار دهید و اندازه آن را به گونه ای تنظیم کنید که کل پخش کننده ویدیو را پوشش دهد. برای جزئیات در مورد پیاده سازی های توصیه شده به مستندات SDK مراجعه کنید.
توجه: همیشه لازم است که متد initialize() را در کدی که مستقیماً توسط یک عمل کاربر فراخوانی شده است (مانند کلیک یا ضربه) فراخوانی کنید.
سازنده
AdDisplayContainer
AdDisplayContainer جدید (containerElement، videoElement، clickTrackingElement)
پارامتر | |
|---|---|
containerElement | عنصری که باید در آن تبلیغات نمایش داده شود. این عنصر باید قبل از ایجاد AdDisplayContainer در DOM درج شود. مقدار نباید صفر باشد. |
عنصر ویدئو | اختیاری عنصر پخش آگهی ویدیویی جایگزین را مشخص می کند. توصیه می کنیم همیشه از پخش کننده ویدیوی محتوای خود عبور کنید. مقدار نباید صفر باشد. |
clickTrackingElement | اختیاری عنصر کلیک روی آگهی ویدیویی جایگزین را مشخص می کند. این را خالی بگذارید تا به SDK اجازه دهید کلیک ها را مدیریت کند. حتی در صورت ارائه، SDK تنها زمانی از عنصر ردیابی کلیک سفارشی استفاده می‌کند که خلاقیت‌های غیر AdSense/AdX در محیط‌هایی نمایش داده می‌شوند که از عناصر UI روی پخش‌کننده ویدیو پشتیبانی نمی‌کنند (مثلاً iPhone یا Android قبل از نسخه 4.0). عنصر ردیابی کلیک سفارشی هرگز نباید از طریق پخش کننده ویدیو ارائه شود، زیرا می تواند کلیک های عناصر رابط کاربری را که SDK ارائه می دهد متوقف کند. همچنین توجه داشته باشید که SDK قابلیت مشاهده عنصر ردیابی کلیک سفارشی را تغییر نخواهد داد. این بدان معنی است که اگر یک عنصر ردیابی کلیک سفارشی ارائه شده باشد، باید هنگام پخش آگهی خطی به درستی نمایش داده شود. می‌توانید ima.AdsManager.isCustomClickTrackingUsed هنگامی که رویداد ima.AdEvent.Type.STARTED فعال می‌شود را بررسی کنید تا مشخص شود عنصر ردیابی کلیک سفارشی شما نمایش داده می‌شود یا خیر. اگر برای رابط کاربری شما مناسب است، هنگام فعال شدن رویداد ima.AdEvent.Type.CONTENT_RESUME_REQUESTED، باید عنصر ردیابی کلیک را پنهان کنید. مقدار نباید صفر باشد. |
مواد و روش ها
از بین رفتن
از بین رفتن()
حالت داخلی و عناصر DOM قبلا ایجاد شده را از بین می برد. IMA SDK بارگیری می‌شود و دیگر نباید با هیچ API تماسی برقرار شود.
مقداردهی اولیه
مقداردهی اولیه ()
عناصر ویدئویی داخلی را برای پخش مقداردهی اولیه می کند. شما باید این روش را به عنوان نتیجه مستقیم یک اقدام کاربر فراخوانی کنید تا مرورگر بتواند عنصر ویدیو را به عنوان شروع شده توسط کاربر علامت گذاری کند.
در صورت قطع صدا، برخی از مرورگرها امکان پخش ویدیو را بدون تعامل با کاربر فراهم می کنند. برای این رفتار، از AdsRequest.setAdWillPlayMuted(true) استفاده کنید و این متد را قبل از AdsManager.start() فراخوانی کنید.