הוספת תמיכה במודעות נלוויות

בחירת פלטפורמה: HTML5 Android iOS

המדריך הזה מיועד לבעלי אפליקציות שרוצים להוסיף מודעות נלוות להטמעה של IMA ב-Android.

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

  • אפליקציה ל-Android עם שילוב של IMA SDK. אם אין לכם עדיין אפליקציה שמשולבת בה ערכת ה-SDK, עיינו בקטע BasicExample. אם אתם צריכים עזרה בהטמעה של IMA SDK באפליקציה, אתם יכולים לעיין במאמר הגדרת IMA SDK.
  • תג מודעה שמוגדר להחזיר מודעה נלווית. אם אתם צריכים דוגמה, עיינו בשאלות הנפוצות.

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

כדי להוסיף מיקום מודעה בדף נלווית ולהציג מודעות נלוות באפליקציה, צריך לפעול לפי השלבים הבאים.

יוצרים ViewGroup כדי להציג את המודעה הנלווית

לפני שאתם מבקשים להוסיף אפליקציה נלווית, אתם צריכים ליצור לה מקום בפריסה. בקובץ ה-XML של הפריסה, מוסיפים רכיב ViewGroup. בדוגמה הזו משתמשים ב-LinearLayout. בשלב מאוחר יותר, תעבירו הפניה לאלמנט הזה אל AdDisplayContainer.

אם אתם משלבים את הקוד באפליקציה BasicExample, הוסיפו את הקוד לקובץ activity_my.xml, מתחת ל-videoPlayerContainer.

<LinearLayout
    android:id="@+id/companionAdSlot"
    android:layout_width="match_parent"
    android:layout_height="250dp"
    android:layout_gravity="center_horizontal"
    android:gravity="center"
    android:orientation="vertical"
    android:textAlignment="center" />

צור CompanionAdSlot

השלב הבא הוא ליצור אובייקט CompanionAdSlot, ואז להוסיף אותו למכונה של ArrayList<CompanionAdSlot>. הממשק AdDisplayContainer מקבל רשימה של מיקומי מודעות נלוות בדף, כדי שתוכלו להציג כמה מודעות נלוות בו-זמנית. כדי ליצור את האובייקט CompanionAdSlot, צריך ליצור מופע של המחלקה ImaSdkFactory.

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}

צריך ליצור מיקום מודעה בדף נלווית לכל גודל של מודעה נלווית שרוצים להציג באפליקציה. ערכת ה-IMA SDK מאכלסת את מיקום המודעה בדף נלווית בכל מודעה נלווית מהתגובה של VAST שהמידות שלה תואמות לגובה ולרוחב של התצוגה. ערכת IMA SDK תומכת גם בשימוש במודעות נלוות בגודל גמיש. אחרי שיוצרים את companionAdSlots, מוסיפים אותם אל AdsLoader. בדוגמאות הבאות מוסבר איך לעשות את זה, בהתאם לשימוש בתוסף Exoplayer-IMA או בהטמעות אחרות של IMA שלא משתמשות בתוסף.

תוסף Exoplayer-IMA

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}

הטמעות אחרות

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}

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

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

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

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

עדכון אפליקציות ל-Android כדי להשתמש במכשירים נלווים בצורה חלקה

כדי להצהיר על מיקום מודעה נלווית גמיש, מעדכנים את השיטה CompanionAdSlot.setSize() כך שתקבל את הערך CompanionAdSlot.FLUID_SIZE בשני הפרמטרים.

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);

שאלות נפוצות

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

התמונה הבאה נוצרה מהדוגמה BasicExample, ובה סרטון התוכן מופעל בחלק העליון והמודעה הנלווית מופיעה מתחתיו.

תמונה לדוגמה של מודעה נלווית ב-IMA ל-Android.