Как создать адаптер защищенных сигналов

Если у вас есть 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

+ (GADVersionNumber)adSDKVersion {
  // Return your SDK's version string here.
  NSString *versionString = kSDKVersionString;
  NSArray<NSString *> *components = [versionString componentsSeparatedByString:@"."];
  GADVersionNumber version = {};
  if (components.count == 3) {
    version.majorVersion = components[0].integerValue;
    version.minorVersion = components[1].integerValue;
    version.patchVersion = components[2].integerValue;
  } else {
    NSLog(@"Unexpected version string: %@. Returning 0.0.0 for adSDKVersion.", versionString);
  }
  return version;
}

Замените kSDKVersionString на строку с версией SDK.

Сбор сигналов

При каждом запросе объявления Google Mobile Ads SDK одновременно собирает сигналы от всех адаптеров в фоновом потоке.

В примере ниже сигналы собираются и возвращаются в Google Mobile Ads SDK с помощью вызова обработчика завершения GADRTBSignalCompletionHandler.

Objective-C

- (void)collectSignalsForRequestParameters:(GADRTBRequestParameters *)params
                         completionHandler:(GADRTBSignalCompletionHandler)handler {
  // Add your signal collection logic here.
  NSString *signals = kSampleSignalPlaceholder;

  // Return the signals as a string to the Google Mobile Ads SDK.
  handler(signals, nil);
}

Замените 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;
}