بار کردن یک آگهی باز برنامه

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

برای اطلاعات بیشتر، راهنمای آگهی در صفحه باز شدن برنامه را ببینید.

این راهنما نحوه ادغام آگهی‌های باز شدن برنامه را در برنامه Android توضیح می‌دهد.

قبل‌از شروع

پیش‌از ادامه دادن، کارهای زیر را انجام دهید:

  • GMA Next-Gen SDK را راه‌اندازی کنید.
  • از شناسه واحد آگهی آزمایشی در صفحه باز شدن برنامه ca-app-pub-3940256099942544/9257395921 استفاده کنید.
    • هنگام ساختن و آزمایش کردن برنامه‌تان، مطمئن شوید که از آگهی‌های آزمایشی استفاده می‌کنید نه آگهی‌های زنده و تولیدی. اگر از شناسه واحد آگهی آزمایشی استفاده نکنید، Google می‌تواند حسابتان را تعلیق کند.
    • قبل‌از انتشار برنامه‌تان، این شناسه را با شناسه واحد آگهی‌تان جایگزین کنید.
    • برای جزئیات درباره آگهی‌های آزمایشی GMA Next-Gen SDK، به فعال کردن آگهی‌های آزمایشی مراجعه کنید.

بار کردن آگهی

مثال زیر یک آگهی را بار می‌کند:

Kotlin

// Load ads after you initialize MobileAds.
AppOpenAd.load(
  AdRequest.Builder(adUnitId).build(),
  object : AdLoadCallback<AppOpenAd> {
    override fun onAdLoaded(ad: AppOpenAd) {
      // App open ad loaded.
      appOpenAd = ad
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {
      // App open ad failed to load.
      Log.e(TAG, "App open ad failed to load: ${adError.message}")
      appOpenAd = null
    }
  },
)

جاوا

// Load ads after you initialize MobileAds.
AppOpenAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<AppOpenAd>() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // App open ad loaded.
        appOpenAd = ad;
      }

      @Override
      public void onAdFailedToLoad(LoadAdError adError) {
        // App open ad failed to load.
        Log.e(TAG, "App open ad failed to load: " + adError.getMessage());
        appOpenAd = null;
      }
    });

هنگام آزمایش، از شناسه واحد آگهی آزمایشی استفاده کنید: ca-app-pub-3940256099942544/9257395921.

نمایش آگهی

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

مثال زیر آگهی را نمایش می‌دهد:

Kotlin

private fun showAd(appOpenAd: AppOpenAd, activity: Activity) {
  // Show the ad.
  appOpenAd.show(activity)
}

جاوا

private void showAd(AppOpenAd appOpenAd, Activity activity) {
  // Show the ad.
  appOpenAd.show(activity);
}

مدیریت شروع سرد و صفحه‌های بار کردن

شروع سرد زمانی اتفاق می‌افتد که برنامه شما از دیسک راه‌اندازی می‌شود و شروع گرم زمانی اتفاق می‌افتد که برنامه را از حافظه دوباره باز می‌کنید. درطول راه‌اندازی سرد، آگهی‌ای که قبلاً بار شده باشد برای نمایش دردسترس ندارید. درطول راه‌اندازی گرم، ممکن است همچنان آگهی بارشده‌ای برای نمایش دردسترس داشته باشید.

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

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

گوش دادن به رویدادهای آگهی

قبل‌از نمایش آگهی، به رویدادهای چرخه حیات آگهی گوش دهید. مثال زیر برگشت فراخوانی‌ها را برای رویدادهای آگهی ثبت می‌کند:

Kotlin

private fun listenToAdEvents() {
  // Listen for ad events.
  val ad = appOpenAd
  if (ad == null) {
    Log.e(TAG, "App open ad is not ready yet.")
    return
  }

  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // App open ad did show.
      }

      override fun onAdDismissedFullScreenContent() {
        // App open ad did dismiss.
        appOpenAd = null
      }

      override fun onAdFailedToShowFullScreenContent(
        fullScreenContentError: FullScreenContentError
      ) {
        // App open ad failed to show.
        Log.e(TAG, "App open ad failed to show: ${fullScreenContentError.message}")
      }

      override fun onAdImpression() {
        // App open ad did record an impression.
      }

      override fun onAdClicked() {
        // App open ad did record a click.
      }
    }
}

جاوا

private void listenToAdEvents() {
  // Listen for ad events.
  if (appOpenAd == null) {
    Log.e(TAG, "App open ad is not ready yet.");
    return;
  }

  appOpenAd.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdShowedFullScreenContent() {
          // App open ad did show.
        }

        @Override
        public void onAdDismissedFullScreenContent() {
          // App open ad did dismiss.
          appOpenAd = null;
        }

        @Override
        public void onAdFailedToShowFullScreenContent(
            @NonNull FullScreenContentError fullScreenContentError) {
          // App open ad failed to show.
          Log.e(TAG, "App open ad failed to show: " + fullScreenContentError.getMessage());
        }

        @Override
        public void onAdImpression() {
          // App open ad did record an impression.
        }

        @Override
        public void onAdClicked() {
          // App open ad did record a click.
        }
      });
}