Integrar adaptadores de indicadores seguros

Os indicadores seguros são dados codificados coletados no dispositivo do cliente e compartilhados com bidders selecionados. Este guia mostra como coletar e enviar indicadores seguros ao Google Ad Manager usando o SDK IMA.

A API Secure Signals requer a versão 4.8.2 ou mais recente do SDK do IMA para tvOS.

Para selecionar indicadores e bidders e ativar o compartilhamento de indicadores seguros, consulte Compartilhar indicadores seguros com bidders.

Usar um provedor de indicadores de terceiros

Para usar indicadores seguros, implante uma classe adaptadora de coletor de indicadores no seu app para coletar indicadores, codificá-los e transmiti-los ao SDK do IMA.

Siga as instruções do provedor terceirizado para configurar uma conta com ele, incluir frameworks, e configurar o adaptador de indicadores seguros no seu app.

O SDK do IMA para tvOS inicializa automaticamente cada adaptador de indicadores seguros, sem mudanças adicionais no seu código.

Confira um exemplo de como adicionar um adaptador de indicadores seguros ao seu projeto:

Enviar dados personalizados

Além de usar um provedor de indicadores terceirizado, você também pode coletar, codificar e enviar indicadores com dados personalizados. Antes de enviar indicadores seguros com dados personalizados, ative os indicadores personalizados no Ad Manager.

Para cada solicitação de anúncio, crie um objeto IMASecureSignals que contenha seus dados personalizados codificados como uma string. Em seguida, adicione o objeto IMASecureSignals à solicitação de anúncio chamando o atributo IMAAdsRequest.secureSignals.

Confira exemplos em Objective-C e Swift:

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