אוטומציה של פלייליסטים של מודעות

הפלטפורמה: HTML5 Android iOS tvOS

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

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

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

כללי מודעות

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

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