Поделиться через

Откладывание активации события

  • Статья

Внимание

Начиная с 20 сентября 2023 г. вы не сможете создавать новые ресурсы Персонализатора. Служба Персонализатора отменяется 1 октября 2026 года.

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

Типичные сценарии для отложенной активации

Откладывание активации событий полезно в следующих примерах сценариев:

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

Обычно такие сценарии возникают, когда:

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

Как отложить активацию, а затем активировать события

Чтобы отложить активацию события, вызовите ранжирование с deferActivation = True в тексте запроса.

Как только вы узнаете, что ваши пользователи отображали персонализированное содержимое или мультимедиа, и ожидание вознаграждения является обоснованным, вы должны активировать это событие. Для этого нужно вызвать API активации с EventID.

Вызов API активации для этого вызова EventID должен быть получен до истечения времени ожидания вознаграждения.

Поведение с отложенной активацией

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

  • Если вы вызываете ранжирование с deferActivation = True и не вызываете Activate API для этого eventId, а вызываете вознаграждение, Персонализатор не учится на событии.
  • Если вы вызываете ранжирование с deferActivation = True и выполняете вызов API Activate для этого eventId, а также вызываете вознаграждение, Персонализатор будет обучаться на событии с указанной оценкой вознаграждения.
  • Если вы вызываете ранжирование с deferActivation = True и выполняете вызов API Activate для этого eventId, но не вызываете вознаграждение, Персонализатор будет обучаться на событии с оценкой вознаграждения по умолчанию, установленной в конфигурации.

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