Пользовательские события позволяют добавить посредничество водопада для рекламной сети, которая не является поддерживаемой рекламной сетью . Вы делаете это, реализуя собственный адаптер событий для рекламной сети, которую вы хотите интегрировать.
Предпосылки
Прежде чем вы сможете создавать собственные события, вы должны сначала интегрировать в свое приложение один из следующих форматов рекламы:
Создайте пользовательское событие в пользовательском интерфейсе
Пользовательское событие должно быть сначала создано в пользовательском интерфейсе Ad Manager. См. инструкции вСоздание групп доходности и управление ими .
Вам необходимо предоставить следующее:
- Имя класса
Полное имя класса, реализующего пользовательский адаптер событий, например,
SampleCustomEvent
; или если ваш класс реализован в Swift,MediationExample.SampleCustomEventSwift
.Имя цели требуется, если в вашем проекте несколько целей или если имя проекта отличается от имени цели. С именем цели это будет выглядеть так:
appName_targetName.className
. Кроме того, не забудьте заменить все небуквенно-цифровые символы, такие как тире, символами подчеркивания. Пример .- Этикетка
Уникальное имя, определяющее источник рекламы.
- Параметр
Необязательный строковый аргумент, передаваемый вашему пользовательскому адаптеру событий.
Внедрение GADMediationAdapter
Первым шагом к созданию пользовательского события является реализация протокола GADMediationAdapter
, как показано в классе SampleCustomEvent
в нашем примере .
В обязанности этого класса входит получение сообщений отAd Manager и делегирование ответственности за создание правильного формата объявления.
Инициализировать адаптер
Когда Google Mobile Ads SDK инициализируется,setUpWithConfiguration:completionHandler:
вызывается для всех поддерживаемых сторонних адаптеров и пользовательских событий, настроенных для приложения в пользовательском интерфейсе Ad Manager . Используйте этот метод для выполнения любой необходимой настройки или инициализации необходимого стороннего SDK для вашего пользовательского события.
Быстрый
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) } }
Цель-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); }
Сообщить номера версий
Все специальные события должны сообщать SDK Google Mobile Ads как версию самого адаптера пользовательского события, так и версию стороннего SDK, с которым взаимодействует пользовательское событие. Версии сообщаются как объекты l10n-GADVersionNumber
:
Быстрый
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 }
Цель-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; }
Запросить объявление
Чтобы запросить рекламу, обратитесь к инструкциям, относящимся к формату рекламы: