כללי מודעות

מצבי פעולה של SDK

ה-SDK יכול לפעול במצב אחד או יותר, בהתאם לתגובת המודעה שהוא מקבל משרת המודעות.

מודעה יחידה
מודעה שאפשר להפעיל בכל שלב כשההודעה start נשלחת אל IMAAdsManager. אין צורך באתחול מיוחד כדי להפעיל מודעה יחידה.
רצף מודעות
מספר מודעות שמוצגות לסירוגין כאשר ההודעה start נשלחת אל IMAAdsManager. אין צורך באתחול מיוחד כדי להפעיל רצף מודעות יחיד.
כללי מודעות
פלייליסט של הפסקות למודעות שתוזמנו בזמנים מסוימים בהתאם לתוכן מסוים. במצב 'כללי מודעות' המערכת מתעלמת מההודעה start. ניתן לתזמן כמה הפסקות למודעות בתוך פלייליסט אחד (לדוגמה: מודעה לפני סרטון, מודעה באמצע סרטון ומודעה בסוף סרטון). לפרטים נוספים על ההטמעה, קראו את הקטע כללי מודעות בהמשך.

כללי מודעות

IMA iOS SDK תומך בפלייליסטים אוטומטיים לחלוטין של מודעות. התכונה הזו מוסיפה לתוכן הפסקות למודעות כפי שצוין ב-Google Ad Manager בזמן ניהול הטראפיק של המודעות. הוא גם מפשט מאוד את קוד נגן הווידאו שנדרש כדי לתמוך בהפסקות למודעות, כולל מודעות לפני הסרטון, מודעות באמצע הסרטון ומודעות בסוף הסרטון.

  • כשמנהלים טראפיק של מודעות ב-Ad Manager, אפשר לקבוע כללים שונים להצגת מודעות, כמו 'תמיד להפעיל הפסקה למודעה בתחילת התוכן' או 'הפעלת הפסקה למודעה של דקה אחת בכל 30 דקות של התוכן'.
  • כשנשלחת בקשה להצגת מודעות, שרת המודעות יכול להחזיר פלייליסט של מודעות. ה-SDK מעבד את הפלייליסט ומתזמן אוטומטית את ההפסקות למודעות שצוינו.
  • כשמפעילים את AdsManager, אובייקט IMAContentPlayhead מועבר באמצעות הקריאה initializeWithContentPlayhead:adsRenderingSettings:. אם בחרת להשתמש ב-AVPlayer כדי להציג את התוכן, כשיוצרים את adDisplayContainer, מעבירים מופע של IMAAVPlayerContentPlayhead ל-SDK. האובייקט הזה משמש למעקב אחר ההתקדמות של הפעלת התוכן, כך שההפסקות למודעות יתווספו באופן אוטומטי בזמנים שצוינו ב-Ad Manager.

    באמצעות AVPlayer:

    IMAContentPlayhead *contentPlayhead =
    [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer];
IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl
                                              adDisplayContainer:adDisplayContainer
                                                 contentPlayhead:contentPlayhead
                                                     userContext:nil];

    ללא AVPlayer:

    1. הטמעת הממשק של IMAContentPlayhead.
    2. מטמיעים את currentTime כדי להחזיר את השעה הנוכחית בנגן הווידאו.
    3. צריך לשנות את הקריאה לאתחול של IMAAdsManager לשימוש ב-initializeWithContentPlayhead:self.
  • IMAAdsManagerDelegate משמש להשהיה ולהמשך של התוכן בזמן שמופעלות הפסקות למודעות.

הערה: לאחר סיום ההפעלה של התוכן או לאחר שהמשתמש הפסיק להפעיל אותו, יש להתקשר אל contentComplete ב-IMAAdsLoader כדי לאותת ל-SDK שהתוכן הסתיים. לאחר מכן, ה-SDK יפעיל את ההפסקה למודעות בסוף הסרטון, אם תזמנתם הפסקות למודעות. האירוע ALL_ADS_COMPLETED מוגבר לאחר הפעלת כל ההפסקות למודעות. כמו כן, חשוב לשים לב שהמעקב אחר תוכן מתחיל בעת קריאה ל-method initializeWithContentPlayhead:adsRenderingSettings של IMAAdsManager, ותמיד יש להפעיל את initializeWithContentPlayhead:adsRenderingSettings לפני הפעלת התוכן.