Безопасные сигналы

Безопасные сигналы — это закодированные данные, которые собираются на клиентском устройстве и передаются избранным участникам торгов. В этом руководстве показано, как собирать и отправлять безопасные сигналы в Google Ad Manager с помощью IMA SDK.

Чтобы выбрать сигналы и системы назначения ставок, а также включить безопасный обмен сигналами, см. раздел «Обмен защищенными сигналами с системами назначения ставок» .

Используйте стороннего поставщика сигналов

Чтобы использовать защищенные сигналы, необходимо развернуть на своем сайте сценарий сборщика сигналов, который будет собирать сигналы, кодировать их и передавать в IMA SDK.

Сценарии защищенных сигналов развертываются автоматически или вручную.

Развертывание автоматически

При выборе поставщиков сигналов в Менеджере рекламы, в зависимости от выбранных вами поставщиков сигналов, вы можете получить возможность попросить Google развернуть сценарий сбора сигналов от вашего имени . Если вы выберете этот вариант и ваш сайт содержит теги издателя Google , выбранные вами сценарии сбора сигналов загружаются автоматически.

Вот пример того, что вы можете увидеть в пользовательском интерфейсе Менеджера рекламы :

Вот пример того, что вы можете увидеть в файле index.html вашего сайта:

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

Развертывание вручную

Если вы не видите опцию «Попросить Google развернуть скрипт сбора сигналов от вашего имени» в Менеджере рекламы или не включаете эту опцию, вам необходимо получить ссылку на скрипт от вашего поставщика безопасных сигналов и вручную включить ее в ваш проект.

Вот пример того, что вы можете увидеть в пользовательском интерфейсе Менеджера рекламы :

Вот пример того, что вы можете увидеть в файле index.html вашего сайта:

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

Отправить пользовательские данные

Помимо использования стороннего поставщика сигналов, вы также можете собирать, кодировать и отправлять сигналы с пользовательскими данными. Прежде чем вы сможете отправлять безопасные сигналы с персонализированными данными, вам необходимо включить специальные сигналы в Менеджере рекламы.

Вот шаги для проектов HTML5:

  1. Создайте объект со следующими свойствами: networkCode и collectorFunction .
  2. Заполните свойство networkCode своим сетевым кодом .
  3. Заполните свойство collectorFunction функцией, которая возвращает обещание, разрешающее ваши закодированные сигналы.

Поместите объект в массив googletag.secureSignalProviders перед созданием adsLoader , чтобы IMA SDK мог получить к нему доступ для получения и передачи закодированных сигналов.

Вот пример JavaScript:

реклама.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);
...