Los indicadores seguros son datos codificados que se recopilan en el dispositivo del cliente y se comparten con ofertantes seleccionados. En esta guía, se muestra cómo recopilar y enviar indicadores seguros a Google Ad Manager con el SDK de IMA.
La API de indicadores seguros requiere la versión 3.29.0 o una posterior del SDK de IMA para Android.
Para seleccionar indicadores y ofertantes, y habilitar el uso compartido de indicadores seguros, consulta Cómo compartir indicadores seguros con los ofertantes.
Usa un proveedor de indicadores externo
Para usar indicadores seguros, debes implementar una clase de adaptador de colector de indicadores en tu app para recopilar indicadores, codificarlos y pasarlos al SDK de IMA.
Sigue las instrucciones de tu proveedor externo para configurar una cuenta con él, agregar dependencias de compilación y configurar su adaptador de indicadores seguros en tu app.
El SDK de IMA para Android inicializa automáticamente cada adaptador de indicadores seguros, sin cambios adicionales en tu código.
A continuación, se muestra un ejemplo de cómo puedes agregar un adaptador de indicadores seguros a tu proyecto:
Envía datos personalizados
Además de usar un proveedor de indicadores de terceros, también puedes recopilar, codificar y enviar indicadores con datos personalizados. Para poder enviar indicadores seguros con datos personalizados, debes activarlos en Ad Manager.
Para cada solicitud de anuncio, crea un objeto SecureSignals que contenga tus datos personalizados codificados como una cadena. Luego, llama a adsRequest.setSecureSignals() para agregar el objeto SecureSignals a tu solicitud de anuncios.
Aquí hay un ejemplo 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);
}
...