Gli indicatori sicuri sono dati codificati raccolti sul dispositivo client e condivisi con offerenti selezionati. Questa guida spiega come raccogliere e inviare indicatori sicuri a Google Ad Manager utilizzando l'SDK IMA.
Per selezionare indicatori e offerenti e attivare la condivisione degli indicatori sicuri, consulta Condividere indicatori sicuri con gli offerenti.
Utilizzare un fornitore di indicatori di terze parti
Per utilizzare gli indicatori sicuri, devi eseguire il deployment di uno script di raccolta degli indicatori sul tuo sito per raccoglierli, codificarli e passarli all'SDK IMA.
Esegui il deployment degli script degli indicatori sicuri automaticamente o manualmente.
Eseguire il deployment automaticamente
Quando selezioni i fornitori di indicatori in Ad Manager, a seconda dei fornitori selezionati, potresti avere la possibilità di chiedere a Google di eseguire il deployment dello script di raccolta degli indicatori per tuo conto. Se selezioni questa opzione e il tuo sito include i tag publisher di Google, gli script di raccolta degli indicatori che hai scelto vengono caricati automaticamente.
Ecco un esempio di ciò che potresti vedere nell'interfaccia utente di Ad Manager:
Ecco un esempio di ciò che potresti vedere nel file index.html del tuo sito:
<script src="//imasdk.googleapis.com/js/sdkloader/ima3_dai.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="dai.js"></script>
Eseguire il deployment manualmente
Se non vedi l'opzione Chiedi a Google di eseguire il deployment dello script di raccolta degli indicatori per tuo conto in Ad Manager o se non attivi questa opzione, devi ottenere un link allo script dal tuo fornitore di indicatori sicuri e includerlo manualmente nel tuo progetto.
Ecco un esempio di ciò che potresti vedere nell'interfaccia utente di Ad Manager:
Ecco un esempio di ciò che potresti vedere nel file index.html del tuo sito:
<script src="//imasdk.googleapis.com/js/sdkloader/ima3_dai.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="dai.js"></script>
Inviare dati personalizzati
Oltre a utilizzare un fornitore di indicatori di terze parti, puoi anche raccogliere, codificare e inviare indicatori con dati personalizzati. Prima di poter inviare indicatori sicuri con dati personalizzati, devi attivare gli indicatori personalizzati in Ad Manager.
Ecco i passaggi per i progetti HTML5:
- Crea un oggetto con le seguenti proprietà:
networkCodeecollectorFunction. - Inserisci il tuo
codice di rete nella proprietà
networkCode. - Inserisci una funzione che restituisce una promessa che si risolve con gli indicatori codificati nella proprietà
collectorFunction.
Inserisci l'oggetto nell'array googletag.secureSignalProviders prima di
creare l'istanza
`streamManager`
in modo che l'SDK IMA possa accedervi per recuperare e trasmettere gli indicatori
codificati:
Ecco un esempio in JavaScript:
console.log("initializing IMA");
videoElement = document.getElementById('video');
adUiElement = document.getElementById('adUi');
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
});
streamManager = new google.ima.dai.api.StreamManager(videoElement, adUiElement);