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

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

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

• גרסה 11.0.0 ואילך של Google Mobile Ads SDK.

• צריך לקרוא את המדריך לתחילת העבודה.

טעינת מודעה

מודעות מותאמות שמוצגות בהתאמה אישית נטענות באמצעות המחלקה AdLoader, שיש לה מחלקה משלה AdLoader.Builder להתאמה אישית במהלך היצירה. כשמוסיפים רכיבי Listener ל-AdLoader במהלך הפיתוח, האפליקציה מציינת אילו סוגים של פורמטים של מודעות היא מוכנה לקבל. לאחר מכן, AdLoader מבקש רק את הסוגים האלה.

אפשר גם להגדיר את האובייקט AdLoader כך שישלח בקשות להצגת מודעות שיכולות להניב מודעת באנר או מודעה מותאמת. הוספת OnAdManagerAdViewLoadedListener ל-AdLoader במהלך היצירה מציינת שמודעות באנר יתחרו עם מודעות מותאמות כדי למלא את הבקשה.

בדוגמת הקוד הבאה אפשר לראות איך ליצור AdLoader שיכול לטעון מודעה מותאמת או מודעת באנר בבקשה אחת:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native-and-banner")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
      @Override
      public void onNativeAdLoaded(NativeAd nativeAd) {
        // Show the ad.
      }
    })
    .forAdManagerAdView(new OnAdManagerAdViewLoadedListener() {
      @Override
      public void onAdManagerAdViewLoaded(AdManagerAdView adView) {
        // Show the banner ad.
      }
    }, AdSize.BANNER, AdSize.MEDIUM_RECTANGLE)
    .withAdListener(new AdListener() {
      @Override
      public void onAdFailedToLoad(LoadAdError error) {
        // Handle the failure by logging, altering the UI, etc.
      }
    })
    .withAdManagerAdViewOptions(new AdManagerAdViewOptions.Builder()
      // Methods in the AdManagerAdViewOptions.Builder class can be
      // used here to specify individual options settings.
      .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native-and-banner")
    .forNativeAd { nativeAd ->
      // Show the ad.
    }
    .forAdManagerAdView({ adView ->
      // Show the banner ad.
    }, AdSize.BANNER, AdSize.MEDIUM_RECTANGLE)
    .withAdListener(object: AdListener() {
      override fun onAdFailedToLoad(adError: LoadAdError) {
        // Handle the failure by logging, altering the UI, etc.
      }
    })
    .withAdManagerAdViewOptions(AdManagerAdViewOptions.Builder()
      // Methods in the AdManagerAdViewOptions.Builder class can be
      // used here to specify individual options settings.
      .build())
    .build()

השיטה forAdManagerAdView() מכינה את AdLoader לקבלת מודעות באנר. כשמפעילים את forAdManagerAdView(), צריך לציין לצד OnAdManagerAdViewLoadedListener רשימה באורך משתנה של גדלי מודעות תקינים.

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

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

הגדרת האובייקט AdViewOptions

הפונקציה האחרונה שכלולה ביצירה של AdLoader היא שיטה אופציונלית נוספת, withAdManagerAdViewOptions():

Java

.withAdManagerAdViewOptions(new AdManagerAdViewOptions.Builder()
    // Methods in the AdManagerAdViewOptions.Builder class can be
    // used here to specify individual banner options settings.
    .build()

Kotlin

.withAdManagerAdViewOptions(AdManagerAdViewOptions.Builder()
    // Methods in the AdManagerAdViewOptions.Builder class can be
    // used here to specify individual banner options settings.
    .build()

אובייקט AdManagerAdViewOptions מאפשר לבעלי תוכן דיגיטלי להגדיר אפשרויות ספציפיות לבאנרים שנטענים על ידי AdLoader, כמו:

setManualImpressionsEnabled()

הפעלת דיווח ידני על חשיפות בהזמנות של Google Ad Manager. אפליקציות שמשתמשות בחשיפות ידניות יכולות לקבוע בעצמן מתי צריך לתעד חשיפה, והן יכולות לעשות זאת על ידי קריאה ל-AdManagerAdView.recordManualImpression().