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

Tek yüklemeli API'ye sahip SDK.

Uygulama açılış reklamları, uygulama yükleme ekranlarından para kazanmak isteyen yayıncılara yönelik özel bir reklam biçimidir. Uygulama açılış reklamları herhangi bir zamanda kapatılabilir ve kullanıcılarınız uygulamanızı ön plana getirdiğinde gösterilecek şekilde tasarlanmıştır.

Daha fazla bilgi için Uygulama açılış reklamlarıyla ilgili yönergeler başlıklı makaleyi inceleyin.

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

Ön koşullar

GMA Next-Gen SDK kurulumunu yapın.

Her zaman test reklamlarıyla test yapın

Uygulamalarınızı oluşturup test ederken etkin ve oluşturulma aşamasındaki reklamlar yerine test reklamlarını kullandığınızdan emin olun. Bu işlemi yapmazsanız hesabınız askıya alınabilir.

Test reklamlarını yüklemek için Android uygulama açılış reklamlarına özel test reklam birimi kimliğini kullanın:

ca-app-pub-3940256099942544/9257395921

Bu reklam birimi kimliği, her istek için test reklamları döndürecek şekilde özel olarak yapılandırılmıştır. Kodlama, test etme ve hata ayıklama sırasında kendi uygulamalarınızda kullanabilirsiniz. Uygulamanızı yayınlamadan önce bu kimliği kendi reklam birimi kimliğinizle değiştirdiğinizden emin olun.

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ın nasıl yükleneceği gösterilmektedir:

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 test reklam birimi kimliğini kullanın: ca-app-pub-3940256099942544/9257395921.

Reklamı gösterme

Uygulama açılış reklamı göstermek için show yöntemini kullanın.

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

Reklam etkinliklerini dinleme

Reklamı göstermeden önce reklam yaşam döngüsü etkinliklerini dinleyin:

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

Soğuk başlatmalar ve yükleme ekranları

Sıfırdan başlatma, uygulamanız sıfırdan başlatıldığında (ör. kullanıcı uygulamanızı ilk kez açtığında veya bellek sonlandırıldıktan sonra) gerçekleşir. Baştan başlatma sırasında, daha önce yüklenmiş ve hemen gösterilmeye hazır bir uygulama açılış reklamınız yoktur.

Reklam isteğindeki gecikmeler nedeniyle kullanıcılar, uygulama açılış reklamı görünmeden önce uygulamanızla etkileşime geçebilir. Kullanıcı deneyiminin kötü olmaması için uygulama açılış reklamlarını, uygulama öğeleri yüklenirken yalnızca yükleme ekranında gösterin. Öğe yükleme tamamlanırsa ve kullanıcı reklam yüklenmeden 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ığına yükleyin.

En iyi uygulamalar

Uygulama açılış reklamlarıyla ilgili şu en iyi uygulamaları deneyin:

  • İlk uygulama açılış reklamınızı yalnızca kullanıcı uygulamanızı birkaç kez açtıktan sonra gösterin.
  • Uygulama açılış reklamlarını yalnızca kullanıcılar uygulamanızın yüklenmesini beklerken gösterin.
  • Yükleme ekranınız, reklam gösterilirken yüklemeyi tamamlarsa reklam kapatıldı geri çağırma yönteminde yükleme ekranını kapatın.