מודעות באנר

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

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

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

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

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

  • 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. תצוגת ההורה היא הפניה של jobject JNI ל-Activity של Android או מצביע אל מכשיר iOS UIView להפעלת Cast לסוג 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, ראו שימוש בחוזים עתידיים כדי לעקוב אחר סטטוס ההשלמה של קריאות ל-method.

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

אפשר להגדיר את המיקום של 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 SDK מספק מחלקה של AdListener שאפשר להרחיב ולהעביר ל-AdView::SetListener() כדי לקבל הודעות על שינויים במצב הצפייה במודעה.

הרחבת methods ב-AdListener היא אופציונלית, ולכן צריך רק להטמיע רק את ה-methods הרצויות. למטה תוכלו לראות דוגמה להטמעת מחלקה שמרחיבה את כל מחלקת השיטות 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 constant
320x50 כרזה טלפונים וטאבלטים kBanner
320x100 מודעת באנר גדולה טלפונים וטאבלטים kLargeBanner
300x250 מלבן בינוני של IAB טלפונים וטאבלטים kMediumRectangle
468x60 מודעת באנר בגודל מלא של IAB טאבלטים kFullBanner
728x90 לידרבורד של IAB טאבלטים kLeaderboard
רוחב שסופק x גובה דינמי מודעת באנר מותאמת טלפונים וטאבלטים לא רלוונטי

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

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

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

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

דוגמה ב-GitHub

סיפורי הצלחה