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 terlebih dahulu mengintegrasikan salah satu format iklan berikut ke dalam aplikasi:

• Banner
• Interstisial
• Native
• Reward

Membuat peristiwa kustom di UI

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

Anda harus menyediakan hal berikut:

Nama Class

Nama class yang sepenuhnya memenuhi syarat yang menerapkan adaptor peristiwa kustom, misalnya, com.google.ads.mediation.sample.customevent.SampleCustomEvent. Sebagai praktik terbaik, sebaiknya gunakan satu kelas 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 Ad Manager UI. Gunakan metode ini untuk melakukan penyiapan atau inisialisasi yang diperlukan di SDK pihak ketiga yang diperlukan untuk peristiwa kustom Anda.

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

import com.google.android.gms.ads.AdFormat;
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();
  }
}

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

import com.google.android.gms.ads.AdFormat
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()
  }
}

Laporkan nomor versi

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

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);
  }
}

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

Minta iklan

Untuk meminta iklan, lihat petunjuk khusus untuk format iklan tersebut:

• Banner
• Interstisial
• Native
• Reward