חזרה להפסקה למודעה שדילגתם עליה

בחירת פלטפורמה: HTML5 Android iOS tvOS Roku

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

לדוגמה, ראו את התרשים הבא. הצופה צופה בסרטון ומחליט לדלג מנקודת הזמן של 5 דקות לנקודת הזמן של 15 דקות. עם זאת, יש הפסקה למודעה אחרי 10 דקות, ואתם רוצים שהצופים יצפו בה לפני שהם יוכלו לצפות בתוכן שאחריה:

כדי להציג את ההפסקה למודעה הזו, פועלים לפי השלבים הבאים:

1. בודקים אם המשתמש דילג על הפסקה למודעה שלא צפה בה, ואם כן, מחזירים אותו להפסקה למודעה.
2. אחרי שהפסקת הפרסום מסתיימת, מחזירים את הצופים למיקום המקורי בסרטון.

בתרשים, זה נראה כך:

כך מטמיעים את התכונה 'חזרה מהירה' באמצעות IMA DAI SDK, כמו שמוצג ב-AdvancedExample.

איך מונעים מדילוג על הפסקה למודעה מבלי שהיא נצפית

בודקים אם המשתמש דילג על הפסקה למודעה שהוא לא צפה בה, ואם כן, מחזירים אותו להפסקה למודעה. בדוגמה המתקדמת של tvOS נעשה שימוש ב-AVPlayerViewController, שיש לו שיטת delegate שמודיעה לכם שהמשתמש הפעיל מעבר מהיר. אם זמן ההתחלה של ההרצה קדימה חל לפני ההפסקה למודעה הקודמת (כלומר, המשתמש דילג מעליה) וההפסקה הזו עדיין לא הופעלה, צריך להחזיר את המשתמש לתחילת ההפסקה למודעה. בנוסף, כדאי לתעד את שעת ההתחלה של הבקשה הראשונית למעבר למיקום מסוים כדי לבדוק אותה מאוחר יותר בפונקציית ה-handler של ad-break-did-end:

- (void)playerViewController:(AVPlayerViewController *)playerViewController
  willResumePlaybackAfterUserNavigatedFromTime:(CMTime)oldTime
                      toTime:(CMTime)targetTime {
  if (self.streamManager) {
    IMACuepoint *prevCuepoint = [self.streamManager
        previousCuepointForStreamTime:CMTimeGetSeconds(targetTime)];
    if (prevCuepoint && !prevCuepoint.isPlayed && oldTime < prevCuepoint.startTime) {
      self.userSeekTime = CMTimeGetSeconds(targetTime);
      [self.playerViewController.player seekToTime:CMTimeMakeWithSeconds(
                 prevCuepoint.startTime, NSEC_PER_SEC)
                 toleranceBefore:kCMTimeZero
                  toleranceAfter:kCMTimeZero];
    }
  }
}

החזרת המשתמש למיקום המקורי שלו בסרטון

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

- (void)streamManager:(IMAStreamManager *)streamManager didReceiveAdEvent:(IMAAdEvent *)event {
  NSLog(@"StreamManager event (%@).", event.typeString);
  switch (event.type) {
    // Your other events go here as normal.
    case kIMAAdEvent_AD_BREAK_ENDED: {
      if (self.userSeekTime > 0) {
        self.playerViewController.player
            seekToTime:CMTimeMakeWithSeconds(self.userSeekTime, NSEC_PER_SEC)
        toleranceBefore:kCMTimeZero
        toleranceAfter:kCMTimeZero];
        self.userSeekTime = 0;

      // existing handling for AD_BREAK_ENDED goes here.
      break;
    }
    // And so on for other events.
    default:
      break;
  }
}