Bu sayfa, Cloud Translation API ile çevrilmiştir.

Doğal gelişmiş

Doğal Reklam gösterme

Yerel reklam yüklendiğinde Google Mobile Ads SDK'sı karşılık gelen reklam biçimi. Uygulamanız reklamı göstermekten, ancak bunu hemen yapmanız gerekmez. Görüntülü Reklam Ağı'nda reklam biçimlerini daha kolay hale getirdiğimizde, SDK'da yalnızca aşağıdaki gibi bakın.

`NativeAdView` sınıf

NativeAd biçimi için karşılık gelen NativeAdView sınıfını kullanır. Bu sınıf bir ViewGroup NativeAd için kök olarak kullanmaları gereken bir değerdir. CEVAP tek bir NativeAdView, tek bir doğal reklama karşılık gelir. Reklamın öğelerini (ImageView ve ekran görüntüsü öğesi), NativeAdView öğesinin alt öğesi olmalıdır nesnesini tanımlayın.

LinearLayout aşağıdaki gibi görünebilir:

<com.google.android.gms.ads.nativead.NativeAdView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
    <LinearLayout
    android:orientation="vertical"
    ... >
        <LinearLayout
        android:orientation="horizontal"
        ... >
          <ImageView
           android:id="@+id/ad_app_icon"
           ... />
          <TextView
            android:id="@+id/ad_headline"
            ... />
         </LinearLayout>


         // Other assets such as image or media view, call to action, etc follow.
         ...
    </LinearLayout>
</com.google.android.gms.ads.nativead.NativeAdView>

NativeAdView ve bir NativeAd ile doldurur:

Java

AdLoader.Builder builder = new AdLoader.Builder(this, "AD_UNIT_ID")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            // Assumes you have a placeholder FrameLayout in your View layout
            // (with id fl_adplaceholder) where the ad is to be placed.
            FrameLayout frameLayout =
                findViewById(R.id.fl_adplaceholder);
            // Assumes that your ad layout is in a file call native_ad_layout.xml
            // in the res/layout folder
            NativeAdView adView = (NativeAdView) getLayoutInflater()
                .inflate(R.layout.native_ad_layout, null);
            // This method sets the text, images and the native ad, etc into the ad
            // view.
            populateNativeAdView(nativeAd, adView);
            frameLayout.removeAllViews();
            frameLayout.addView(adView);
        }
});

Kotlin

val builder = AdLoader.Builder(this, "AD_UNIT_ID")
    .forNativeAd { nativeAd ->
        // Assumes that your ad layout is in a file call native_ad_layout.xml
        // in the res/layout folder
        val adView = layoutInflater
                .inflate(R.layout.native_ad_layout, null) as NativeAdView
        // This method sets the text, images and the native ad, etc into the ad
        // view.
        populateNativeAdView(nativeAd, adView)
        // Assumes you have a placeholder FrameLayout in your View layout
        // (with id ad_frame) where the ad is to be placed.
        ad_frame.removeAllViews()
        ad_frame.addView(adView)
    }

Belirli bir yerel reklama ait tüm öğelerin NativeAdView düzeni. Google Mobile Ads SDK'sı, yerel reklam öğeleri yerel reklam görünümü düzeninin dışında oluşturulduğunda uyarı kaydetmeye çalışır.

Reklam görüntüleme sınıfları, her bir öğe için kullanılan görüntülemeyi kaydetmek üzere kullanılan yöntemler ve NativeAd nesnesinin kendisini kaydetmek için kullanılan bir yöntem de sağlar. Görünümlerin bu şekilde kaydedilmesi, SDK'nın görevleri otomatik olarak işlemesine olanak tanır Örneğin:

Tıklamaları kaydetme
Gösterimlerin, ilk piksel ekranda göründüğünde kaydedilmesi
Reklam Seçenekleri yer paylaşımını görüntüleme

Reklam Seçenekleri yer paylaşımı

SDK, her reklam görüntüsüne bir Reklam Seçenekleri yer paylaşımı ekler. Şurada yer bırakın: tercih ettiğiniz köşeyi otomatik olarak eklenen Reklam Seçenekleri logosu için doğal reklam görünümü. Ayrıca, yer paylaşımı kolayca görülebildiğinden, arka plan renklerini emin olmanız gerekir. Yer paylaşımının görünümü ve özellikleri hakkında daha fazla bilgi için işlevi için Yerel reklamlar alanına bakın açıklamaları bölümüne gidin.

Reklam ilişkilendirmesi

Görüntülemenin bir reklam olduğunu belirtmek için bir reklam ilişkilendirmesi göstermeniz gerekir. Daha fazla bilgi için politikamızı yönergelerimize bakın.

Kod örneği

Doğal reklam görüntüleme adımları şunlardır:

NativeAdView sınıfının bir örneğini oluşturun.
Görüntülenecek her reklam öğesi için:
1. Öğe görünümünü, reklam nesnesindeki öğeyle doldurun.
2. Öğe görünümünü ViewGroup sınıfına kaydedin.
MediaView yerel reklam düzeniniz büyük bir medya öğesi içeriyorsa.
Reklam nesnesini ViewGroup sınıfınla kaydedin.

NativeAd gösteren örnek bir işlevi aşağıda bulabilirsiniz:

Java

private void displayNativeAd(ViewGroup parent, NativeAd ad) {

    // Inflate a layout and add it to the parent ViewGroup.
    LayoutInflater inflater = (LayoutInflater) parent.getContext()
            .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    NativeAdView adView = (NativeAdView) inflater
            .inflate(R.layout.ad_layout_file, parent);

    // Locate the view that will hold the headline, set its text, and call the
    // NativeAdView's setHeadlineView method to register it.
    TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline);
    headlineView.setText(ad.getHeadline());
    adView.setHeadlineView(headlineView);

    ...
    // Repeat the above process for the other assets in the NativeAd
    // using additional view objects (Buttons, ImageViews, etc).
    ...

    // If the app is using a MediaView, it should be
    // instantiated and passed to setMediaView. This view is a little different
    // in that the asset is populated automatically, so there's one less step.
    MediaView mediaView = (MediaView) adView.findViewById(R.id.ad_media);
    adView.setMediaView(mediaView);

    // Call the NativeAdView's setNativeAd method to register the
    // NativeAdObject.
    adView.setNativeAd(ad);

    // Ensure that the parent view doesn't already contain an ad view.
    parent.removeAllViews();

    // Place the AdView into the parent.
    parent.addView(adView);
}

Kotlin

fun displayNativeAd(parent: ViewGroup, ad: NativeAd) {

    // Inflate a layout and add it to the parent ViewGroup.
    val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE)
            as LayoutInflater
    val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView

    // Locate the view that will hold the headline, set its text, and use the
    // NativeAdView's headlineView property to register it.
    val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
    headlineView.text = ad.headline
    adView.headlineView = headlineView

    ...
    // Repeat the above process for the other assets in the NativeAd using
    // additional view objects (Buttons, ImageViews, etc).
    ...

    val mediaView = adView.findViewById<MediaView>(R.id.ad_media)
    adView.mediaView = mediaView

    // Call the NativeAdView's setNativeAd method to register the
    // NativeAdObject.
    adView.setNativeAd(ad)

    // Ensure that the parent view doesn't already contain an ad view.
    parent.removeAllViews()

    // Place the AdView into the parent.
    parent.addView(adView)
}

Görevler şunlardır:

Düzeni şişirme

Java

LayoutInflater inflater = (LayoutInflater) parent.getContext()
        .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
NativeAdView adView = (NativeAdView) inflater
        .inflate(R.layout.ad_layout_file, parent);

Kotlin

val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE)
        as LayoutInflater
val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView

Bu kod, yerel bir öğe görüntülemek için görünümler içeren XML düzenini şişiriyor reklamını yapabilir ve ardından NativeAdView öğesine bir referans bulabilir. Fragment'inizde veya etkinliğinizde mevcut bir NativeAdView varsa bunu yeniden kullanabileceğinizi ya da düzen dosyası kullanmadan dinamik olarak bir örnek oluşturabileceğinizi unutmayın.

Öğe görünümlerini doldurup kaydedin

Bu örnek kod, başlığı görüntülemek için kullanılan görünümü bulur ve metni ayarlar reklam nesnesi tarafından sağlanan dize öğesini kullanır ve bunu NativeAdView nesne:
Java
```
TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline);
headlineView.setText(ad.getHeadline());
adView.setHeadlineView(headlineView);
```
Kotlin
```
val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
headlineView.text = ad.headline
adView.headlineView = headlineView
```
Bu görünümü bulma, değerini belirleme ve onu reklam görüntüleme sınıfı, Uygulamanın göstereceği doğal reklam nesnesi.

Tıklamaları yönetme

Doğal reklam görünümünün üzerinde veya içinde herhangi bir görünüme özel tıklama işleyicileri uygulamayın. Tıklama etkinliklerini kendiniz gözlemlemek için reklam dinleyiciyi kullanın.

Önceki bölümde açıklandığı gibi, reklam görüntüleme öğelerini doğru şekilde doldurup kaydettiğiniz sürece reklam görüntüleme öğelerine yapılan tıklamalar SDK tarafından işlenir.

Aşağıdaki örnekte, bir reklamın dinleyiciye tıklama etkinlikleri:

Java

AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110")
    ...
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(LoadAdError adError) {
            // Handle the failure by logging, altering the UI, and so on.
        }
        @Override
        public void onAdClicked() {
            // Log the click event or other custom behavior.
        }
    })
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
    ...
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .build()

MediaView'i kaydetme

Lütfen MediaView öğesinin yerine ImageView yerel öğenizin düzenine bir ana resim öğesi eklemek istiyorsanız reklam.

MediaView, video veya resim olan ana medya öğesini göstermek için tasarlanmış özel bir View'tir.

MediaView, bir XML düzeninde tanımlanabilir veya dinamik bir şekilde oluşturulabilir. Google herhangi bir NativeAdView görünüm hiyerarşisine yerleştirilmelidir. öğe görünümündedir. MediaView kullanan uygulamalar NativeAdView:
Java
```
MediaView mediaView = adView.findViewById(R.id.ad_media);
adView.setMediaView(mediaView);
```
Kotlin
```
adView.mediaView = adView.findViewById<MediaView>(R.id.ad_media)
```
Tüm öğe görüntülemelerinde olduğu gibi, medya görünümünde de içeriğin doldurulması gerekir. Bu, getMediaContent() bir MediaView. Aşağıda, medya görüntüleme için medya içeriğini ayarlayan bir kod snippet'i verilmiştir:
Java
```
mediaView.setMediaContent(nativeAd.getMediaContent());
```
Kotlin
```
mediaView.mediaContent = nativeAd.mediaContent
```
ImageScaleType

MediaView sınıfı, görüntülenirken ImageScaleType özelliğini içeriyor. resim. Bir resmin MediaView içinde ölçeklenme şeklini değiştirmek isterseniz setImageScaleType() kullanarak ilgili ImageView.ScaleType MediaView yöntemi:
Java
```
mediaView.setImageScaleType(ImageView.ScaleType.CENTER_CROP);
```
Kotlin
```
mediaView.imageScaleType = ImageView.ScaleType.CENTER_CROP
```
MediaContent

MediaContent sınıfı, doğal reklamın medya içeriğiyle ilgili verileri içerir. Bu veriler MediaView sınıfı kullanılarak gösterilir. MediaView mediaContent özelliği bir MediaContent örneğiyle ayarlandığında:
- Video öğesi kullanılabilir durumdaysa arabelleğe alınır ve MediaView Video öğesinin kullanılabilir olup olmadığını hasVideoContent()
- Reklamda video öğesi yoksa mainImage öğesi indirilir. ve MediaView içine yerleştirilir.
Varsayılan olarak, mainImage indirilen ilk resim öğesidir. Eğer setReturnUrlsForImageAssets(true) kullanılıyor, mainImage ise null mainImage özelliğini, manuel olarak indirdiğiniz görüntüye ayarlayın. Bu resmin yalnızca video öğesi olmadığında kullanılacağını unutmayın.
Yerel reklam nesnesini kaydetme

Bu son adımda, yerel reklam nesnesi, gösterilmesinden sorumlu görünüme kaydedilir:
Java
```
adView.setNativeAd(ad);
```
Kotlin
```
adView.setNativeAd(ad)
```

Reklamı kaldır

Yerel reklamınızı göstermeyi tamamladığınızda, reklamın uygun şekilde toplanmasını sağlar.

Java

nativeAd.destroy();

Kotlin

nativeAd.destroy()

GitHub'daki örnekler

Doğal reklamların uygulanmasını tamamlayın örneği:

Java Kotlin

Sonraki adımlar

Aşağıdaki konuları inceleyin:

Doğal gelişmiş

Doğal Reklam gösterme

NativeAdView sınıf

Java

Kotlin

Reklam Seçenekleri yer paylaşımı

Reklam ilişkilendirmesi

Kod örneği

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

ImageScaleType

Java

Kotlin

MediaContent

Java

Kotlin

Reklamı kaldır

Java

Kotlin

GitHub'daki örnekler

Sonraki adımlar

`NativeAdView` sınıf