تحسين وقت تحميل IMA
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحمّل حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA SDK) العناصر التابعة لطلب الإعلانات وقياس إمكانية العرض
وإعداد تقارير مرّات ظهور الإعلانات. من خلال إعداد IMA قبل تقديم طلب إعلان، يمكنك
زيادة الوقت اللازم لتحميل متطلّبات IMA إلى أقصى حد قبل تشغيل الإعلان. تتناول هذه الصفحة
كيفية التعامل مع أوقات تحميل IMA في تطبيقك.
الاتصال بـ ImaSdkFactory.initialize()
تبدأ الطريقة
ImaSdkFactory.initialize()
بتحميل موارد حزمة تطوير البرامج (SDK) مسبقًا قبل تقديم أول طلب إعلان. لاستخدامinitialize()، يجب تثبيت الإصدار 3.35.1 من IMA أو إصدار أحدث.
يمكنك استدعاء ImaSdkFactory.initialize() عند بدء تشغيل التطبيق أو في مرحلة مبكرة من
دورة حياة التطبيق حسبما تسمح به بنية تطبيقك. تأخذ عملية استدعاء initialize()
المَعلمات التالية:
-
context: يستخدم سياق التطبيق، والذي يكون متاحًا دائمًا أثناء
دورة حياة التطبيق.
settings: نقْل عنصر
ImaSdkSettings
مع ضبط قيمه. يجب أن تكون إعدادات IMA المستخدَمة في طلب initialize()
متطابقة مع قيم الإعدادات المستخدَمة في طلب createAdsLoader(). تستخدِم حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA SDK) هذه الإعدادات، خاصةً إعداد اللغة،
لإيجاد مفتاح ذاكرة التخزين المؤقت. لا ننصح باستخدام قيم اختبارية أو زائفة للإعدادات
المستخدَمة في طلب الطريقة initialize()، لأنّه قد يحدث عدم توفّر ذاكرة التخزين المؤقت ويؤدي ذلك إلى
زيادة وقت تحميل الإعلان.
إعادة استخدام مثيل AdsLoader
لتحسين وقت تحميل IMA، ننصحك بإعادة استخدام مثيل
AdsLoader
نفسه. يمكن لواجهة AdsLoader معالجة طلبات إعلانات أو أحداث بث متعددة.
تجنَّب إنشاء مثيل جديد من AdsLoader لكل طلب. يتطلب إنشاء مثيل جديد
AdsLoader وقت تحميل، ويستخدم موارد إضافية للجهاز.
طلب الإعلانات قبل التشغيل
إذا كان بإمكانك الوصول إلى مثيل AdsLoader قبل بدء تشغيل الإعلان،
يمكنك أيضًا استدعاء الأسلوب
AdsLoader.requestAds()
مبكرًا. يؤدي إجراء هذا الطلب إلى بدء تحميل إعلانات ما قبل التشغيل. عندما يكون المستخدِم
جاهزًا لبدء تشغيل المحتوى، استخدِم الأسلوب
AdsManager.init()
وانتظِر حدث LOADED لتشغيل الإعلانات.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Improve IMA load time\n\nThe IMA SDK loads dependencies to request ads, measure viewability and\nreport ad impressions. By initializing IMA before you make an ad request, you\nmaximize the time to load IMA dependencies before ad playback. This page covers\nhow to handling IMA load times in your app.\n\nCall `ImaSdkFactory.initialize()`\n---------------------------------\n\nThe\n[`ImaSdkFactory.initialize()`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/ImaSdkFactory#initialize(android.content.Context,com.google.ads.interactivemedia.v3.api.ImaSdkSettings))\nmethod starts to preload SDK resources in advance of the first ad request. To\nuse `initialize()`, you need IMA version 3.35.1 or higher.\n\nCall `ImaSdkFactory.initialize()` on application startup, or as early in the\napplication's lifecycle as your app structure allows. The `initialize()` call\ntakes the following parameters:\n\n- **`context`**: Uses the application context, which is always available during the lifecycle of the application.\n- **`settings`** : Pass the an [`ImaSdkSettings`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/ImaSdkSettings) object with its values set. The IMA settings used in the `initialize()` call must be the same as the settings values used in the `createAdsLoader()` call. The IMA SDK utilizes these settings, particularly the language setting, for cache key. We don't recommend using test or fake values for the settings used in the `initialize()` method call, as cache misses might occur and increase ad load time.\n\nReuse the `AdsLoader` instance\n------------------------------\n\nTo improve IMA load time, we recommend you reuse the same\n[`AdsLoader`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/AdsLoader)\ninstance. The `AdsLoader` interface can handle multiple ad or stream requests.\nAvoid creating a new `AdsLoader` instance for each request. Creating a new\n`AdsLoader` instance requires a load time, and uses additional device resources.\n\nRequest ads in advance of playback\n----------------------------------\n\nIf you have access to the `AdsLoader` instance prior to starting ad playback,\nyou can also call the\n[`AdsLoader.requestAds()`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/AdsLoader#requestAds(com.google.ads.interactivemedia.v3.api.AdsRequest))\nmethod early. Making this call starts loading pre-roll ads. When the user\nis ready to start content playback, call the\n[`AdsManager.init()`](/interactive-media-ads/docs/sdks/android/client-side/api/reference/com/google/ads/interactivemedia/v3/api/BaseManager#init())\nmethod and wait for the `LOADED` event to play ads."]]
