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

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

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

טעינת המודעה

מודעות מותאמות אישית בפורמט 'מודעה מותאמת' נטענות באמצעות הכיתה AdLoader, שיש לה גם כיתה משלה, AdLoader.Builder, שמאפשרת להתאים אישית אותה במהלך היצירה. הוספת מאזינים ל-AdLoader במהלך ה-build מאפשרת לאפליקציה לציין אילו סוגי פורמטים של מודעות היא מוכנה לקבל. לאחר מכן, ה-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, and so on.
      }
    })
    .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, and so on.
      }
    })
    .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() של אובייקט המאזין שצוין.

הגדרת AdViewOptions

הפונקציה האחרונה שכלולה ביצירה של AdLoader שלמעלה היא method אופציונלי נוסף, 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().