Doğal reklam yükleme

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

Doğal reklamlar, platforma özgü kullanıcı arayüzü bileşenleri aracılığıyla kullanıcılara sunulan reklam öğeleridir. Bu reklamlar, düzenlerinizi oluştururken kullandığınız görünüm türleriyle gösterilir ve uygulamanızın görsel tasarımına uyacak şekilde biçimlendirilebilir.

Doğal reklam yüklendiğinde uygulamanız, öğelerini içeren bir reklam nesnesi alır ve bu öğeleri göstermekten Google Mobile Ads SDK (Legacy) değil, uygulama sorumlu olur.

Genel olarak, doğal reklamları başarılı bir şekilde uygulamak için iki bölüm vardır: SDK'yı kullanarak reklam yükleme ve ardından reklam içeriğini uygulamanızda görüntüleme.

Bu sayfada, doğal reklamları yüklemek için SDK'nın nasıl kullanılacağı gösterilmektedir. İpucu: Doğal reklamlar hakkında daha fazla bilgi edinmek için Doğal Reklamlar Başucu Kitabı'na göz atın.

Ayrıca, bazı müşteri başarı öykülerine de göz atabilirsiniz: 1. örnek olay, 2. örnek olay.

Ön koşullar

Devam etmeden önce Google Mobile Ads SDK (Legacy) ayarlarını yapın.

Her zaman test reklamlarıyla test edin

Uygulamalarınızı oluştururken ve test ederken yayındaki üretim reklamları yerine test reklamlarını kullandığınızdan emin olun.

Test reklamlarını yüklemenin en kolay yolu, Android'deki doğal reklamlar için özel test reklam birimi kimliğimizi kullanmaktır:

ca-app-pub-3940256099942544/2247696110

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

Google Mobile Ads SDK (Legacy) test reklamları hakkında ayrıntılı bilgi için Test reklamlarını etkinleştirme başlıklı makaleyi inceleyin.

Reklamları yükleme

Doğal reklamlar, oluşturma sırasında özelleştirilebilmesi için kendi Builder sınıfına sahip olan AdLoader sınıfıyla yüklenir. Uygulama, oluşturulurken AdLoader nesnesine dinleyiciler ekleyerek hangi tür doğal reklamları almaya hazır olduğunu belirtir. AdLoader daha sonra yalnızca bu türleri ister.

AdLoader oluşturma

Aşağıdaki kodda, yerel reklamları yükleyebilen bir AdLoader oluşturma işlemi gösterilmektedir:

Java

// It is recommended to call AdLoader.Builder on a background thread.
new Thread(
        () -> {
          AdLoader adLoader =
              new AdLoader.Builder(context, "AD_UNIT_ID")
                  .forNativeAd(
                      new NativeAd.OnNativeAdLoadedListener() {
                        @Override
                        // The native ad loaded successfully. You can show the ad.
                        public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {}
                      })
                  .withAdListener(
                      new AdListener() {
                        @Override
                        // The native ad load failed. Check the adError message for failure
                        // reasons.
                        public void onAdFailedToLoad(@NonNull LoadAdError adError) {}
                      })
                  // Use the NativeAdOptions.Builder class to specify individual options
                  // settings.
                  .withNativeAdOptions(new NativeAdOptions.Builder().build())
                  .build();
        })
    .start();
NativeAdSnippets.java

Kotlin

// It is recommended to call AdLoader.Builder on a background thread.
CoroutineScope(Dispatchers.IO).launch {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forNativeAd { nativeAd ->
        // The native ad loaded successfully. You can show the ad.
      }
      .withAdListener(
        object : AdListener() {
          override fun onAdFailedToLoad(adError: LoadAdError) {
            // The native ad load failed. Check the adError message for failure reasons.
          }
        }
      )
      // Use the NativeAdOptions.Builder class to specify individual options settings.
      .withNativeAdOptions(NativeAdOptions.Builder().build())
      .build()
}
NativeAdSnippets.kt

AD_UNIT_ID yerine test cihazınızın cihaz kimliğini yazın.

Uyarı: onAdFailedToLoad() yönteminden yeni bir reklam yüklemeye çalışmanız kesinlikle önerilmez. onAdFailedToLoad() üzerinden reklam yüklemeniz gerekiyorsa sınırlı ağ bağlantısı gibi durumlarda sürekli başarısız reklam isteklerini önlemek için reklam yükleme yeniden denemelerini sınırlayın.

forNativeAd() yöntemi, AdLoader öğesini NativeAd biçimine hazırlamaktan sorumludur. Bir reklam başarıyla yüklendiğinde dinleyici nesnesinin onNativeAdLoaded() yöntemi çağrılır.

AdLoader ile bir AdListener ayarlama (isteğe bağlı)

AdLoader oluşturulurken withAdListener işlevi, yükleyici için bir AdListener ayarlar. Yöntem, tek parametre olarak bir AdListener alır. Bu parametre, reklam yaşam döngüsü olayları gerçekleştiğinde AdLoader öğesinden geri çağırmalar alır:

Java

adLoaderBuilder.withAdListener(
    // Override AdListener callbacks here.
    new AdListener() {});
NativeAdSnippets.java

Kotlin

adLoaderBuilder.withAdListener(
  // Override AdListener callbacks here.
  object : AdListener() {}
)
NativeAdSnippets.kt

Reklam isteğinde bulun

İpucu: Reklamları göstermeyi planlamadan önce önceden yüklenmiş reklamların önbelleğini oluşturmak için reklam yükleme çağrılarını kullanabilirsiniz. Böylece, gerektiğinde reklamlar sıfır gecikmeyle gösterilebilir. Reklamların süresi bir saat sonra dolduğundan bu önbelleği temizlemeniz ve her saat yeni reklamlarla yeniden yüklemeniz gerekir.

AdLoader oluşturma işlemini tamamladıktan sonra reklam isteğinde bulunmak için kullanabilirsiniz. Bu işlem için iki yöntem kullanılabilir: loadAd() ve loadAds().

Önemli Nokta: loadAds() yöntemi yalnızca Google reklamlarıyla çalışır. Uyumlulaştırılmış reklamlar için loadAd() kullanın.

loadAd()

Bu yöntem, tek bir reklam için istek gönderir.

Java

adLoader.loadAd(new AdRequest.Builder().build());
NativeAdSnippets.java

Kotlin

adLoader.loadAd(AdRequest.Builder().build())
NativeAdSnippets.kt

loadAds()

Bu yöntem, birden fazla reklam (en fazla beş) için istek gönderir:

Java

// Load three native ads.
adLoader.loadAds(new AdRequest.Builder().build(), 3);
NativeAdSnippets.java

Kotlin

// Load three native ads.
adLoader.loadAds(AdRequest.Builder().build(), 3)
NativeAdSnippets.kt

Her iki yöntem de ilk parametre olarak bir AdRequest nesnesi alır. Bu, banner'lar ve geçiş reklamları tarafından kullanılan aynı AdRequest sınıftır ve diğer reklam biçimlerinde olduğu gibi hedefleme bilgileri eklemek için AdRequest sınıfının yöntemlerini kullanabilirsiniz.

Birden çok reklam yükleme (isteğe bağlı)

loadAds() yöntemi ek bir parametre alır: SDK'nın istek için yüklemeye çalışması gereken reklam sayısı. Bu sayı beş ile sınırlıdır ve SDK'nın istenen reklam sayısını tam olarak döndüreceği garanti edilmez.

Döndürülen Google reklamlarının tümü birbirinden farklı olacaktır ancak ayrılmış envanterden veya üçüncü taraf alıcılardan gelen reklamların benzersiz olacağı garanti edilmez.

Uyumlulaştırma kullanıyorsanız loadAds() yöntemini kullanmayın. Birden fazla yerel reklam isteği, uyumlulaştırma için yapılandırılmış reklam birimi kimliklerinde çalışmaz.

Geri aramalar

loadAd() çağrısından sonra, yerel reklam nesnesini yayınlamak veya bir hatayı bildirmek için önceden tanımlanmış dinleyici yöntemlerine tek bir geri çağırma yapılır.

loadAds() çağrıldıktan sonra bu tür birden fazla geri çağırma yapılır (en az bir ve istenen reklam isteği sayısından fazla olmamak üzere). Birden fazla reklam isteyen uygulamalar, yükleme işleminin tamamlanıp tamamlanmadığını belirlemek için geri çağırma uygulamalarında AdLoader.isLoading() işlevini çağırmalıdır.

Aşağıda, onNativeAdLoaded() geri çağırma işlevinde isLoading() öğesinin nasıl kontrol edileceğini gösteren bir örnek verilmiştir:

Java

adLoaderBuilder
    .forNativeAd(
        nativeAd -> {
          // This callback is invoked when a native ad is successfully loaded.
        })
    .build();
NativeAdSnippets.java

Kotlin

adLoaderBuilder
  .forNativeAd { nativeAd ->
    // This callback is invoked when a native ad is successfully loaded.
  }
  .build()
NativeAdSnippets.kt

Yayın kaynakları

Yüklenen doğal reklamlarda destroy() yöntemini kullandığınızdan emin olun. Bu işlem, kullanılan kaynakları serbest bırakır ve bellek sızıntılarını önler.

Önemli Nokta: destroy(), kullanılmamış veya referans verilmemiş olsalar bile tüm reklamlar için çağrılmalıdır.

Etkinliğinizin onDestroy() yönteminde tüm NativeAd referanslarının yok edildiğini doğrulayın.

onNativeAdLoaded geri çağırma işlevinizde, referansı kaldırılacak mevcut doğal reklamları yok ettiğinizden emin olun.

Bir diğer önemli kontrol de etkinliğin yok edilip edilmediğidir. Yok edildiyse döndürülen reklamda destroy() yöntemini çağırın ve hemen geri dönün:

Java

nativeAd.destroy();
NativeAdSnippets.java

Kotlin

nativeAd.destroy()
NativeAdSnippets.kt

En iyi uygulamalar

Reklam yüklerken aşağıdaki kurallara uyun.

• Bir listede doğal reklam kullanan uygulamalar, reklam listesini önceden önbelleğe almalıdır.

• Reklamları önbelleğe alırken önbelleğinizi temizleyin ve bir saat sonra yeniden yükleyin.

• İlk istek yüklenene kadar loadAd() veya loadAds()'u AdLoader üzerinde çağırmayın.

• Doğal reklam önbelleğe almayı yalnızca gerekli olanla sınırlayın. Örneğin, önceden önbelleğe alma işlemi sırasında yalnızca ekranda hemen görünen reklamları önbelleğe alın. Doğal reklamlar büyük bir bellekte kaplanan yere sahiptir ve doğal reklamları kaldırmadan önbelleğe almak aşırı bellek kullanımına neden olur.

• Artık kullanılmayan doğal reklamları imha edin.

Video reklamlar için donanım hızlandırma

Video reklamların doğal reklam görünümlerinizde başarıyla gösterilmesi için donanım hızlandırma etkinleştirilmelidir.

Donanım hızlandırma varsayılan olarak etkindir ancak bazı uygulamalar bu özelliği devre dışı bırakmayı seçebilir. Uygulamanız bu durumdaysa reklam kullanan Activity kitaplığı sınıfları için donanım hızlandırmayı etkinleştirmenizi öneririz.

Donanım hızlandırmayı etkinleştirme

Uygulamanız, donanım hızlandırma genel olarak etkinleştirildiğinde düzgün çalışmıyorsa bu özelliği her bir etkinlik için ayrı ayrı kontrol edebilirsiniz. Donanım hızlandırmayı etkinleştirmek veya devre dışı bırakmak için AndroidManifest.xml öğenizdeki <application> ve <activity> öğeleri için android:hardwareAccelerated özelliğini kullanın. Aşağıdaki örnekte, donanım hızlandırma tüm uygulama için etkinleştirilir ancak bir etkinlik için devre dışı bırakılır:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>
HardwareAccelerationSnippet.xml

Donanım hızlandırmayı kontrol etme seçenekleri hakkında daha fazla bilgi için Donanım hızlandırma kılavuzuna bakın. Etkinlik devre dışı bırakılırsa tek reklam görünümlerinin donanım hızlandırma için etkinleştirilemeyeceğini, bu nedenle etkinliğin kendisinde donanım hızlandırmanın etkinleştirilmesi gerektiğini unutmayın.

Reklamınızı gösterme

Bir reklamı yükledikten sonra yapmanız gereken tek şey, reklamı kullanıcılarınıza göstermektir. Daha fazla bilgi için Doğal gelişmiş reklamlar veya Tam ekran doğal reklamlar bölümüne bakın.