Adiar a ativação de eventos

  • Artigo

Importante

A partir de 20 de setembro de 2023, você não poderá criar novos recursos do Personalizador. O serviço Personalizador está sendo desativado no dia 1º de outubro de 2026.

A ativação adiada de eventos permite que você crie sites personalizados ou campanhas de email, considerando que o usuário pode nunca realmente ver a página ou abrir o email. Nesses cenários, o aplicativo talvez precise chamar a Classificação antes mesmo de saber se o resultado será usado ou exibido para o usuário. Se o conteúdo nunca for mostrado ao usuário, nenhuma Recompensa padrão (normalmente zero) deverá ser assumida para que ele aprenda. A ativação adiada permite que você use os resultados de uma chamada de classificação em um ponto no tempo e decida se o evento deve ser aprendido posteriormente ou em outro lugar no código.

Cenários típicos para ativação adiada

Adiar a ativação de eventos é útil nos seguintes cenários de exemplo:

  • Você está renderizando previamente uma página da Web personalizada para um usuário, mas o usuário pode nunca conseguir vê-la porque alguma lógica de negócios pode substituir a opção de ação do Personalizador.
  • Você está personalizando o conteúdo "abaixo da dobra" em uma página da Web e é altamente possível que o conteúdo nunca seja visto pelo usuário.
  • Você está personalizando emails de marketing e precisa evitar o treinamento de emails que nunca foram abertos pelos usuários.
  • Você personalizou um canal de mídia dinâmico e os usuários podem parar de executar o canal antes que ele chegue às músicas ou vídeos selecionados pelo Personalizador.

Em termos gerais, esses cenários ocorrem quando:

  • Você está renderizando previamente a interface do usuário que o usuário pode ou não ver devido a restrições de interface do usuário ou hora.
  • Seu aplicativo está fazendo a personalização preditiva na qual você faz chamadas de classificação antes de saber se usará a saída.

Como adiar a ativação e ativar eventos posteriormente

Para adiar a ativação de um evento, chame Classificação com deferActivation = True no corpo da solicitação.

Assim que você souber que os usuários mostraram o conteúdo personalizado ou a mídia e esperar uma Recompensa é razoável, você deve ativar esse evento. Para fazer isso, chame a API de ativação com a EventID.

A chamada ativar API para essa chamada EventID deve ser recebida antes que a janela Tempo de espera de recompensa expire.

Comportamento com ativação adiada

O Personalizador aprenderá com eventos e recompensas da seguinte forma:

  • Se você chamar Classificação com deferActivation = True e não chamar a API Activate para essa EventID e chamar Recompensa, o Personalizador não aprenderá com o evento.
  • Se você chamar Classificação com deferActivation = True e não chamar a API Activate para essa EventID e chamar Recompensa, o Personalizador irá aprenderá com o evento com a pontuação especificada da Recompensa.
  • Se você chamar Classificação com deferActivation = True e não chamar a API Activate para essa EventID e chamar Recompensa, o Personalizador aprenderá com o evento com a pontuação especificada da Recompensa definida na configuração.

Próximas etapas