Adapter für sichere Signale entwickeln

Wenn Sie ein SDK für einen Signalanbieter haben, das RTB-Signale (Real-Time Bidding, Echtzeitgebote) generiert, können Sie einen sicheren Signaladapter entwickeln, damit Google Mobile Ads SDK Signale aus Ihrem SDK erfassen kann.

Google Mobile Ads SDK leitet Ihre Signale an ausgewählte teilnehmende Authorized Buyers- und Open Bidding-Käufer weiter.

Das folgende Diagramm veranschaulicht den Lebenszyklus von Anfrage und Antwort für die Erfassung sicherer Signale:

Ein Adapter für sichere Signale ist für die Adapterinitialisierung und die Signalerfassung verantwortlich.

Adapter für sichere Signale implementieren

Implementieren Sie einen Adapter für sichere Signale für Google Mobile Ads SDK, um Signale aus Ihrem SDK zu erfassen.

In diesem Leitfaden wird beschrieben, wie Sie einen Adapter für sichere Signale implementieren, indem Sie die RtbAdapter abstrakte Klasse erweitern.

Im folgenden Beispiel erweitert die RtbAdapter abstrakte Klasse:

Java

public class SampleAdapterSnippets extends RtbAdapter {

Adapter initialisieren

Google Mobile Ads SDK ruft die initialize() Methode auf, wenn Google Mobile Ads SDK Ihren Adapter für sichere Signale instanziiert. Verwenden Sie diese Methode, um Ihr SDK zu initialisieren.

Wenn Ihr SDK vollständig initialisiert ist und Google Mobile Ads SDK Signale erfassen kann, rufen Sie den InitializationCompleteCallback Callback auf.

Wenn Ihr Adapter für sichere Signale keinen Callback aufruft, erfasst Google Mobile Ads SDK keine Signale von ihm.

Im folgenden Beispiel wird der Abschluss Callback aufgerufen, um Google Mobile Ads SDK darüber zu informieren, dass Ihr SDK erfolgreich initialisiert wurde:

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();
}

Adapter- und SDK-Version melden

Ihr Adapter für sichere Signale muss sowohl die Adapter- als auch die SDK-Version melden. Google Mobile Ads SDK verwendet diese Versionen für Berichte und die Fehlerbehebung.

Wenn Ihr SDK diesen Adapter in derselben Binärdatei implementiert, können Sie für beide Versionen dieselbe Version zurückgeben.

Im folgenden Beispiel wird die Version Ihres Adapters für sichere Signale zurückgegeben:

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);
}

Im folgenden Beispiel wird die Version Ihres SDK zurückgegeben, mit der Ihr Adapter für sichere Signale interagiert:

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);
}

Ersetzen Sie SDK_VERSION_STRING durch die SDK-Version string.

Signale erfassen

Bei jeder Anzeigenanfrage erfasst Google Mobile Ads SDK Signale gleichzeitig von allen Adaptern in einem Hintergrundthread.

Im folgenden Beispiel werden Signale erfasst und an Google Mobile Ads SDK zurückgegeben, indem die SignalCallbacks.onSuccess() Methode aufgerufen wird:

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);
}

Ersetzen Sie SAMPLE_SIGNAL_PLACEHOLDER durch den String für sichere Signale.

Die Signalerfassung muss innerhalb einer Sekunde abgeschlossen sein. Wenn die Signalerfassung länger als eine Sekunde dauert, sollten Sie Signale in Ihrem Adapter für sichere Signale oder Ihrem SDK speichern, wenn Sie den Adapter initialisieren.

Wenn Ihr Adapter für sichere Signale keine Signale erfassen kann, übergeben Sie einen Fehler an die signalCallbacks.onFailure() Methode.

Signale verschleiern

Wenn Sie sichere Signale für Bieter und Kuratierungspartner freigeben, müssen Sie die Signale verschleiern.