Share your feedback and help shape the Google Mobile Ads SDK roadmap. Take the Google Mobile Ads SDK Annual Survey for 2023 before it closes on May 5th, 2023.

מודעות באנר

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

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

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

ביצוע בדיקות תמיד באמצעות מודעות בדיקה

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

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

  • Android: ‏ca-app-pub-3940256099942544/6300978111
  • iOS: ‏ca-app-pub-3940256099942544/2934735716

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

מידע נוסף על אופן הפעולה של מודעות בדיקה של Mobile Ads SDK זמין במאמר מודעות בדיקה.

יישום

הגדרת AdView

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

  1. הוסף את הכותרת הבאה לקוד C++ של האפליקציה שלך:

     #include "firebase/gma/ad_view.h"
    
  2. הצהרה ויצירה של אובייקט AdView:

      firebase::gma::AdView* ad_view;
      ad_view = new firebase::gma::AdView();
    
  3. אפשר ליצור AdSize ולהפעיל את תצוגת המודעות באמצעות התצוגה המפורטת AdParent של ההורה. תצוגת ההורה היא הפנייה של JNI jobject ל-Android Activity או הפניה ל-iOS UIView מסוג AdParent:

     // my_ad_parent is a jobject reference
     // to an Android Activity or a pointer to an iOS UIView.
     firebase::gma::AdParent ad_parent = static_cast(my_ad_parent);
     firebase::Future result =
       ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);
    
  4. כחלופה לשמירה על העתיד כמשתנה, אפשר לבדוק מדי פעם את סטטוס פעולת האתחול על ידי הפעלת InitializeLastResult() באובייקט AdView. זה יכול להיות כלי שימושי למעקב אחר תהליך האתחול במרכז המשחקים הגלובלי.

      // Monitor the status of the future in your game loop:
      firebase::Future<void> result = ad_view->InitializeLastResult();
      if (result.status() == firebase::kFutureStatusComplete) {
        // Initialization completed.
        if(future.error() == firebase::gma::kAdErrorCodeNone) {
          // Initialization successful.
        } else {
          // An error has occurred.
        }
      } else {
        // Initialization on-going.
      }
    
  5. למידע נוסף על עבודה עם firebase::Future, מומלץ לקרוא את המאמר שימוש בחוזים עתידיים כדי לעקוב אחר סטטוס ההשלמה של קריאות השיטה.

הגדרת מיקום המודעה

אפשר להגדיר את המיקום של AdView בכל שלב אחרי ההפעלה שלו:

firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);

טעינת מודעה

אפשר לטעון מודעה ברגע שהמודעה AdView תופעל:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result = ad_view->LoadAd(my_ad_request);

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

הצגה של המודעה

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

firebase::Future<void> result = ad_view->Show();

אירועי מודעות

ב-Google Mobile Ads C++ SDK יש שיעור AdListener שניתן להרחיב ולהעביר אל AdView::SetListener() כדי לקבל התראות על שינויים במצב הצפייה במודעה.

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

class ExampleAdListener
    : public firebase::gma::AdListener {
 public:
  ExampleAdListener() {}
  void OnAdClicked() override {
    // This method is invoked when the user clicks the ad.
  }

  void OnAdClosed() override {
   // This method is invoked when the user closes the ad.
  }

  void OnAdImpression() override {
    // This method is invoked when an impression is recorded for an ad.
  }

  void OnAdOpened() override {
    // This method is invoked when an ad opens an overlay that covers the screen.
  }
};

ExampleAdListener* ad_listener = new ExampleAdListener();
ad_view->SetAdListener(ad_listener);

בטבלה הבאה מפורטים הגדלים הרגילים של מודעות באנר.

גודל בנקודות (WxH) תיאור זמינות firebase::gma::AdSize קבוע
320x50 באנר טלפונים וטאבלטים kBanner
320x100 מודעת באנר גדולה טלפונים וטאבלטים kLargeBanner
300x250 מלבן בינוני של IAB טלפונים וטאבלטים kMediumRectangle
468x60 באנר בגודל מלא של IAB טאבלטים kFullBanner
728x90 רשימת המובילים של IAB טאבלטים kLeaderboard
רוחב שסופק x גובה ניתן להתאמה מודעת באנר מותאמת טלפונים וטאבלטים לא רלוונטי

גדלים מותאמים אישית של מודעות

כדי להגדיר גודל מותאם אישית של מודעת באנר, אתם יכולים להשתמש בבנאי firebase::gma::AdSize באמצעות הפרמטרים של רוחב וגובה, כפי שמתואר כאן:

firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);

מקורות מידע נוספים

דוגמה ב-GitHub

סיפורי הצלחה