Если у вас есть SDK поставщика сигналов, который генерирует сигналы для назначения ставок в реальном времени, вы можете разработать адаптер защищенных сигналов, чтобы Google Mobile Ads SDK мог собирать сигналы из вашего SDK.
Google Mobile Ads SDK пересылает ваши сигналы выбранным авторизованным покупателям и покупателям, использующим Open Bidding.
На диаграмме ниже показан жизненный цикл запроса и ответа при сборе защищенных сигналов.
Адаптер защищенных сигналов отвечает за инициализацию адаптера и сбор сигналов.
Как реализовать адаптер защищенных сигналов
Чтобы собирать сигналы из SDK, реализуйте адаптер защищенных сигналов для Google Mobile Ads SDK.
В этом руководстве рассказывается, как реализовать адаптер защищенных сигналов с помощью протокола GADRTBAdapter.
В примере ниже реализован протокол GADRTBAdapter.
Objective-C
@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end
Инициализируйте адаптер
Google Mobile Ads SDK вызывает метод setUpWithConfiguration:completionHandler:, когда Google Mobile Ads SDK создает экземпляр адаптера защищенных сигналов. Используйте этот метод для инициализации SDK.
Когда SDK полностью инициализируется и будет готов к сбору сигналов Google Mobile Ads SDK, вызовите блок завершения GADMediationAdapterSetUpCompletionBlock.
Если адаптер защищенных сигналов не выполняет обратный вызов, Google Mobile Ads SDK не собирает сигналы из него.
В следующем примере вызывается обработчик завершения, который сообщает Google Mobile Ads SDK, что SDK инициализирован:
Objective-C
+ (void)setUpWithConfiguration:(GADMediationServerConfiguration *)configuration
completionHandler:(GADMediationAdapterSetUpCompletionBlock)completionHandler {
// Add your SDK initialization logic here.
// Invoke the completionHandler once initialization completes. Pass a nil
// error to indicate initialization succeeded.
completionHandler(nil);
}
Как сообщить о версии адаптера и SDK
Адаптер защищенных сигналов должен сообщать как свою версию, так и версию SDK. Google Mobile Ads SDK использует эти версии для создания отчетов и устранения неполадок.
Если ваш SDK реализует этот адаптер в том же двоичном файле, вы можете возвращать одну и ту же версию для адаптера и SDK.
В примере ниже возвращается версия адаптера защищенных сигналов:
Objective-C
+ (GADVersionNumber)adapterVersion {
// If your secure signals SDK implements this adapter in the same binary
// return the same version as your SDK.
// return [self adSDKVersion];
// If you built a separate binary for this secure signals adapter, return
// the adapter's version here.
GADVersionNumber version = {};
version.majorVersion = 4;
version.minorVersion = 5;
version.patchVersion = 6;
return version;
}
В примере ниже возвращается версия SDK, с которой взаимодействует адаптер защищенных сигналов:
Objective-C
Замените kSDKVersionString на строку с версией SDK.
Сбор сигналов
При каждом запросе объявления Google Mobile Ads SDK одновременно собирает сигналы от всех адаптеров в фоновом потоке.
В примере ниже сигналы собираются и возвращаются в Google Mobile Ads SDK с помощью вызова обработчика завершения GADRTBSignalCompletionHandler.
Objective-C
Замените kSampleSignalPlaceholder строкой защищенного сигнала.
Сбор сигналов должен завершиться в течение одной секунды. Если сбор сигналов занимает больше одной секунды, рекомендуем кешировать сигналы в адаптере защищенных сигналов или SDK при инициализации адаптера.
Если адаптеру защищенных сигналов не удается собрать сигналы, вызовите обработчик завершения с сигналами nil и объектом NSError.
Обфускация сигналов
Если вы передаете защищенные сигналы системам назначения ставок и партнерам по рекомендациям, то должны обфусцировать эти сигналы.
Возвращает значение nil для дополнительной информации от рекламной сети.
Адаптерам защищенных сигналов не требуются дополнительные параметры сети.
В примере ниже метод +networkExtrasClass возвращает значение nil:
Objective-C
+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
// Network extras are not applicable because signal providers do not request ads.
return nil;
}