تبلیغات بینابینی


تبلیغات بینابینی، تبلیغات تمام صفحه‌ای هستند که رابط کاربری یک برنامه را تا زمانی که توسط کاربر بسته شود، می‌پوشانند. آن‌ها معمولاً در نقاط انتقال طبیعی در جریان یک برنامه، مانند بین فعالیت‌ها یا در طول مکث بین سطوح یک بازی، نمایش داده می‌شوند. وقتی یک برنامه یک تبلیغ بینابینی را نشان می‌دهد، کاربر می‌تواند انتخاب کند که یا روی تبلیغ ضربه بزند و به مقصد خود ادامه دهد یا آن را ببندد و به برنامه بازگردد. مطالعه موردی .

این راهنما به شما نشان می‌دهد که چگونه با استفاده از Google Mobile Ads C++ SDK، تبلیغات بینابینی را در برنامه‌های اندروید و iOS ادغام کنید.

پیش‌نیازها

همیشه با تبلیغات آزمایشی تست کنید

هنگام ساخت و آزمایش برنامه‌های خود، مطمئن شوید که از تبلیغات آزمایشی به جای تبلیغات زنده و تولیدی استفاده می‌کنید. عدم انجام این کار می‌تواند منجر به مسدود شدن حساب شما شود.

ساده‌ترین راه برای بارگذاری تبلیغات آزمایشی، استفاده از شناسه واحد تبلیغات آزمایشی اختصاصی ما برای تبلیغات بینابینی است که در هر پلتفرم دستگاه متفاوت است:

  • اندروید: ca-app-pub-3940256099942544/1033173712
  • iOS: ca-app-pub-3940256099942544/4411468910

آنها به طور ویژه پیکربندی شده‌اند تا برای هر درخواست، تبلیغات آزمایشی را برگردانند و شما می‌توانید هنگام کدنویسی، آزمایش و اشکال‌زدایی از آنها در برنامه‌های خود استفاده کنید. فقط قبل از انتشار برنامه، مطمئن شوید که آن را با شناسه واحد تبلیغاتی خود جایگزین می‌کنید.

برای اطلاعات بیشتر در مورد نحوه عملکرد تبلیغات آزمایشی SDK تبلیغات موبایل، به بخش تبلیغات آزمایشی مراجعه کنید.

پیاده‌سازی

مراحل اصلی برای ادغام تبلیغات بینابینی عبارتند از:

  1. یک تبلیغ بارگذاری کنید.
  2. برای تماس‌های برگشتی ثبت‌نام کنید.
  3. نمایش تبلیغ و مدیریت رویدادهای چرخه حیات آن.

پیکربندی یک InterstitialAd

تبلیغات بینابینی در اشیاء InterstitialAd نمایش داده می‌شوند، بنابراین اولین قدم برای ادغام تبلیغات بینابینی در برنامه شما، ایجاد و مقداردهی اولیه یک شیء InterstitialAd است.

  1. هدر زیر را به کد C++ برنامه خود اضافه کنید:

     #include "firebase/gma/interstial_ad.h"

  2. یک شیء InterstitialAd را تعریف و نمونه‌سازی کنید:

     firebase::gma::InterstitialAd* interstitial_ad;
 interstitial_ad = new firebase::gma::InterstitialAd();

  3. نمونه InterstitialAd را با استفاده از نمای والد خود که به نوع AdParent تبدیل شده است، مقداردهی اولیه کنید. نمای والد یک ارجاع JNI jobject به یک Activity اندروید یا یک اشاره‌گر به یک UIView iOS است.

    // 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<void> result = interstitial_ad->Initialize(ad_parent);

  4. به عنوان جایگزینی برای حفظ آینده به عنوان یک متغیر، می‌توانید به صورت دوره‌ای وضعیت عملیات مقداردهی اولیه را با فراخوانی InitializeLastResult() روی شیء InterstitialAd بررسی کنید. این می‌تواند برای پیگیری فرآیند مقداردهی اولیه در حلقه بازی سراسری شما مفید باشد.

    // Monitor the status of the future in your game loop:
firebase::Future<void> result = interstitial_ad->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.
}

برای اطلاعات بیشتر در مورد کار با firebase::Future ، به بخش «استفاده از Futures برای نظارت بر وضعیت تکمیل فراخوانی‌های متد» مراجعه کنید.

بارگذاری یک تبلیغ

بارگذاری یک تبلیغ با استفاده از متد LoadAd() روی شیء InterstitialAd انجام می‌شود. متد load مستلزم آن است که شیء InterstitialAd را مقداردهی اولیه کرده باشید و شناسه واحد تبلیغ و یک شیء AdRequest داشته باشید. یک firebase::Future برگردانده می‌شود که می‌توانید از آن برای نظارت بر وضعیت و نتیجه عملیات بارگذاری استفاده کنید.

کد زیر نحوه بارگذاری یک تبلیغ را پس از راه‌اندازی موفقیت‌آمیز InterstitialAd نشان می‌دهد:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult>