Os indicadores seguros são dados codificados coletados no dispositivo cliente e compartilhados com alguns bidders. Este guia mostra como coletar e enviar indicadores seguros ao Google Ad Manager usando o SDK do IMA.
A API Secure Signals requer a versão 3.29.0 ou mais recente do SDK do IMA para Android.
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, adicionar dependências de build e configurar o adaptador de indicadores seguros no app.
O SDK do IMA para Android inicializa automaticamente cada adaptador de sinais seguros, sem outras mudanças no 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 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 SecureSignals contendo os dados personalizados
codificados como uma string. Em seguida, adicione o objeto SecureSignals à solicitação de anúncio chamando adsRequest.setSecureSignals().
Confira um exemplo de Java:
app/src/main/java/com/example/project name/MainActivity.java
...
private void requestAds(String adTagUrl) {
// Create the ads request.
AdsRequest request = sdkFactory.createAdsRequest();
request.setAdTagUrl(adTagUrl);
request.setContentProgressProvider(
() -> {
if (videoPlayer.getDuration() <= 0) {
return VideoProgressUpdate.VIDEO_TIME_NOT_READY;
}
return new VideoProgressUpdate(
videoPlayer.getCurrentPosition(), videoPlayer.getDuration());
});
SecureSignals signal = SecureSignals.create("My encoded signal string");
request.setSecureSignals(signal);
// Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
adsLoader.requestAds(request);
}
...