Разбор SegmentRequest

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

Использовать кодировку gzip

Google использует кодирование GZIP при отправке SegmentRequest на вашу конечную точку. Ваша конечная точка должна поддерживать прием и отправку ответов с кодированием GZIP.

Курирование с использованием контекстного сигнала или защищенных конечных точек сигнала

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

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

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

  • SegmentRequest.site : описывает веб-сайт, на котором отображается изображение, например, URL-адрес сайта. В SegmentRequest может быть указан только один из параметров SegmentRequest.site или SegmentRequest.app .
  • SegmentRequest.app : описывает приложение, отображающее изображение, например, идентификатор приложения, специфичный для платформы. В SegmentRequest может быть указан только один из параметров SegmentRequest.site или SegmentRequest.app .
  • SegmentRequest.pub : описывает издателя носителя, создающего отпечаток; например, идентификатор издателя.
  • SegmentRequest.user : описывает выбор пользователя относительно того, как могут обрабатываться его персональные данные; например, с помощью строки согласия TCF.
  • SegmentRequest.device : описывает информацию об устройстве, например, географическое местоположение устройства с точностью до метрополитена.

Вы можете использовать контекстные сигналы для реализации логики курирования, которая может определять применимые сегменты данных для возврата в SegmentResponse .

Используйте безопасные сигналы

Защищённые сигналы — это данные, созданные издателем и предоставленные им одному или нескольким партнёрам. Они обфусцируются перед отправкой в ​​Google в запросе объявления и в Real-time Curation отображаются в обфусцированном виде в SegmentRequest.user.eids.uids.id .

Если ваша конечная точка настроена на использование защищённых сигналов, она будет получать запросы сегментов только для инвентаря издателей, которые решили поделиться защищёнными сигналами с вашим аккаунтом курирования. Следовательно, общее количество показов, доступных для отправки на защищённые конечные точки сигналов, меньше, чем на конечные точки контекстных сигналов.

Логика курирования вашей конечной точки должна интерпретировать защищенный сигнал и использовать защищенный сигнал для определения применимых сегментов данных для возврата в SegmentResponse .

Примеры SegmentRequest

Контекстный сигнал Конечная точка курирования в реальном времени 

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

Защищенный сигнал Конечная точка курирования в реальном времени 

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

Следующие шаги