Defina regras de conversão

Conversion Rules é um recurso avançado do pilar de Proteção . Ele permite validar as instalações e os engajamentos do usuário aplicando regras personalizadas definidas por você.

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.

Defina uma regra de conversão

Para definir uma regra de conversão, siga os passos abaixo:

1. Em Proteção , selecione Conversion Rules .

2. Selecione Nova regra de conversão .

3. Insira um nome para sua regra.

4. Escolha entre um dos seguintes status:

   • Ativo - A regra é aplicada às atribuições imediatamente quando as condições forem cumpridas.
   • Teste - Use esse status para testar sua regra de conversão. Para regras de conversão com status de teste , nós não alteramos a fonte de atribuição, nem enviamos callbacks.
   • Pausado - Sua regra não é aplicada a nenhuma atribuição.

5. Selecione seu aplicativo.

6. Selecione um tipo de regra e configure-a de acordo.

   • Loja
   • Região
   • Versão
   • Parâmetro
   • Correspondência entre região e campanhas
   • Correspondência entre versão e campanhas

7. Selecione Criar regra.

Uma vez que a regra estiver ativa , a Adjust compara os dados de atribuição com a regra de configuração. Isso pode mudar os resultados da sua atribuição. Você vai ver essas mudanças na exportação de dados brutos e no Datascape. Para quaisquer regras com status de teste , nós não alteramos a fonte de atribuição nem enviamos callbacks.

Comportamentos de atribuição

Para alguns tipos de regras específicos, é possível definir como os resultados de atribuição são trabalhados. Estas são as opções disponíveis:

Dispositivos não verificados

• Instalações de dispositivos não verificados serão sinalizadas como não verificado .

• A Adjust retém os postbacks e dados agregados.

  • Os dados brutos são compartilhados como uma atividade unverified_install para dispositivos não verificados.
  • As fontes recebem callbacks padrão install sem nenhuma mudança na atribuição de instalação .
  • O relatório da coorte está disponível até o nível da campanha .

• Os dispositivos não verificados não podem ser reatribuídos.

Dispositivos não confiáveis

• Isso representa o nível mais alto de severidade.

• As instalações de dispositivos não confiáveis serão rejeitadas .

  • Os postbacks de instalação serão enviados, mas a instalação será marcada como não atribuída .
  • As fontes podem receber callbacks rejected_install , que podem incluir campos como click_id e o motivo para a rejeição. Esses dados são fornecidos para fins de diagnóstico e de análise de fraude.
  • O relatório de coorte está limitado aos totais de alto nível . Não há detalhamento por canal, campanha ou outras dimensões granulares.

• Os dispositivos não confiáveis não podem ser reatribuídos.

Atividades pós-instalação

Para tipos de regra específicos, é possível aplicar as condições para todas as atividades pós-instalação (sessões, eventos e receita de anúncios).
As atividades pós-instalação que não cumprirem as condições definidas serão rejeitadas.

• Não há alterações na atribuição de instalações .
• Se a instalação foi atribuída a uma fonte válida (isso é, não classificada como um dispositivo não confiável ):
  • Os dados brutos serão compartilhados como atividades rejected_session, rejected_event ou rejected_ad_revenue.
  • As atividades rejeitadas são expostas em relatórios nos buckets Sessões rejeitadas , Eventos rejeitados ou Receitas de anúncios rejeitadas .

Tipos de regra

Loja

O regra de tipo de loja permite instalações de aplicativos da Google Play Store e da App Store da Apple.

Se quiser configurar a regra da loja, siga estes passos:

1. Escolha a(s) loja(s) permitida(s). Para aplicativos de plataforma única, apenas as lojas de plataformas correspondentes serão exibidas.

2. Escolha como deve ser o resultado de atribuição caso a loja não corresponda às lojas permitidas:

   • Dispositivos não verificados
   • Dispositivos não confiáveis

3. Se não quiser que a regra seja executada para um canal específico, use a opção Excluir canais .

4. Selecione Criar regra.

Com essa regra, as instalações que não sejam das lojas permitidas serão atribuídas a Dispositivos não verificados ou a Dispositivos não confiáveis .

Região

O tipo de regra Região permite dispositivos e instalações de regiões específicas.

Se quiser configurar a regra da região, siga estes passos:

1. Escolha como os resultados de atribuição devem ser alterados caso as regiões não correspondam à região especificada:

   • Dispositivos não verificados
   • Dispositivos não confiáveis
   • Essa regra também é compatível com atividades pós-instalações

2. Em Condições da regra , escolha várias regiões definindo condições por País .

   1. Tipo de condição - Defina como É igual a or Excluir .
   2. Valor - Escolha um valor da lista.

3. Se não quiser que a regra seja executada para um canal específico, use a opção Excluir canais .

4. Selecione Criar regra.

Com essa regra, as instalações que não sejam dos países especificados serão atribuídas a Dispositivos não verificados ou a Dispositivos não confiáveis .

Exemplo: uma regra de Região com

• Tipo de condição: Incluir
• Valor de país: Japão

Interpretação: como um profissional de marketing, eu quero aceitar apenas as atividades vindas da região Japão.

Comportamento:
As instalações vindas de fora do Japão serão tratadas como Não verificado , e quaisquer atividades pós-instalação que não cumpram as condições serão rejeitadas.

Versão

A regra de Versão permite que você defina condições com base em campos específicos d versão, como:

• Versão do aplicativo
• Versão do SDK
• Versão da assinatura
• versão do SO

Você pode usar essa regra para restringir a atribuição a dispositivos com versões específicas. Se as condições não forem atendidas, a atribuição será feita a dispositivos não verificados ou não confiáveis, dependendo da sua configuração.

Se quiser configurar a regra de Versão, siga estes passos:

1. Escolha como a atribuição deve se comportar se os pontos de dados da versão não corresponderem às condições especificadas:

   • Dispositivos não verificados
   • Dispositivos não confiáveis
   • Essa regra também é compatível com atividades pós-instalações

2. Em Condições da regra:

   1. (Opcional) Pré-condições funcionam como filtros globais, limitando a aplicação da regra. Elas devem ser cumpridas antes que qualquer condição de grupo seja avaliada. Por exemplo, para aplicar essa regra apenas a dispositivos Android em um aplicativo multiplataforma, use a seguinte pré-condição:

      • Condição: Nome do sistema operacional
      • Tipo de condição: igual a
      • Valor: Android

   2. (Obrigatório) Condições – Adicione uma ou mais condições baseadas na versão que devem ser atendidas para que a instalação seja atribuída normalmente. As condições dentro de um grupo são combinadas usando a lógica E . Use grupos separados para aplicar a lógica OU .

3. Se não quiser que a regra seja executada para um canal específico, use a opção Excluir canais .

4. Selecione Criar regra.

Exemplo: como profissional de marketing, preciso definir uma regra que atenda aos requisitos da equipe de segurança para o meu aplicativo multiplataforma. O requisito é bloquear apenas as instalações (a regra não se aplica a atividades pós-instalação) no Android se:

• A versão do aplicativo for inferior à 2.2.1 e a versão do SO do dispositivo for inferior à 6.0.0.
• A versão do app for inferior à 2.9.1 e a versão do SO do dispositivo for inferior à 7.1.2.

Comportamento de atribuição se a condição não corresponder: dispositivo não confiável
Inclui atividades pós-instalação: desativada

Pré-condições: [Nome do SO] [igual a] [Android]

Condições de correspondência:

Grupo 1 [Versão do aplicativo] [Maior que ou igual a] [2.2.1] [Versão do SO] [Maior que ou igual a] [6.0.0]

Grupo 2 [Versão do aplicativo] [Maior que ou igual a] [2.9.1] [Versão do SO] [Maior que ou igual a] [7.1.2]

• Caso 1: o nome do SO instalado é iOS

  • Resultado: a regra foi pulada

• Caso 2: o nome do SO instalado é Android; a versão do aplicativo é 2.3 e a versão do SO é 6.1.

  • Resultado: condição correspondida. Sem rejeição.

• Caso 3: o nome do SO instalado é Android; a versão do aplicativo é 2.1 e versão do SO é 6.1

  • Resultado: a condição não teve correspondência. A atribuição foi rejeitada.

Funcionalidade Fixar/Desafixar

Você pode fixar uma condição para convertê-la em uma pré-condição. Esta é uma maneira simples de aplicar filtros globais que devem ser cumpridos antes que qualquer condição de grupo na regra seja avaliada. Isso é especialmente útil quando você percebe que uma condição deve determinar se a regra deve ser aplicada.

Para fixar uma condição: clique no ícone de fixar ao lado da condição no grupo. Ele será movido para a seção Pré-condições.

Para desafixar uma pré-condição: clique no ícone de desafixar. A condição voltará para a seção de condições do grupo.

Parâmetro

O tipo de regra Parâmetro confere se os parâmetros especificados do SDK (por exemplo, product_id) estão inclusos no payload e se, caso não estejam, eles cumprem a ação selecionada.

Se quiser configurar a regra de parâmetro, siga estes passos:

1. Escolha como os resultados de atribuição devem ser alterados caso os parâmetros de sessão não correspondam aos parâmetros especificados:

   • Dispositivos não verificados
   • Dispositivos não confiáveis
   • Essa regra também é compatível com atividades pós-instalações

2. Em condições da regra , forneça os nomes de parâmetros do SDK que devem ser conferidos. Você pode adicionar vários parâmetros. Quando vários parâmetros são definidos, todos precisam estar presentes para que a atividade seja aprovada no monitoramento.

3. Se não quiser que a regra seja executada para um canal específico, use a opção Excluir canais .

4. Selecione Criar regra.

Com essa regra, as instalações e atividades pós-instalação que não contenham os parâmetros especificados serão atribuídas a Dispositivos não verificados ou a Dispositivos não confiáveis .

Exemplo: Uma regra de Parâmetro com

• Nome do parâmetro: product_id

Interpretação: como profissional de marketing, quero aceitar apenas atividades que incluam o parâmetro product_id no payload.

Comportamento:
As instalações que não incluãm o parâmetro product_id obrigatório serão tratadas como Não confiáveis , e quaisquer atividades pós-instalação (sessões, eventos e receitas de anúncios) que não incluam o parâmetro product_id obrigatório serão rejeitadas.

Correspondência entre região e campanhas

O tipo de regra Região e campanhas são correspondentes permite dispositivos e instalações de regiões e campanhas específicas.

Se quiser configurar a regra Região e campanhas são correspondentes, siga estes passos:

1. Em Definir o filtro de canais , selecione o canal , a campanha e o grupo de anúncios para escolher a campanha.

2. Em Condições da regra , escolha várias regiões definindo condições por País .

   1. Tipo de condição - Defina como É igual a or Excluir .
   2. Valor - Escolha um valor da lista.

3. Selecione Criar regra.

Exemplo: para uma regra de Região e campanhas são correspondentes com

• Valor do canal da campanha: Moloco
• Valor de país: EUA

Interpretação : para a campanha da Moloco, eu quero atribuir apenas as instalações vindas dos EUA.

Comportamento : se houver uma instalação de fora dos EUA, ela não será atribuída a nenhuma campanha da Moloco, mesmo que o último engajamento (que ganhou a atribuição) tenha vindo da Moloco.

A Adjust busca o melhor engajamento anterior. Se um engajamento elegível for encontrado, ele receberá a atribuição pela instalação. Se nenhum engajamento for encontrado, a instalação final será atribuída como orgânica.

Correspondência entre versão e campanhas

A regra Correspondência entre versão e campanhas permite a atribuição apenas para instalações que correspondam tanto a uma versão específica do aplicativo quanto a uma campanha específica.

Você pode usar essa regra para garantir que apenas instalações de versões específicas do aplicativo sejam atribuídas a redes designadas. Por exemplo:

• A Rede A só deve receber atribuições se a versão do aplicativo for 3.0.5.
• A rede B só deve receber atribuições se a versão do aplicativo for 3.0.6 ou 3.0.7.
• A rede WW só deve receber atribuições se a versão do aplicativo contiver o sufixo "_ww" (p. ex., 3.0.8_ww).

Para configurar uma regra de correspondência de versão e campanhas:

1. Em Definir o filtro de canais , selecione o Canal , a Campanha e o Grupo de anúncios para a campanha que você deseja criar a correspondência.

2. Se você estiver usando um aplicativo multiplataforma, selecione as plataformas às quais a regra deve ser aplicada.

3. Em Condições da regra , escolha um Tipo de condição e um Valor :

   • O tipo de condição deve ser um dos tipos de condição de string ou de versionamento semântico.
   • Para o valor, insira um ou mais valores, dependendo do tipo selecionado.
   • A Adjust compara o valor com:
     • app_version_short no iOS
     • app_version em todas as outras plataformas

4. Selecione Criar regra.

Exemplo

Para uma regra de Correspondência entre versão e campanhas :

• Valor do Canal da campanha: WW
• Condição da versão do aplicativo: [Contém] _ww

Interpretação : para o canal WW, quero atribuir apenas as instalações que tenham versões de aplicativo terminando com _ww.

Comportamento : se uma instalação tiver uma versão do aplicativo que não contém _ww, ela não será atribuída a nenhuma campanha do WW, mesmo que o último engajamento tenha vindo do WW.

A Adjust procurará pelo próximo engajamento elegível. Caso encontre um, a atribuição vai para essa fonte. Caso contrário, a instalação será atribuída como orgânica.

Gerencie sua regra de conversão

Na página Conversion Rules , você pode:

• Ver uma lista com suas regras de conversão.

• Ver o status da regra e alterá-lo.

• Selecionar (ícone de edição) para editar a regra. É possível alterar o nome, status, tipo e configurações da regra.

  • Não é possível mudar o app para o qual você adicionou a regra.

• Selecionar (ícone de exclusão) para excluir a regra.

Relatórios

Aqui você encontra detalhes de como a Adjust registra dados de regras de conversão no Datascape. É usada a seguinte estrutura nos relatórios:

Atribuição alterada para Dispositivos não verificados

Atribuição alterada para Dispositivos não confiáveis

Dimensões

• Dispositivos não verificados
• Dispositivos não confiáveis

Métricas

Comportamentos de atribuição Dispositivos não verificados e não confiáveis

• Instalações

  1. Instalações não verificadas (regra da loja)
  2. Instalações não verificadas (regra da região)
  3. Regra de versão de instalações não verificadas
  4. Regra de parâmetro de instalações não verificadas
  5. Instalações rejeitadas (regra da loja)
  6. Instalações rejeitadas (regra da região)
  7. Regra de versão de instalações rejeitadas
  8. Regra de parâmetro de instalações rejeitadas

• Reatribuições

  1. Reatribuições não verificadas (regra da loja)
  2. Reatribuições não verificadas (regra da região)
  3. Regra de versão de reatribuições não verificadas
  4. Regra de parâmetro de reatribuições não verificadas
  5. Regra de loja reatribuições rejeitadas
  6. Regra de região reatribuições rejeitadas
  7. Regra de versão de reatribuições rejeitadas
  8. Regra de parâmetro de reatribuições rejeitadas

Atividades pós-instalação rejeitadas

1. Regra de região de sessões rejeitadas
2. Regra de região de eventos rejeitados
3. Regra de região de receitas de anúncios rejeitadas
4. Regra de versão de sessões rejeitadas
5. Regra de versão de eventos rejeitados
6. Regra de versão de receitas de anúncios rejeitadas
7. Regra de parâmetro de sessões rejeitadas
8. Regra de parâmetro de eventos rejeitados
9. Regra de parâmetro de receita de anúncios rejeitadas

Comportamento de atribuição "Ignorar a fonte"

1. Engajamentos não verificados (regra de campanha da região)
2. Cliques não verificados (regra de campanha da região)
3. Impressões não verificadas (regra de campanha da região)
4. Regra de campanha da versão - Engajamentos não verificados
5. Regra de campanha da versão - Cliques não verificados (regra de campanha da versão)
6. Regra de campanha da versão - Impressões não verificadas