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. Vous en implémentant un adaptateur d'événement personnalisé pour le réseau publicitaire à intégrer.
Prérequis
Avant de pouvoir créer des événements personnalisés, vous devez intégrer l'un des le format d'annonce suivant dans votre application:
Créer un événement personnalisé dans l'UI
Vous devez d'abord créer un événement personnalisé dans Ad Manager UI. Consultez les instructions fournies dans l'article Créer et gérer le rendement Google Groupes.
Vous devez fournir les éléments suivants:
- Nom de la classe
Nom complet de la classe qui implémente l'événement personnalisé. adaptateur secteur, par exemple
SampleCustomEvent
; ou si votre classe est implémentée en Swift,MediationExample.SampleCustomEventSwift
Le nom de la cible est obligatoire 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, ressemblerait à ceci:
appName_targetName.className
. De plus, n'oubliez pas pour remplacer tous les caractères non alphanumériques tels que les tirets par des traits de soulignement. Exemple :- Libellé
Nom unique définissant la source d'annonces.
- Paramètre
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
Protocole GADMediationAdapter
, comme indiqué par la classe SampleCustomEvent
dans notre exemple.
Il est de la responsabilité de cette classe de recevoir les messages de Ad Manager et déléguez la création au bon format d'annonce.
Initialiser l'adaptateur
Lorsque le SDK Google Mobile Ads s'initialise,
setUpWithConfiguration:completionHandler:
est appelé sur tous les adaptateurs tiers compatibles et les événements personnalisés configurés
pour l'application dans l'interface utilisateur d'Ad Manager. Utilisez cette méthode pour
effectuer les opérations de configuration ou d'initialisation 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 les deux versions
l'adaptateur d'événement personnalisé et la version du SDK tiers
d'événements personnalisés. Les versions sont signalées comme
GADVersionNumber
Objets:
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: