Adiar a ativação de eventos
Importante
A partir de 20 de setembro de 2023, não será mais possível 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 APIActivate
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 APIActivate
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 APIActivate
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
- Como configurar Recompensas padrão.
- Veja como determinar a pontuação da recompensa e quais dados considerar.