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

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

برای اطلاعات بیشتر، به راهنمای آگهی باز کردن برنامه مراجعه کنید.

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

پیش‌نیازها

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

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

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

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

ca-app-pub-3940256099942544/9257395921

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

برای جزئیات مربوط به 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.
        }
      });
}

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

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

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

دارایی‌های برنامه را در رشته پس‌زمینه‌ای بار کنید تا بار کردن درحین نمایش آگهی ادامه یابد.

روال‌های مطلوب

این روال‌های مطلوب را برای تبلیغات باز کردن برنامه دنبال کنید:

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