מודעות נלוות

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

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

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

מדריכים מועילים

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

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

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

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

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 של מודעות Companion ב-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 , והיא כוללת את סרטון התוכן שמופעל למעלה ואת מודעת התאמה שמופיעה למטה.