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

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

این راهنما نحوه ادغام تبلیغات بینابینی در یک برنامه اندروید را توضیح می‌دهد.

پیش‌نیازها

GMA Next-Gen SDK را راه‌اندازی کنید .

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

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

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

ca-app-pub-3940256099942544/1033173712

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

برای جزئیات بیشتر در مورد تبلیغات آزمایشی GMA Next-Gen SDK ، به فعال کردن تبلیغات آزمایشی مراجعه کنید.

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

توجه: برای بهینه‌سازی تأخیر نمایش تبلیغات برای چندین تبلیغ، می‌توانید از پیش‌بارگذاری تبلیغات استفاده کنید.

مثال زیر نحوه بارگذاری یک تبلیغ واحد را به شما نشان می‌دهد:

کاتلین

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

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

جاوا

// Load ads after you initialize MobileAds.
InterstitialAd.load(
    new AdRequest.Builder(adUnitId).build(),
    new AdLoadCallback<InterstitialAd>() {
      @Override
      public void onAdLoaded(@NonNull InterstitialAd ad) {
        // Interstitial ad loaded.
        interstitialAd = ad;
      }

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

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

نمایش تبلیغ

برای نمایش یک تبلیغ بینابینی، از متد show استفاده کنید.

کاتلین

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

جاوا

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

به رویدادهای تبلیغاتی گوش دهید

قبل از نمایش تبلیغ، به رویدادهای چرخه عمر تبلیغ گوش دهید:

کاتلین

// Listen for ad events.
val ad = interstitialAd
if (ad == null) {
  Log.e(TAG, "Interstitial ad is not ready yet.")
  return
}

ad.adEventCallback =
  object : InterstitialAdEventCallback {
    override fun onAdShowedFullScreenContent() {
      // Interstitial ad did show.
    }

    override fun onAdDismissedFullScreenContent() {
      // Interstitial ad did dismiss.
      interstitialAd = null
    }

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

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

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

جاوا

// Listen for ad events.
if (interstitialAd == null) {
  Log.e(TAG, "Interstitial ad is not ready yet.");
  return;
}

interstitialAd.setAdEventCallback(
    new InterstitialAdEventCallback() {
      @Override
      public void onAdShowedFullScreenContent() {
        // Interstitial ad did show.
      }

      @Override
      public void onAdDismissedFullScreenContent() {
        // Interstitial ad did dismiss.
        interstitialAd = null;
      }

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

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

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