Os indicadores seguros são dados codificados coletados no dispositivo cliente e compartilhados com alguns bidders. Este guia mostra como coletar e enviar sinais seguros para o 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 os bidders.
Usar um provedor de sinal de terceiros
Para usar indicadores seguros, é necessário implantar um script de coletor de indicadores no seu site para coletar, codificar e transmitir os indicadores 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 selecionados, 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 coletor de indicadores escolhidos serão carregados automaticamente.
Confira um exemplo do que você pode encontrar 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>
...
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 do script do provedor de indicadores seguros e incluí-lo manualmente no projeto.
Confira um exemplo do que você pode encontrar 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>
...
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.
Estas são as etapas para projetos HTML5:
- Crie um objeto com estas propriedades:
networkCodeecollectorFunction. - Preencha a propriedade
networkCodecom seu código de rede. - Preencha a propriedade
collectorFunctioncom uma função que retorna uma promessa que é resolvida para seus sinais codificados.
Envie o objeto para a matriz googletag.secureSignalProviders antes de
instanciar o adsLoader para que o SDK do IMA possa acessá-lo para extrair e
transmitir os sinais codificados.
Confira um exemplo em 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);
...