Bezpieczne sygnały

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 przesył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, przeczytaj artykuł Udostępnianie licytującym bezpiecznych sygnałów.

Korzystanie z zewnętrznego dostawcy sygnałów

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

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

Wdrażaj automatycznie

Podczas wybierania dostawców sygnałów w usłudze Ad Manager w zależności od wybranych dostawców możesz mieć opcję 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>
...

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 jeśli nie włączysz tej opcji, musisz uzyskać link do skryptu od dostawcy bezpiecznych sygnałów i ręcznie go dodać 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>
...

Wysyłanie danych niestandardowych

Uwaga: sygnały zabezpieczone za pomocą danych niestandardowych to ograniczona funkcja w wersji beta, która może nie być dostępna w Twojej sieci. Aby uzyskać dostęp do tej funkcji, skontaktuj się ze swoim opiekunem klienta.

Oprócz korzystania z zewnętrznego dostawcy sygnałów możesz też zbierać, kodować i wysyłać sygnały z danymi niestandardowymi. Aby móc wysyłać bezpieczne sygnały z danymi niestandardowymi, musisz włączyć sygnały niestandardowe w usłudze Ad Manager.

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 właściwość networkCode kodem sieci.
3. Właściwość collectorFunction wypełnij funkcją, która zwraca obietnicę, która rozwiązuje się do zakodowanych sygnałów.

Przed utworzeniem instancji adsLoader prześlij obiekt do tablicy googletag.secureSignalProviders, aby pakiet IMA SDK mógł uzyskać do niego dostęp w celu pobierania i przesyłania zakodowanych sygnałów.

Oto przykład kodu 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);
...