Integrar adaptadores de indicadores seguros

Selecione a plataforma: HTML5 Android iOS tvOS

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, codificar e transmitir indicadores ao SDK do IMA.

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

Implantar automaticamente

Ao selecionar provedores de indicadores no Ad Manager, dependendo dos provedores selecionados, você pode receber a opção 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 Google Publisher, 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 ver 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 você não encontrar a opção Pedir ao Google para implantar o script de coleta de indicadores em seu nome no Ad Manager ou se não ativar essa opção, será necessário receber um link de script do 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 ver 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 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.

Confira as etapas para projetos HTML5:

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

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

Confira um exemplo de 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