Format Iklan Native Khusus

Format iklan native khusus

Selain format native yang ditentukan sistem, penayang Ad Manager memiliki opsi untuk membuat format iklan native mereka sendiri dengan menentukan daftar kustom aset. Format ini disebut format iklan native kustom dan dapat digunakan dengan iklan yang direservasi. Hal ini memungkinkan penayang meneruskan data terstruktur arbitrer ke aplikasi mereka. Iklan ini direpresentasikan oleh objek NativeCustomFormatAd.

Memuat format iklan native khusus

Panduan ini menjelaskan cara memuat dan menampilkan format iklan native kustom.

Membuat AdLoader

Seperti iklan native, format iklan native kustom dimuat menggunakan class AdLoader:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/native")
    .forCustomFormatAd("10063170",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
          @Override
          public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
              // Show the custom format and record an impression.
          }
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/6499/example/native")
        .forCustomFormatAd("10063170",
            { ad ->
                // Show the custom format and record an impression.
            },
            { ad, s ->
            // Handle the click action
            })
        .withAdListener( ... )
        .withNativeAdOptions( ... )
        .build()

Metode forCustomFormatAd mengonfigurasi AdLoader untuk meminta format iklan native kustom. Ada tiga parameter yang diteruskan ke metode:

• ID format iklan native khusus yang harus diminta oleh AdLoader. Setiap format iklan native kustom memiliki ID yang terkait dengannya. Parameter ini menunjukkan format yang diminta oleh aplikasi Anda dari AdLoader.
• OnCustomFormatAdLoadedListener yang akan dipanggil saat iklan berhasil dimuat.
• OnCustomClickListener opsional yang akan dipanggil saat pengguna mengetuk atau mengklik iklan. Untuk mengetahui informasi selengkapnya tentang pemroses ini, lihat bagian "Menangani klik dan tayangan" di bawah.

Karena satu unit iklan dapat disiapkan untuk menayangkan lebih dari satu format materi iklan, forCustomFormatAd dapat dipanggil beberapa kali dengan ID format unik untuk menyiapkan pemuat iklan untuk lebih dari satu format iklan native kustom yang memungkinkan.

Catatan: forNativeAd dan forCustomFormatAd dapat digunakan secara bersamaan dengan satu AdLoader jika Anda memiliki unit iklan yang dikonfigurasi untuk menayangkan beberapa format iklan.

ID format iklan native khusus

ID format yang digunakan untuk mengidentifikasi format iklan native kustom dapat ditemukan di UI Ad Manager pada bagian Native di dalam dropdown Penayangan:

Setiap ID format iklan native khusus muncul di samping namanya. Dengan mengklik salah satu nama, Anda akan diarahkan ke layar detail yang menampilkan informasi tentang kolom format:

Dari sini, masing-masing kolom dapat ditambahkan, diedit, dan dihapus. Catat Nama setiap aset. Nama adalah kunci yang digunakan untuk mendapatkan data setiap aset saat menampilkan format iklan native khusus.

Menampilkan format iklan native kustom

Format iklan native kustom berbeda dengan format yang ditentukan sistem, karena penayang dapat menentukan daftar asetnya sendiri yang membentuk iklan. Oleh karena itu, proses untuk menampilkan satu format berbeda dengan format yang ditentukan sistem dalam beberapa hal:

1. Karena class NativeCustomFormatAd dimaksudkan untuk menangani salah satu format iklan native kustom yang Anda tentukan di Ad Manager, class tersebut tidak memiliki "pengambil" yang bernama untuk aset. Sebagai gantinya, metode ini menawarkan metode seperti getText dan getImage yang menggunakan nama kolom sebagai parameter.
2. Tidak ada class tampilan iklan khusus seperti NativeAdView untuk digunakan dengan NativeCustomFormatAd. Anda bebas menggunakan tata letak apa pun yang sesuai untuk pengalaman pengguna Anda.
3. Karena tidak ada class ViewGroup khusus, Anda tidak perlu mendaftarkan setiap tampilan yang digunakan untuk menampilkan aset iklan. Tindakan ini akan menghemat beberapa baris kode saat menampilkan iklan, tetapi juga berarti Anda harus melakukan sedikit pekerjaan tambahan untuk menangani klik nanti.

Berikut adalah contoh fungsi yang menampilkan NativeCustomFormatAd:

Java

public void displayCustomFormatAd (ViewGroup parent,
                                     NativeCustomFormatAd customFormatAd) {
    // Inflate a layout and add it to the parent ViewGroup.
    LayoutInflater inflater = (LayoutInflater) parent.getContext()
            .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    View adView = inflater.inflate(R.layout.custom_format_ad, parent);

    // Locate the TextView that will hold the value for "Headline" and
    // set its text.
    TextView myHeadlineView = (TextView) adView.findViewById(R.id.headline);
    myHeadlineView.setText(customFormatAd.getText("Headline"));

    // Locate the ImageView that will hold the value for "MainImage" and
    // set its drawable.
    Button myMainImageView = (ImageView) adView.findViewById(R.id.main_image);
    myMainImageView.setImageDrawable(
            customFormatAd.getImage("MainImage").getDrawable());

    ...
    // Continue locating views and displaying assets until finished.
    ...
}

Kotlin

public fun displayCustomFormatAd (parent: ViewGroup,
                                customFormatAd: NativeCustomFormatAd) {
    val adView = layoutInflater
            .inflate(R.layout.ad_simple_custom_format, null)

    val myHeadlineView = adView.findViewById<TextView>(R.id.headline)
    myHeadlineView.setText(customFormatAd.getText("Headline"));

    // Locate the ImageView that will hold the value for "MainImage" and
    // set its drawable.
    val myMainImageView = adView.findViewById(R.id.main_image);
    myMainImageView.setImageDrawable(
            customFormatAd.getImage("MainImage").drawable;

    ...
    // Continue locating views and displaying assets until finished.
    ...
}

Video native untuk format iklan native kustom

Saat membuat format kustom, Anda memiliki opsi untuk membuat format tersebut memenuhi syarat untuk video.

Dalam implementasi aplikasi, Anda dapat menggunakan NativeCustomFormatAd.getMediaContent() untuk mendapatkan konten media. Lalu, panggil setMediaContent() untuk menyetel konten media di tampilan media Anda ke tampilan media. Jika iklan tidak memiliki konten video, buat rencana alternatif untuk menampilkan iklan tanpa video.

Catatan: Tidak seperti iklan native yang berisi gambar di tampilan media saat video tidak tersedia, tampilan media iklan native kustom tidak memiliki konten jika tidak berisi video.

Contoh di bawah ini memeriksa apakah iklan memiliki konten video, dan menampilkan gambar jika video tidak tersedia:

Java

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(final NativeCustomFormatAd ad) {

  MediaContent mediaContent = ad.getMediaContent();

  // Assumes you have a FrameLayout in your view hierarchy with the id media_placeholder.
  FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

  // Apps can check the MediaContent's hasVideoContent property to determine if the
  // NativeCustomFormatAd has a video asset.
  if (mediaContent != null && mediaContent.hasVideoContent()) {
    MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
    mediaView.setMediaContent(mediaContent);
    mediaPlaceholder.addView(mediaView);

    // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The
    // VideoController will call methods on this object when events occur in the video
    // lifecycle.
    VideoController vc = mediaContent.getVideoController();
    vc.setVideoLifecycleCallbacks(
        new VideoController.VideoLifecycleCallbacks() {
          @Override
          public void onVideoEnd() {
            // Publishers should allow native ads to complete video playback before
            // refreshing or replacing them with another ad in the same UI location.
            super.onVideoEnd();
          }
        });
  } else {
    ImageView mainImage = new ImageView(this);
    mainImage.setAdjustViewBounds(true);
    mainImage.setImageDrawable(ad.getImage("MainImage").getDrawable());
    mediaPlaceholder.addView(mainImage);
    mainImage.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View view) {
            ad.performClick("MainImage");
          }
        });
  }
}

Kotlin

// Called when a custom native ad loads.
NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad ->

  val mediaContent = ad.mediaContent

  // Apps can check the MediaContent's hasVideoContent property to determine if the
  // NativeCustomFormatAd has a video asset.
  if (mediaContent != null && mediaContent.hasVideoContent()) {
    val mediaView = MediaView(mediaPlaceholder.getContest())
    mediaView.mediaContent = mediaContent

    val videoController = mediaContent.videoController

    // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The
    // VideoController will call methods on this object when events occur in the video
    // lifecycle.
    if (videoController != null) {
      videoController.videoLifecycleCallbacks =
        object : VideoController.VideoLifecycleCallbacks() {
          override fun onVideoEnd() {
            // Publishers should allow native ads to complete video playback before refreshing
            // or replacing them with another ad in the same UI location.
            super.onVideoEnd()
          }
        }
    }
  } else {
    val mainImage = ImageView(this)
    mainImage.adjustViewBounds = true
    mainImage.setImageDrawable(ad.getImage("MainImage")?.drawable)

    mainImage.setOnClickListener { ad.performClick("MainImage") }
    customTemplateBinding.simplecustomMediaPlaceholder.addView(mainImage)
  }
}

Lihat MediaContent untuk informasi selengkapnya tentang cara menyesuaikan pengalaman video iklan native kustom.

Download contoh Rendering Kustom Ad Manager untuk melihat contoh cara kerja video native.

Klik dan tayangan format iklan native khusus

Dengan format iklan native khusus, aplikasi Anda bertanggung jawab untuk mencatat tayangan dan melaporkan peristiwa klik ke Google Mobile Ads SDK.

Mencatat tayangan

Untuk mencatat tayangan iklan format kustom, panggil metode recordImpression pada NativeCustomFormatAd yang sesuai:

myCustomFormatAd.recordImpression();

Jika aplikasi Anda tidak sengaja memanggil metode dua kali untuk iklan yang sama, SDK akan otomatis mencegah tayangan duplikat direkam untuk satu permintaan.

Melaporkan klik

Untuk melaporkan ke SDK bahwa telah terjadi klik pada tampilan aset, panggil metode performClick pada NativeCustomFormatAd yang sesuai dan teruskan nama aset yang diklik. Misalnya, jika Anda memiliki aset dalam format kustom yang disebut "MainImage" dan ingin melaporkan klik pada ImageView yang terkait dengan aset tersebut, kode Anda akan terlihat seperti ini:

myCustomFormatAd.performClick("MainImage");

Perhatikan bahwa Anda tidak perlu memanggil metode ini untuk setiap tampilan yang terkait dengan iklan. Jika Anda memiliki kolom lain bernama "Teks" yang dimaksudkan untuk ditampilkan, tetapi tidak diklik atau diketuk oleh pengguna, aplikasi Anda tidak perlu memanggil performClick untuk tampilan aset tersebut.

Merespons tindakan klik kustom

Ketika klik dilakukan pada iklan format kustom, ada tiga kemungkinan respons dari SDK, yang dicoba dalam urutan ini:

1. Panggil OnCustomClickListener dari AdLoader, jika disediakan.
2. Untuk setiap URL deep link iklan, coba temukan resolver konten dan mulai resolver pertama yang selesai.
3. Buka browser dan navigasikan ke URL Tujuan tradisional iklan.

Metode forCustomFormatAd menerima OnCustomClickListener. Jika Anda meneruskan objek pemroses, SDK akan memanggil metode onCustomClick dan tidak melakukan tindakan lebih lanjut. Namun, jika Anda meneruskan nilai null sebagai pemroses, SDK akan melakukan fallback ke URL deeplink dan/atau URL tujuan yang terdaftar dengan iklan.

Pemroses Klik Kustom memungkinkan aplikasi Anda memutuskan tindakan terbaik yang akan diambil sebagai respons terhadap klik, apakah itu mengupdate UI, meluncurkan aktivitas baru, atau hanya mencatat log klik. Berikut ini contoh yang hanya mencatat bahwa klik terjadi:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/6499/example/native")
    .forCustomFormatAd("10063170",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
        // Display the ad.
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String assetName) {
            Log.i("MyApp", "A custom click just happened for " + assetName + "!");
          }
      }).build();

Kotlin

val adLoader = AdLoader.Builder(this, "/6499/example/native")
    .forCustomFormatAd("10063170",
        { ad ->
            // Display the ad.
        },
        { ad, assetName ->
                Log.i("MyApp", "A custom click just happened for $assetName!")
    }).build()

Pada awalnya, mungkin tampak aneh bahwa ada pemroses klik kustom. Lagi pula, aplikasi Anda baru saja memberi tahu SDK bahwa klik terjadi, jadi mengapa SDK harus berhenti dan melaporkannya ke aplikasi?

Alur informasi ini berguna karena beberapa alasan, tetapi yang terpenting memungkinkan SDK untuk tetap mengontrol respons terhadap klik. Layanan ini dapat secara otomatis melakukan ping ke URL pelacakan pihak ketiga yang telah ditetapkan untuk materi iklan, misalnya, dan menangani tugas lain di balik layar, tanpa kode tambahan.