تحسين وقت تحميل IMA

تحمّل حزمة تطوير البرامج للإعلانات التفاعلية التبعيات لطلب الإعلانات وقياس إمكانية العرض وتسجيل مرّات ظهور الإعلانات. من خلال تهيئة حزمة IMA قبل تقديم طلب عرض الإعلان، يمكنك زيادة الوقت المتاح لتحميل تبعيات حزمة IMA قبل تشغيل الإعلان. تتناول هذه الصفحة كيفية التعامل مع أوقات تحميل 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 لتشغيل الإعلانات.