מודעות נלוות

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

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

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

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

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

  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 וסרטון התוכן מוצג למעלה עם המודעה הנלווית שלמטה.