> 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. Uma *condição* verifica algo sobre o tráfego recebido, como o URL da página de destino, o país ou o tipo de dispositivo, e determina se a regra se aplica. Saiba mais sobre como [Criar uma regra de redirecionamento](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/create-a-redirect-rule.md).

## Atributos das condições

A tabela abaixo lista os atributos de condição que você pode usar em uma regra.

<details>

<summary>Referência dos atributos de condição</summary>

| Atributo da condição                 | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Página de destino                    | O URL de destino original.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Endereço IP                          | O endereço IP registrado para um dispositivo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ID compartilhado                     | Um parâmetro de string de consulta controlado pelo parceiro e usado em relatórios.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| País                                 | O país de origem do tráfego.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Status                               | O estado de origem do tráfego.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Status do anúncio                    | O estado de uso do anúncio associado.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| SubID1                               | Um parâmetro de string de consulta controlado pelo parceiro e usado em relatórios.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| SubID2                               | Um parâmetro de string de consulta controlado pelo parceiro e usado em relatórios.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| SubID3                               | Um parâmetro de string de consulta controlado pelo parceiro e usado em relatórios.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ID do MP                             | identificador exclusivo de um parceiro na impact.com                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Tipo de dispositivo                  | O tipo de dispositivo que o cliente estava usando quando a regra de redirecionamento foi acionada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| URL de referência                    | URL do site que direciona tráfego para o URL de destino original.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| SKU do produto                       | Identificador do item relacionado ao anúncio, geralmente definido em um catálogo de produtos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ID do anúncio                        | identificador exclusivo de um anúncio na impact.com                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Probabilidade                        | A regra de redirecionamento selecionará aleatoriamente uma porcentagem do tráfego para redirecioná-lo. Isso é usado principalmente em testes A/B.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Alternativa para dispositivos móveis | <p>Se um anúncio tiver <a href="https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/blocking-and-redirect-rules/create-app-install-interstitials.md">redirecionamento alternativo para dispositivos móveis</a> configurado, a regra de roteamento associada poderá solicitar o redirecionamento do tráfego para a respectiva loja de aplicativos para baixar um app.</p><p><em>Redirecionamento alternativo para dispositivos móveis</em> As regras de redirecionamento alternativo para dispositivos móveis geralmente são configuradas durante a integração. Consulte as especificações técnicas para saber se você deve ter uma regra de redirecionamento desse tipo.</p> |
| Nome do app                          | O nome do app que o cliente estava usando quando a regra de redirecionamento foi acionada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Nome do navegador                    | O nome do navegador que o cliente estava usando quando a regra de redirecionamento foi acionada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Nome do sistema operacional          | O nome do sistema operacional que o cliente estava usando quando a regra de redirecionamento foi acionada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| WebView no app                       | Indica se o cliente estava usando uma WebView no app quando a regra de redirecionamento foi acionada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

</details>

## Operadores de condição

Um dos atributos de condição mais úteis é **Página de destino**, pois permite criar condições e redirecionamentos com base no URL recebido. Os operadores listados abaixo são para o atributo **Página de destino** . Os operadores disponíveis dependem do atributo selecionado: a maioria dos atributos oferece um conjunto menor. Por exemplo, **Redirecionamento alternativo para dispositivos móveis** oferece apenas **é** e **não é**.

<details>

<summary>Referência de operadores de condição</summary>

| 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 marcadores de posição (`{NAME}`) para capturar partes do valor e um curinga (`*`) para corresponder a quaisquer caracteres restantes. |
| **está em**         | O valor do atributo corresponde a um dos valores de uma lista especificada.                                                                                                                         |
| **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 corresponde a nenhum dos valores de uma lista especificada.                                                                                                                 |
| **Regex**           | O valor do atributo corresponde a uma expressão regular personalizada.                                                                                                                              |

</details>

## Combinar condições

Você pode combinar várias condições usando **AND**:

* Use **AND** quando mais de um critério precisa ser verdadeiro ao mesmo tempo, por exemplo, tráfego de um país específico e de um tipo específico de dispositivo.
* Selecione **Adicionar outra** para adicionar uma condição separada e independente, que atenda à primeira condição ou à nova. Não é necessário atender às duas. Isso significa que **Adicionar outra** é como uma condição **OR** .

As próximas duas seções mostram como criar uma regra de redirecionamento usando os operadores *Contém* e *Corresponde a* .

## Use o operador contém

A maneira mais simples de direcionar o tráfego com base na URL é criar duas regras separadas usando o operador **contém**. Suponha que você queira adicionar um parâmetro de consulta a quem acessar uma página do Reino Unido e outro a quem acessar uma página dos EUA.

Regra 1, tráfego do Reino Unido:

1. Condição: `Página de destino` **contém** `/uk`.
2. Ação: redirecionar para o mesmo 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: redirecionar para o mesmo URL, com `?a=456` adicionado ao final.

Cada regra verifica se o URL recebido contém um trecho de texto ( `/uk` ou `/us`). Se encontrar o trecho, a regra de redirecionamento encaminha o visitante com um parâmetro extra adicionado.

Isso funciona bem para divisões simples entre duas opções, mas essa técnica não consegue reutilizar partes do URL original. Para isso, você precisa usar **corresponde a**.

## Usar o operador matches

O operador **matches** permite escrever um padrão para o URL inteiro e marcar uma parte dele com um espaço reservado, escrito como `{PLACEHOLDER}`, para que você possa reutilizar exatamente esse trecho mais adiante no redirecionamento.

<details>

<summary>Usar matches com um espaço reservado</summary>

Digamos que você venda sapatos e que todas as páginas de produtos do Reino Unido tenham este formato: `https://www.example.com/uk/<product-name>`. 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 chama o que vier logo depois de `PRODUCT`.
2. Teste inserindo `https://www.example.com/uk/sneakers` como 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` uma vez `{PRODUCT}` é capturado como `sneakers`.

Assim, o espaço reservado funciona como uma variável: qualquer texto que ele capture da URL recebida será inserido no mesmo lugar na URL de saída.

</details>

<details>

<summary>Use correspondências com um curinga</summary>

Usando exatamente a mesma regra acima, teste uma URL um pouco diferente:

1. Teste inserindo `https://www.example.com/uk/sneakers/mens` como página de destino de teste. O resultado será: nenhuma correspondência encontrada.

Isso acontece porque o operador **corresponde** 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 considera o segmento extra `/mens`, por isso a correspondência falha.

Para permitir qualquer conteúdo depois do espaço reservado, adicione um curinga (`*`) ao final do padrão:

* Novo padrão: `https://www.example.com/uk/{PRODUCT}*`
* Agora, ele corresponde tanto a `https://www.example.com/uk/sneakers` quanto a `https://www.example.com/uk/sneakers/mens`. `{PRODUCT}` ainda captura apenas `sneakers` (até o próximo `/`), e `*` simplesmente absorve tudo o que vier depois.

Se o padrão não terminar com `*`, a URL recebida deverá terminar exatamente no mesmo ponto que o padrão; caso contrário, não haverá correspondência.

</details>

<details>

<summary>Use correspondências com vários espaços reservados</summary>

Você pode usar vários espaços reservados no mesmo padrão. Digamos que as páginas de produtos incluam uma categoria e um SKU, como `https://www.example.com/uk/shop/product/sneakers/SKU123-blue-running-shoe`, e que às vezes haja conteúdo adicional depois disso na página (como `/reviews`).

1. Defina a condição como `Landing Page` **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.
   * o sufixo `*` permite qualquer conteúdo adicional que venha depois (como `/reviews`), usando o aprendizado da seção anterior.
2. Teste inserindo `https://www.example.com/uk/shop/product/sneakers/SKU123-blue-running-shoe/reviews`. Você deverá 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 os dois valores capturados são reutilizados. A parte `/reviews` é descartada porque a URL de redirecionamento não faz referência a ela.

</details>

<details>

<summary>Os curingas e os marcadores de posição fazem referência a</summary>

A tabela abaixo lista a sintaxe que você pode usar ao escrever uma regra de **correspondência** .

| Sintaxe          | O que faz                                                                                                                                                  |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{NAME}`         | Um marcador de posição que captura um segmento da URL (até o próximo `/` ou até o fim da URL), para que possa ser reutilizado na ação de redirecionamento. |
| `*`              | Corresponde a quaisquer caracteres restantes após um marcador de posição. Use-o quando a URL puder ter conteúdo adicional após o seu padrão.               |
| Não `*` no final | O padrão deve corresponder exatamente à URL até o fim. Não é permitido nenhum conteúdo adicional.                                                          |

</details>


---

# 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=<question>&goal=<user_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.
