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