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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Как настроить вознаграждения по умолчанию.
• Узнайте, как определить оценку вознаграждения и какие данные следует учитывать.