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, 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, primero debes integrar uno de los siguientes formatos de anuncio en tu app:
Crea un evento personalizado en la IU
Primero, se debe crear un evento personalizado en la IU de AdMob. Consulta las instrucciones en Agrega un evento personalizado.
Debes proporcionar la siguiente información:
- Nombre de clase
Es el nombre completamente calificado de la clase que implementa el adaptador de eventos personalizado, por ejemplo,
SampleCustomEvent
o, si tu clase se implementó 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 del destino. Con el nombre de destino, se vería 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
Un argumento de string opcional que se pasa a tu adaptador de eventos personalizado.
Cómo implementar 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 del 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 los eventos personalizados configurados para la app dentro de la AdMob IU. 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 los anuncios móviles de Google tanto la versión del
adaptador de eventos personalizado como la versión del SDK de terceros con el que
el evento personalizado interactúa. 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, consulta las instrucciones específicas del formato del anuncio: