מודעות באנר

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

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

• ממלאים את תחילת העבודה.
• (Android בלבד) היכרות עם הפניה jobject של JNI (ראו טיפים ל-JNI ב-Android).

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

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

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

• 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 ל-Activity ב-Android או למצביע ל-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<firebase::gma::AdParent>(my_ad_parent);
    firebase::Future result =
      ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);

4. לחלופין, במקום לשמור את ה-Future כמשתנה, אפשר לבדוק מדי פעם את הסטטוס של פעולת האי initialization על ידי קריאה ל-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 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);

גדלים של מודעות באנר

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

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

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

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

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

דוגמה ב-GitHub

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

סיפורי הצלחה

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