تبلیغات باز برنامه

پلتفرم مورد نظر: اندروید، iOS، یونیتی ، فلاتر

این راهنما برای ناشرانی در نظر گرفته شده است که تبلیغات باز برنامه را با استفاده از SDK تبلیغات موبایلی گوگل ادغام می‌کنند.

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

تبلیغات باز شدن اپلیکیشن به طور خودکار یک ناحیه کوچک از برند را نشان می‌دهند تا کاربران متوجه شوند که در اپلیکیشن شما هستند. در اینجا مثالی از ظاهر یک تبلیغ باز شدن اپلیکیشن آورده شده است:

پیش‌نیازها

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

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

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

/21775744923/example/app-open

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

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

کلاس Application را گسترش دهید

یک کلاس جدید ایجاد کنید که کلاس Application را ارث‌بری کند. این یک روش آگاه از چرخه حیات برای مدیریت تبلیغاتی فراهم می‌کند که به جای یک Activity واحد، به وضعیت برنامه گره خورده‌اند:

جاوا

public class MyApplication extends Application
    implements ActivityLifecycleCallbacks, DefaultLifecycleObserver {

  private AppOpenAdManager appOpenAdManager;
  private Activity currentActivity;

  @Override
  public void onCreate() {
    super.onCreate();
    this.registerActivityLifecycleCallbacks(this);

    ProcessLifecycleOwner.get().getLifecycle().addObserver(this);
    appOpenAdManager = new AppOpenAdManager();
  }

کاتلین

class MyApplication :
  MultiDexApplication(), Application.ActivityLifecycleCallbacks, DefaultLifecycleObserver {

  private lateinit var appOpenAdManager: AppOpenAdManager
  private var currentActivity: Activity? = null

  override fun onCreate() {
    super<MultiDexApplication>.onCreate()
    registerActivityLifecycleCallbacks(this)

    ProcessLifecycleOwner.get().lifecycle.addObserver(this)
    appOpenAdManager = AppOpenAdManager()
  }

سپس، کد زیر را به AndroidManifest.xml خود اضافه کنید:

<!-- TODO: Update to reference your actual package name. -->
<application
    android:name="com.google.android.gms.example.appopendemo.MyApplication" ...>
...
</application>

کامپوننت کاربردی خود را پیاده‌سازی کنید

تبلیغ شما باید به سرعت نمایش داده شود، بنابراین بهتر است قبل از اینکه نیاز به نمایش آن باشد، آن را بارگذاری کنید. به این ترتیب، به محض ورود کاربر به برنامه، تبلیغ آماده نمایش خواهد بود.

یک کامپوننت کاربردی AppOpenAdManager پیاده‌سازی کنید تا کار مربوط به بارگذاری و نمایش تبلیغات App Open را کپسوله‌سازی کند:

جاوا

private class AppOpenAdManager {

  private static final String LOG_TAG = "AppOpenAdManager";
  private static final String AD_UNIT_ID = "/21775744923/example/app-open";

  private AppOpenAd appOpenAd = null;
  private boolean isLoadingAd = false;
  private boolean isShowingAd = false;

  /** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
  private long loadTime = 0;

  /** Constructor. */
  public AppOpenAdManager() {}

کاتلین

private inner class AppOpenAdManager {

  private val googleMobileAdsConsentManager =
  private var appOpenAd: AppOpenAd? = null
  private var isLoadingAd = false
  var isShowingAd = false

  /** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
  private var loadTime: Long = 0

برای استفاده از AppOpenAdManager ، متدهای عمومی wrapper را در نمونه‌ی تک‌لایتونی MyApplication فراخوانی کنید. کلاس Application با بقیه‌ی کد ارتباط برقرار می‌کند و کار بارگذاری و نمایش تبلیغ را به manager واگذار می‌کند.

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

مرحله بعدی پر کردن متد loadAd() و مدیریت فراخوانی‌های بارگذاری تبلیغات است.

جاوا

AppOpenAd.load(
    context,
    "AD_UNIT_ID",
    new AdManagerAdRequest.Builder().build(),
    new AppOpenAdLoadCallback() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // Called when an app open ad has loaded.
        Log.d(LOG_TAG, "App open ad loaded.");

        appOpenAd = ad;
        isLoadingAd = false;
        loadTime = (new Date()).getTime();
      }

      @Override
      public void onAdFailedToLoad(LoadAdError loadAdError) {
        // Called when an app open ad has failed to load.
        Log.d(LOG_TAG, "App open ad failed to load with error: " + loadAdError.getMessage());

        isLoadingAd = false;
      }
    });

کاتلین

AppOpenAd.load(
  context,
  "AD_UNIT_ID",
  AdManagerAdRequest.Builder().build(),
  object : AppOpenAdLoadCallback() {
    override fun onAdLoaded(ad: AppOpenAd) {
      // Called when an app open ad has loaded.
      Log.d(LOG_TAG, "App open ad loaded.")

      appOpenAd = ad
      isLoadingAd = false
      loadTime = Date().time
    }

    override fun onAdFailedToLoad(loadAdError: LoadAdError) {
      // Called when an app open ad has failed to load.
      Log.d(LOG_TAG, "App open ad failed to load with error: " + loadAdError.message)

      isLoadingAd = false
    }
  },
)

AD_UNIT_ID با شناسه واحد تبلیغاتی خود جایگزین کنید.

نمایش تبلیغ

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

کد زیر یک تبلیغ را نمایش داده و متعاقباً آن را بارگذاری مجدد می‌کند:

جاوا

public void showAdIfAvailable(
    @NonNull final Activity activity,
    @NonNull OnShowAdCompleteListener onShowAdCompleteListener) {
  // If the app open ad is already showing, do not show the ad again.
  if (isShowingAd) {
    Log.d(TAG, "The app open ad is already showing.");
    return;
  }

  // If the app open ad is not available yet, invoke the callback then load the ad.
  if (appOpenAd == null) {
    Log.d(TAG, "The app open ad is not ready yet.");
    onShowAdCompleteListener.onShowAdComplete();
    // Load an ad.
    return;
  }

  isShowingAd = true;
  appOpenAd.show(activity);
}

کاتلین

fun showAdIfAvailable(activity: Activity, onShowAdCompleteListener: OnShowAdCompleteListener) {
  // If the app open ad is already showing, do not show the ad again.
  if (isShowingAd) {
    Log.d(TAG, "The app open ad is already showing.")
    return
  }

  // If the app open ad is not available yet, invoke the callback then load the ad.
  if (appOpenAd == null) {
    Log.d(TAG, "The app open ad is not ready yet.")
    onShowAdCompleteListener.onShowAdComplete()
    // Load an ad.
    return
  }

  isShowingAd = true
  appOpenAd?.show(activity)
}

تنظیم FullScreenContentCallback

تابع FullScreenContentCallback رویدادهای مربوط به نمایش AppOpenAd شما را مدیریت می‌کند. قبل از نمایش AppOpenAd ، حتماً تابع callback را تنظیم کنید:

جاوا

appOpenAd.setFullScreenContentCallback(
    new FullScreenContentCallback() {
      @Override
      public void onAdDismissedFullScreenContent() {
        // Called when full screen content is dismissed.
        Log.d(TAG, "Ad dismissed fullscreen content.");
        // Don't forget to set the ad reference to null so you
        // don't show the ad a second time.
        appOpenAd = null;
        isShowingAd = false;

        onShowAdCompleteListener.onShowAdComplete();
        // Load an ad.
      }

      @Override
      public void onAdFailedToShowFullScreenContent(@NonNull AdError adError) {
        // Called when full screen content failed to show.
        Log.d(TAG, adError.getMessage());
        appOpenAd = null;
        // Don't forget to set the ad reference to null so you
        // don't show the ad a second time.
        isShowingAd = false;

        onShowAdCompleteListener.onShowAdComplete();
        // Load an ad.
      }

      @Override
      public void onAdShowedFullScreenContent() {
        Log.d(TAG, "Ad showed fullscreen content.");
      }

      @Override
      public void onAdImpression() {
        // Called when an impression is recorded for an ad.
        Log.d(TAG, "The ad recorded an impression.");
      }

      @Override
      public void onAdClicked() {
        // Called when ad is clicked.
        Log.d(TAG, "The ad was clicked.");
      }
    });

کاتلین

appOpenAd?.fullScreenContentCallback =
  object : FullScreenContentCallback() {
    override fun onAdDismissedFullScreenContent() {
      // Called when full screen content is dismissed.
      Log.d(TAG, "Ad dismissed fullscreen content.")
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      appOpenAd = null
      isShowingAd = false

      onShowAdCompleteListener.onShowAdComplete()
      // Load an ad.
    }

    override fun onAdFailedToShowFullScreenContent(adError: AdError) {
      // Called when full screen content failed to show.
      Log.d(TAG, adError.message)
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      appOpenAd = null
      isShowingAd = false

      onShowAdCompleteListener.onShowAdComplete()
      // Load an ad.
    }

    override fun onAdShowedFullScreenContent() {
      Log.d(TAG, "Ad showed fullscreen content.")
    }

    override fun onAdImpression() {
      // Called when an impression is recorded for an ad.
      Log.d(TAG, "The ad recorded an impression.")
    }

    override fun onAdClicked() {
      // Called when ad is clicked.
      Log.d(TAG, "The ad was clicked.")
    }
  }

انقضای تبلیغ را در نظر بگیرید

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

جاوا

/** Check if ad was loaded more than n hours ago. */
private boolean wasLoadTimeLessThanNHoursAgo(long numHours) {
  long dateDifference = (new Date()).getTime() - loadTime;
  long numMilliSecondsPerHour = 3600000;
  return (dateDifference < (numMilliSecondsPerHour * numHours));
}

/** Check if ad exists and can be shown. */
private boolean isAdAvailable() {
  // For time interval details, see: https://support.google.com/admob/answer/9341964
  return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4);
}

کاتلین

/** Check if ad was loaded more than n hours ago. */
private fun wasLoadTimeLessThanNHoursAgo(numHours: Long): Boolean {
  val dateDifference: Long = Date().time - loadTime
  val numMilliSecondsPerHour: Long = 3600000
  return dateDifference < numMilliSecondsPerHour * numHours
}

/** Check if ad exists and can be shown. */
private fun isAdAvailable(): Boolean {
  // For time interval details, see: https://support.google.com/admob/answer/9341964
  return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4)
}

پیگیری فعالیت‌های فعلی

برای نمایش تبلیغ، به یک زمینه Activity نیاز دارید. برای پیگیری جدیدترین فعالیت مورد استفاده، Application.ActivityLifecycleCallbacks را ثبت و پیاده‌سازی کنید.

جاوا

@Override
public void onActivityCreated(@NonNull Activity activity, @Nullable Bundle savedInstanceState) {}

@Override
public void onActivityStarted(@NonNull Activity activity) {
  // An ad activity is started when an ad is showing, which could be AdActivity class from Google
  // SDK or another activity class implemented by a third party mediation partner. Updating the
  // currentActivity only when an ad is not showing will ensure it is not an ad activity, but the
  // one that shows the ad.
  if (!appOpenAdManager.isShowingAd) {
    currentActivity = activity;
  }
}

@Override
public void onActivityResumed(@NonNull Activity activity) {}

@Override
public void onActivityPaused(@NonNull Activity activity) {}

@Override
public void onActivityStopped(@NonNull Activity activity) {}

@Override
public void onActivitySaveInstanceState(@NonNull Activity activity, @NonNull Bundle outState) {}

@Override
public void onActivityDestroyed(@NonNull Activity activity) {}

کاتلین

override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}

override fun onActivityStarted(activity: Activity) {
  // An ad activity is started when an ad is showing, which could be AdActivity class from Google
  // SDK or another activity class implemented by a third party mediation partner. Updating the
  // currentActivity only when an ad is not showing will ensure it is not an ad activity, but the
  // one that shows the ad.
  if (!appOpenAdManager.isShowingAd) {
    currentActivity = activity
  }
}

override fun onActivityResumed(activity: Activity) {}

override fun onActivityPaused(activity: Activity) {}

override fun onActivityStopped(activity: Activity) {}

override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}

override fun onActivityDestroyed(activity: Activity) {}

registerActivityLifecycleCallbacks به شما امکان می‌دهد به تمام رویدادهای Activity گوش دهید. با گوش دادن به زمان شروع و پایان activityها، می‌توانید ارجاعی به Activity فعلی را پیگیری کنید که بعداً در ارائه تبلیغات باز برنامه خود از آن استفاده خواهید کرد.

به رویدادهای برجسته‌سازی برنامه گوش دهید

برای گوش دادن به رویدادهای پیش‌زمینه برنامه، مراحل زیر را انجام دهید:

کتابخانه‌ها را به فایل gradle خود اضافه کنید

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

کاتلین

  dependencies {
    implementation("com.google.android.gms:play-services-ads:24.7.0")
    implementation("androidx.lifecycle:lifecycle-process:2.8.3")
  }

گرووی

  dependencies {
    implementation 'com.google.android.gms:play-services-ads:24.7.0'
    implementation 'androidx.lifecycle:lifecycle-process:2.8.3'
  }

رابط ناظر چرخه عمر را پیاده‌سازی کنید

شما می‌توانید با پیاده‌سازی رابط DefaultLifecycleObserver به رویدادهای پیش‌زمینه‌سازی (foregrounding events) گوش دهید.

onStart() را برای نمایش تبلیغ هنگام باز شدن برنامه پیاده‌سازی کنید.

جاوا

@Override
public void onStart(@NonNull LifecycleOwner owner) {
  DefaultLifecycleObserver.super.onStart(owner);
  appOpenAdManager.showAdIfAvailable(currentActivity);
}

کاتلین

override fun onStart(owner: LifecycleOwner) {
  super.onStart(owner)
  currentActivity?.let {
    // Show the ad (if available) when the app moves to foreground.
    appOpenAdManager.showAdIfAvailable(it)
  }
}

صفحه‌های شروع سرد و بارگیری

تاکنون مستندات فرض می‌کنند که شما فقط زمانی تبلیغات باز بودن برنامه را نشان می‌دهید که کاربران برنامه شما را در حالت تعلیق در حافظه، در پیش‌زمینه قرار می‌دهند. «شروع سرد» زمانی اتفاق می‌افتد که برنامه شما راه‌اندازی می‌شود اما قبلاً در حافظه معلق نبوده است.

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

روش ترجیحی برای استفاده از تبلیغات باز برنامه در شروع سرد، استفاده از یک صفحه بارگذاری برای بارگذاری محتوای بازی یا برنامه شما و نمایش تبلیغ فقط از صفحه بارگذاری است. اگر بارگیری برنامه شما کامل شده و کاربر را به محتوای اصلی برنامه هدایت کرده است، تبلیغ را نشان ندهید.

بهترین شیوه‌ها

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

  • اولین تبلیغ باز برنامه خود را پس از اینکه کاربران چند بار از برنامه شما استفاده کردند، نمایش دهید.
  • تبلیغات باز شدن برنامه را در زمان‌هایی نمایش دهید که کاربران شما در غیر این صورت منتظر بارگذاری برنامه شما هستند.
  • اگر یک صفحه بارگذاری زیر تبلیغ باز برنامه دارید و صفحه بارگذاری شما قبل از اینکه تبلیغ بسته شود، بارگذاری را کامل می‌کند، می‌توانید صفحه بارگذاری خود را با استفاده از متد onAdDismissedFullScreenContent() بسته کنید.

مثال‌ها در گیت‌هاب

مراحل بعدی

مباحث زیر را بررسی کنید: