Tek bir uygulama açılış reklamı yükleme

Uygulama açılış reklamları, uygulama yükleme ekranlarından para kazanmak isteyen yayıncılara yönelik bir reklam biçimidir. Kullanıcılarınız uygulama açılış reklamlarını istedikleri zaman kapatabilir. Kullanıcılar uygulamanızı ön plana getirdiğinde uygulama açılış reklamlarını gösterin.

Daha fazla bilgi için Uygulama açılış reklamı kılavuzu başlıklı makaleyi inceleyin.

Bu kılavuzda, uygulama açılış reklamlarının bir Android uygulamasına nasıl entegre edileceği açıklanmaktadır.

Başlamadan önce

Devam etmeden önce şunları yapın:

  • GMA Next-Gen SDK kurulumu.
  • Test uygulaması açılış reklam birimi kimliğini (ca-app-pub-3940256099942544/9257395921) kullanın.
    • Uygulamanızı oluştururken ve test ederken, yayındaki üretim reklamları yerine test reklamlarını kullandığınızdan emin olun. Test reklam birimi kimliğini kullanmazsanız Google, hesabınızı askıya alabilir.
    • Uygulamanızı yayınlamadan önce bu kimliği reklam birimi kimliğinizle değiştirin.
    • GMA Next-Gen SDK test reklamları hakkında ayrıntılı bilgi için Test reklamlarını etkinleştirme başlıklı makaleyi inceleyin.

Reklam yükleme

Aşağıdaki örnekte tek bir reklam yüklenmektedir:

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

Java

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

Test sırasında şu test reklam birimi kimliğini kullanın: ca-app-pub-3940256099942544/9257395921.

Reklamı göster

Uygulama açılış reklamı göstermek için show yöntemini çağırın. Uygulama açılış reklamlarının süresi, yüklendikten dört saat sonra dolar. Dört saatten uzun süredir yüklenen uygulama açılış reklamlarını göstermeyin.

Aşağıdaki örnekte reklam gösterilmektedir:

Kotlin

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

Java

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

Baştan başlatma ve yükleme ekranlarını yönetme

Baştan başlatma, uygulamanız diskten başlatıldığında gerçekleşir. Hazır durumda başlatma ise uygulamayı bellekten yeniden açtığınızda gerçekleşir. Soğuk başlatma sırasında, gösterilecek önceden yüklenmiş bir reklamınız yoktur. Sıcak başlatma sırasında, gösterilecek yüklü bir reklamınız olabilir.

Sıfırdan başlatma sırasında kullanıcılar, uygulamanız yüklenip reklam göstermeden önce uygulamanızla etkileşime geçebilir. Kötü bir kullanıcı deneyimini önlemek için uygulama açılış reklamlarını, uygulama öğeleri yüklenirken yalnızca yükleme ekranından baştan başlatmalarda gösterin. Kullanıcılarınız uygulamanızın yüklenmesini beklerken uygulama açılış reklamları gösterin. Uygulama ilk kez başlatıldığında uygulama açılış reklamı göstermeyin. Öğe yükleme işlemi tamamlanırsa ve kullanıcılar reklam yüklenmeden önce ana içeriğe ulaşırsa reklamı göstermeyin.

Reklam gösterilirken yüklemenin devam etmesi için uygulama öğelerini arka plan iş parçacığında yükleyin. Reklam gösterilirken yükleme ekranınızın yüklenmesi tamamlanırsa reklam kapatıldı geri çağırma yönteminde yükleme ekranını kapatın.

Reklam etkinliklerini dinleme

Reklamı göstermeden önce reklam yaşam döngüsü olaylarını dinleyin. Aşağıdaki örnekte, reklam etkinlikleri için geri çağırmalar kaydedilmektedir:

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

Java

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