Функции обработчика данных

Как использовать защищенные сигналы, если у вас нет GPT SDK или IMA SDK

В этой статье рассказывается о том, как издатели могут самостоятельно собирать защищенные сигналы и включать их значения в запросы объявлений (в частности, для инвентаря на подключенных телевизорах), если нет возможности использовать библиотеку тега Google Publisher Tag (GPT) или Interactive Media Ads (IMA) SDK.

Примечание. В число IMA SDK входят как клиентские IMA SDK, так и IMA DAI SDK.

Google Менеджер рекламы собирает защищенные сигналы по запросам ставок и отвечает за их отправку, если используется GPT или IMA SDK. Однако издатели, которые не могут или не хотят использовать какой-либо из поддерживаемых SDK, могут самостоятельно собирать значения защищенных сигналов и включать их в запросы объявлений.

Чаще всего так можно (и нужно) поступать при показе на инвентаре для подключенных телевизоров.

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

Требования

Издателям, которые хотят реализовать интеграцию защищенных сигналов без IMA SDK, нужно действовать в следующем порядке:

Издатель создает JSON-файл для всех сигналов, которые нужно отправить в запросе объявления. Желательно (но не обязательно) использовать при этом механизм кеширования, чтобы уменьшить время отправки запроса объявления.
Издатель преобразовывает JSON-файл в зашифрованную строку формата websafe base64.
Издатель создает запрос объявления, который будет включать параметр SSJ с закодированной строкой в качестве значения.
После получения сигналов покупатель обязан уничтожить полученную информацию.

Техническая информация

Пример

Ниже приведен файл JSON, включающий два сигнала: один – предоставленный сторонним поставщиком сигналов SOURCE1, а второй – специальный защищенный сигнал издателя с названием 123, указанным после кода сети издателя. Данные DATA1 создаются с помощью функции, предоставленной поставщиком сигнала SOURCE1, а DATA2 – с помощью функции, созданной издателем:

{

      "signals": [

        {

          "source": "SOURCE1",

          "data": "DATA1",

          "isPubCreated": false

        },

        {

          "source": "123",

          "data": "DATA2",

          "isPubCreated": true

        }  ]

    }

Источник сигнала: "SOURCE1" – сторонний сигнал

source – идентификатор source_id стороннего IDP (предоставляется поставщиком при регистрации);
data – выходные данные библиотеки поставщика сигнала;
элемент isPubCreated принимает значение false.

Источник сигнала: "123" – специальные защищенные сигналы, создаваемые издателем

source – код сети издателя;
data – сигнал, созданный издателем, который участник аукциона должен быть способен расшифровать;
элемент isPubCreated принимает значение true.

После использования JSON.stringify()
[]"signals":"{"source":"SOURCE1","data":"DATA1","isPubCreated":false},{"source":"123","data":"DATA2","isPubCreated":true}]]

После кодирования по методу Base64

eyJzaWduYWxzIjpbeyJzb3VyY2UiOiJTT1VSQ0UxIiwiZGF0YSI6IkRBVEExIiwiaXNQdWJDcmVhdGVkIjpmYWxzZX0seyJzb3VyY2UiOiIxMjMiLCJkYXRhIjoiREFUQTIiLCJpc1B1YkNyZWF0ZWQiOnRydWV9XX0=

После кодирования по методу websafe

eyJzaWduYWxzIjpbeyJzb3VyY2UiOiJTT1VSQ0UxIiwiZGF0YSI6IkRBVEExIiwiaXNQdWJDcmVhdGVkIjpmYWxzZX0seyJzb3VyY2UiOiIxMjMiLCJkYXRhIjoiREFUQTIiLCJpc1B1YkNyZWF0ZWQiOnRydWV9XX0%3D

Эта информация оказалась полезной?

Как можно улучшить эту статью?