Configuración

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

Requisitos previos

Antes de crear eventos personalizados, primero debes integrar uno de los siguientes formatos de anuncios 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 Ad Manager. Consulta las instrucciones en Crea y administra grupos de rendimiento.

Debes proporcionar la siguiente información:

Nombre de clase

Es el nombre completamente calificado de la clase que implementa el adaptador de eventos personalizados, 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 al nombre del destino. Con el nombre del destino, se verá de la siguiente manera: appName_targetName.className. Además, recuerda reemplazar los caracteres que no sean alfanuméricos, como los 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 personalizados.

Cómo implementar GADMediaAdapter

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

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

Cómo inicializar el adaptador

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

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

#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 de los informes

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

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
}

+ (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 del formato de anuncio:

• Banner
• Intersticial
• Nativo
• Recompensado