Configuración

Los eventos personalizados te permiten agregar la mediación en cascada para una red de publicidad que no es una red de publicidad compatible. Para ello, implementa un adaptador de evento personalizado para la red de publicidad que deseas integrar.

Puedes encontrar un proyecto de evento personalizado de muestra completo en nuestro repositorio de GitHub.

Requisitos previos

Antes de crear eventos personalizados, primero debes integrar uno de los siguientes formatos de anuncio en tu app:

• Banner
• Intersticial
• Nativo
• Recompensado

Crea un evento personalizado en la IU

Primero, se debe crear un evento personalizado en la IU de AdMob. Consulta las instrucciones en Agrega un evento personalizado.

Debes proporcionar la siguiente información:

Nombre de clase

Es el nombre completamente calificado de la clase que implementa el adaptador de eventos personalizado, por ejemplo, com.google.ads.mediation.sample.customevent.SampleCustomEvent. La práctica recomendada es usar una sola clase de adaptador para todos los formatos de anuncios de eventos personalizados.

Etiqueta

Es un nombre único que define la fuente del anuncio.

Parámetro

Un argumento de string opcional que se pasa a tu adaptador de eventos personalizado.

Inicializa el adaptador

Cuando se inicializa el SDK de anuncios de Google para dispositivos móviles, initialize() se invoca en todos los adaptadores de terceros compatibles y los eventos personalizados configurados para la app dentro de la AdMob IU. Usa este método para realizar la configuración o inicialización necesarias en el SDK de terceros requerido para tu evento personalizado.

Java

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

Kotlin

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

Números de versión del informe

Todos los eventos personalizados deben informar al SDK de los anuncios móviles de Google tanto la versión del adaptador de eventos personalizado como la versión del SDK de terceros con el que el evento personalizado interactúa. Las versiones se informan como objetos 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)
  }
}

Solicitar anuncio

Para solicitar un anuncio, consulta las instrucciones específicas del formato del anuncio:

• Banner
• Intersticial
• Nativo
• Recompensado