מודעות באנר

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

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

• מסיימים את המאמר תחילת העבודה.
• (Android בלבד) יש יתרון בעבודה עם קובצי עזר של JNI jobject (מידע נוסף זמין במאמר טיפים ל-Android JNI).

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

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

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

• 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 מייצגים בקשה אחת להצגת מודעה, והם מכילים מאפיינים למידע כמו טירגוט.

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

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

לבסוף, כדי להציג את המודעה במסך, צריך להתקשר אל 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

• תוכלו לראות את קוד המקור של האפליקציה למתחילים לדוגמה ב-GitHub.

סיפורי הצלחה

• תרחיש לדוגמה לדוגמה.