Mit benutzerdefinierten Ereignissen können Sie die abfolgebasierte Vermittlung für ein Werbenetzwerk hinzufügen, das kein unterstütztes Werbenetzwerk ist. Dazu müssen Sie einen benutzerdefinierten Ereignisadapter für das Werbenetzwerk implementieren, das Sie einbinden möchten.
Ein vollständiges Beispielprojekt für ein benutzerdefiniertes Ereignis finden Sie in unserem GitHub Repository.
Vorbereitung
Bevor Sie benutzerdefinierte Ereignisse erstellen können, müssen Sie eines der folgenden Anzeigenformate in Ihre App einbinden:
Benutzerdefiniertes Ereignis in der Benutzeroberfläche erstellen
Ein benutzerdefiniertes Ereignis muss zuerst in der AdMob-Benutzeroberfläche erstellt werden. Eine Anleitung finden Sie unter Benutzerdefiniertes Ereignis hinzufügen.
Sie müssen Folgendes angeben:
- Klassenname
Der vollständig qualifizierte Name der Klasse, die den benutzerdefinierten Ereignis adapter implementiert, z. B.
SampleCustomEvent; oder, wenn Ihre Klasse in Swift implementiert ist,MediationExample.SampleCustomEventSwift.Der Zielname ist erforderlich, wenn Ihr Projekt mehrere Ziele hat oder wenn sich der Projektname vom Zielnamen unterscheidet. Mit dem Zielnamen sieht das so aus:
appName_targetName.className. Außerdem müssen Sie alle nicht alphanumerischen Zeichen wie Bindestriche durch Unterstriche ersetzen. Beispiel.- Label
Ein eindeutiger Name, der die Anzeigenquelle definiert.
- Parameter
Ein optionales String-Argument, das an Ihren benutzerdefinierten Ereignisadapter übergeben wird.
GADMediationAdapter implementieren
Der erste Schritt zum Erstellen eines benutzerdefinierten Ereignisses ist die Implementierung des
GADMediationAdapter Protokolls, wie in der SampleCustomEvent Klasse
in unserem Beispiel gezeigt.
Diese Klasse ist dafür verantwortlich, Nachrichten von AdMob zu empfangen und die Verantwortung für das Erstellen des richtigen Anzeigenformats zu delegieren.
Adapter initialisieren
Wenn Google Mobile Ads SDK initialisiert wird, wird
setUpWithConfiguration:completionHandler:
für alle unterstützten Drittanbieter-Adapter und benutzerdefinierten Ereignisse aufgerufen, die
für die App in der AdMob-Benutzeroberfläche konfiguriert sind. Verwenden Sie diese Methode, um die erforderliche Einrichtung oder Initialisierung des erforderlichen Drittanbieter-SDK für Ihr benutzerdefiniertes Ereignis vorzunehmen.
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);
}
Versionsnummern melden
Alle benutzerdefinierten Ereignisse müssen Google Mobile Ads SDK sowohl die Version von
dem benutzerdefinierten Ereignisadapter selbst als auch die Version des Drittanbieter-SDK melden, mit dem das
benutzerdefinierte Ereignis interagiert. Versionen werden als
GADVersionNumber
Objekte gemeldet:
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;
}
Anzeige anfordern
Eine Anzeige können Sie gemäß der Anleitung für das jeweilige Anzeigenformat anfordern: