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

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

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

پیش‌نیازها

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

همیشه با آگهی‌های آزمایشی آزمایش کنید

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

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

ca-app-pub-3940256099942544/1033173712

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

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

بار کردن آگهی

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

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

Kotlin

// 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 استفاده کنید.

Kotlin

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);
}

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

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

Kotlin

// 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.
      }
    });