Começar a usar indicadores seguros

Selecione a plataforma: HTML5 Android iOS tvOS

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 do IMA.

A API de indicadores seguros exige 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, é necessário implantar uma classe de adaptador de coletor de indicadores no seu app para coletar, codificar e transmitir os indicadores ao SDK do IMA.

Siga as instruções do provedor terceirizado para criar uma conta, 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 outras mudanças no código.

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

Enviar dados personalizados

Além de usar um provedor de indicadores de terceiros, 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, faça o seguinte:

1. Crie um objeto IMASecureSignals que contenha os dados personalizados codificados como uma string.
2. Adicione o objeto IMASecureSignals à sua solicitação de anúncio definindo o atributo 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)
}
...