שיפור זמן הטעינה של IMA
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
ה-IMA SDK טוען יחסי תלות כדי לבקש שידורים של הטמעת מודעות דינמיות (DAI), למדוד את הניראות ולדווח על חשיפות של מודעות. כשמאתחלים את IMA לפני ששולחים בקשת סטרימינג, אפשר למקסם את הזמן לטעינה של יחסי התלות של IMA לפני ההפעלה של הסטרימינג. בדף הזה מוסבר איך לטפל בזמני הטעינה של IMA באפליקציה.
התקשרות אל ImaSdkFactory.initialize()
השיטה ImaSdkFactory.initialize()
מתחילה לטעון מראש משאבי SDK לפני הבקשה הראשונה לשידור.
כדי להשתמש ב-initialize()
, צריך IMA מגרסה 3.35.1 ואילך.
צריך להפעיל את ImaSdkFactory.initialize()
בזמן ההפעלה של האפליקציה, או בשלב מוקדם ככל האפשר במחזור החיים של האפליקציה, בהתאם למבנה האפליקציה. הקריאה ל-initialize()
מקבלת את הפרמטרים הבאים:
context
: המערכת משתמשת בהקשר של האפליקציה, שתמיד זמין במהלך מחזור החיים של האפליקציה.
settings
: מעבירים אובייקט ImaSdkSettings
עם הערכים שהוגדרו לו. הגדרות ה-IMA שנעשה בהן שימוש בקריאה initialize()
חייבות להיות זהות לערכי ההגדרות שנעשה בהם שימוש בקריאה createAdsLoader()
. מערכת IMA SDK משתמשת בהגדרות האלה, במיוחד בהגדרת השפה, למפתח המטמון. לא מומלץ להשתמש בערכים לבדיקה או בערכים מזויפים להגדרות שמשמשות בקריאה ל-method initialize()
, כי ייתכן שיחולו החמצות במטמון ויאריכו את זמן הטעינה של המודעות.
שימוש חוזר במכונה AdsLoader
כדי לשפר את זמן הטעינה של IMA, מומלץ לעשות שימוש חוזר באותו מכונה של AdsLoader
. הממשק AdsLoader
יכול לטפל במספר בקשות להצגת מודעות או להעברת סטרימינג.
מומלץ לא ליצור מכונה חדשה של AdsLoader
לכל בקשה. יצירת מכונה חדשה של AdsLoader
דורשת זמן טעינה ומשתמשת במשאבים נוספים במכשיר.
שליחת בקשות להעברת נתונים (stream) לפני ההפעלה
אם יש לכם גישה למכונה AdsLoader
לפני שתתחילו את ההפעלה של הסטרימינג, תוכלו גם להפעיל את השיטה AdsLoader.requestStream()
מוקדם. הקריאה הזו מתחילה את טעינת הסטרימינג של ה-DAI. כשהמשתמש מוכן להתחיל את ההפעלה של הסטרימינג, צריך להפעיל את השיטה StreamManager.init()
כדי לאתחל את ההפעלה של הסטרימינג.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-21 (שעון UTC)."],[],[],null,["# Improve IMA load time\n\nThe IMA SDK loads dependencies to request Dynamic Ad Insertion (DAI) streams,\nmeasure viewability and report ad impressions. By initializing IMA before you\nmake a stream request, you maximize the time to load IMA dependencies before\nstream playback. This page covers how to handling IMA load times in your app.\n\nCall `ImaSdkFactory.initialize()`\n---------------------------------\n\nThe\n[`ImaSdkFactory.initialize()`](/ad-manager/dynamic-ad-insertion/sdk/android/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 stream request.\nTo use `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`](/ad-manager/dynamic-ad-insertion/sdk/android/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 streams in advance of playback\n--------------------------------------\n\nIf you have access to the `AdsLoader` instance prior to starting stream\nplayback, you can also call the\n[`AdsLoader.requestStream()`](/ad-manager/dynamic-ad-insertion/sdk/android/api/reference/com/google/ads/interactivemedia/v3/api/AdsLoader#requestStream(com.google.ads.interactivemedia.v3.api.StreamRequest))\nmethod early. Making this call starts loading the DAI stream. When the user\nis ready to start stream playback, call the\n[`StreamManager.init()`](/ad-manager/dynamic-ad-insertion/sdk/android/api/reference/com/google/ads/interactivemedia/v3/api/BaseManager#init())\nmethod to initialize stream playback."]]