טעינה של מודעה מותאמת

בחירת פלטפורמה: Android iOS Flutter Unity Android (גרסה קודמת)

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

כשטעינת מודעה מותאמת מתבצעת, האפליקציה מקבלת אובייקט מודעה שמכיל את הנכסים שלה, והאפליקציה (ולא Google Mobile Ads SDK (Legacy)) אחראית להציג אותם.

באופן כללי, יש שני שלבים להטמעה מוצלחת של מודעות מותאמות: טעינת מודעה באמצעות ה-SDK ואז הצגת תוכן המודעה באפליקציה.

בדף הזה מוסבר איך להשתמש ב-SDK כדי לטעון מודעות מותאמות. טיפ: מידע נוסף על מודעות מותאמות זמין במדריך למודעות מותאמות.

אתם יכולים גם לקרוא כמה סיפורי הצלחה של לקוחות: מקרה לדוגמה 1, מקרה לדוגמה 2.

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

לפני שממשיכים, מגדירים את Google Mobile Ads SDK (Legacy).

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

כשאתם מפתחים ובודקים את האפליקציות, חשוב להשתמש במודעות בדיקה ולא במודעות פעילות.

הדרך הכי קלה לטעון מודעות לבדיקה היא להשתמש במזהה הייעודי של יחידת המודעות לבדיקה של מודעות מותאמות ב-Android:

ca-app-pub-3940256099942544/2247696110

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

פרטים על מודעות בדיקה ב-Google Mobile Ads SDK (Legacy) זמינים במאמר הפעלת מודעות בדיקה.

טעינת מודעות

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

יצירת AdLoader

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

Java

// It is recommended to call AdLoader.Builder on a background thread.
new Thread(
        () -> {
          AdLoader adLoader =
              new AdLoader.Builder(context, "AD_UNIT_ID")
                  .forNativeAd(
                      new NativeAd.OnNativeAdLoadedListener() {
                        @Override
                        // The native ad loaded successfully. You can show the ad.
                        public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {}
                      })
                  .withAdListener(
                      new AdListener() {
                        @Override
                        // The native ad load failed. Check the adError message for failure
                        // reasons.
                        public void onAdFailedToLoad(@NonNull LoadAdError adError) {}
                      })
                  // Use the NativeAdOptions.Builder class to specify individual options
                  // settings.
                  .withNativeAdOptions(new NativeAdOptions.Builder().build())
                  .build();
        })
    .start();
NativeAdSnippets.java

Kotlin

// It is recommended to call AdLoader.Builder on a background thread.
CoroutineScope(Dispatchers.IO).launch {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forNativeAd { nativeAd ->
        // The native ad loaded successfully. You can show the ad.
      }
      .withAdListener(
        object : AdListener() {
          override fun onAdFailedToLoad(adError: LoadAdError) {
            // The native ad load failed. Check the adError message for failure reasons.
          }
        }
      )
      // Use the NativeAdOptions.Builder class to specify individual options settings.
      .withNativeAdOptions(NativeAdOptions.Builder().build())
      .build()
}
NativeAdSnippets.kt

מחליפים את AD_UNIT_ID במזהה המכשיר של מכשיר הבדיקה.

אזהרה: מומלץ מאוד לא לנסות לטעון מודעה חדשה מהשיטה onAdFailedToLoad(). אם אתם חייבים לטעון מודעה מ-onAdFailedToLoad(), כדאי להגביל את המספר של ניסיונות טעינת המודעה כדי למנוע כשלים חוזרים בבקשות להצגת מודעות במצבים כמו חיבור רשת מוגבל.

ה-method‏ forNativeAd() אחראית להכנת ה-AdLoader לפורמט NativeAd. כשהמודעה נטענת, מתבצעת קריאה ל-method‏ onNativeAdLoaded() של אובייקט ה-listener.

הגדרת AdListener עם AdLoader (אופציונלי)

כשיוצרים את ה-AdLoader, הפונקציה withAdListener מגדירה AdListener ל-loader. ה-method מקבלת AdListener כפרמטר היחיד שלה, שמקבל קריאות חוזרות (callbacks) מ-AdLoader כשמתרחשים אירועים במחזור החיים של המודעה:

Java

adLoaderBuilder.withAdListener(
    // Override AdListener callbacks here.
    new AdListener() {});
NativeAdSnippets.java

Kotlin

adLoaderBuilder.withAdListener(
  // Override AdListener callbacks here.
  object : AdListener() {}
)
NativeAdSnippets.kt

בקשה להצגת מודעות

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

אחרי שמסיימים ליצור AdLoader, אפשר להשתמש בה כדי לבקש מודעות. יש שתי שיטות זמינות: loadAd() ו-loadAds().

נקודה חשובה: השיטה loadAds() פועלת רק עם מודעות Google. במודעות שמוצגות דרך מנגנון בחירת הרשת, צריך להשתמש ב-loadAd().

loadAd()

השיטה הזו שולחת בקשה למודעה אחת.

Java

adLoader.loadAd(new AdRequest.Builder().build());
NativeAdSnippets.java

Kotlin

adLoader.loadAd(AdRequest.Builder().build())
NativeAdSnippets.kt

loadAds()

השיטה הזו שולחת בקשה לכמה מודעות (עד חמש):

Java

// Load three native ads.
adLoader.loadAds(new AdRequest.Builder().build(), 3);
NativeAdSnippets.java

Kotlin

// Load three native ads.
adLoader.loadAds(AdRequest.Builder().build(), 3)
NativeAdSnippets.kt

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

טעינת כמה מודעות (אופציונלי)

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

כל מודעות Google שיוחזרו יהיו שונות זו מזו, אבל לא מובטח שמודעות ממלאי שטחי פרסום שמור או מקונים מצד שלישי יהיו ייחודיות.

אל תשתמשו ב-loadAds() אם אתם משתמשים בתהליך בחירת הרשת, כי בקשות לכמה מודעות מותאמות לא פועלות במזהים של יחידות מודעות שהוגדרו לתהליך בחירת הרשת.

התקשרות חזרה

אחרי קריאה ל-loadAd(), מתבצעת קריאה חוזרת (callback) אחת לשיטות המאזין שהוגדרו קודם כדי להעביר את אובייקט המודעה המותאמת או לדווח על שגיאה.

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

הדוגמה הבאה מראה איך לבדוק את isLoading() בקריאה החוזרת (callback) של onNativeAdLoaded():

Java

adLoaderBuilder
    .forNativeAd(
        nativeAd -> {
          // This callback is invoked when a native ad is successfully loaded.
        })
    .build();
NativeAdSnippets.java

Kotlin

adLoaderBuilder
  .forNativeAd { nativeAd ->
    // This callback is invoked when a native ad is successfully loaded.
  }
  .build()
NativeAdSnippets.kt

שחרור משאבים

חשוב להשתמש בשיטה destroy() במודעות מותאמות שנטענו. הפעולה הזו משחררת משאבים בשימוש ומונעת דליפות זיכרון.

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

מוודאים שכל ההפניות ל-NativeAd נהרסות ב-method‏ onDestroy() של הפעילות.

ב-callback של onNativeAdLoaded, חשוב להשמיד את כל המודעות המותאמות הקיימות שההפניה אליהן תוסר.

בדיקה חשובה נוספת היא אם הפעילות נהרסה, ואם כן, צריך להפעיל את destroy() במודעה שהוחזרה ולחזור מיד:

Java

nativeAd.destroy();
NativeAdSnippets.java

Kotlin

nativeAd.destroy()
NativeAdSnippets.kt

שיטות מומלצות

כשאתם טוענים מודעות, חשוב לפעול לפי הכללים הבאים.

• באפליקציות שבהן מודעות מותאמות מוצגות ברשימה, צריך לשמור מראש במטמון את רשימת המודעות.

• כששומרים מודעות במטמון מראש, צריך לנקות את המטמון ולטעון מחדש אחרי שעה.

• אל תקראו ל-loadAd() או ל-loadAds() ב-AdLoader עד שהבקשה הראשונה תסיים להיטען.

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

• להשמיד מודעות מותאמות כשהן כבר לא בשימוש.

שיפור מהירות באמצעות חומרה במודעות וידאו

כדי שמודעות וידאו יוצגו בהצלחה בתצוגות של המודעות מותאמות, צריך להפעיל שיפור מהירות באמצעות חומרה.

שיפור מהירות באמצעות חומרה מופעל כברירת מחדל, אבל באפליקציות מסוימות אפשר להשבית אותה. אם זה המצב באפליקציה שלכם, מומלץ להפעיל שיפור מהירות באמצעות חומרה במחלקות Activity שמשתמשות במודעות.

הפעלת שיפור המהירות באמצעות חומרה

אם האפליקציה לא פועלת כמו שצריך כששיפור המהירות באמצעות חומרה מופעל באופן גלובלי, אפשר לשלוט בו גם לפעילויות ספציפיות. כדי להפעיל או להשבית את שיפור המהירות באמצעות חומרה, משתמשים במאפיין android:hardwareAccelerated של הרכיבים <application> ו-<activity> בקובץ AndroidManifest.xml. בדוגמה הבאה, האצת החומרה מופעלת לכל האפליקציה אבל מושבתת לפעילות אחת:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>
HardwareAccelerationSnippet.xml

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

הצגת המודעה

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