מודעות באנר

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

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

• משלימים את התהליך שנתחיל?.
• (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 צפייה. תצוגת ההורה היא קובץ עזר של 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<firebase::gma::AdParent>(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();

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

ערכת ה-SDK של C++ למודעות Google לנייד מספקת מחלקה 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.

סיפורי הצלחה

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