Разработайте защищенный адаптер сигнала.

Если у вас есть SDK поставщика сигналов, генерирующий сигналы для торгов в реальном времени (RTB), вы можете разработать защищенный адаптер сигналов, который позволит Google Mobile Ads SDK собирать сигналы из вашего SDK.

Google Mobile Ads SDK пересылает ваши сигналы выбранным участвующим авторизованным покупателям и покупателям, участвующим в открытом тендере .

Следующая диаграмма иллюстрирует жизненный цикл запроса-ответа для безопасного сбора сигналов:

Защищенный сигнальный адаптер отвечает за инициализацию адаптера и сбор сигнала.

Внедрить защищенный адаптер сигнала.

Внедрите защищенный адаптер сигналов для Google Mobile Ads SDK , чтобы собирать сигналы из вашего SDK.

В этом руководстве описано, как реализовать защищенный адаптер сигналов путем расширения абстрактного класса RtbAdapter .

Следующий пример расширяет абстрактный класс RtbAdapter :

Java 

public class SampleAdapterSnippets extends RtbAdapter {
SampleAdapterSnippets.java

Инициализируйте адаптер.

Google Mobile Google Mobile Ads SDK Google Mobile Ads SDK вызывает метод initialize() при создании экземпляра вашего защищенного адаптера сигнала. Используйте этот метод для инициализации вашего SDK.

Когда ваш SDK полностью инициализируется и будет готов к сбору сигналов Google Mobile Ads SDK , вызовите функцию обратного вызова InitializationCompleteCallback .

Если ваш адаптер защищенных сигналов не отправляет обратный вызов, Google Mobile Ads SDK не будет собирать сигналы от вашего адаптера защищенных сигналов.

В следующем примере вызывается функция обратного вызова завершения, чтобы сообщить Google Mobile Ads SDK об успешной инициализации вашего SDK:

Java 

@Override
public void initialize(
    Context context,
    InitializationCompleteCallback initializationCompleteCallback,
    List<MediationConfiguration> configurations) {

  // Add your SDK initialization logic here.

  // Invoke the InitializationCompleteCallback once initialization completes.
  initializationCompleteCallback.onInitializationSucceeded();
}

SampleAdapterSnippets.java

Версия адаптера отчетов и SDK

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

Если ваш SDK реализует этот адаптер в том же исполняемом файле, вы можете вернуть одну и ту же версию как для адаптера, так и для SDK.

В следующем примере отображается версия вашего адаптера защищенного сигнала:

Java 

@Override
public VersionInfo getVersionInfo() {
  // If your SDK implements this adapter in the same binary, return
  // the same version as your SDK.
  // return getSDKVersionInfo();

  // If you built a separate binary for this adapter, return
  // the adapter's version here.
  int major = 4;
  int minor = 5;
  int micro = 6;
  return new VersionInfo(major, minor, micro);
}

SampleAdapterSnippets.java

В следующем примере возвращается версия вашего SDK, с которой взаимодействует ваш адаптер защищенных сигналов:

Java 

@Override
public VersionInfo getSDKVersionInfo() {

  // Return your SDK's version string here.
  String versionString = SDK_VERSION_STRING;
  String[] splits = versionString.split("\\.");
  if (splits.length >= 3) {
    try {
      int major = Integer.parseInt(splits[0]);
      int minor = Integer.parseInt(splits[1]);
      int micro = Integer.parseInt(splits[2]);
      return new VersionInfo(major, minor, micro);
    } catch (NumberFormatException e) {
      // Fall through to log warning and return 0.0.0.
    }
  }

  Log.w(
      TAG,
      String.format(
          "Unexpected SDK version format: %s. Returning 0.0.0 for SDK version.", versionString));
  return new VersionInfo(0, 0, 0);
}

SampleAdapterSnippets.java

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

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

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

В следующем примере осуществляется сбор и передача сигналов в Google Mobile Ads SDK путем вызова метода SignalCallbacks.onSuccess() :

Java 

@Override
public void collectSignals(RtbSignalData rtbSignalData, SignalCallbacks signalCallbacks) {

  // Add your signal collection logic here.
  String signals = SAMPLE_SIGNAL_PLACEHOLDER;

  // Return the signals as a string to the Google Mobile Ads SDK.
  signalCallbacks.onSuccess(signals);
}

SampleAdapterSnippets.java

Замените SAMPLE_SIGNAL_PLACEHOLDER на строку вашего защищенного сигнала.

Сбор сигналов должен завершиться в течение одной секунды. Если сбор сигналов занимает больше одной секунды, рассмотрите возможность кэширования сигналов в вашем защищенном адаптере сигналов или в вашем SDK при инициализации адаптера .

Если ваш адаптер защищенного сигнала не может собрать сигналы, передайте сообщение об ошибке методу signalCallbacks.onFailure() .

Затуманить сигналы

При передаче защищенных сигналов участникам торгов и партнерам по кураторству необходимо их обфусцировать.