Indicadores seguros

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.

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 secuencia de comandos de captador de indicadores en tu sitio para recopilar indicadores, codificarlos y pasarlos al SDK de IMA.

Puedes implementar secuencias de comandos de indicadores seguros de forma automática o manual.

Implementa automáticamente

Cuando selecciones los proveedores de indicadores en Ad Manager, según los proveedores de indicadores seleccionados, es posible que tengas la opción de solicitar a Google que implemente la secuencia de comandos de recopilación de indicadores en tu nombre. Si seleccionas esta opción y tu sitio incluye Etiquetas del publicador de Google, las secuencias de comandos del recopilador de indicadores que elegiste se cargarán automáticamente.

Este es un ejemplo de lo que podrías ver en la IU de Ad Manager:

Este es un ejemplo de lo que podrías ver en el archivo index.html de tu sitio:

...
<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<!-- Load gpt.js, which autoloads all signal provider scripts configured to be deployed by Google. -->
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script src="ads.js"></script>
...

Implementa de forma manual

Si no ves la opción Solicita a Google que implemente la secuencia de comandos de recopilación de indicadores en tu nombre en Ad Manager o si no activas esta opción, debes obtener un vínculo de secuencia de comandos de tu proveedor de indicadores seguros y, luego, incluirlo manualmente en tu proyecto.

Este es un ejemplo de lo que podrías ver en la IU de Ad Manager:

Este es un ejemplo de lo que podrías ver en el archivo index.html de tu sitio:

...
<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<!-- Load signal provider scripts manually, using the unique instructions given by each signal provider. -->
<script src="//cdn.provider1.com/files/a/e/5/4/7/signalCollector.js"></script>
<script src="//provider2.co.uk/ads/signalcollector/script.min.js"></script>
<script src="/local/path/to/third_party_signal_provider_3.js"></script>
<script src="ads.js"></script>
...

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 activar los indicadores personalizados en Ad Manager.

Estos son los pasos para los proyectos HTML5:

  1. Crea un objeto con estas propiedades: networkCode y collectorFunction.
  2. Propaga la propiedad networkCode con tu código de red.
  3. Completa la propiedad collectorFunction con una función que devuelva una promesa que se resuelva en tus indicadores codificados.

Envía el objeto al array googletag.secureSignalProviders antes de crear una instancia de tu adsLoader para que el SDK de IMA pueda acceder a él y recuperar y transmitir tus indicadores codificados.

Este es un ejemplo de JavaScript:

ads.js

...
console.log("initializing IMA");
adContainer = document.getElementById('ad-container');
adDisplayContainer = new google.ima.AdDisplayContainer(adContainer, videoElement);

const NETWORK_CODE = '12345678901';
const signalCollector = () => {
 return new Promise((resolve, reject) => {
   resolve("My encoded signal string");
 });
}
if (!googletag) googletag = {};
if (!googletag.secureSignalProviders) googletag.secureSignalProviders = [];
googletag.secureSignalProviders.push({
 networkCode: NETWORK_CODE,
 collectorFunction: signalCollector
});

adsLoader = new google.ima.AdsLoader(adDisplayContainer);
...