Разбор 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 в запросе на показ они обфусцируются и в режиме реального времени отображаются в обфусцированном виде в 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" }
      ]
    }]
  }
}

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