Uygulama açılış reklamlarını ayarlama

SDK.

Platform seçin: Android iOS Unity Flutter Android (Eski)

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

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.

Başlamadan önce

Devam etmeden önce aşağıdakileri yapın:

  • GMA Next-Gen SDK kurulumunu yapın.
  • Test uygulama açılış reklamı birimi kimliğini ca-app-pub-3940256099942544/9257395921 kullanın.
    • Uygulamanızı oluşturup test ederken etkin ve oluşturulma aşamasındaki 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 ön yüklemesini anlama

GMA Next-Gen SDK içinde reklam önceden yükleme, reklam yükleme ve önbelleğe alma işlemlerini otomatikleştirir.

Reklam önceden yükleme aşağıdaki avantajları sağlar:

  • Referans yönetimi: Reklamlar gösterilene kadar referansları korur.
  • Otomatik yeniden yükleme: Önbellekten bir reklam alındığında yeni bir reklam yükler.
  • Yönetilen yeniden denemeler: Bir reklam yüklenemediğinde yeni bir reklam yükler.
  • Geçerlilik süresi yönetimi: Reklamları geçerlilik süreleri dolmadan önce yeniler.
  • Önbellek optimizasyonu: En yüksek öncelikli reklamı yayınlamak için önbellek sırasını optimize eder.

Reklam ön yüklemesini başlatma

Reklamları önceden yüklemeye başlamak için startPreload() yöntemini uygulama başlangıcında bir kez çağırın. startPreload() yöntemini çağırdıktan sonra, GMA Next-Gen SDK reklamlar otomatik olarak önceden yüklenir ve önceden yüklenmiş yapılandırmalar için başarısız olan istekler yeniden denenir.

Aşağıdaki örnekte, reklamların önceden yüklenmeye nasıl başlanacağı gösterilmektedir:

Kotlin

private fun startPreloading(adUnitId: String) {
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  AppOpenAdPreloader.start(adUnitId, preloadConfig)
}

Java

private void startPreloading(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  AppOpenAdPreloader.start(adUnitId, preloadConfig);
}

AD_UNIT_ID yerine reklam birimi kimliğinizi yazın.

Önceki örnekte, reklam birimi kimliğinin önceden yükleme kimliği olarak nasıl kullanılacağı gösterilmektedir. Önceden yükleme kimliği, reklam önceden yükleme yapılandırmasını tanımlamak için oluşturduğunuz dize tanımlayıcıdır. Uygulamanız aynı reklam birimi kimliği için birden fazla hedefleme yapılandırması gerektiriyorsa özel bir dize tanımlayıcı iletin.

Önceden yüklenmiş reklamı alma ve gösterme

Reklam göstermek istediğinizde pollAd() yöntemini çağırın. GMA Next-Gen SDK, kullanılabilir bir reklamı alır ve arka planda bir sonraki reklamı otomatik olarak önceden yükler. Reklam yoksa GMA Next-Gen SDK reklam döndürmez.

Kullanılabilir bir reklam nesneniz olduğunda reklamı göstermek için show yöntemini çağırın. Aşağıdaki örnekte, önceden yüklenmiş bir reklamın nasıl alınacağı ve gösterileceği açıklanmaktadır:

Kotlin

private fun pollAndShowAd(activity: Activity, adUnitId: String) {
  // Polling returns the next available ad and loads another ad in the background.
  val ad = AppOpenAdPreloader.pollAd(adUnitId)
  if (ad == null) {
    Log.e(TAG, "App open ad is not available.")
    return
  }

  // Interact with the ad object as needed.
  Log.d(TAG, "App open ad response info: ${ad.getResponseInfo()}")
  ad.adEventCallback =
    object : AppOpenAdEventCallback {
      override fun onAdImpression() {
        Log.d(TAG, "App open ad recorded an impression.")
      }
    }
  ad.show(activity)
}

Java

private void pollAndShowAd(Activity activity, String adUnitId) {
  // Polling returns the next available ad and loads another ad in the background.
  AppOpenAd ad = AppOpenAdPreloader.pollAd(adUnitId);

  // Interact with the ad object as needed.
  if (ad == null) {
    Log.e(TAG, "App open ad is not available.");
    return;
  }

  Log.d(TAG, "App open ad response info: " + ad.getResponseInfo());
  ad.setAdEventCallback(
      new AppOpenAdEventCallback() {
        @Override
        public void onAdImpression() {
          Log.d(TAG, "App open ad recorded an impression.");
        }
      });

  // Show the ad.
  ad.show(activity);
}

Reklam göstermeye hazır olana kadar pollAd() yöntemini çağırmaktan kaçının. Reklam yanıtı bilgilerini göstermeden okumak için Yanıt bilgilerini okuma başlıklı makaleyi inceleyin.

Reklam etkinliklerini dinleme

Reklamı göstermeden önce reklam etkinliklerini dinleyin. Aşağıdaki örnekte, reklam etkinlikleri için geri çağırma işlevlerinin nasıl kaydedileceği gösterilmektedir:

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

İsteğe bağlı: Önceden yükleme etkinliklerini dinleme

Reklamları önceden yüklemeye başladığınızda, reklamlar başarıyla önceden yüklendiğinde, önceden yüklenemediğinde veya reklam önbelleği tükendiğinde bildirim almak için önceden yükleme etkinliklerine kaydolun.

Aşağıdaki örnekte, önceden yükleme reklam etkinliklerine nasıl kaydolacağınız gösterilmektedir:

Kotlin

private fun startPreloadingWithCallback(adUnitId: String) {
  val preloadCallback =
    object : PreloadCallback {
      override fun onAdFailedToPreload(preloadId: String, adError: LoadAdError) {
        Log.d(TAG, "App open preload ad $preloadId failed to load with error: ${adError.message}")
      }

      override fun onAdsExhausted(preloadId: String) {
        Log.i(TAG, "App open preload ad $preloadId is not available")
      }

      override fun onAdPreloaded(preloadId: String, responseInfo: ResponseInfo) {
        Log.i(TAG, "App open preload ad $preloadId is available")
      }
    }
  val adRequest = AdRequest.Builder(adUnitId).build()
  val preloadConfig = PreloadConfiguration(adRequest)
  AppOpenAdPreloader.start(adUnitId, preloadConfig, preloadCallback)
}

Java

private void startPreloadingWithCallback(String adUnitId) {
  PreloadCallback preloadCallback =
      new PreloadCallback() {
        @Override
        public void onAdFailedToPreload(@NonNull String preloadId, @NonNull LoadAdError adError) {
          Log.d(
              TAG,
              String.format(
                  "App open preload ad %s failed to load with error: %s",
                  preloadId, adError.getMessage()));
        }

        @Override
        public void onAdsExhausted(@NonNull String preloadId) {
          Log.i(TAG, String.format("App open preload ad %s is not available", preloadId));
        }

        @Override
        public void onAdPreloaded(@NonNull String preloadId, @NonNull ResponseInfo responseInfo) {
          Log.i(TAG, String.format("App open preload ad %s is available", preloadId));
        }
      };
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest);
  AppOpenAdPreloader.start(adUnitId, preloadConfig, preloadCallback);
}

Bir reklam yüklenemediğinde GMA Next-Gen SDK, reklamları otomatik olarak önceden yükler ve önceden yüklenmiş yapılandırmalar için başarısız olan istekleri yeniden dener.

İsteğe bağlı: Reklamın kullanılabilirliğini kontrol edin

Bir reklamın kullanılabilir olup olmadığını öğrenmeniz gerekiyorsa reklamın kullanılabilirliğini kontrol edin. Aşağıdaki örnekte, önceden yüklenmiş bir reklamın kullanılabilir olup olmadığının nasıl kontrol edileceği gösterilmektedir:

Kotlin

private fun isAdAvailable(adUnitId: String): Boolean {
  return AppOpenAdPreloader.isAdAvailable(adUnitId)
}

Java

private boolean isAdAvailable(String adUnitId) {
  return AppOpenAdPreloader.isAdAvailable(adUnitId);
}

İsteğe bağlı: Arabellek boyutunu ayarlama

Arabellek boyutu, bellekte tutulan önceden yüklenmiş reklamların sayısını kontrol eder. Google, varsayılan olarak bellek tüketimi ile reklam yayınlama gecikmesi arasında denge kurmak için arabellek boyutunu optimize eder. Bellekte tutulan reklam sayısını artırmak için özel bir arabellek boyutu ayarlayabilirsiniz. Maksimum arabellek boyutunun dört olmasını öneririz.

Aşağıdaki örnekte, dört önceden yüklenmiş reklamın arabellek boyutunun nasıl ayarlanacağı gösterilmektedir:

Kotlin

private fun setBufferSize(adUnitId: String) {
  val adRequest = AdRequest.Builder(adUnitId).build()
  // Four is the recommended maximum buffer size.
  val preloadConfig = PreloadConfiguration(adRequest, bufferSize = 4)
  AppOpenAdPreloader.start(adUnitId, preloadConfig)
}

Java

private void setBufferSize(String adUnitId) {
  AdRequest adRequest = new AdRequest.Builder(adUnitId).build();
  // Four is the recommended maximum buffer size.
  PreloadConfiguration preloadConfig = new PreloadConfiguration(adRequest, 4);
  AppOpenAdPreloader.start(adUnitId, preloadConfig);
}

Önceden yüklenen önbellek sınırları

GMA Next-Gen SDK, tüm reklam birimleri ve önceden yükleme kimliklerinde önceden yüklenen toplam reklam sayısıyla ilgili uygulama genelinde bir sınır uygular:

  • Varsayılan sınır: Google, bellekte en fazla 6 önceden yüklenmiş reklam tutar. Bu sınır, tüm biçimler ve önceden yükleme kimlikleri arasında paylaşılır.
  • Önceden yükleme kimliği başına 2 veya 3 arabellek boyutu tutmanızı öneririz.

İsteğe bağlı: Reklamların önceden yüklenmesini durdurma

Oturumda belirli bir önceden yükleme kimliği için reklam göstermeniz gerekmiyorsa reklamların önceden yüklenmesini durdurabilirsiniz. Belirli bir önceden yükleme kimliği için reklam yüklemeyi durdurmak üzere, destroy() yöntemini önceden yükleme kimliğiyle birlikte çağırın. destroy() yönteminin çağrılması, önceden yükleme kimliğiyle ilişkili tüm önceden yüklenmiş reklamları önbellekten kaldırır.

Aşağıdaki örnekte, reklamların önceden yüklenmesinin nasıl durdurulacağı gösterilmektedir:

Kotlin

private fun stopPreloading(adUnitId: String) {
  // Stops the preloading and destroy preloaded ads.
  AppOpenAdPreloader.destroy(adUnitId)
}

Java

private void stopPreloading(String adUnitId) {
  // Stops the preloading and destroy preloaded ads.
  AppOpenAdPreloader.destroy(adUnitId);
}

İsteğe bağlı: Yanıt bilgilerini okuyun

Reklamı önbellekten kaldırmadan sonraki önceden yüklenmiş reklamın yanıt bilgilerini okuyun.

Aşağıdaki örnekte, önceden yüklenen sonraki reklam yanıtı bilgilerinin nasıl okunacağı gösterilmektedir:

Kotlin

val responseInfo = AppOpenAdPreloader.peekAdResponseInfo(preloadId)
if (responseInfo == null) {
  Log.e(TAG, "Failed to peek ad response info.")
  return
}

Log.d(TAG, "Peeked ad response ID: ${responseInfo.responseId}")

Java

ResponseInfo responseInfo = AppOpenAdPreloader.peekAdResponseInfo(preloadId);
if (responseInfo == null) {
  Log.e(TAG, "Failed to peek ad response info.");
  return;
}

Log.d(TAG, "Peeked ad response ID: " + responseInfo.getResponseId());

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.

Uygulama öğelerini arka plan iş parçacığında yükleyin. Böylece reklam gösterilirken yükleme işlemi devam eder.

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.