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