מודעות באנר

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

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

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

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

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

  • 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 או הפניה להעברה של UIView ב-iOS לסוג 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. האפשרות הזו יכולה לעזור לכם לעקוב אחרי תהליך האתחול ב-game Loop גלובלי.

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

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

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

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

סיפורי הצלחה