Opracowywanie adaptera bezpiecznych sygnałów

Jeśli masz pakiet SDK dostawcy sygnałów, który generuje sygnały na potrzeby określania stawek w czasie rzeczywistym (RTB), możesz opracować adapter bezpiecznych sygnałów, aby umożliwić usłudze Google Mobile Ads SDK zbieranie sygnałów z Twojego pakietu SDK.

Google Mobile Ads SDK przekazuje Twoje sygnały do wybranych kupujących korzystających z usług Authorized Buyers i Otwartego ustalania stawek.

Diagram poniżej przedstawia cykl życia żądania i odpowiedzi w przypadku zbierania bezpiecznych sygnałów:

Adapter bezpiecznego sygnału odpowiada za inicjowanie adaptera i zbieranie sygnałów.

Wdrażanie adaptera bezpiecznych sygnałów

Wdróż adapter bezpiecznego sygnału dla Google Mobile Ads SDK, aby zbierać sygnały z pakietu SDK.

Z tego przewodnika dowiesz się, jak wdrożyć adapter bezpiecznego sygnału, rozszerzając klasę abstrakcyjną RtbAdapter.

W tym przykładzie rozszerzamy klasę abstrakcyjną RtbAdapter:

Java

public class SampleAdapterSnippets extends RtbAdapter {
SampleAdapterSnippets.java

Inicjowanie adaptera

Google Mobile Ads SDK wywołuje metodę initialize() gdy Google Mobile Ads SDK tworzy instancję Twojego adaptera bezpiecznych sygnałów. Użyj tej metody, aby zainicjować pakiet SDK.

Gdy pakiet SDK zostanie w pełni zainicjowany i będzie gotowy do zbierania sygnałów na potrzeby Google Mobile Ads SDK, wywołaj wywołanie zwrotne InitializationCompleteCallback.

Jeśli adapter bezpiecznych sygnałów nie wywoła funkcji zwrotnej, Google Mobile Ads SDK nie będzie zbierać sygnałów z tego adaptera.

W tym przykładzie wywołujemy funkcję zwrotną completion callback , aby poinformować Google Mobile Ads SDK, że pakiet SDK został zainicjowany:

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

Zgłaszanie wersji adaptera i pakietu SDK

Adapter sygnałów bezpiecznych musi zgłaszać zarówno wersję adaptera, jak i wersję pakietu SDK. Google Mobile Ads SDK używa tych wersji do raportowania i rozwiązywania problemów.

Jeśli Twój pakiet SDK implementuje ten adapter w tym samym pliku binarnym, możesz zwrócić tę samą wersję zarówno w przypadku adaptera, jak i pakietu SDK.

Ten przykład zwraca wersję adaptera bezpiecznego sygnału:

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

Poniższy przykład zwraca wersję pakietu SDK, z którą współpracuje Twój adapter bezpiecznego sygnału:

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

Zastąp SDK_VERSION_STRING ciągiem znaków wersji pakietu SDK.

Zbieranie sygnałów

Przy każdym żądaniu reklamy Google Mobile Ads SDK zbiera sygnały jednocześnie ze wszystkich adapterów w wątku w tle.

W tym przykładzie sygnały są zbierane i zwracane do Google Mobile Ads SDK przez wywołanie metody 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

Zastąp SAMPLE_SIGNAL_PLACEHOLDER ciągiem bezpiecznego sygnału.

Zbieranie sygnałów musi zostać zakończone w ciągu sekundy. Jeśli zbieranie sygnałów trwa dłużej niż sekundę, rozważ buforowanie sygnałów w adapterze bezpiecznych sygnałów lub w pakiecie SDK podczas inicjowania adaptera.

Jeśli adapter bezpiecznych sygnałów nie może zbierać sygnałów, przekaż błąd do metody signalCallbacks.onFailure().

Maskowanie sygnałów

Gdy udostępniasz bezpieczne sygnały licytującym i partnerom wyboru, musisz je zaciemnić.