Partilhar via

Adiar 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 de Personalizador será aposentado no dia 1º de outubro de 2026.

A ativação diferida de eventos permite criar sites personalizados ou campanhas de mailing, considerando que o usuário pode nunca realmente ver a página ou abrir o e-mail. Nesses cenários, o aplicativo pode precisar chamar Rank 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) deve ser assumida para que ele aprenda. A Ativação Adiada permite que você use os resultados de uma chamada de Classificação em um determinado momento e decida se o Evento deve ser aprendido mais tarde ou em outro lugar do seu código.

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

O adiamento da ativação de eventos é útil nos seguintes cenários de exemplo:

  • Você está pré-renderizando 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 e-mails de marketing e precisa evitar o treinamento de e-mails que nunca foram abertos pelos usuários.
  • Você personalizou um canal de mídia dinâmico e seus usuários podem parar de reproduzir o canal antes que ele chegue às músicas ou vídeos selecionados pelo Personalizador.

Em termos gerais, estes cenários acontecem quando:

  • Você está pré-renderizando a interface do usuário que o usuário pode ou não conseguir ver devido à interface do usuário ou restrições de tempo.
  • Seu aplicativo está fazendo 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, posteriormente, ativar eventos

Para adiar a ativação de um evento, chame Rank with deferActivation = True no corpo do legado.

Assim que você souber que seus usuários receberam o conteúdo ou mídia personalizada, e esperar uma recompensa é razoável, você deve ativar esse evento. Para fazer isso, chame a API Activate com o eventId.

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

Comportamento com ativação adiada

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

  • Se você chamar Rank com deferActivation = True, e não chamar a Activate API para esse eventId e chamar Reward, o Personalizador não aprenderá com o evento.
  • Se você chamar Rank com deferActivation = True, e chamar a Activate API para esse eventId e chamar Reward, o Personalizer aprenderá com o evento com a pontuação de Reward especificada.
  • Se você chamar Rank com deferActivation = True, e chamar a Activate API para esse eventId, mas omitir chamar Reward, o Personalizer aprenderá com o evento com a pontuação Default Reward definida na configuração.

Próximos passos