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

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

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

• أكمِل البدء.
• (نظام التشغيل Android فقط) يجب أن تكون على دراية بالعمل مع مراجع JNI jobject (اطّلِع على نصائح حول JNI في Android).

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

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

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

• نظام تشغيل 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 عرض والد. العرض الرئيسي هو jobject JNI يشير إلى 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 اختياري، لذا ما عليك سوى تنفيذ 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);

أحجام البانر

يسرد الجدول أدناه أحجام البانر العادية.

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

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

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

مراجع إضافية

مثال في GitHub

• يمكنك الاطّلاع على رمز المصدر لتطبيق مثال على تطبيق التشغيل السريع في GitHub.

قصص النجاح

• نموذج حالة استخدام