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 de la recopilación de indicadores.

Implementa un adaptador de indicadores seguros

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

En esta guía, se explica cómo implementar un adaptador de indicadores seguros a través de la implementación del protocolo GADRTBAdapter.

En el siguiente ejemplo, se implementa el protocolo GADRTBAdapter:

Objective-C

@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end

Inicializa el adaptador

Google Mobile Ads SDK llama al método setUpWithConfiguration:completionHandler: cuando Google Mobile Ads SDK crea una instancia de tu adaptador de indicadores seguros. Usa este método para inicializar tu SDK.

Cuando el SDK se inicialice por completo y esté listo para que Google Mobile Ads SDK recopile indicadores, llama al bloque de finalización GADMediationAdapterSetUpCompletionBlock.

Si tu adaptador de indicadores seguros no devuelve la llamada, Google Mobile Ads SDK no recopila indicadores de tu adaptador de indicadores seguros.

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

Objective-C

+ (void)setUpWithConfiguration:(GADMediationServerConfiguration *)configuration
             completionHandler:(GADMediationAdapterSetUpCompletionBlock)completionHandler {
  // Add your SDK initialization logic here.

  // Invoke the completionHandler once initialization completes. Pass a nil
  // error to indicate initialization succeeded.
  completionHandler(nil);
}

Informa la versión del adaptador y del SDK

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

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

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

Objective-C

+ (GADVersionNumber)adapterVersion {
  // If your secure signals SDK implements this adapter in the same binary
  // return the same version as your SDK.
  // return [self adSDKVersion];

  // If you built a separate binary for this secure signals adapter, return
  // the adapter's version here.
  GADVersionNumber version = {};
  version.majorVersion = 4;
  version.minorVersion = 5;
  version.patchVersion = 6;
  return version;
}

En el siguiente ejemplo, se devuelve la versión de tu SDK con la que interactúa tu adaptador de indicadores seguros:

Objective-C

+ (GADVersionNumber)adSDKVersion {
  // Return your SDK's version string here.
  NSString *versionString = kSDKVersionString;
  NSArray<NSString *> *components = [versionString componentsSeparatedByString:@"."];
  GADVersionNumber version = {};
  if (components.count == 3) {
    version.majorVersion = components[0].integerValue;
    version.minorVersion = components[1].integerValue;
    version.patchVersion = components[2].integerValue;
  } else {
    NSLog(@"Unexpected version string: %@. Returning 0.0.0 for adSDKVersion.", versionString);
  }
  return version;
}

Reemplaza kSDKVersionString por la cadena de versión del SDK.

Recopila indicadores

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

En el siguiente ejemplo, se recopilan y devuelven indicadores a Google Mobile Ads SDK llamando al controlador de finalización GADRTBSignalCompletionHandler:

Objective-C

- (void)collectSignalsForRequestParameters:(GADRTBRequestParameters *)params
                         completionHandler:(GADRTBSignalCompletionHandler)handler {
  // Add your signal collection logic here.
  NSString *signals = kSampleSignalPlaceholder;

  // Return the signals as a string to the Google Mobile Ads SDK.
  handler(signals, nil);
}

Reemplaza kSampleSignalPlaceholder por tu cadena de indicador seguro.

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

Si tu adaptador de indicadores seguros no puede recopilar indicadores, llama al controlador de finalización con indicadores nil y un objeto NSError.

Ofusca los indicadores

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

Devuelve un valor nil para los parámetros adicionales de la red de publicidad

Los adaptadores de indicadores seguros no requieren parámetros adicionales de extras de red.

En el siguiente ejemplo, el método +networkExtrasClass devuelve un valor nil:

Objective-C

+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
  // Network extras are not applicable because signal providers do not request ads.
  return nil;
}