Inizia a utilizzare gli indicatori sicuri

Gli indicatori sicuri sono dati codificati raccolti sul dispositivo client e condivisi con offerenti selezionati. Questa guida illustra come raccogliere e inviare indicatori sicuri a Google Ad Manager utilizzando l'SDK IMA.

L'API indicatori sicuri richiede la versione 3.18.1 o successiva dell'SDK IMA per iOS.

Per selezionare gli indicatori e gli offerenti e attivare la condivisione di indicatori sicuri, consulta Condividere indicatori sicuri con gli offerenti.

Utilizzare un fornitore di indicatori di terze parti

Per utilizzare gli indicatori sicuri, devi implementare una classe di adattatore del raccoltore di indicatori nella tua app per raccogliere gli indicatori, codificarli e trasmetterli all'SDK IMA.

Segui le istruzioni del fornitore di terze parti per creare un account, includere i framework, e configurare l'adattatore di indicatori sicuri nella tua app.

L'SDK IMA per iOS inizializza automaticamente ogni adattatore di indicatori sicuri, senza apportare ulteriori modifiche al codice.

Ecco un esempio di come aggiungere un adattatore di indicatori sicuri al tuo progetto:

Inviare dati personalizzati

Oltre a utilizzare un fornitore di indicatori di terze parti, puoi anche raccogliere, codificare e inviare indicatori con dati personalizzati. Prima di poter inviare indicatori sicuri con dati personalizzati, devi attivare gli indicatori personalizzati in Ad Manager.

Per ogni richiesta di annuncio, crea un oggetto IMASecureSignals contenente i dati personalizzati codificati come stringa. Aggiungi poi l'oggetto IMASecureSignals alla richiesta di annuncio chiamando l'attributo IMAAdsRequest.secureSignals.

Ecco alcuni esempi in Objective-C e Swift:

...
- (void)requestAds {
  // Create an ad display container for ad rendering.
  IMAAdDisplayContainer *adDisplayContainer =
      [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                          viewController:self
                                          companionSlots:nil];
  // Create an ad request with our ad tag, display container, and optional user context.
  IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:kTestAppAdTagUrl
                                                adDisplayContainer:adDisplayContainer
                                                   contentPlayhead:self.contentPlayhead
                                                       userContext:nil];
  
  IMASecureSignals *signals =
      [[IMASecureSignals alloc] initWithCustomData:@"My encoded signal string"];
  request.secureSignals = signals;
  
  [self.adsLoader requestAdsWithRequest:request];
}
...

...
private func requestAds() {
  // Create ad display container for ad rendering.
  let adDisplayContainer = IMAAdDisplayContainer(
    adContainer: videoView, viewController: self, companionSlots: nil)
  // Create an ad request with our ad tag, display container, and optional user context.
  let request = IMAAdsRequest(
    adTagUrl: ViewController.testAppAdTagURL,
    adDisplayContainer: adDisplayContainer,
    contentPlayhead: contentPlayhead,
    userContext: nil)
  
  let signals = IMASecureSignals(customData: "My encoded signal string")
  request.secureSignals = signals
  
  adsLoader.requestAds(with: request)
}
...