Integracja adapterów bezpiecznych sygnałów

Bezpieczne sygnały to zakodowane dane zbierane na urządzeniu klienta i udostępniane wybranym licytującym. Z tego przewodnika dowiesz się, jak zbierać i wysyłać bezpieczne sygnały do Google Ad Managera za pomocą pakietu IMA SDK.

Aby wybrać sygnały i licytujących oraz włączyć udostępnianie bezpiecznych sygnałów, zapoznaj się z artykułem Udostępnianie bezpiecznych sygnałów licytującym.

Korzystanie z usługi zewnętrznego dostawcy sygnałów

Aby korzystać z bezpiecznych sygnałów, musisz wdrożyć w witrynie skrypt podmiotu zbierającego sygnały, który będzie zbierać sygnały, kodować je i przekazywać do pakietu IMA SDK.

Skrypty bezpiecznych sygnałów możesz wdrażać automatycznie lub ręcznie.

Automatyczne wdrażanie

Podczas wybierania dostawców sygnałów w Ad Managerze w zależności od wybranych dostawców sygnałów możesz mieć możliwość poproszenia Google o wdrożenie skryptu zbierania sygnałów w Twoim imieniu. Jeśli wybierzesz tę opcję, a Twoja witryna zawiera tagi wydawcy Google, wybrane przez Ciebie skrypty zbierania sygnałów będą wczytywane automatycznie.

Oto przykład tego, co możesz zobaczyć w interfejsie Ad Managera:

Oto przykład tego, co możesz zobaczyć w pliku index.html witryny:

<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

Wdrażanie ręczne

Jeśli w Ad Managerze nie widzisz opcji Poproś Google o wdrożenie skryptu zbierania sygnałów w Twoim imieniu lub nie włączysz tej opcji, musisz uzyskać link do skryptu od dostawcy bezpiecznych sygnałów i ręcznie dodać go do projektu.

Oto przykład tego, co możesz zobaczyć w interfejsie Ad Managera:

Oto przykład tego, co możesz zobaczyć w pliku index.html witryny:

<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

Wysyłanie danych niestandardowych

Oprócz korzystania z usług dostawcy sygnałów zewnętrznych możesz też zbierać, kodować i wysyłać sygnały z danymi niestandardowymi. Zanim zaczniesz wysyłać bezpieczne sygnały z danymi niestandardowymi, musisz włączyć sygnały niestandardowe w Ad Managerze.

W przypadku projektów HTML5 wykonaj te czynności:

  1. Utwórz obiekt z tymi właściwościami: networkCode i collectorFunction.
  2. Wypełnij pole networkCode swoim kodem sieci.
  3. Wypełnij właściwość collectorFunction funkcją, która zwraca obietnicę, która jest rozwiązywana w postaci zakodowanych sygnałów.

Przesuń obiekt do tablicy googletag.secureSignalProviders przed utworzeniem instancji adsLoader, aby pakiet IMA SDK mógł uzyskać do niego dostęp w celu pobrania i przesłania zakodowanych sygnałów:

Oto przykład w 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