تحمّل حزمة تطوير البرامج لإعلانات الوسائط التفاعلية التبعيات لطلب الإعلانات وقياس إمكانية العرض وتسجيل مرات ظهور الإعلان. من خلال إعداد "إعلانات الوسائط التفاعلية" قبل إجراء طلب إعلان، يمكنك زيادة الوقت المتاح لتحميل التبعيات الخاصة بـ "إعلانات الوسائط التفاعلية" قبل تشغيل الإعلان. تتناول هذه الصفحة كيفية التعامل مع أوقات تحميل IMA في تطبيقك.
الاتصال بـ ImaSdkFactory.initialize()
تبدأ طريقة
ImaSdkFactory.initialize()
في التحميل المُسبَق لموارد حزمة تطوير البرامج (SDK) قبل طلب الإعلان الأول. لاستخدام initialize()، يجب أن يكون لديك الإصدار 3.35.1 من "إعلانات الوسائط التفاعلية" أو إصدار أحدث.
استدعِ الدالة ImaSdkFactory.initialize() عند بدء تشغيل التطبيق أو في أقرب وقت ممكن خلال دورة حياة التطبيق، وذلك حسب ما يسمح به هيكل تطبيقك. يتضمّن طلب initialize() المَعلمات التالية:
context: تستخدم سياق التطبيق الذي يكون متاحًا دائمًا خلال دورة حياة التطبيق.settings: مرِّر عنصرImaSdkSettingsمع ضبط قيمه. يجب أن تكون إعدادات IMA المستخدَمة في طلبinitialize()هي نفسها قيم الإعدادات المستخدَمة في طلبcreateAdsLoader(). تستفيد حزمة تطوير البرامج لإعلانات الوسائط التفاعلية من هذه الإعدادات، خاصةً إعدادات اللغة، لمفتاح ذاكرة التخزين المؤقت. لا ننصح باستخدام قيم اختبارية أو وهمية للإعدادات المستخدَمة في استدعاء طريقةinitialize()، لأنّ ذلك قد يؤدي إلى عدم العثور على البيانات في ذاكرة التخزين المؤقت وزيادة وقت تحميل الإعلان.
إعادة استخدام مثيل AdsLoader
لتحسين وقت تحميل IMA، ننصحك بإعادة استخدام مثيل
AdsLoader نفسه. يمكن لواجهة AdsLoader التعامل مع طلبات متعدّدة للإعلانات أو البث.
تجنَّب إنشاء مثيل AdsLoader جديد لكل طلب. يتطلّب إنشاء مثيل جديد
AdsLoader وقت تحميل، ويستخدم موارد إضافية من الجهاز.
طلب إدراج الإعلانات قبل التشغيل
إذا كان بإمكانك الوصول إلى مثيل AdsLoader قبل بدء تشغيل الإعلان، يمكنك أيضًا استدعاء الطريقة AdsLoader.requestAds() مبكرًا. يؤدي إجراء هذا الاستدعاء إلى بدء تحميل إعلانات ما قبل التشغيل. عندما يصبح المستخدم جاهزًا لبدء تشغيل المحتوى، استدعِ طريقة AdsManager.init() وانتظِر حدث LOADED لتشغيل الإعلانات.