Desarrolla un adaptador de indicadores seguros

Si tienes un SDK de proveedor de indicadores que genera indicadores de licitación en tiempo real (RTB), puedes desarrollar un adaptador de indicadores seguros para permitir que Google Mobile Ads SDK recopile indicadores de tu SDK.

Google Mobile Ads SDK reenvía tus indicadores a los compradores participantes seleccionados de Authorized Buyers y Open Bidding.

En el siguiente diagrama, se ilustra el ciclo de vida de solicitud y respuesta para la recopilación de indicadores seguros:

Un adaptador de indicadores seguros es responsable de la inicialización del adaptador y la recopilación de indicadores.

Implementa un adaptador de indicadores seguros

Implementa un adaptador de indicadores seguros para Google Mobile Ads SDK para recopilar indicadores de tu SDK.

En esta guía, se explica cómo implementar un adaptador de indicadores seguros extendiendo la clase abstracta RtbAdapter.

En el siguiente ejemplo, se extiende la clase abstracta RtbAdapter:

Java

public class SampleAdapterSnippets extends RtbAdapter {
SampleAdapterSnippets.java

Inicializa el adaptador

Google Mobile Ads SDK llama al método initialize() cuando Google Mobile Ads SDK crea una instancia de tu adaptador de indicadores seguros. Usa este método para inicializar el SDK.

Cuando el SDK se inicialice por completo y esté listo para que Google Mobile Ads SDK recopile indicadores, llama a la devolución de llamada InitializationCompleteCallback.

Si tu adaptador de indicadores seguros no realiza una devolución de llamada, Google Mobile Ads SDK no recopila indicadores de tu adaptador de indicadores seguros.

En el siguiente ejemplo, se llama a la devolución de llamada de finalización para informar a Google Mobile Ads SDK que tu SDK se inicializó correctamente:

Java

@Override
public void initialize(
    Context context,
    InitializationCompleteCallback initializationCompleteCallback,
    List<MediationConfiguration> configurations) {

  // Add your SDK initialization logic here.

  // Invoke the InitializationCompleteCallback once initialization completes.
  initializationCompleteCallback.onInitializationSucceeded();
}

SampleAdapterSnippets.java

Informa la versión del adaptador y del SDK

Tu adaptador de señales seguras debe informar tanto la versión del adaptador como la versión del SDK. Google Mobile Ads SDK usa estas versiones para generar informes y solucionar problemas.

Si tu SDK implementa este adaptador en el mismo archivo binario, puedes devolver la misma versión para el adaptador y el SDK.

En el siguiente ejemplo, se devuelve la versión de tu adaptador de indicadores seguros:

Java

@Override
public VersionInfo getVersionInfo() {
  // If your SDK implements this adapter in the same binary, return
  // the same version as your SDK.
  // return getSDKVersionInfo();

  // If you built a separate binary for this adapter, return
  // the adapter's version here.
  int major = 4;
  int minor = 5;
  int micro = 6;
  return new VersionInfo(major, minor, micro);
}

SampleAdapterSnippets.java

En el siguiente ejemplo, se muestra la versión del SDK con la que interactúa tu adaptador de señales seguras:

Java

@Override
public VersionInfo getSDKVersionInfo() {

  // Return your SDK's version string here.
  String versionString = SDK_VERSION_STRING;
  String[] splits = versionString.split("\\.");
  if (splits.length >= 3) {
    try {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]);
      return new VersionInfo(major, minor, micro);
    } catch (NumberFormatException e) {
      // Fall through to log warning and return 0.0.0.
    }
  }

  Log.w(
      TAG,
      String.format(
          "Unexpected SDK version format: %s. Returning 0.0.0 for SDK version.", versionString));
  return new VersionInfo(0, 0, 0);
}

SampleAdapterSnippets.java

Reemplaza SDK_VERSION_STRING por la cadena de tu versión del SDK.

Recopila indicadores

En cada solicitud de anuncio, Google Mobile Ads SDK recopila indicadores de forma simultánea de todos los adaptadores en un subproceso en segundo plano.

En el siguiente ejemplo, se recopilan y se devuelven indicadores a Google Mobile Ads SDK llamando al método SignalCallbacks.onSuccess():

Java

@Override
public void collectSignals(RtbSignalData rtbSignalData, SignalCallbacks signalCallbacks) {

  // Add your signal collection logic here.
  String signals = SAMPLE_SIGNAL_PLACEHOLDER;

  // Return the signals as a string to the Google Mobile Ads SDK.
  signalCallbacks.onSuccess(signals);
}

SampleAdapterSnippets.java

Reemplaza SAMPLE_SIGNAL_PLACEHOLDER por tu cadena de señal segura.

La recopilación de señales debe completarse en un segundo. Si la recopilación de indicadores tarda más de un segundo, considera almacenar en caché los indicadores en tu adaptador de indicadores seguros o en tu SDK cuando inicialices el adaptador.

Si tu adaptador de indicadores seguros no puede recopilar indicadores, pasa un error al método signalCallbacks.onFailure().

Ofusca los indicadores

Cuando compartes indicadores seguros con los ofertantes y los socios de selección, debes ofuscar los indicadores.