Configurar regras de evento

As Regras de eventos estendem o Conversion Rules para validar eventos pós-instalação com base nas condições personalizadas que você definiu.
Quando um evento não cumpre essas condições, a Adjust o rejeita e avisa sobre a rejeição nos callbacks, nas exportações de CSV e nos relatórios.

Antes de começar

O que você precisa saber antes de começar.

Requisitos

• Usuários com permissões de Administrador, Editor ou Editor personalizado na Adjust.
• Um aplicativo multiplataforma ou de plataforma única na Adjust.

Configurar uma regra de evento

Para definir uma regra de evento, siga os passos abaixo:

1. No AppView, abra Eventos e assinaturas e selecione o evento que queira validar.

2. Selecione Editar evento .

3. Vá até o monitoramento que deseja configurar.

4. Escolha uma das seguintes opções de status:

   • Ativo - Quando a regra é salva, o monitoramento fica ativo no sistema da Adjust. Os eventos que não cumprirem os requisitos de monitoramento serão rejeitados .
   • Teste - Quando a regra é salva, o monitoramento fica ativo no sistema da Adjust. Os eventos que não cumprirem os requisitos de monitoramento não serão rejeitados , e sim sinalizados e relatados.
   • Pausado - A regra não é aplicada a nenhum evento. Use esse status para salvar suas alterações sem ativá-las.

5. Configure um ou mais monitoramentos (veja Monitoramentos).

6. Selecione Save changes (Salvar alterações).

Remover um monitoramento de regras de evento

Para remover um monitoramento, basta definir seu status como Desativado .

Monitoramentos

É possível aplicar vários monitoramentos na sua regra de evento.
Se qualquer monitoramento com o status Ativo apresentar erros, o evento será rejeitado .

Filtros-alvo

Use filtros de destino para restringir o tráfego ao qual cada verificação se aplica. Os filtros são configurados por verificação e não afetam outras verificações na mesma regra.

Canais

Restrinja a verificação apenas a canais de tráfego específicos. Por padrão, a verificação se aplica a todos os canais.

Instalar versão do aplicativo

Restringa a verificação a usuários que instalaram uma versão específica do app. Use isso para garantir que a lógica da regra seja aplicada apenas a usuários para os quais ela é válida e significativa — por exemplo, usuários que instalaram uma versão onde todos os eventos e fluxos referenciados pela regra já faziam parte do app.

Controle de fonte

Use isso para controlar qual fonte de evento é aceita e para lidar com eventos que não estão mais ativos no seu app.

Fonte de evento aceita

Restringe quais fontes de eventos serão aceitas.

• SDK - Aceita apenas eventos vindos do SDK.
• S2S - Aceita apenas eventos de servidor para servidor (S2S).

Se um evento vier de uma fonte não permitida, ele será rejeitado.

Evento descontinuado

Rejeite o evento se ele tiver sido removido do app e não estiver mais sendo acionado. Use isso para invalidar quaisquer acionadores restantes para eventos que não fazem mais parte do fluxo de eventos do seu app.

Controle de fluxo

Use-o para controlar a sequência esperada, o timing e os parâmetros necessários de eventos.
Você pode selecionar várias condições. Neste caso, todas as condições selecionadas precisam sem preenchidas para que o evento seja aprovado. Do contrário, o evento será rejeitado.

Tempo após a instalação

Exija que o evento ocorra dentro de ou após um período específico após a instalação.
Por exemplo: "Maior que ou igual a 5 minutos após a instalação".

Evento anterior obrigatório

Exija que um evento específico (como Nível 1 ) ocorra antes desse evento. Como uma restrição adicional, você pode também especificar um tempo mínimo ou máximo entre o evento anterior necessário e o atual.

Evento não pode acontecer se... - exclusão mútua de eventos específicos

Rejeite o evento se um outro evento especificado já foi acionado para esse usuário. Use isso para impor exclusão mútua entre dois eventos — se um ocorreu, o outro é bloqueado.
Exemplo: " a compra não pode ser efetuada se o reembolso já tiver sido realizado".

O último disparo do evento aconteceu no mínimo antes — supressão de eventos baseada no tempo

Rejeite o evento se ele tiver sido acionado há menos de um determinado período de tempo. Use isso para limitar a frequência com que o mesmo evento pode ser aceito para um determinado usuário.
Exemplo: "o último gatilho da compra aconteceu há no mínimo 5 minutos ."

Parâmetros obrigatórios

Exija que parâmetros específicos do SDK (como user_id e transaction_id) estejam no payload do evento. Você pode adicionar vários parâmetros. Quando vários parâmetros são definidos, todos precisam estar presentes para que o evento seja aprovado no monitoramento.

Controle de receita

Use esse monitoramento para validar eventos monetizados para completude e verificação de compra.
Ele será aprovado ou não com base no resultado da Verificação de compra .
Ative a opção de também rejeitar eventos com dados de transação ausentes.

Configuração de controle de receita

A configuração da verificação de compra é gerenciada em AppView -> Protection -> Verificação de compra .
Para usar os resultados da verificação de compra no fluxo de controle de receita, é preciso trocar do Modo antigo para o Modo de evento primeiro.

• Verificação de compra não configurada para regras de eventos

• Exemplo de configuração de verificação de compra

Compartilhamento de dados

Os eventos rejeitados serão relatados como:

• Callbacks e exportações de CSV quando um alerta de Evento rejeitado é configurado. O placeholder {rejection_reason} é informado com valores granulares por verificação:

  • post_install_activity_event_rule_source_check
  • post_install_activity_event_rule_flow_check
  • post_install_activity_event_rule_pv_status_check

• Métricas de eventos rejeitados e taxa de eventos rejeitados em relatórios, com detalhamento do motivo da rejeição :

  • rejected_events_post_install_activity_event_rule_source_check (Verificação da fonte da regra de evento)
  • rejected_events_post_install_activity_event_rule_flow_check (Verificação do fluxo de regras de evento)
  • rejected_events_post_install_activity_event_rule_pv_status_check (Verificação de status PV da regra de evento)
  • rejected_events_post_install_activity_rule (Filtros de atividade pós-instalação) — preservados para compatibilidade retroativa

Resultados do modo de teste

As regras com o status de Teste não rejeitam eventos mesmo se a regra apresentar erros. Resultados rejeitados são compartilhados apenas com os clientes — eles não são encaminhados para parceiros.

Para distinguir resultados de teste dos resultados ao vivo, adicione o placeholder {conversion_rule_status} às suas callbacks ou à configuração de exportação CSV. O placeholder retorna test quando a regra está em status de teste e live quando a regra está em status ao vivo.