Adapter für sichere Signale entwickeln

Wenn Sie ein SDK eines Signalanbieters haben, das RTB-Signale (Real-Time Bidding, Echtzeitgebote) generiert, können Sie einen Adapter für sichere Signale 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 Anfrage-Antwort-Lebenszyklus 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 das Protokoll GADRTBAdapter implementieren.

Im folgenden Beispiel wird das GADRTBAdapter-Protokoll implementiert:

Objective-C

@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end

Adapter initialisieren

Google Mobile Ads SDK ruft die Methode setUpWithConfiguration:completionHandler: auf, wenn Google Mobile Ads SDK den Adapter für sichere Signale instanziiert. Verwenden Sie diese Methode, um Ihr SDK zu initialisieren.

Wenn das SDK vollständig initialisiert und bereit ist, Signale für Google Mobile Ads SDK zu erfassen, rufen Sie den Abschlussblock GADMediationAdapterSetUpCompletionBlock auf.

Wenn Ihr Adapter für sichere Signale nicht antwortet, werden von Google Mobile Ads SDK keine Signale von Ihrem Adapter für sichere Signale erfasst.

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

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

Adapter- und SDK-Version melden

Der Adapter für sichere Signale muss sowohl die Adapterversion 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 die Adapter- und SDK-Version dieselbe Version zurückgeben.

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

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

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

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

Ersetzen Sie kSDKVersionString durch den String Ihrer SDK-Version.

Signale erfassen

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

Im folgenden Beispiel werden Signale erfasst und durch Aufrufen des Abschluss-Handlers GADRTBSignalCompletionHandler an Google Mobile Ads SDK zurückgegeben:

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

Ersetzen Sie kSampleSignalPlaceholder durch den String für das sichere Signal.

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

Wenn der Adapter für sichere Signale keine Signale erfassen kann, rufen Sie den Abschluss-Handler mit nil-Signalen und einem NSError-Objekt auf.

Signale verschleiern

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

nil-Wert für Werbenetzwerk-Extras zurückgeben

Für Adapter für sichere Signale sind keine zusätzlichen Netzwerk-Extras-Parameter erforderlich.

Im folgenden Beispiel gibt die Methode +networkExtrasClass einen nil-Wert zurück:

Objective-C

+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
  // Network extras are not applicable because signal providers do not request ads.
  return nil;
}