Doğal reklamlar

Doğal reklamlar, kullanıcılara sunulan kullanıcı arayüzü bileşenleri üzerinden platformda yerleşik olarak bulunuyor. Bu iki içerikte, aynı görünüm türleri kullanılarak düzenlerinizi oluşturmakta olduğunuz bir metindir ve düzeninize uyacak şekilde uygulamanın görsel tasarımı.

Yerel reklam yüklendiğinde uygulamanız reklam öğesini içeren bir reklam nesnesi alır. Google Mobile Ads SDK'sı yerine uygulama göstermekten sorumludur.

Genel olarak, doğal reklamları başarıyla uygulamanın iki bölümü vardır: SDK kullanarak reklam yükleme ve ardından reklam içeriğini uygulamanızda gösterme.

Bu sayfada, Google Etiket Yöneticisi'ni kullanarak yerel reklamlar.

Ön koşullar

• Başlangıç kılavuzunu tamamlayın.

Her zaman test reklamlarıyla test etme

Uygulamalarınızı oluştururken ve test ederken, uygulamalarınızın yanı sıra üretim reklamlarıdır.

Test reklamlarını yüklemenin en kolay yolu, özel test reklam birimi kimliğimizi kullanmaktır en iyi uygulamaları görelim:

/21775744923/example/native

Her istek için test reklamı döndürecek şekilde özel olarak yapılandırılmıştır. kod yazma, test etme ve hata ayıklama sırasında kendi uygulamalarınızda kullanabilirsiniz. Tek yapmanız gereken uygulamanızı yayınlamadan önce bunu kendi reklam birimi kimliğinizle değiştirin.

Google Mobile Ads SDK'sının test reklamlarının işleyiş şekli hakkında daha fazla bilgi için Test reklamları başlıklı makaleyi inceleyin.

Reklamları yükle

Yerel reklamlar AdLoader sınıf, kendine ait bir web sitesi olan Builder sınıfını kullanarak özelleştirebilirsiniz. AdLoader için dinleyiciler ekleyerek oluşturulan yerel reklam türlerinin hangileri olduğunu belirten uygulamalar alabiliyorsunuz. Daha sonra AdLoader, yalnızca bu türleri ister.

AdLoader oluşturma

Önemli Bilgi: Mobile Ads SDK'sına ana iş parçacığı üzerinden tüm çağrıları yapın.

Aşağıdaki kod, yerel olarak yükleyebilen bir AdLoader özelliğinin nasıl oluşturulacağını göstermektedir reklamlar:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            // Show the ad.
        }
    })
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(LoadAdError adError) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .withNativeAdOptions(new NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native}")
    .forNativeAd { ad : NativeAd ->
        // Show the ad.
    }
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
            // Handle the failure.
        }
    })
    .withNativeAdOptions(NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build()

Uyarı: onAdFailedToLoad() yönteminden yeni bir reklam yüklenmeye çalışılıyorsa kesinlikle önerilmez. onAdFailedToLoad() alanından bir reklam yüklemeniz gerekiyorsa reklamı sınırlandırın Şu durumlarda sürekli başarısız reklam isteklerini önlemek için yükleme yeniden denemeleri: sınırlı ağ bağlantısı.

İlgili içeriği oluşturmak için kullanılan forNativeAd() yöntemi, AdLoader öğesini NativeAd biçimine hazırlamaktan sorumludur. Reklam başarıyla yüklendiğinde, işleyici nesnesinin onNativeAdLoaded() yöntemi çağrılır.

AdLoader ile bir AdListener oluşturma (isteğe bağlı)

withAdListener işlevi, AdLoader'ü oluştururken yükleyici için bir AdListener ayarlar. Yöntem, yalın parametresi olarak bir AdListener alır ve reklam yaşam döngüsü olayları gerçekleştiğinde AdLoader kaynaklı geri çağırmalar:

Java

.withAdListener(new AdListener() {
    // AdListener callbacks can be overridden here.
})

Kotlin

.withAdListener(object : AdListener() {
    // AdListener callbacks can be overridden here.
})

Reklam isteğinde bulun

İpucu: Reklam yükleme çağrısından önce, önceden yüklenmiş reklamların önbelleğini oluşturmak için gerektiğinde reklamların sıfır gecikmeyle gösterilebilmesi için bunları göstermektir. Reklamların süresi bir saat sonra dolduğu için bu önbelleği temizlemeli ve yeni reklam görebilirsiniz.

AdLoader oluşturmayı bitirdiğinizde, artık reklam isteğinde bulunmak için bunu kullanabilirsiniz. loadAd() yöntemini kullanın. Bu işlem AdManagerAdRequest nesnesini ifade eder. Bu aynı Banner'lar ve geçiş reklamları tarafından AdManagerAdRequest sınıf kullanılıyor, ve AdManagerAdRequest sınıfının yöntemlerini kullanarak şunları yapabilirsiniz: Tıpkı olduğu gibi hedefleme bilgileri ekleyin diğer reklam biçimleriyle benzerdir.

loadAd()

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

Java

adLoader.loadAd(new AdManagerAdRequest.Builder().build());

Kotlin

adLoader.loadAd(AdManagerAdRequest.Builder().build())

Not: Ad Manager, loadAds() yöntemini desteklemez ve yalnızca bir tek reklam olarak gösterilir.

Geri çağırma işlevleri

loadAd() çağrısından sonra, önceden tanımlanan numaraya tek bir geri arama yapılır işleyici yöntemlerini kullanarak yerel reklam nesnesini yayınlayın veya hata bildirin.

Kaynakları serbest bırakın

Yüklenen doğal reklamlarda destroy() yöntemini kullandığınızdan emin olun. Bu sürümler bellek sızıntılarını önler.

Önemli Nokta: destroy(), kullanılmıyor olsalar bile tüm reklamlarda çağrılmalıdır veya referans verilen siteler.

Etkinliğinizin onDestroy() yönteminde tüm NativeAd referanslarının kaldırıldığından emin olun.

onNativeAdLoaded geri aramanızda mevcut tüm öğeleri kaldırdığınızdan emin olun referans olarak çıkarılacak doğal reklamlara izin verir.

Diğer bir önemli kontrolü de etkinliğin kaldırılıp kaldırılmadığını kontrol etmektir. Kaldırılmışsa şu tarihte destroy() çağrısı yapın: döndürüp hemen geri dönüyor:

Java

final AdLoader adLoader = new AdLoader.Builder(this, "/21775744923/example/native")
        .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
    @Override
    public void onNativeAdLoaded(NativeAd nativeAd) {
        // If this callback occurs after the activity is destroyed, you
        // must call destroy and return or you may get a memory leak.
        // Note `isDestroyed()` is a method on Activity.
        if (isDestroyed()) {
            nativeAd.destroy();
            return;
        }
        ...
    }
}).build();

Kotlin

lateinit var adLoader: AdLoader
...
adLoader = AdLoader.Builder(this, "/21775744923/example/native")
    .forNativeAd { nativeAd ->
        // If this callback occurs after the activity is destroyed, you
        // must call destroy and return or you may get a memory leak.
        // Note `isDestroyed` is a method on Activity.
        if (isDestroyed) {
            nativeAd.destroy()
            return@forNativeAd
        }
        ...
    }.build()

En iyi uygulamalar

Reklamları yüklerken bu kurallara uyun.

• Listedeki yerel reklamlar kullanan uygulamalar, reklam listesini önbelleğe almalıdır.

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

• İlki olana kadar AdLoader numaralı telefondan loadAd() adlı kişiyi aramayın isteğin yüklenmesini bitir.

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

Video reklamların doğal reklam görüntülemelerinizde başarılı bir şekilde gösterilmesi için donanım hızlanma etkinleştirilmelidir.

Donanım hızlandırma varsayılan olarak etkindir ancak bazı uygulamalar devre dışı bırakabilirsiniz. Bu durum uygulamanız için geçerliyse donanımı etkinleştirmenizi öneririz. reklam kullanan etkinlik sınıfları için hızlandırma.

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

Donanım hızlandırma etkinken uygulamanız düzgün çalışmıyorsa bunu bağımsız etkinlikler için de kontrol edebilirsiniz. Donanım hızlandırmayı etkinleştirmek veya devre dışı bırakmak için AndroidManifest.xml'inizdeki <application> ve <activity> öğeleri için android:hardwareAccelerated özelliğini kullanın. Aşağıdaki örnekte, uygulamanın tamamı için hızlandırma ancak tek bir etkinlik için devre dışı bırakma:

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

HW hızlandırmasına bakın rehberi Donanım hızlandırmasını denetleme seçenekleri hakkında daha fazla bilgi edinin. Not tek reklam görünümlerinin donanım hızlandırma için etkinleştirilemeyeceğini unutmayın. Etkinlik devre dışı bırakıldığından etkinliğin kendisinde donanım hızlandırma olması gerekir etkin.

Reklamınızı gösterin

Bir reklamı yükledikten sonra geriye kalan tek şey onu kullanıcılarınıza göstermektir. Yerel Gelişmiş rehberimizi inceleyin.