Les événements personnalisés vous permettent d'ajouter une médiation en cascade pour un réseau publicitaire qui n'est pas un réseau publicitaire compatible. Pour ce faire, mettez en œuvre un adaptateur d'événement personnalisé pour le réseau publicitaire que vous souhaitez intégrer.
Prérequis
Avant de pouvoir créer des événements personnalisés, vous devez d'abord intégrer l'un des formats d'annonces suivants à votre application:
Créer un événement personnalisé dans l'interface utilisateur
Vous devez d'abord créer un événement personnalisé dans l'interface utilisateur Ad Manager. Consultez les instructions dans Créer et gérer des groupes de rendement
Vous devez fournir les éléments suivants:
- Nom du cours
Nom complet de la classe qui implémente l'adaptateur d'événement personnalisé (par exemple,
SampleCustomEvent
; ou si votre classe est implémentée en Swift,MediationExample.SampleCustomEventSwift
.Veuillez indiquer un nom de cible si votre projet comporte plusieurs cibles ou si le nom du projet est différent du nom de la cible. Avec le nom de la cible, cela ressemblerait à ceci:
appName_targetName.className
. En outre, n'oubliez pas de remplacer tous les caractères non alphanumériques tels que les tirets par des traits de soulignement. Exemple.- Étiquette
Nom unique définissant la source d'annonces.
- Paramètres
Argument de chaîne facultatif transmis à votre adaptateur d'événement personnalisé.
Implémenter GADMediationAdapter
Pour créer un événement personnalisé, la première étape consiste à implémenter le protocole GADMediationAdapter
, comme indiqué par la classe SampleCustomEvent
de notre exemple.
Cette classe est chargée de recevoir les messages deAd Manager et de déléguer la responsabilité de créer le format d'annonce approprié.
Initialiser l'adaptateur
Lorsque le SDK Google Mobile Ads s'initialise,
setUpWithConfiguration:completionHandler:
est appelé sur tous les adaptateurs tiers compatibles et tous les événements personnalisés configurés pour l'application dans l' Ad Manager UI. Utilisez cette méthode afin d'effectuer toutes les configurations ou initialisations nécessaires sur le SDK tiers requis pour votre événement personnalisé.
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);
}
Numéros de version des rapports
Tous les événements personnalisés doivent signaler au SDK Google Mobile Ads la version de l'adaptateur d'événements personnalisés lui-même et la version du SDK tiers avec laquelle l'événement personnalisé interagit. Les versions sont signalées en tant qu'objets
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;
}
Demander une annonce
Pour demander une annonce, reportez-vous aux instructions spécifiques au format d'annonce: