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