Sviluppare un adattatore di indicatori sicuri

Se hai un SDK del fornitore di indicatori che genera indicatori di offerte in tempo reale (RTB), puoi sviluppare un adattatore di indicatori sicuri per consentire a Google Mobile Ads SDK di raccogliere indicatori dal tuo SDK.

Google Mobile Ads SDK inoltra gli indicatori agli acquirenti Authorized Buyers e Open Bidding partecipanti selezionati.

Il seguente diagramma illustra il ciclo di vita della richiesta-risposta per la raccolta di indicatori sicuri:

Un adattatore di indicatori sicuri è responsabile dell'inizializzazione dell'adattatore e della raccolta degli indicatori.

Implementa un adattatore di indicatori sicuri

Implementa un adattatore di indicatori sicuri per Google Mobile Ads SDK per raccogliere gli indicatori dal tuo SDK.

Questa guida spiega come implementare un adattatore di indicatori sicuri implementando il protocollo GADRTBAdapter.

L'esempio seguente implementa il protocollo GADRTBAdapter:

Objective-C

@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end

Inizializza l'adattatore

Google Mobile Ads SDK chiama il metodo setUpWithConfiguration:completionHandler: quando Google Mobile Ads SDK crea un'istanza dell'adattatore di indicatori sicuri. Utilizza questo metodo per inizializzare l'SDK.

Quando l'SDK viene inizializzato completamente ed è pronto per la raccolta degli indicatori da parte di Google Mobile Ads SDK, chiama il blocco di completamento GADMediationAdapterSetUpCompletionBlock.

Se l'adattatore di indicatori sicuri non esegue il callback, Google Mobile Ads SDK non raccoglie indicatori dall'adattatore di indicatori sicuri.

L'esempio seguente chiama il gestore del completamento per informare Google Mobile Ads SDK che l'SDK è stato inizializzato correttamente:

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

Segnala la versione dell'adattatore e dell'SDK

L'adattatore per l'indicatore sicuro deve segnalare sia la versione dell'adattatore sia quella dell'SDK. Google Mobile Ads SDK utilizza queste versioni per i report e la risoluzione dei problemi.

Se l'SDK implementa questo adattatore nello stesso file binario, puoi restituire la stessa versione sia per l'adattatore che per l'SDK.

L'esempio seguente restituisce la versione dell'adattatore di indicatori sicuri:

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

L'esempio seguente restituisce la versione dell'SDK con cui interagisce l'adattatore di indicatori sicuri:

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

Sostituisci kSDKVersionString con la stringa della versione dell'SDK.

Raccogli indicatori

Per ogni richiesta di annuncio, Google Mobile Ads SDK raccoglie contemporaneamente gli indicatori da tutti gli adattatori su un thread in background.

L'esempio seguente raccoglie e restituisce gli indicatori a Google Mobile Ads SDK chiamando il gestore di completamento 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);
}

Sostituisci kSampleSignalPlaceholder con la stringa dell'indicatore sicuro.

La raccolta degli indicatori deve essere completata entro un secondo. Se la raccolta degli indicatori richiede più di un secondo, valuta la possibilità di memorizzare nella cache gli indicatori nell'adattatore di indicatori sicuri o nell'SDK quando inizializzi l'adattatore.

Se l'adattatore di indicatori sicuri non riesce a raccogliere indicatori, chiama il gestore del completamento con indicatori nil e un oggetto NSError.

Offusca gli indicatori

Quando condividi indicatori sicuri con gli offerenti e i partner di selezione, devi offuscare gli indicatori.

Restituisci un valore nil per le informazioni extra della rete pubblicitaria

Gli adattatori di indicatori sicuri non richiedono parametri aggiuntivi per le informazioni extra della rete.

Il seguente metodo +networkExtrasClass di esempio restituisce un valore nil:

Objective-C

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