إعلانات البانر

تشغل إعلانات البانر مساحة ضمن تصميم التطبيق، إما في أعلى شاشة الجهاز أو أسفلها. تبقى هذه الإعلانات معروضة على الشاشة أثناء تفاعل المستخدمين مع التطبيق، ويمكن أن يتم تحديثها تلقائيًا بعد فترة زمنية معيّنة. إذا كنت تستخدم الإعلانات على الأجهزة الجوّالة لأول مرة، فهي خيار رائع للبدء. دراسة حالة.

المتطلبات الأساسية

الاختبار دائمًا باستخدام الإعلانات الاختبارية

عند إنشاء تطبيقاتك واختبارها، احرِص على استخدام الإعلانات الاختبارية بدلاً من الإعلانات النهائية المعروضة. وقد يؤدي عدم إجراء ذلك إلى تعليق حسابك.

أسهل طريقة لتحميل الإعلانات الاختبارية هي استخدام رقم تعريف الوحدة الإعلانية الاختبارية المخصّص لإعلانات البانر، والذي يختلف حسب منصة الجهاز:

  • نظام تشغيل Android: ‏ ca-app-pub-3940256099942544/6300978111
  • نظام تشغيل iOS: ‏ ca-app-pub-3940256099942544/2934735716

تمت تهيئة أرقام تعريف الوحدات الإعلانية هذه خصيصًا لعرض إعلانات اختبارية لكل طلب، ويمكنك استخدامها بحرية في تطبيقاتك أثناء الترميز والاختبار وتحديد الأخطاء وحلّها. ما عليك سوى استبدالها برقم تعريف الوحدة الإعلانية الخاص بك قبل نشر تطبيقك.

لمزيد من المعلومات عن آلية عمل الإعلانات الاختبارية في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، راجِع مقالة الإعلانات الاختبارية.

التنفيذ

إعداد 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. كبديل للاحتفاظ بالنتيجة المستقبلية كمتغيّر، يمكنك التحقّق بشكلٍ دوري من حالة عملية الإعداد من خلال استدعاء 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 طلب عرض الإعلان واحدًا وتحتوي على خصائص لمعلومات مثل الاستهداف.

عرض الإعلان

أخيرًا، اعرِض الإعلان على الشاشة من خلال استدعاء Show(). يمكن استدعاء هذه الطريقة في أي وقت بعد إعداد الإعلان:

firebase::Future<void> result = ad_view->Show();

أحداث الإعلانات

توفّر حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" بلغة C++ فئة 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
320×50 بانر الهواتف والأجهزة اللوحية kBanner
100x320 بانر كبير الهواتف والأجهزة اللوحية kLargeBanner
300×250 مستطيل IAB متوسط الهواتف والأجهزة اللوحية kMediumRectangle
468×60 بانر IAB بالحجم الكامل الأجهزة اللوحية kFullBanner
728×90 قائمة صدارة IAB الأجهزة اللوحية kLeaderboard
العرض المقدَّم × الارتفاع التكيُّفي إعلان بانر تكيُّفي الهواتف والأجهزة اللوحية لا ينطبق

أحجام الإعلانات المخصّصة

لتحديد حجم بانر مخصّص، اضبط الأبعاد المطلوبة باستخدام أداة إنشاء firebase::gma::AdSize مع مَعلمتَي العرض والارتفاع، كما هو موضّح هنا:

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

مراجع إضافية

مثال على GitHub

قصص النجاح