Inizia a utilizzare gli indicatori sicuri

Seleziona la piattaforma: HTML5 Android iOS tvOS

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

L'API Secure Signals richiede la versione 4.8.2 o successive dell'SDK IMA per tvOS.

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

Utilizza un fornitore di indicatori di terze parti

Per utilizzare gli indicatori sicuri, devi implementare una classe di adattatore per l'agente di raccolta degli 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 per l'indicatore sicuro nella tua app.

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

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

Invia 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, segui questi passaggi:

1. Crea un oggetto IMASecureSignals contenente i dati dei clienti 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)
}
...