Penyiapan

Peristiwa kustom memungkinkan Anda menambahkan mediasi waterfall untuk jaringan iklan yang bukan jaringan iklan yang didukung. Anda melakukannya dengan menerapkan adaptor peristiwa kustom untuk jaringan iklan yang ingin diintegrasikan.

Prasyarat

Sebelum dapat membuat peristiwa kustom, Anda harus mengintegrasikan salah satu format iklan berikut ke dalam aplikasi terlebih dahulu:

Membuat peristiwa kustom di UI

Peristiwa kustom harus dibuat terlebih dahulu di UI Ad Manager. Lihat petunjuk di Membuat dan mengelola grup hasil.

Anda harus memberikan hal berikut:

Nama Kelas

Nama class yang sepenuhnya memenuhi syarat yang mengimplementasikan adaptor peristiwa kustom, misalnya, com.google.ads.mediation.sample.customevent.SampleCustomEvent. Sebagai praktik terbaik, sebaiknya gunakan satu class adaptor untuk semua format iklan peristiwa kustom.

Label

Nama unik yang menentukan sumber iklan.

Parameter

Argumen string opsional yang diteruskan ke adaptor peristiwa kustom Anda.

Melakukan inisialisasi adaptor

Saat Google Mobile Ads SDK melakukan inisialisasi, initialize() dipanggil di semua adaptor pihak ketiga yang didukung dan peristiwa kustom yang dikonfigurasi untuk aplikasi dalam UI Ad Manager. Gunakan metode ini untuk melakukan penyiapan atau inisialisasi yang diperlukan pada SDK pihak ketiga yang diperlukan untuk peristiwa kustom Anda.

Java

package com.google.ads.mediation.sample.customevent;

import com.google.android.gms.ads.mediation.Adapter;
import com.google.android.gms.ads.mediation.InitializationCompleteCallback;
import com.google.android.gms.ads.mediation.MediationConfiguration;

public class SampleAdNetworkCustomEvent extends Adapter {
  private static final String SAMPLE_AD_UNIT_KEY = "parameter";

  @Override
  public void initialize(Context context,
      InitializationCompleteCallback initializationCompleteCallback,
      List<MediationConfiguration> mediationConfigurations) {
    // This is where you will initialize the SDK that this custom
    // event is built for. Upon finishing the SDK initialization,
    // call the completion handler with success.
    initializationCompleteCallback.onInitializationSucceeded();
  }
}

Kotlin

package com.google.ads.mediation.sample.customevent

import com.google.android.gms.ads.mediation.Adapter
import com.google.android.gms.ads.mediation.InitializationCompleteCallback
import com.google.android.gms.ads.mediation.MediationConfiguration

class SampleCustomEvent : Adapter() {
  private val SAMPLE_AD_UNIT_KEY = "parameter"

  override fun initialize(
    context: Context,
    initializationCompleteCallback: InitializationCompleteCallback,
    mediationConfigurations: List<MediationConfiguration>
  ) {
    // This is where you will initialize the SDK that this custom
    // event is built for. Upon finishing the SDK initialization,
    // call the completion handler with success.
    initializationCompleteCallback.onInitializationSucceeded()
  }
}

Nomor versi laporan

Semua peristiwa kustom harus melaporkan ke Google Mobile Ads SDK versi adaptor peristiwa kustom itu sendiri dan versi SDK pihak ketiga yang digunakan peristiwa kustom. Versi dilaporkan sebagai objek VersionInfo:

Java

package com.google.ads.mediation.sample.customevent;

public class SampleCustomEvent extends Adapter {

  @Override
  public VersionInfo getVersionInfo() {
    String versionString = new VersionInfo(1, 2, 3);
    String[] splits = versionString.split("\\.");

    if (splits.length >= 4) {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]) * 100 + Integer.parseInt(splits[3]);
      return new VersionInfo(major, minor, micro);
    }

    return new VersionInfo(0, 0, 0);
  }

  @Override
  public VersionInfo getSDKVersionInfo() {
    String versionString = SampleAdRequest.getSDKVersion();
    String[] splits = versionString.split("\\.");

    if (splits.length >= 3) {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]);
      return new VersionInfo(major, minor, micro);
    }

    return new VersionInfo(0, 0, 0);
  }
}

Kotlin

package com.google.ads.mediation.sample.customevent

class SampleCustomEvent : Adapter() {
  override fun getVersionInfo(): VersionInfo {
    val versionString = VersionInfo(1,2,3).toString()
    val splits: List<String> = versionString.split("\\.")

    if (splits.count() >= 4) {
      val major = splits[0].toInt()
      val minor = splits[1].toInt()
      val micro = (splits[2].toInt() * 100) + splits[3].toInt()
      return VersionInfo(major, minor, micro)
    }

    return VersionInfo(0, 0, 0)
  }

  override fun getSDKVersionInfo(): VersionInfo {
    val versionString = VersionInfo(1,2,3).toString()
    val splits: List<String> = versionString.split("\\.")

    if (splits.count() >= 3) {
      val major = splits[0].toInt()
      val minor = splits[1].toInt()
      val micro = splits[2].toInt()
      return VersionInfo(major, minor, micro)
    }

    return VersionInfo(0, 0, 0)
  }
}

Meminta iklan

Untuk meminta iklan, lihat petunjuk khusus untuk format iklan: