מודעות נלוות

מדריך זה מיועד לבעלי אתרים שמעוניינים להוסיף מודעות נלוות ליישום ה-IMA ב-iOS.

דרישות מוקדמות

  • אפליקציה ל-iOS עם שילוב של IMA SDK.
  • תג מודעה שהוגדר להחזיר מודעה נלווית.

פריימרים שימושיים

אם עדיין לא הטמעת את ה-IMA SDK באפליקציה, ניתן לעיין במדריך לתחילת העבודה.

הוספת מודעות נלוות לאפליקציה

יצירת UIView למודעה נלווית

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

תמונה של יצירת UIView למודעה הנלווית שלך.

יצירת IMACompanionAdSlot

השלב הבא הוא בניית אובייקט IMACompanionAdSlot מהתצוגה שלך. ה-IMA SDK מאכלס את מיקום המודעה הנלווית בכל מודעה נלווית מתגובת VAST שיש לה מימדים שתואמים לגובה ולרוחב של התצוגה. ב-IMA SDK יש גם תמיכה בשימוש במודעות נלוות בגודל גמיש.

ViewController.h 
@property(nonatomic, weak) IBOutlet UIView *companionView;
ViewController.m 
self.companionSlot =
    [[IMACompanionAdSlot alloc] initWithView:self.companionView
                                       width:self.companionView.frame.size.width
                                      height:self.companionView.frame.size.height];

העברה של משבצת המודעה הנלווית למאגר המודעות

לסיום, צריך ליידע את ה-SDK שהמשבצת הנלווית קיימת. כדי לעשות זאת, צריך להעביר מערך של משבצות זמן נלוות ל-constructor של IMAAdDisplayContainer:

ViewController.m 
return [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                           viewController:self
                                           companionSlots:@[ self.companionSlot ]];

זה הכול! האפליקציה שלך מציגה עכשיו מודעות נלוות.

הצגת מודעות נלוות נוזלות

IMA תומכת עכשיו במודעות נלוות משתנות. הגודל של המודעות הנלוות האלה יכול להתאים לגודל של מיקום המודעה. הן ממלאות 100% מרוחב התצוגה של ההורה ומשנים את הגובה שלהן כך שיתאים לתוכן של המודעה הנלווית. הן מוגדרות באמצעות הגודל הנלווה של Fluid ב-Ad Manager. בתמונה הבאה מוסבר איפה להגדיר את הערך הזה.

תמונה שמציגה את ההגדרות של המודעות הנלוות ב-Ad Manager. מדגיש את האפשרות של גדלים נלווים.

עדכון אפליקציות ל-iOS במצב Companion

אפשר להצהיר על משבצת מודעה נלווית גמישה על ידי הפעלת IMACompanionAdSlot עם הפרמטר view בלבד, לא כולל width ו-height.

ViewController.m 
self.companionSlot =
      [[IMACompanionAdSlot alloc] initWithView:self.companionView];

שאלות נפוצות

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