Os indicadores seguros são dados codificados coletados no dispositivo cliente e compartilhados com alguns bidders. Este guia mostra como coletar e enviar sinais seguros para o Google Ad Manager usando o SDK do IMA.
A API Secure Signals requer a versão 3.18.1 ou mais recente do SDK do IMA para iOS.
Para selecionar indicadores e bidders e ativar o compartilhamento de indicadores seguros, consulte Compartilhar indicadores seguros com os bidders.
Usar um provedor de sinal de terceiros
Para usar indicadores seguros, é necessário implantar uma classe de adaptador de coletor de indicadores no app para coletar, codificar e transmitir os indicadores ao SDK do IMA.
Siga as instruções do provedor de terceiros para configurar uma conta, incluir frameworks e configurar o adaptador de indicadores seguros no app.
O SDK do IMA para iOS inicializa automaticamente cada adaptador de sinais seguros, sem nenhuma mudança adicional no código.
Confira um exemplo de como adicionar um adaptador de sinais 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, crie um objeto IMASecureSignals que contenha os
dados personalizados codificados como uma string. Em seguida, adicione o objeto IMASecureSignals à
sua 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)
}
...