מודעות נלוות

המדריך הזה מיועד לבעלי תוכן דיגיטלי שמעוניינים להוסיף מודעות נלוות להטמיע את ה-IMA ב-Android.

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

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

ספרי לימוד למתחילים

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

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

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

לפני שמבקשים שותף/ה, צריך ליצור בשבילו מרחב משותף הפריסה שלו. ב-XML של הפריסה, מוסיפים רכיב ViewGroup. הזה לדוגמה משתמשת ב-LinearLayout. בשלב מאוחר יותר נעביר הפניה לרכיב הזה אל AdDisplayContainer. אם אתם משולב באפליקציה BasicExample (דוגמה לשימוש בסיסי), צריך להוסיף אותה אל activity_my.xml מתחת ל-com.google.android.exoplayer2.ui.PlayerView.

activity_my.xml

<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 מתעדת רשימה של משבצות מודעה נלוות כדי לאפשר לך להציג מודעות נלוות מרובות בו-זמנית. צריך ליצור מופע של ImaSdkFactory כדי ליצור את CompanionAdSlot.

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

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

BasicExample

adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();

הטמעות אחרות

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

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

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

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

עדכון אפליקציות ל-Android בשביל אפליקציות נלוות

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

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

שאלות נפוצות

פעלתי בהתאם למדריך, אבל אני לא רואה מודעות נלוות. מה עליי לעשות?

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

כיצד ייראה מיקום המודעה הנלווית שלי לאחר ביצוע מדריך זה?

התמונה שלמטה נוצרה מתוך BasicExample וסרטון התוכן מופעל למעלה עם המודעה הנלווית למטה.