Integrare gli adattatori di indicatori sicuri

Seleziona la piattaforma: HTML5 Android iOS tvOS

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

L'API indicatori sicuri richiede la versione 4.8.2 o successive dell'SDK IMA per tvOS.

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

Utilizzare un provider di indicatori di terze parti

Per utilizzare gli indicatori sicuri, devi eseguire il deployment di una classe di adattatore per l'agente di raccolta degli indicatori nella tua app per raccogliere gli indicatori, codificarli e passarli all'SDK IMA.

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

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

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

Inviare dati personalizzati

Oltre a utilizzare un provider 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, segui questi passaggi:

1. Crea un oggetto IMASecureSignals contenente i dati personalizzati codificati come stringa.
2. Aggiungi l'oggetto IMASecureSignals alla richiesta di annuncio impostando l'attributo IMAAdsRequest.secureSignals:

Objective-C

BasicExample/ViewController.m

...
- (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];
}
...

Swift

BasicExample/ViewController.swift

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