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

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

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

• גרסה 11.0.0 ואילך של Google Mobile Ads SDK.
• משלימים את תחילת העבודה.

טעינת המודעה

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

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

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

JavaKotlin

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();

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.

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

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

הגדרת AdViewOptions

הפונקציה האחרונה שכלולה ביצירה של AdLoader שלמעלה היא method אופציונלי נוסף, withAdManagerAdViewOptions():

JavaKotlin

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

.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().