Configuración

Los eventos personalizados le permiten agregar mediación en cascada a una red de publicidad que no sea una red publicitaria compatible. Tú lo haces esto mediante la implementación de un adaptador de eventos personalizado para la red de publicidad que integrarla.

Puedes encontrar un proyecto de evento personalizado de muestra completo en nuestro Centro de repo.

Requisitos previos

Antes de crear eventos personalizados, debes integrar uno de los siguiente formato 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 cuenta de la IU de Google. Consulta las instrucciones en Agrega un evento personalizado.

Debes proporcionar la siguiente información:

Nombre de clase

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

El nombre del destino es obligatorio si tienes varios destinos en tu proyecto o si el nombre del proyecto es diferente del nombre objetivo. Con el nombre del destino, se vería así: appName_targetName.className. Además, recuerda para reemplazar caracteres que no son alfanuméricos, como guiones por guiones bajos. Ejemplo:

Etiqueta

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

Parámetro

Es un argumento de cadena opcional que se pasa a tu adaptador de eventos personalizado.

Cómo implementar GADMediationAdapter

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

Es responsabilidad de esta clase recibir mensajes de AdMob y delega 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, setUpWithConfiguration:completionHandler: se invoca en todos los adaptadores de terceros compatibles y eventos personalizados configurados para la aplicación dentro de la IU de AdMob. Usa este método para realizar la configuración o inicialización necesarias 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);
}

Números de versión del informe

Todos los eventos personalizados deben informar al SDK de anuncios de Google para dispositivos móviles tanto la versión de el adaptador de eventos personalizado y la versión del SDK de terceros las interfaces de eventos personalizados. Las versiones se informan como GADVersionNumber objetos:

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, consulta las instrucciones específicas para el formato del anuncio:

• Banner
• Intersticial
• Nativo
• Recompensado