Integracja adapterów bezpiecznych sygnałów

Wybierz platformę: HTML5 Android iOS tvOS

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

Korzystanie z zewnętrznego dostawcy sygnałów

Aby korzystać z bezpiecznych sygnałów, musisz wdrożyć w 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 wdrożyć automatycznie lub ręcznie.

Automatyczne wdrażanie

Gdy wybierasz dostawców sygnałów w Ad Managerze, w zależności od wybranych dostawców może pojawić się opcja Poproś Google o wdrożenie skryptu zbierania sygnałów w Twoim imieniu. Jeśli wybierzesz tę opcję, a Twoja witryna zawiera tagi wydawcy Google, wybrane skrypty zbierające sygnały zostaną załadowane automatycznie.

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

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

<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>
auto_load.html

Ręczne wdrażanie

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 pobrać 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 UI:

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

<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>
manual_load.html

Wysyłanie danych niestandardowych

Oprócz korzystania z zewnętrznego dostawcy sygnałów 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.

Oto instrukcje dotyczące projektów HTML5:

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

Zanim utworzysz instancję `streamManager` , dodaj obiekt do tablicy googletag.secureSignalProviders, 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");
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);

auto_load.js