Integrar adaptadores de indicadores seguros

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.

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, implante um script de coleta de indicadores no seu site para coletar e codificar indicadores e transmiti-los ao SDK do IMA.

Você implanta scripts de indicadores seguros de forma automática ou manual.

Implantar automaticamente

Ao selecionar provedores de indicadores no Ad Manager, dependendo dos provedores escolhidos, você pode ter a opção de Pedir ao Google para implantar o script de coleta de indicadores em seu nome. Se você selecionar essa opção e seu site incluir tags do editor do Google, os scripts de coleta de indicadores escolhidos serão carregados automaticamente.

Confira um exemplo do que você pode ver na interface do Ad Manager:

Confira um exemplo do que você pode encontrar no arquivo index.html do seu site:

<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>
auto_load.html

Implantar manualmente

Se a opção Pedir ao Google para implantar o script de coleta de indicadores em seu nome não aparecer no Ad Manager ou se você não ativar essa opção, será necessário receber um link de script do seu provedor de indicadores seguros e incluí-lo manualmente no seu projeto.

Confira um exemplo do que você pode ver na interface do Ad Manager:

Confira um exemplo do que você pode encontrar no arquivo index.html do seu site:

<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>
manual_load.html

Enviar dados personalizados

Além de usar um provedor de indicadores terceirizado, 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.

Estas são as etapas para projetos em HTML5:

  1. Crie um objeto com estas propriedades: networkCode e collectorFunction.
  2. Preencha a propriedade networkCode com seu código de rede.
  3. Preencha a propriedade collectorFunction com uma função que retorne uma promessa que seja resolvida com seus indicadores codificados.

Envie o objeto para a matriz googletag.secureSignalProviders antes de instanciar o adsLoader para que o SDK do IMA possa acessá-lo para recuperar e transmitir seus indicadores codificados:

Confira um exemplo em JavaScript:

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

const NETWORK_CODE = '21775744923';

/**
 * Sample signal collector function.
 * @return {!Promise<string>} A promise that resolves to the encoded signals.
 */
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);

auto_load.js