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ê.

Solução para crescimento:

Para ativar o Conversion Rules na sua conta, entre em contato com sales@adjust.com.

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:

Em Proteção , selecione Conversion Rules .
Selecione Nova regra de conversão .
Insira um nome para sua regra.
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.
Selecione seu aplicativo.
Selecione um tipo de regra e configure-a de acordo.
- Loja
- Região
- Versão
- Correspondência entre região e campanhas
- Correspondência entre versão e campanhas
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

A Adjust retém os postbacks e dados agregados.
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.
A Adjust não retém os postbacks ou dados agregados.
Os dispositivos não confiáveis não podem ser reatribuídos.

Importante:

Para usar esse comportamento de atribuição, seja em modo ativo ou de teste, sua conta precisa ter o recurso Conversion Rules Core ativado. Entre em contato com sales@adjust.com para receber ajuda.

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:

Escolha a(s) loja(s) permitida(s). Para aplicativos de plataforma única, apenas as lojas de plataformas correspondentes serão exibidas.
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
Se não quiser que a regra seja executada para um canal específico, use a opção Excluir canais .
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:

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
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.
Se não quiser que a regra seja executada para um canal específico, use a opção Excluir canais .
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 atribuir apenas as instalações vindas da região Japão

Comportamento : essa regra atribui quaisquer instalações vindas de fora do Japão como Dispositivos não verificados ou Dispositivos não confiáveis.

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:

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
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 .
Se não quiser que a regra seja executada para um canal específico, use a opção Excluir canais .
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 instalações 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

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

Observação:

Se a regra não tivesse incluído a pré-condição do nome do sistema operacional, a atribuição da instalação teria sido rejeitada porque nenhuma condição foi atendida.

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.

Pré-condições e detalhes das condições

Nome	Detalhes
Versão do aplicativo	Tipos de condição de string: - Igual a (string) - Diferente de (string) - Contém - Não contém ✅Compatível com múltiplos valores Tipos de condição de versionamento semântico¹: - Igual a (semântico) - Diferente de (semântico) - Maior que - Maior ou igual a - Menos do que - Menos do que ou igual a - Dentro do intervalo - Fora do intervalo ✅ Igual a e Diferente de são compatíveis com múltiplos valores Lógica de comparação: A Adjust compara a versão do aplicativo (da regra) com: - app_version_short no iOS - app_version em todas as outras plataformas
Nome do SO	Tipos de condição de lista: - Igual a - Diferente de ✅ Compatível com múltiplos valores
versão do SO	Tipos de condição de versionamento semântico¹: - Igual a (semântico) - Diferente de (semântico) - Maior que - Maior que ou igual a - Menos do que - Menos do que ou igual a - Dentro do intervalo - Fora do intervalo ✅ Igual a e Diferente de oferecem suporte a múltiplos valores
Versão do SDK	Tipos de condição de versionamento semântico¹: - Igual a (semântico) - Diferente de (semântico) - Maior que - Maior ou igual a - Menos do que - Menos do que ou igual a - Dentro do intervalo - Fora do intervalo ✅ Igual a e Diferente de oferecem suporte a múltiplos valores Orientações de uso: Para SDKs não nativos (por exemplo, React Native, Unity), segmente a versão do SDK não nativo. Exemplos: client_sdk = react_native5.0.0@ios5.1.0 Regra: versão do SDK = 5.0 → ✅ Aceito Regra: versão do SDK = 5.0, versão do SDK nativo = 5.0.0 → ❌ Rejeitado
Plataforma de SDK	Tipos de condições de lista: - Igual a - Diferente de ✅ Suporta múltiplos valores Orientações de uso: Usado para SDKs não nativos como React Native ou Unity. Exemplos: client_sdk = react_native5.0.0@ios5.1.0 Regra: plataforma SDK = React Native → ✅ Aceito Regra: plataforma SDK = React Native, plataforma do SDK nativa = Android → ❌ Rejeitado
Versão do SDK nativo	Tipos de condição de versionamento semântico¹: - Igual a (semântico) - Diferente de (semântico) - Maior que - Maior ou igual a - Menos do que - Menos do que ou igual a - Dentro do intervalo - Fora do intervalo ✅ Igual a e Diferente de oferecem suporte a múltiplos valores Instruções de uso: Use este campo quando o seu aplicativo integrar com o SDK nativo da Adjust, ou quando um SDK não nativo (por exemplo, React Native, Unity) for sobreposto a ele. Você pode: - Usar apenas a versão do SDK nativo para direcionar todas as integrações usando uma versão específica do SDK nativo, independentemente do wrapper (por exemplo, Android SDK 5.0.0 em vários wrappers). - Combine a versão do SDK nativo com a plataforma do SDK e a versão do SDK para corresponder precisamente às instalações usando uma combinação específica de wrapper e SDK nativo (por exemplo, React Native 5.0 + SDK do iOS 5.1.0).
Plataforma de SDK nativo	Tipos de condições de lista: - Igual a - Diferente de ✅ Oferece suporte a múltiplos valores Orientações de uso: Pode ser combinado com a plataforma do SDK para corresponder exatamente aos pares do SDK. Exemplos: client_sdk = react_native5.0.0@ios5.1.0 Regra: plataforma do SDK = React Native, plataforma do SDK nativo = iOS → ✅ Aceito Regra: plataforma do SDK = React Native, plataforma do SDK nativo = Android → ❌ Rejeitado
Versão da assinatura de SDK	Tipos de condição de versionamento semântico¹: - Igual a (semântico) - Diferente de (semântico) - Maior que - Maior que ou igual a - Menos do que - Menos do que ou igual a - Dentro do intervalo - Fora do intervalo ✅ Igual a e Diferente de oferecem suporte a múltiplos valores

Observação:

¹ Formato de versão semântica

A versão deve seguir o versionamento semântico padrão:

Formato:
MAJOR.MINOR.PATCH[-pre-release][+build]

Componentes:

MAJOR, MINOR e PATCH são valores numéricos (por ex.: 1.2.3)
Uma tag de pré-lançamento opcional pode vir na sequência, como: -alpha, -beta, -rc ou -dev
Você também pode incluir metadados de build (por exemplo, +build123), que são ignorados durante a comparação de versão

Exemplos de versões válidas:

5.3.1
1.0.0-beta
2.2.0-rc
3.4.5-dev+123
v2.1.0 (o prefixo opcional v é compatível)

Importante:

Tenha cuidado ao usar operadores que estreitam a condição de forma muito rigorosa, como:
Versão do aplicativo = 1.2.1
Se o seu app lançar uma nova versão (por exemplo, 1.2.2), a regra não terá mais correspondência, e novas instalações poderão ser rejeitadas ou não verificadas.

✅ Uma alternativa mais segura é usar um intervalo ou limite inferior, como:
Versão do aplicativo ≥ 1.2.1

Sempre certifique-se de que suas condições sejam compatíveis com versões futuras do aplicativo, a menos que você queira intencionalmente uma versão específica.

Se você realmente quiser direcionar uma build muito específica, considere mover essa condição para a seção Pré-condições .
Isso ajuda a melhorar a legibilidade das regras e a manutenção a longo prazo.

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.

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:

Em Definir o filtro de canais , selecione o canal , a campanha e o grupo de anúncios para escolher a campanha.
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.
Selecione Criar regra.

Observação:

Este tipo de regra ignora a fonte de atribuição. Se uma instalação não cumprir os critérios definidos para uma campanha específica, ela não será atribuída à campanha. Em vez disso, vamos procurar outras fontes de atribuição elegíveis. Caso não encontremos nenhuma, o último fallback é considerado como orgânico.

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

Valor do canal da campanha: AppLovin
Valor de país: Japão

Interpretação : para a campanha da AppLovin, eu quero atribuir apenas as instalações vindas da região Japão.

Comportamento : se houver uma instalação fora do Japão, ela não será atribuída a nenhuma campanha da AppLovin, mesmo se o último engajamento (que ganhou a atribuição) tiver vindo da AppLovin.

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:

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.
Se você estiver usando um aplicativo multiplataforma, selecione as plataformas às quais a regra deve ser aplicada.
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
Selecione Criar regra.

Observação:

Tipos de condição

Grupo	Tipo
String	- Igual a (string) - Diferente de (string) - Contém - Não contém ✅ Compatível com múltiplos valores
Versionamento semântico¹	- Igual a (semântico) - Diferente de (semântico) - Maior que - Maior que ou igual a - Menos do que - Menos do que ou igual a - Dentro do intervalo - Fora do intervalo ✅ Igual a e Diferente de são compatíveis com múltiplos valores

Observação:

¹ Formato de versão semântica

A versão deve seguir o versionamento semântico padrão:

Formato:
MAJOR.MINOR.PATCH[-pre-release][+build]

Componentes:

MAJOR, MINOR e PATCH são valores numéricos (por ex.: 1.2.3)
Uma tag de pré-lançamento opcional pode vir na sequência, como: -alpha, -beta, -rc ou -dev
Você também pode incluir metadados de build (por exemplo, +build123), que são ignorados durante a comparação de versão

Exemplos de versões válidas:

5.3.1
1.0.0-beta
2.2.0-rc
3.4.5-dev+123
v2.1.0 (o prefixo opcional v é compatível)

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

Nível de estrutura de campanha	Valor registrado
Canal	Dispositivos não verificados
Campanha	Tipo de regra Regra de Loja, Regra de Região ou Regra de Versão
Grupo de anúncios	Nome da rede com token de link a que o engajamento foi originalmente atribuído.
Criativo	Campanha a que o engajamento foi originalmente atribuído.

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

Nível de estrutura de campanha	Valor registrado
Canal	Dispositivos não confiáveis
Campanha	Tipo de regra Regra de Loja, Regra de Região ou Regra de Versão
Grupo de anúncios	Unknown
Criativo	Unknown

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. Instalações rejeitadas (regra da loja)
5. Instalações rejeitadas (regra da região)
6. Regra de versão 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 loja reatribuições rejeitadas
5. Regra de região reatribuições rejeitadas
6. Regra de versão de reatribuições rejeitadas

Comportamento de atribuição "Ignorar a fonte"

Engajamentos não verificados (regra de campanha da região)
Cliques não verificados (regra de campanha da região)
Impressões não verificadas (regra de campanha da região)
Regra de campanha da versão - Engajamentos não verificados
Regra de campanha da versão - Cliques não verificados (regra de campanha da versão)
Regra de campanha da versão - Impressões não verificadas

Veja também:

Painel Protection