כללי מודעות

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

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

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

כללי מודעות

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

  • בניהול הטראפיק של מודעות ב-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 מוגדל אם בכל ההפסקות למודעות יש הופעלו. כמו כן, חשוב לזכור שהמעקב אחר התוכן מתחיל בתאריך מכשיר initializeWithContentPlayhead:adsRenderingSettings של IMAAdsManager קוראים ל-method ותמיד צריך לקרוא ל-initializeWithContentPlayhead:adsRenderingSettings לפני שמפעילים את התוכן.