Configuración

Los eventos personalizados te permiten agregar mediación de cascada para una red de publicidad que no es una red de publicidad compatible. A fin de lograrlo, 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, debes integrar uno de los siguientes formatos de anuncio en tu app:

• Banner
• Intersticial
• Nativo
• Recompensado

Cómo crear un evento personalizado en la IU

Primero, se debe crear un evento personalizado en la IU de AdMob. Consulta las instrucciones enCómo agregar un evento personalizado.

Debes proporcionar lo siguiente:

Nombre de clase

El nombre completo de la clase que implementa el adaptador de eventos personalizado, por ejemplo, SampleCustomEvent o, si tu clase se implementa en Swift, MediationExample.SampleCustomEventSwift.

El nombre de destino es obligatorio si tienes varios destinos en tu proyecto o si el nombre del proyecto es diferente del nombre de destino. Con el nombre de destino, se vería de la siguiente manera: appName_targetName.className. Además, recuerda reemplazar los caracteres no alfanuméricos, como guiones, guiones bajos. Ejemplo.

Etiqueta

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

Parámetro

Un argumento de string opcional pasado a tu adaptador de evento personalizado.

Implementa GADMediationAdapter

El primer paso para crear un evento personalizado es implementar el protocolo GADMediationAdapter, como lo muestra la clase SampleCustomEvent en nuestro ejemplo.

Es responsabilidad de esta clase recibir mensajes deAdMob y delegar la responsabilidad de crear el formato de anuncio correcto.

Inicializa el adaptador

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

Swift

import GoogleMobileAds

class SampleCustomEvent: NSObject, GADMediationAdapter {

  static func setUpWith(
    _ configuration: GADMediationServerConfiguration,
    completionHandler: @escaping GADMediationAdapterSetUpCompletionBlock
  ) {
    // 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.
    completionHandler(nil)
  }
}

Objective‑C

#import "SampleCustomEvent.h"

@implementation SampleCustomEvent
...

+ (void)setUpWithConfiguration:(nonnull GADMediationServerConfiguration *)configuration
             completionHandler:(nonnull GADMediationAdapterSetUpCompletionBlock)completionHandler {
  // This is where you initialize the SDK that this custom event is built
  // for. Upon finishing the SDK initialization, call the completion handler
  // with success.
  completionHandler(nil);
}

Informar números de versión

Todos los eventos personalizados deben informar al SDK de los anuncios móviles de Google la versión del adaptador de eventos personalizados y la versión del SDK de terceros con la que interactúa con el evento personalizado. Las versiones se informan como objetos GADVersionNumber :

Swift

static func adSDKVersion() -> GADVersionNumber {
  let versionComponents = String(SampleSDKVersion).components(
    separatedBy: ".")

  if versionComponents.count >= 3 {
    let majorVersion = Int(versionComponents[0]) ?? 0
    let minorVersion = Int(versionComponents[1]) ?? 0
    let patchVersion = Int(versionComponents[2]) ?? 0

    return GADVersionNumber(
      majorVersion: majorVersion, minorVersion: minorVersion, patchVersion: patchVersion)
  }

  return GADVersionNumber()
}

static func adapterVersion() -> GADVersionNumber {
  let versionComponents = String(SampleAdSDK.SampleAdSDKVersionNumber).components(
    separatedBy: ".")
  var version = GADVersionNumber()
  if versionComponents.count == 4 {
    version.majorVersion = Int(versionComponents[0]) ?? 0
    version.minorVersion = Int(versionComponents[1]) ?? 0
    version.patchVersion = Int(versionComponents[2]) * 100 + Int(versionComponents[3])
  }
  return version
}

Objective‑C

+ (GADVersionNumber)adSDKVersion {
  NSArray *versionComponents =
      [SampleSDKVersion componentsSeparatedByString:@"."];
  GADVersionNumber version = {0};
  if (versionComponents.count >= 3) {
    version.majorVersion = [versionComponents[0] integerValue];
    version.minorVersion = [versionComponents[1] integerValue];
    version.patchVersion = [versionComponents[2] integerValue];
  }
  return version;
}

+ (GADVersionNumber)adapterVersion {
  NSArray *versionComponents =
      [SampleCustomEventAdapterVersion componentsSeparatedByString:@"."];
  GADVersionNumber version = {0};
  if (versionComponents.count == 4) {
    version.majorVersion = [versionComponents[0] integerValue];
    version.minorVersion = [versionComponents[1] integerValue];
    version.patchVersion = [versionComponents[2] integerValue] * 100 +
                           [versionComponents[3] integerValue];
  }
  return version;
}

Solicitar anuncio

Para solicitar un anuncio, consulte las instrucciones específicas para el formato del anuncio:

• Banner
• Intersticial
• Nativo
• Recompensado