> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/build-redirect-rule-conditions.md). # Criar condições de regra de redirecionamento Toda regra de redirecionamento começa com uma ou mais condições. Um *condição* verifica algo sobre o tráfego de entrada, como a URL da página de destino, o país ou o tipo de dispositivo, e decide se a regra se aplica. Leia mais sobre como [Criar uma regra de redirecionamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/create-a-redirect-rule.md). ## Atributos da condição A tabela abaixo lista os atributos de condição que você pode usar em uma regra.
Referência de atributos de condição | Atributo da condição | Descrição | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Página de destino | A URL de destino original. | | Endereço IP | O endereço IP registrado em um dispositivo. | | ID Compartilhado | Um parâmetro de string de consulta controlado pelo parceiro, usado em relatórios. | | País | O país de onde o tráfego se origina. | | Estado | O estado de onde o tráfego se origina. | | Status do anúncio | O estado de uso do anúncio associado. | | SubID1 | Um parâmetro de string de consulta controlado pelo parceiro, usado em relatórios. | | SubID2 | Um parâmetro de string de consulta controlado pelo parceiro, usado em relatórios. | | SubID3 | Um parâmetro de string de consulta controlado pelo parceiro, usado em relatórios. | | ID do MP | O identificador exclusivo da impact.com para um parceiro | | Tipo de dispositivo | Que tipo de dispositivo o cliente estava usando quando a regra de redirecionamento foi acionada para ativação. | | URL de referência | URL do site que está encaminhando tráfego para a URL de destino original. | | SKU do produto | Um identificador para o assunto do anúncio, que geralmente é designado em um catálogo de produtos. | | ID do anúncio | O identificador exclusivo da impact.com para um anúncio. | | Probabilidade | A regra de redirecionamento capturará aleatoriamente uma porcentagem do tráfego para ser redirecionada. Isso é usado principalmente para testes A/B. | | Fallback para celular |

Se um anúncio tiver fallback móvel configurado, a regra de roteamento associada pode solicitar o redirecionamento do tráfego para a respectiva loja de aplicativos para baixar um app.

Fallback móvel As regras de redirecionamento geralmente são configuradas durante o Onboarding. Verifique suas especificações técnicas para ver se você deve ter uma regra de redirecionamento de fallback móvel.

| | Nome do app | O nome do app que o cliente estava usando quando a regra de redirecionamento foi acionada para ativação. | | Nome do navegador | O nome do navegador que o cliente estava usando quando a regra de redirecionamento foi acionada para ativação. | | Nome do sistema operacional | O nome do sistema operacional que o cliente estava usando quando a regra de redirecionamento foi acionada para ativação. | | WebView no app | Se o cliente estava usando um webview no app quando a regra de redirecionamento foi acionada para ativação. |
## Operadores de condição Um dos atributos de condição mais úteis é **Página de destino**, pois ele permite criar condições e redirecionamentos com base na URL de entrada. Os operadores listados abaixo são para o **Página de destino** atributo. Os operadores disponíveis dependem do atributo que você escolher: a maioria dos atributos oferece um conjunto menor. Por exemplo, **Fallback para celular** oferece apenas **está** e **não é**.
Referência de operadores de condição | Operador | Descrição | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **contém** | O valor do atributo inclui o texto especificado. | | **começa com** | O valor do atributo começa com o texto especificado. | | **termina com** | O valor do atributo termina com o texto especificado. | | **corresponde a** | O valor do atributo corresponde a um padrão, que pode incluir espaços reservados (`{NAME}`) para capturar partes do valor e um curinga (`*`) para corresponder a quaisquer caracteres restantes. | | **em** | O valor do atributo é um de uma lista especificada de valores. | | **não contém** | O valor do atributo não inclui o texto especificado. | | **não começa com** | O valor do atributo não começa com o texto especificado. | | **não termina com** | O valor do atributo não termina com o texto especificado. | | **não é** | O valor do atributo não é exatamente igual ao valor especificado. | | **não está em** | O valor do atributo não é nenhum de uma lista especificada de valores. | | **Regex** | O valor do atributo corresponde a uma expressão regular personalizada. |
## Combinar condições Você pode combinar várias condições usando **E**: * Use **E** quando mais de uma coisa precisa ser verdadeira ao mesmo tempo, por exemplo, tráfego de um país específico e de um tipo de dispositivo específico. * Selecione **Adicionar outro** para adicionar uma condição separada e independente que atenda à primeira condição ou à nova. Ela não precisa atender a ambas. Isso significa que **Adicionar outro** é como um **OU** condição. As próximas duas seções mostram como criar uma regra de redirecionamento usando os *Contém* e *Corresponde a* operadores. ## Use o operador contains A maneira mais simples de dividir o tráfego por URL é com duas regras separadas usando **contém**. Digamos que você queira que qualquer pessoa que acesse uma página do Reino Unido receba um parâmetro de consulta, e qualquer pessoa que acesse uma página dos EUA receba outro. Regra 1, tráfego do Reino Unido: 1. Condição: `Página de destino` **contém** `/uk`. 2. Ação: redirecione para a mesma URL, com `?a=123` adicionado ao final. Regra 2, tráfego dos EUA: 1. Condição: `Página de destino` **contém** `/us`. 2. Ação: redirecione para a mesma URL, com `?a=456` adicionado ao final. Cada regra verifica na URL de entrada um trecho de texto (seja `/uk` ou `/us`). Se encontrar o texto, a regra de redirecionamento envia o visitante adiante com um parâmetro extra adicionado. Isso funciona bem para divisões simples de um caso ou outro, mas essa técnica não consegue reutilizar partes da URL original. Para isso, você precisa usar **corresponde a**. ## Use o operador matches O **corresponde a** O operador permite escrever um padrão para a URL inteira e marcar uma parte dela com um espaço reservado, escrito como `{PLACEHOLDER}`, para que você possa reutilizar exatamente esse trecho mais tarde no redirecionamento.
Use matches com um espaço reservado Digamos que você venda sapatos, e que toda página de produto do Reino Unido pareça `https://www.example.com/uk/`. Você quer redirecionar cada uma para a mesma página em um site parceiro, mantendo o nome do produto. 1. Defina a condição como `Página de destino` **corresponde a** `https://www.example.com/uk/{PRODUCT}`, que corresponde a qualquer URL que comece com `https://www.example.com/uk/` e captura tudo o que vier logo depois disso como `PRODUCT`. 2. Teste isso inserindo `https://www.example.com/uk/sneakers` como uma página de destino de teste. Você receberá o resultado: uma correspondência bem-sucedida, com `{PRODUCT}` definido como `sneakers`. 3. Defina a ação para redirecionar para `https://www.example.com/uk/{PRODUCT}?a=123`, que se torna `https://www.example.com/uk/sneakers?a=123` quando `{PRODUCT}` é capturado como `sneakers`. Então o espaço reservado funciona como uma variável: qualquer texto que ele capture da URL de entrada é inserido no mesmo lugar na URL de saída.
Use matches com um curinga Usando exatamente a mesma regra acima, tente testar uma URL um pouco diferente: 1. Teste isso inserindo `https://www.example.com/uk/sneakers/mens` como uma página de destino de teste. Você receberá o resultado: nenhuma correspondência encontrada. Isso ocorre porque o **corresponde a** O operador verifica o padrão em relação à URL inteira, não apenas ao início dela. O padrão `https://www.example.com/uk/{PRODUCT}` considera apenas um segmento depois de `/uk/`, e não leva nada em conta para o extra `/mens`, então a correspondência falha. Para permitir qualquer coisa depois do espaço reservado, adicione um curinga (`*`) ao final do padrão: * Novo padrão: `https://www.example.com/uk/{PRODUCT}*` * Agora isso corresponde a ambos `https://www.example.com/uk/sneakers` e `https://www.example.com/uk/sneakers/mens`. `{PRODUCT}` ainda captura apenas `sneakers` (até o próximo `/`) `*` simplesmente absorve tudo o que vier depois. Se o seu padrão não terminar em `*`, a URL de entrada deve terminar exatamente no mesmo ponto em que o padrão termina, ou não haverá correspondência.
Use matches com vários espaços reservados Você pode usar vários espaços reservados no mesmo padrão. Digamos que suas páginas de produto incluam, de fato, tanto uma categoria quanto um SKU, como `https://www.example.com/uk/shop/product/sneakers/SKU123-blue-running-shoe`, e a página às vezes tem conteúdo extra depois disso (como `/reviews`). 1. Defina a condição como `Página de destino` **corresponde a** `https://www.example.com/uk/shop/product/{CATEGORY}/{SKU}*`, em que: * `{CATEGORY}` captura o segmento logo após `/product/`. * `{SKU}` captura o próximo segmento depois disso. * o caractere final `*` permite qualquer outra coisa que venha depois (como `/reviews`), usando a lição da seção anterior. 2. Teste isso inserindo `https://www.example.com/uk/shop/product/sneakers/SKU123-blue-running-shoe/reviews`. Você deve receber o resultado: uma correspondência bem-sucedida, com `{CATEGORY}` definido como `sneakers` e `{SKU}` definido como `SKU123-blue-running-shoe`. 3. Defina a ação para redirecionar para `https://www.example.com/redirect/{CATEGORY}/{SKU}`, que se torna `https://www.example.com/redirect/sneakers/SKU123-blue-running-shoe` quando ambos os valores capturados são reutilizados. O `/reviews` trecho é removido porque a URL de redirecionamento não faz referência a ele.
Referência de curingas e espaços reservados A tabela abaixo lista a sintaxe que você pode usar ao escrever uma **corresponde a** regra. | Sintaxe | O que faz | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `{NAME}` | Um espaço reservado que captura um segmento da URL (até o próximo `/` ou o fim da URL) para que possa ser reutilizado na ação de redirecionamento. | | `*` | Corresponde a quaisquer caracteres restantes após um espaço reservado. Use-o quando a URL puder ter conteúdo extra após o seu padrão. | | Não `*` no final | O padrão deve corresponder exatamente até o fim da URL. Nada extra é permitido. |
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/build-redirect-rule-conditions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.