Сигналы, предоставленные издателем

Вы можете отправлять данные об аудитории и контекстуальные данные в виде сигналов издателя (PPS) в запросах объявлений. С помощью PPS вы можете использовать свои пользовательские данные для улучшения программной монетизации, сообщая характеристики своей аудитории участникам торгов во всех типах транзакций , используя стандартную таксономию, без необходимости делиться идентификаторами пользователей. Характеристики вашей аудитории могут включать данные о поведении и интересах ( Таксономия аудитории IAB 1.1 ), а также контекстные данные ( Таксономия контента IAB 2.2 ). Вы также можете отправлять структурированные сигналы, предоставленные издателем, которые определены Google, и позволяют отправлять дополнительные сигналы.

Создайте пользовательские сигналы JSON

На верхнем уровне создайте объект JSON с одной парой ключ-значение. Ключ должен быть PublisherProvidedTaxonomySignals , а его значение должно быть массивом объектов. Каждый объект в массиве должен иметь две пары ключ-значение:

  • Ключ taxonomy , который принимает следующие значения, сопоставленные со следующими общедоступными спецификациями IAB:

    • IAB_AUDIENCE_1_1 для таксономии аудитории 1.1
    • IAB_CONTENT_2_2 для таксономии контента 2.2

  • Ключ values с соответствующим массивом значений строковой таксономии.

Создайте массив структурированных сигналов

Для структурированных сигналов добавьте ключ PublisherProvidedStructuredSignals со значением массива объектов. Создайте объект на основе следующего списка значений ключа сигнала:

Переключить вид таблицы структурированных сигналов

Сигнал «тип» Значение Возможные значения "single_value" Возможные "values" Значения
Тип аудиоканала "audio_feed"
  • "af_1" : Музыка
  • "af_2" : Трансляция
  • "af_3" : Подкаст
 н/д
Рейтинг контента "content_rating"
  • "cr_1" : Г
  • "cr_2" : PG
  • "cr_3" : Т
  • "cr_4" : МА
 н/д
Доставка контента "delivery" н/д
  • "cd_1" : потоковая передача
  • "cd_2" : прогрессивный
  • "cd_3" : Скачать
Качество производства "prodq"
  • "pq_1" : профессионально созданный.
  • "pq_2" : Потребитель
  • "pq_3" : созданный пользователем (пользовательский контент).
 н/д

См. следующий пример, в котором IAB_AUDIENCE_1_1 и IAB_CONTENT_2_2 используются для сигналов таксономии и включают структурированные сигналы.

const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
     // '6' = 'Demographic | Age Range | 30-34'
     // '284' = 'Interest | Business and Finance |  Mergers and Acquisitions'
  },
  {
     "taxonomy": "IAB_CONTENT_2_2",
     "values": ["49", "138"]
     // '49' = 'Books and Literature | Poetry'
     // '138' = 'Education | College Education | College Planning'
  }],
  "PublisherProvidedStructuredSignals": [{
      "type": "audio_feed",
      "single_value": "af_1",
    },
    {
      "type": "delivery",
      "values": ["cd_1", "cd_3"],
    },
  ],
};

Настройте запрос объявления

Выполните следующие действия, чтобы отправить PPS с вашим IMAAdsRequest :

  • Создайте строку JSON с интересами, поведением или контекстными данными пользователя.
  • Создайте строку ASCII в кодировке Base64 из приведенной выше строки JSON.
  • Добавьте закодированную строку к URL-адресу тега объявления с помощью параметра &ppsj= . 
let userSignals = """
{
   "PublisherProvidedTaxonomySignals": [
    {
      "taxonomy": "IAB_AUDIENCE_1_1",
      "values": [
        "1",
        "284"
      ]
    }
  ],
}
"""
let base64Signals = Data(userSignals.utf8).base64EncodedString()
var encodedSignals = base64Signals.replacingOccurrences(of: "+", with: "%2B")
encodedSignals = encodedSignals.replacingOccurrences(of: "/", with: "%2F")
encodedSignals = encodedSignals.replacingOccurrences(of: "=", with: "%3D")


let finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals