> For the complete documentation index, see [llms.txt](https://docs.sellermagnet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sellermagnet.com/pt-or-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-rule-builder.md).

# Construtor de regras PPC

{% hint style="info" %}
**Dificuldade:** 🔴 Avançado · **Tempo de leitura:** \~12 min
{% endhint %}

{% hint style="success" icon="rocket" %}
**Abrir esta página no seu painel:** [**Ir para Construtor de Regras PPC \[BETA\] →**](https://dashboard.sellermagnet.com/ppc/rules/builder)
{% endhint %}

{% hint style="warning" icon="triangle-exclamation" %}
**BETA:** O PPC Manager está em beta, e o Rule Builder é uma das suas superfícies mais recentes. Algumas ações avançadas e a lógica de grupos OR chegam à interface antes do worker de automatização - o guia sinaliza cada uma onde se aplica. Por favor, reporte qualquer coisa inesperada para <info@sellermagnet.com>.
{% endhint %}

## 📋 Visão geral

![SellerMagnet PPC Rule Builder - visual automation canvas screenshot](/files/w7azJHs2ZZYFqbkiyY7I)

O **Rule Builder** é uma tela visual de arrastar e largar para montar regras de lances automatizadas. Em vez de preencher um formulário, você arrasta **condições** (ACoS, CTR, gasto, cliques e mais) e **ações** (aumentar ou baixar lances, pausar uma palavra-chave, adicionar uma negativa, enviar um alerta) para uma tela, liga-as com lógica AND/OR e guarda.

É importante compreender o que o Rule Builder **não** é: não é um motor de automatização separado. Nos bastidores, a tela serializa exatamente para o mesmo esquema JSON usado pela página [Bid Rules](/pt-or-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-bid-rules.md), e guarda através do mesmo endpoint. Uma regra que você construa aqui aparece na sua lista de Bid Rules, corre no mesmo agendamento e aparece no mesmo histórico de execução. Pense no Rule Builder como um editor mais rico sobre o mesmo motor de regras.

**Rule Builder vs o modal Create Rule**

A página [Bid Rules](/pt-or-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-bid-rules.md) tem um modal simples **Create Rule** que é perfeito para uma única regra de uma ação em que todas as condições são unidas por AND. O Rule Builder é a superfície para power users da mesma ideia. Use-o quando você quiser:

| Você quer...                                                                                          | Modal Create Rule | Rule Builder         |
| ----------------------------------------------------------------------------------------------------- | ----------------- | -------------------- |
| Adicionar várias condições AND                                                                        | Sim               | Sim                  |
| Agrupar condições com lógica **OR**                                                                   | Não               | Sim (grupos visuais) |
| Escolher entre ações avançadas (bid to breakeven, pausar campanha, adicionar negativa, enviar alerta) | Não               | Sim                  |
| Definir o escopo por **padrão de nome de campanha** (wildcards)                                       | Não               | Sim                  |
| Definir uma **janela de lookback por condição**                                                       | Não               | Sim                  |
| **Simular** a regra face ao histórico antes de guardar                                                | Não               | Sim (Test Rule)      |
| Rever as **últimas 30 execuções** no painel                                                           | Não               | Sim                  |
| Carregar um **template** pronto a usar                                                                | Não               | Sim                  |

{% hint style="info" icon="lightbulb" %}
**Quando usar qual:** Recorra ao modal para proteções rápidas como "ACoS > 35% e Clicks > 25, diminuir lance 10%." Recorra ao Rule Builder quando uma regra precisa de ramos OR, de uma ação que não seja de lance, de escopo por padrão, ou quando você quer pré-visualizar o seu impacto antes de entrar em vigor.
{% endhint %}

***

## A Tela num Relance

O Rule Builder é um espaço de trabalho de três painéis.

| Painel                                  | O que faz                                                                                                                                                                                |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Building Blocks** (esquerda)          | A paleta. Arraste Conditions, Logic (AND/OR) e Actions para a tela                                                                                                                       |
| **Canvas** (centro)                     | Onde a regra ganha forma: uma secção **WHEN** para as condições e uma secção **THEN** para as ações, com o cartão de escopo da campanha por cima                                         |
| **Properties / Last 30 runs** (direita) | Edite as definições do bloco selecionado, ou mude de separador para rever as execuções recentes. Por baixo fica a barra de ações: Schedule, toggle Active, Test Rule, Run Now, Save Rule |

A tela lê-se de cima para baixo como uma frase: **Apply to** (escopo) estas campanhas, **WHEN** estas condições correspondem, **THEN** faz isto.

{% hint style="warning" %}
**Ligação Amazon Ads necessária.** O Rule Builder precisa de uma conta Amazon Advertising ligada. Se você vir um banner "Connect Your Amazon Advertising Account", ligue-a primeiro em Settings - caso contrário, o seletor de escopo de campanha e a simulação não têm dados com que trabalhar.
{% endhint %}

***

## Construir uma Regra Passo a Passo

{% stepper %}
{% step %}

### Passo 1: Nomear a regra

Escreva um nome descritivo no campo no topo da tela (o padrão é "Untitled Rule"). Um estilo de nomenclatura consistente como `[Ação]-[Condição]-[Escopo]` mantém uma longa lista de regras legível, por exemplo `Cut-HighACoS-AllCampaigns`.
{% endstep %}

{% step %}

### Passo 2: Definir o escopo (Apply to)

O cartão de escopo fica no topo da tela. Escolha quais campanhas a regra toca:

| Modo de escopo            | Comportamento                                                                                          |
| ------------------------- | ------------------------------------------------------------------------------------------------------ |
| **All campaigns**         | A regra avalia todas as campanhas, incluindo as que você criar mais tarde                              |
| **Specific campaigns**    | Escolha campanhas de uma lista de seleção múltipla (mantenha Ctrl/Cmd para selecionar várias)          |
| **Match by name pattern** | Introduza um padrão wildcard como `SP - Auto - *` ou `*brand*`. Não distingue maiúsculas de minúsculas |
| **Match by tag**          | Em breve - a opção está visível mas desativada                                                         |

{% hint style="danger" %}
**"All campaigns" é inclusivo do futuro.** Uma regra com escopo All campaigns também correrá em qualquer nova campanha que você lançar mais tarde. Se você só alguma vez quer que corra nas campanhas de hoje, escolha Specific campaigns e selecione-as explicitamente.
{% endhint %}
{% endstep %}

{% step %}

### Passo 3: Arrastar condições (o bloco WHEN)

A partir da secção **Conditions** da paleta, arraste uma métrica para a tela. Métricas de condição disponíveis:

| Métrica         | Unidade | Uso típico                                         |
| --------------- | ------- | -------------------------------------------------- |
| **ACoS**        | %       | Limitar o custo publicitário de vendas             |
| **CTR**         | %       | Encontrar palavras-chave de baixa relevância       |
| **CVR**         | %       | Detetar conversores fortes ou fracos               |
| **Spend**       | €       | Definir um piso de gasto antes de agir             |
| **Clicks**      | -       | Exigir dados suficientes para serem significativos |
| **Impressions** | -       | Condicionar ao volume de visibilidade              |
| **Orders**      | -       | Alvejar palavras-chave com zero ou muitos pedidos  |
| **Sales**       | €       | Filtrar por receita                                |

Cada condição largada começa com um padrão sensato (por exemplo, ACoS assume o padrão `> 30`). Selecione o bloco para abrir as suas **Properties** à direita e ajustar a **Metric**, o **Operator** (`>`, `≥`, `<`, `≤`, `=`), o **Value** e o **Lookback (days)** - 7, 14 ou 30. A janela de lookback é por condição, por isso uma regra pode medir ACoS ao longo de 14 dias enquanto exige Clicks ao longo de 30 dias.

{% hint style="info" icon="lightbulb" %}
**Adicione sempre um gate de volume de dados.** Emparelhe qualquer condição de eficiência (ACoS, CTR, CVR) com uma condição `Clicks >` ou `Spend >` para que a regra nunca aja sobre uma palavra-chave com dois cliques e um ACoS temporariamente descontrolado.
{% endhint %}
{% endstep %}

{% step %}

### Passo 4: Adicionar lógica - AND vs OR

As condições dentro do mesmo grupo são unidas por **AND** (todas têm de corresponder). AND é o padrão: basta largar outra métrica no mesmo grupo e encadeia-se automaticamente com um divisor "AND" entre os blocos.

Para lógica **OR**, adicione um segundo grupo. Arraste o bloco **OR** da paleta (ou clique em **+ Add OR group**) para criar um novo grupo. A tela mostra um divisor **OR** entre os grupos, por isso a regra lê-se "corresponder ao grupo 1 **OR** corresponder ao grupo 2." Cada grupo carrega o seu próprio conjunto de condições AND.

{% hint style="warning" %}
**Os grupos OR estão à frente do worker.** Você pode construir e guardar grupos OR hoje, e o Test Rule irá avaliá-los, mas até a atualização do worker de automatização chegar, as regras guardadas encadeiam **todas** as condições como AND quando realmente executam. O Rule Builder mostra um toast de lembrete quando você guarda uma regra de múltiplos grupos. Se você precisa de comportamento OR verdadeiro ao vivo agora mesmo, divida-a em duas regras separadas de grupo único.
{% endhint %}
{% endstep %}

{% step %}

### Passo 5: Largar uma ação (o bloco THEN)

A partir da secção **Actions** da paleta, arraste uma ação para a zona THEN. Ações disponíveis:

| Ação                 | Recebe um valor?         | Disponibilidade                                           |
| -------------------- | ------------------------ | --------------------------------------------------------- |
| **Change bid by %**  | Sim (ex. `+10` ou `-30`) | Ao vivo                                                   |
| **Set bid to value** | Sim (ex. `0.50 €`)       | Ao vivo                                                   |
| **Pause keyword**    | Não                      | Ao vivo                                                   |
| **Enable keyword**   | Não                      | Ao vivo                                                   |
| **Bid to breakeven** | Não                      | Beta - simula agora, executa após a atualização do worker |
| **Pause campaign**   | Não                      | Beta - simula agora, executa após a atualização do worker |
| **Add negative**     | Não                      | Beta - simula agora, executa após a atualização do worker |
| **Send alert**       | Não                      | Beta - simula agora, executa após a atualização do worker |

As ações com uma etiqueta **Beta** chegam à interface antes do worker. Quando você seleciona uma, o seu painel Properties mostra a nota: "This action ships in the UI but waits on a worker update before applying. Saved rules using it will simulate but not execute until then." São seguras de construir e testar - simplesmente ainda não vão alterar nada na Amazon.

Para **Change bid by %**, um valor positivo aumenta os lances e um valor negativo baixa-os; ao guardar, isto mapeia automaticamente para um tipo de regra Increase ou Decrease.
{% endstep %}

{% step %}

### Passo 6: Testar antes de guardar

Clique em **Test Rule** na barra de ações. O construtor avalia as suas condições face aos **últimos 30 dias** de dados e devolve um resumo em linguagem clara, por exemplo: quantas vezes por dia a regra teria disparado, quantas palavras-chave e campanhas teriam correspondido, um impacto mensal estimado no gasto e nas vendas, e até cinco palavras-chave de amostra correspondidas. Trate os números de impacto como estimativas direcionais a partir do desempenho recente, não como garantias.
{% endstep %}

{% step %}

### Passo 7: Agendar, ativar e guardar

Na barra de ações:

* **Schedule:** Diário, Horário ou Semanal.
* **Active:** deixe o toggle ligado para implementar a regra ao vivo, ou desligue-o para guardar um rascunho que não corre.
* Clique em **Save Rule.** A regra é escrita através do endpoint padrão das Bid Rules e agora aparece na página [Bid Rules](/pt-or-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-bid-rules.md).

**Run Now** aplica uma regra guardada uma vez, sob demanda. Você tem de guardar a regra primeiro - o Run Now visa a regra guardada, por isso pede-lhe para guardar se ainda não o fez.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Carregue um Template para começar depressa.** O menu **Load Template** (canto superior direito) larga na tela uma regra inicial totalmente ligada - como pausar palavras-chave de baixo CTR, impulsionar conversores fortes, cortar gasto desperdiçado ou negar automaticamente as bombas de ACoS. Carregue uma e depois ajuste os limites à sua conta antes de guardar.
{% endhint %}

***

## Como a Tela Mapeia para o Motor das Bid Rules

Quando você guarda, o Rule Builder achata a tela visual na mesma estrutura JSON que o motor das Bid Rules lê:

* Cada bloco de condição torna-se uma entrada `{metric, operator, value, lookback_days}` - idêntica a uma linha de condição do modal.
* O primeiro bloco de ação torna-se a ação primária da regra. Uma ação **Change bid by %** resolve para um tipo de regra Increase Bid ou Decrease Bid com base no sinal do valor.
* A sua escolha de escopo torna-se o filtro de campanha (uma lista de campanhas específicas, um padrão de nome ou todas as campanhas).
* O layout visual é guardado junto da regra para que a tela possa ser reconstruída.

Como o esquema de saída e o endpoint de guardar são partilhados, tudo o que você já sabe sobre as Bid Rules continua a aplicar-se: a mesma semântica de cadência diária/semanal, o mesmo registo de execução e o mesmo fluxo de revisão do Approval Center se você correr em modo de revisão manual. O Rule Builder é uma forma mais amigável de criar a regra, não uma coisa diferente para gerir.

***

## Exemplo Prático: Parar Palavras-chave Desperdiçadoras, Visualmente

Vamos construir uma regra "pause the money drains" de ponta a ponta.

**Objetivo:** Pausar qualquer palavra-chave que tenha gasto dinheiro real sem converter, mas apenas nas campanhas auto.

{% stepper %}
{% step %}

### Nome e escopo

* **Nome:** `Pause-NoSales-AutoCampaigns`
* **Escopo:** escolha **Match by name pattern** e introduza `* Auto *` para que a regra só toque nas suas campanhas de targeting automático.
  {% endstep %}

{% step %}

### Condições WHEN (todas AND)

Arraste três condições para um grupo para que se encadeiem com AND:

| Condição   | Operador | Valor  | Lookback |
| ---------- | -------- | ------ | -------- |
| **Orders** | `=`      | `0`    | 14 dias  |
| **Clicks** | `>`      | `20`   | 14 dias  |
| **Spend**  | `>`      | `15 €` | 14 dias  |

Os gates `Clicks > 20` e `Spend > 15` garantem que a regra só dispara em palavras-chave com dados significativos e estatisticamente fiáveis - não numa palavra-chave que teve três cliques.
{% endstep %}

{% step %}

### Ação THEN

Arraste **Pause keyword** para a zona THEN. Não recebe valor.
{% endstep %}

{% step %}

### Testar, depois implementar

Clique em **Test Rule.** Suponha que reporta que teria correspondido a 12 palavras-chave em 4 campanhas e lista os piores infratores. Isso parece certo, por isso defina **Schedule** para Diário, deixe **Active** ligado e clique em **Save Rule.** A regra corre agora diariamente e aparece na sua lista de Bid Rules, onde você pode rever o seu registo de execução uma semana depois.
{% endstep %}
{% endstepper %}

> **Plano de recuperação:** Reveja as palavras-chave pausadas mensalmente. Algumas falham por causa de um problema no listing (sem stock, imagens fracas) em vez de serem más palavras-chave. Corrija a causa raiz e reative-as.

***

<details>

<summary><strong>⚠️ Erros comuns a evitar</strong></summary>

{% hint style="danger" %}

* **Sem gate de volume de dados.** Uma regra de "ACoS > 40%, baixar lance" sem uma condição de cliques ou gasto irá disparar em palavras-chave com quase nenhuns dados. **Solução:** adicione sempre `Clicks > 20` ou `Spend > 10 €` no mesmo grupo.
* **Esperar que OR corra ao vivo hoje.** Dois grupos unidos por OR irão simular corretamente, mas até à atualização do worker, a execução trata todas as condições como AND. **Solução:** para comportamento OR verdadeiro agora mesmo, guarde duas regras separadas de grupo único.
* **Guardar uma ação Beta e esperar alterações na Amazon.** Bid to breakeven, pausar campanha, adicionar negativa e enviar alerta são Beta - simulam mas ainda não executam. **Solução:** para automatização ao vivo hoje, use Change bid by %, Set bid to value, Pause keyword ou Enable keyword.
* **Alterações percentuais demasiado agressivas num agendamento diário.** Uma alteração de lance diária de `-30%` colapsa um lance de 1,00 € para cerca de 0,08 € numa semana. **Solução:** mantenha as alterações percentuais diárias modestas (cerca de 5-15%) e reserve as oscilações maiores para agendamentos semanais.
  {% endhint %}

{% hint style="warning" %}

* **Esquecer-se de guardar antes do Run Now.** O Run Now atua sobre a regra guardada. Se você não guardou, ele vai pedir-lhe para o fazer. **Solução:** clique em Save Rule primeiro, depois em Run Now.
* **Definir o escopo como All campaigns por acidente.** All campaigns inclui também campanhas futuras. **Solução:** use Specific campaigns ou um Name pattern quando você quer um escopo delimitado.
  {% endhint %}

</details>

## ✅ Boas práticas

* **Simule cada regra antes de guardar.** O Test Rule face a 30 dias de histórico é a forma mais barata de apanhar uma regra que corresponderia a demasiadas (ou a zero) palavras-chave.
* **Um trabalho claro por regra.** Uma regra que corta desperdício e escala vencedores ao mesmo tempo tende a lutar contra si própria. Construa regras focadas e deixe-as correr lado a lado.
* **Condicione ao volume, depois à eficiência.** Ponha uma condição Clicks ou Spend ao lado de cada condição ACoS/CTR/CVR para que dados finos não possam desencadear uma ação.
* **Comece a partir de um template.** O Load Template dá-lhe uma linha de base sensata; ajuste os limites às suas margens em vez de começar de uma tela em branco.
* **Mantenha os nomes descritivos.** `[Ação]-[Condição]-[Escopo]` torna uma lista de regras crescente autodocumentada.
* **Rascunhe com Active desligado.** Guarde ideias promissoras com o toggle Active desligado, teste-as ao longo de alguns dias, depois passe-as a ao vivo.

***

## 🔧 Solução de problemas

### A tela está vazia e não consigo arrastar nada

| Verificar                           | Solução                                                                                                       |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| A sua conta Amazon Ads está ligada? | Procure o banner de ligação no topo. Ligue primeiro em Settings                                               |
| Você largou numa drop zone?         | Largue as condições na zona WHEN e as ações na zona THEN; o alvo destaca-se quando você arrasta por cima dele |

### O Test Rule devolve zero correspondências

| Verificar                                   | Solução                                                                                                                     |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| Os limites são demasiado restritos?         | Relaxe uma condição (ex. baixe um piso de Spend) e teste novamente                                                          |
| Dados suficientes na janela de lookback?    | Alargue o lookback por condição para 30 dias                                                                                |
| O escopo corresponde realmente a campanhas? | Verifique o seu name pattern - não distingue maiúsculas de minúsculas mas tem mesmo de corresponder aos nomes das campanhas |

### Guardei uma regra mas nada mudou na Amazon

| Verificar                                       | Solução                                                                                                                    |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| A ação é uma ação Beta (paridade com o worker)? | Bid to breakeven, pausar campanha, adicionar negativa e enviar alerta simulam mas ainda não executam. Use uma ação ao vivo |
| Você construiu grupos OR?                       | A lógica OR de múltiplos grupos executa como AND até à atualização do worker. Divida em regras separadas se necessário     |
| O toggle Active está ligado?                    | Uma regra guardada com Active desligado é um rascunho e não corre                                                          |
| O agendamento já decorreu?                      | Uma regra diária corre uma vez por dia; uma regra semanal uma vez por semana. Use Run Now para aplicar imediatamente       |

### O Run Now não faz nada

O Run Now visa uma regra guardada. Guarde a regra primeiro, depois clique em Run Now.

***

## ❓ FAQ

<details>

<summary><strong>Uma regra que construo aqui é o mesmo que uma Bid Rule?</strong></summary>

Sim. O Rule Builder guarda através do mesmo endpoint e esquema que o modal Create Rule na página [Bid Rules](/pt-or-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-bid-rules.md). A sua regra aparece nessa lista e corre no mesmo motor. O construtor é apenas uma forma mais rica de a criar.

</details>

<details>

<summary><strong>Posso editar uma regra que fiz no modal usando o Rule Builder?</strong></summary>

Ambas as superfícies escrevem para o mesmo armazenamento de regras, por isso as regras vivem num só lugar na página Bid Rules. O Rule Builder é melhor para criar novas regras visualmente e para regras que precisam de grupos OR, ações avançadas, escopo por padrão ou simulação.

</details>

<details>

<summary><strong>Porque é que posso selecionar uma ação OR mas o guia diz que corre como AND?</strong></summary>

O agrupamento OR está incorporado na interface e no simulador antes do worker de automatização. Até a atualização do worker chegar, uma regra guardada de múltiplos grupos encadeia todas as condições como AND quando realmente executa. O construtor lembra-o com um toast quando você guarda uma.

</details>

<details>

<summary><strong>Qual é a diferença entre Test Rule e Run Now?</strong></summary>

O Test Rule é uma simulação: avalia a sua regra face aos últimos 30 dias de dados e mostra o que teria correspondido, sem alterar nada. O Run Now executa uma regra guardada uma vez, a sério, sob demanda.

</details>

<details>

<summary><strong>O que faz a janela de lookback?</strong></summary>

Define quantos dias passados cada condição mede - 7, 14 ou 30. É por condição, por isso uma regra pode exigir ACoS ao longo de 14 dias e Clicks ao longo de 30 dias ao mesmo tempo.

</details>

<details>

<summary><strong>Onde reviso o que uma regra realmente fez?</strong></summary>

Mude o painel da direita para o separador **Last 30 runs** para ver as execuções recentes (hora de início, entidades correspondidas, entidades alteradas e estado) depois de a regra ser guardada. Para o histórico completo, abra a regra na página Bid Rules e verifique o seu registo de execução.

</details>

***

## ➡️ O que vem a seguir?

{% content-ref url="/pages/IMFthwHhFFFix5HSFlmh" %}
[Regras de lances PPC](/pt-or-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-bid-rules.md)
{% endcontent-ref %}

{% content-ref url="/pages/KbEwZBDP0FVpHPkc8m04" %}
[Central de Aprovação PPC](/pt-or-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-approval-center.md)
{% endcontent-ref %}