הפעלה ידנית של הפסקה למודעה

במדריך הזה תמצאו הוראות לשינוי לוח הזמנים של ההפסקות למודעות שמוגדר כברירת מחדל, ולהגדרת תזמונים משלכם להפעלה של הפסקות למודעות. כשמטמיעים הפעלה ידנית של הפסקות למודעות, ה-SDK מפעיל אירוע AD_BREAK_READY כשמתבצעת טעינה של הפסקה למודעות, ומחכה שתתחילו את ההפעלה של ההפסקה.

דרישות מוקדמות

  • אפליקציה ל-Android שהוטמעה בה IMA SDK.

הגדרת הפעלה ידנית של הפסקות למודעות

כדי להגדיר הפעלה ידנית של הפסקות למודעות:

  1. אומרים ל-SDK שאתם רוצים לשלוט בהפעלה של הפסקות למודעות.
  2. מאזינים לאירוע AD_break_READY.
  3. אפשר לבקש מה-SDK להפעיל מודעות כשרוצים.

בקטע הקוד הבא מוצגים השינויים הנדרשים בדוגמה מתקדמת כדי להטמיע הפעלה ידנית של הפסקות למודעות.

public VideoPlayerController(
      Context context,
      VideoPlayerWithAdPlayback videoPlayerWithAdPlayback,
      View playButton,
      View playPauseToggle,
      String language,
      ViewGroup companionViewGroup,
      Logger log) {
  ...
  
  sdkFactory = ImaSdkFactory.getInstance();
  ImaSdkSettings imaSdkSettings = sdkFactory.createImaSdkSettings();
  imaSdkSettings.setLanguage(language);
  // Tell the SDK you want to control ad break playback.
  imaSdkSettings.setAutoPlayAdBreaks(false);
  
  ...
}
...
@Override
public void onAdEvent(AdEvent adEvent) {
    ...
    switch (adEvent.getType()) {
      // Listen for the AD_BREAK_READY event.
      case AD_BREAK_READY:
        // Tell the SDK to play ads when you're ready. To skip this ad break,
        // simply return from this handler without calling adsManager.start().
        adsManager.start();
        break;
      ...
}

שאלות נפוצות

האם נדרשת הפעלה ידנית של מודעות לצורך הטמעת IMA SDK?
לא. הפעלה ידנית של מודעות היא תכונה אופציונלית לבעלי אפליקציות שלא רוצים ש-IMA SDK יפעיל באופן אוטומטי הפסקות למודעות לפי כלל מודעה או תגובת VMAP.