Los eventos personalizados te permiten agregar la mediación en cascada para una red de publicidad que no es una red de publicidad compatible. Para ello, debes implementar un adaptador de eventos personalizados para la red de publicidad que deseas integrar.
Puedes encontrar un proyecto de evento personalizado de muestra completo en nuestro GitHub repo.
Requisitos previos
Antes de crear eventos personalizados, primero debes integrar uno de los siguientes formatos de anuncios en tu app:
Cómo crear un evento personalizado en la IU
Primero, se debe crear un evento personalizado en la IU de AdMob. Consulta las instrucciones en Cómo agregar un evento personalizado.
Debes proporcionar lo siguiente:
- 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 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 cualquier carácter no alfanumérico, como guiones, por guiones bajos. Ejemplo.- Etiqueta
Es un nombre único que define la fuente de anuncios.
- Parámetro
Es un argumento de cadena opcional que se pasa al adaptador de eventos personalizados.
Cómo implementar GADMediationAdapter
El primer paso para crear un evento personalizado es implementar el
GADMediationAdapter protocolo, como se muestra en la SampleCustomEvent clase
en nuestro ejemplo.
Es responsabilidad de esta clase recibir mensajes de AdMob y delegar la responsabilidad de crear el formato de anuncio correcto.
Cómo inicializar el adaptador
Cuando Google Mobile Ads SDK se inicializa,
setUpWithConfiguration:completionHandler:
se invoca en todos los adaptadores de terceros compatibles y los eventos personalizados configurados
para la app en la IU de AdMob. Usa este método para realizar cualquier configuración o inicialización necesaria en el SDK de terceros requerido para tu evento personalizado.
Swift
import GoogleMobileAds
class SampleCustomEvent: NSObject, MediationAdapter {
static func setUpWith(
_ configuration: MediationServerConfiguration,
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);
}
Cómo informar números de versión
Todos los eventos personalizados deben informar a Google Mobile Ads SDK la versión de
su propio adaptador de eventos personalizados y la versión del SDK de terceros con el que interactúa el
evento personalizado. Las versiones se informan como
GADVersionNumber
objetos:
Swift
static func adSDKVersion() -> VersionNumber {
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 VersionNumber(
majorVersion: majorVersion, minorVersion: minorVersion, patchVersion: patchVersion)
}
return VersionNumber()
}
static func adapterVersion() -> VersionNumber {
let versionComponents = String(SampleAdSDK.SampleAdSDKVersionNumber).components(
separatedBy: ".")
var version = VersionNumber()
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;
}
Cómo solicitar un anuncio
Para solicitar un anuncio, consulta las instrucciones específicas del formato de anuncio: