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

SDK با API تک بارگذاری.

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

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

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

پیش‌نیازها

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

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

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

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

ca-app-pub-3940256099942544/9257395921

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

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

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

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

کاتلین 

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

کاتلین 

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

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

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

کاتلین 

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

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

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

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

فایل‌های برنامه را در یک رشته پس‌زمینه بارگذاری کنید تا بارگیری در حین نمایش تبلیغ ادامه یابد.

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

برای تبلیغات باز اپلیکیشن، این بهترین شیوه‌ها را دنبال کنید:

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