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

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

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

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

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

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

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

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

נקודת מפתח: בדוגמה הבסיסית מוטמע התוסף Exoplayer-IMA שמטפל בהגדרה של ImaSdkSettings ו-AdEvents. לכן לא ניתן להשתמש בדוגמה הבסיסית כנקודת התחלה למדריך הזה.

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.