> 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-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-rule-builder.md).

# Construtor de regras PPC

Construa regras de lances automatizadas visualmente numa tela de arrastar e largar - combine condições, lógica AND/OR e ações, simule face ao histórico e depois implemente no mesmo motor que alimenta

{% hint style="info" %}
**Dificuldade:** 🔴 Avançado · **Tempo de leitura:** \~14 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](https://1034596264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAUp8wGCBcLktsaowHWoK%2Fuploads%2Fgit-blob-d99f4b2ccf219cf176039710ff685bad22ad224f%2Fppc-rule-builder.png?alt=media)

O **Rule Builder** é uma tela visual para montar regras de lances automatizadas. Em vez de preencher um formulário, você adiciona **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) à tela, arrastando-as, ou clicando nelas ou premindo Enter ou Space sobre elas na paleta. 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 [Regras de lances PPC](/pt-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.

{% hint style="warning" %}
**Duas coisas que o Builder não faz.** Primeiro, **Save Rule cria sempre uma regra nova.** O Builder não consegue abrir nem editar uma regra existente, por isso guardar duas vezes na mesma sessão cria duas regras. Segundo, **nada no Builder executa uma regra a pedido.** Os dois botões de pré-visualização apenas contam correspondências e nunca alteram lances. Uma regra começa a agir quando você a guarda como **Active** e chega a hora do seu agendamento.
{% endhint %}

**Rule Builder vs o modal Create Rule**

A página [Regras de lances PPC](/pt-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 target ACoS, pausar campanha, adicionar como 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                   |
| **Pré-visualizar** a regra face a 30 dias de histórico antes de guardar                                      | Não               | Sim (Preview matches) |
| 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, com uma barra de ações em largura total por cima.

| Área                                                     | O que faz                                                                                                                                                                                                       |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Botões do cabeçalho** (canto superior direito)         | **Load Template** abre um menu, navegável pelo teclado, de regras iniciais. **Rules List** liga à página [Regras de lances PPC](/pt-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-bid-rules.md) |
| **Barra de ações** (largura total, por cima dos painéis) | **Schedule** (Daily, Hourly, Weekly), o toggle **Active**, **Preview matches**, **Preview saved rule** e **Save Rule**                                                                                          |
| **Building Blocks** (esquerda)                           | A paleta, em três secções: **Conditions**, **Logic** (AND, OR) e **Actions**. Adicione um item arrastando-o para a tela, ou clicando nele ou premindo Enter ou Space sobre ele                                  |
| **Canvas** (centro)                                      | Onde a regra ganha forma: o campo do nome da regra com um botão **Clear**, o cartão de escopo da campanha, uma secção **WHEN** para as condições e uma secção **THEN** para as ações                            |
| **Properties / Last 30 runs** (direita)                  | Edite as definições do bloco selecionado, ou mude de separador para rever as execuções recentes                                                                                                                 |

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 as pré-visualizações 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 texto de exemplo é "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`.

O botão **Clear** junto ao campo do nome esvazia a tela inteira: o nome, todas as condições e ações, e o escopo, que volta a All campaigns.
{% 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 no mesmo seletor de campanhas usado noutras partes do PPC Manager, com bandeiras de países e selos SP/SB/SD. As campanhas arquivadas ficam ocultas até você ligar o filtro Archived |
| **Match by name pattern** | Introduza um padrão wildcard como `SP - Auto - *` ou `*brand*`. Use `*` como wildcard. Não distingue maiúsculas de minúsculas                                                                         |
| **Match by tag**          | Desativado e com o selo "Coming soon"                                                                                                                                                                 |

Se a lista de campanhas não puder ser carregada, o seletor mostra "Could not load your campaigns. Check your connection and reopen this rule." Isso é um problema de carregamento, não uma conta vazia.

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

{% hint style="danger" %}
**Um padrão de nome é um instantâneo único, e um padrão que não corresponde a nada significa todas as campanhas.** Quando você clica em Save Rule, o padrão é convertido numa lista fixa de IDs de campanha. As campanhas que você criar mais tarde e que correspondam ao padrão **não** são adicionadas à regra. Pior: se o padrão não corresponder a nenhuma campanha no momento de guardar (um erro de digitação, ou uma campanha que foi renomeada), a lista fica vazia, e uma lista vazia é tratada como "sem filtro" - a regra guardada passa então a cobrir **todas as campanhas**. O Preview matches não avisa, porque mostra zero correspondências para esse padrão. Confirme que o padrão corresponde às campanhas que você espera antes de guardar.
{% endhint %}
{% endstep %}

{% step %}

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

Na secção **Conditions** da paleta, arraste uma métrica para a tela, ou clique nela (ou prima Enter ou Space sobre ela). Métricas de condição disponíveis, com as etiquetas que a paleta mostra:

| Métrica         | 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                                |

Introduza as métricas percentuais como números simples: `30` significa 30%. Os resumos dos blocos na tela mostram um símbolo de euro depois dos valores de Spend e Sales, seja qual for a moeda do marketplace em que você anuncia.

Cada condição adicionada começa com o operador "greater than", um **lookback de 14 dias** e um valor padrão que depende da métrica (por exemplo, ACoS começa em `> 30`). Selecione o bloco para abrir as suas **Properties** à direita e ajustar:

* **Metric**
* **Operator** - `>` (maior que), `≥` (maior ou igual a), `<` (menor que), `≤` (menor ou igual a), `=` (igual a)
* **Value**
* **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. **Delete Block**, no fundo do painel, remove o bloco selecionado; o pequeno x em cada bloco faz o mesmo.

{% 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 adicionar outra métrica ao mesmo grupo e ela encadeia-se automaticamente, com um divisor "AND" entre os blocos. Cada grupo é encabeçado por um selo com o texto "All of (AND) #1", "All of (AND) #2", e assim por diante, e tem no fundo uma zona **Add AND condition** para largar uma métrica diretamente nesse grupo. O item **AND** na secção Logic da paleta não adiciona nada; serve apenas para lembrar que AND é o padrão.

Para lógica **OR**, adicione um segundo grupo. Arraste o item **OR** da paleta (ou clique nele), ou clique em **+ Add OR group** por baixo dos grupos existentes. 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. Quando existe mais de um grupo, cada grupo oferece **Remove this group**.

{% hint style="warning" %}
**Os grupos OR estão à frente do worker.** Você pode construir e guardar grupos OR hoje, e o Preview matches 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. Quando você guarda uma regra de múltiplos grupos, o Rule Builder mostra o toast "OR groups will activate once your worker is updated. Until then, all conditions chain as AND." 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: Adicionar uma ação (o bloco THEN)

Na secção **Actions** da paleta, arraste uma ação para a zona THEN, ou clique nela (ou prima Enter ou Space sobre ela) para a adicionar aí. Ações disponíveis:

| Ação                   | Recebe um valor?                         | Disponibilidade                          |
| ---------------------- | ---------------------------------------- | ---------------------------------------- |
| **Adjust bid by %**    | Sim (ex. `+10` ou `-30`; começa em `10`) | Ao vivo                                  |
| **Set bid (absolute)** | Sim (ex. `0.50 €`; começa em `0.5`)      | Ao vivo                                  |
| **Bid to target ACoS** | Não                                      | Beta - aguarda uma atualização do worker |
| **Pause keyword**      | Não                                      | Ao vivo                                  |
| **Enable keyword**     | Não                                      | Ao vivo                                  |
| **Pause campaign**     | Não                                      | Beta - aguarda uma atualização do worker |
| **Add as negative**    | Não                                      | Beta - aguarda uma atualização do worker |
| **Send alert**         | Não                                      | Beta - aguarda uma atualização do worker |

Selecione um bloco de ação para alterar o seu **Action Type** ou **Value** no painel Properties.

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 pré-visualizar - simplesmente ainda não vão alterar nada na Amazon.

**Bid to target ACoS** define o lance para o que o seu target ACoS permite. **Não** é o seu verdadeiro ponto de equilíbrio de lucro, por isso não o leia como "licitar até ao ponto em que deixo de ganhar dinheiro."

Para **Adjust 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: Pré-visualizar o editor antes de guardar

Clique em **Preview matches** na barra de ações. O construtor avalia a regra **tal como está neste momento na tela**, guardada ou não, face aos **últimos 30 dias** de dados. Depois mostra um resumo em linguagem clara:

* "This rule would have fired about N times a day on K keywords across C campaigns in the last D days."
* "Estimated impact: spend X / sales Y per month."
* **Top matches**: até cinco palavras-chave de amostra com a respetiva campanha, ACoS e gasto.

Trate os números de impacto como estimativas direcionais a partir do desempenho recente, não como garantias. **O Preview matches não altera nada.** Se você editar a tela enquanto uma pré-visualização ainda está a carregar, o resultado é descartado em vez de ser mostrado face à regra errada.
{% endstep %}

{% step %}

### Passo 7: Agendar, ativar, guardar e verificar a versão guardada

Na barra de ações:

* **Schedule:** Daily, Hourly ou Weekly.
* **Active:** o toggle vem ligado por padrão. Deixe-o ligado para ativar a regra no seu agendamento, 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 [Regras de lances PPC](/pt-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-bid-rules.md).

**Guardar uma regra Active é a única forma de uma regra começar a agir.** Não existe um "run now" a pedido no Builder.

Antes de guardar, o Builder verifica os problemas seguintes e mostra um toast em vez de guardar:

* "Canvas is empty - add at least one condition."
* "Add at least one action."
* "Pick at least one campaign - or switch the scope to "All campaigns"."
* "Enter a name pattern - or switch the scope to "All campaigns"."

Depois de um save bem-sucedido, **Preview saved rule** fica disponível. Procura a versão que você **guardou por último** e conta quantas palavras-chave correspondem a ela nos últimos 30 dias: "N keywords match the saved rule." Depois lembra que isto é apenas uma pré-visualização, sem lances alterados nem ações em fila, e oferece uma ligação **Review bid suggestions** para as Smart Bid Suggestions na página Bid Rules, para rever alterações de lance individuais. Se você clicar nele antes de guardar, o Builder diz-lhe para guardar a regra primeiro. A contagem abrange as palavras-chave do seu projeto e não aplica o escopo de campanha da regra, por isso pode ser mais alta do que a contagem do Preview matches para uma regra limitada a algumas campanhas.

Resumindo os dois botões: **Preview matches** avalia o editor atual, e **Preview saved rule** verifica a versão que você guardou por último. Nenhum deles altera lances.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Carregue um Template para começar depressa.** O menu **Load Template** (canto superior direito) carrega na tela uma regra inicial já ligada, substituindo o respetivo nome, condições e ações. Use as setas, Enter e Escape para se mover pelo menu. Não altera o seu escopo. Carregue uma e depois ajuste os limites à sua conta antes de guardar.

| Template                   | Carrega                                                   |
| -------------------------- | --------------------------------------------------------- |
| **Pause low-CTR keywords** | CTR < 0,2; Impressions > 1000; Clicks < 5 - Pause keyword |
| **Boost STAR keywords**    | Orders > 5; ACoS < 21 - Adjust bid by +20%                |
| **Cut wasteful spend**     | Clicks > 20; Orders = 0 - Adjust bid by -30%              |
| **Defend brand terms**     | CTR < 1,5 - Adjust bid by +15%                            |
| **Capture share at peak**  | CTR > 1; CVR > 5 - Adjust bid by +25%                     |
| **Auto-negate ACoS bombs** | ACoS > 90; Clicks > 10 - Add as negative                  |

Todas as condições dos templates usam um lookback de 14 dias. Duas coisas a verificar antes de guardar um. **Defend brand terms** não tem filtro de marca nas suas condições, por isso defina você o escopo (por exemplo, um padrão de nome) para as suas campanhas de marca. **Auto-negate ACoS bombs** carrega uma ação Beta que ainda não executa e, embora a descrição no menu diga "above 3x target", a condição que realmente carrega é um ACoS fixo acima de 90.
{% 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 **Adjust 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, uma lista de IDs de campanha resolvida a partir do seu padrão de nome no momento de guardar, 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 e o mesmo registo de execução. 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.

Lembre-se de que o padrão é um instantâneo único: a regra cobrirá as campanhas auto que existirem e corresponderem quando você clicar em Save Rule, e não as campanhas auto que você lançar depois. Se mais tarde criar uma nova campanha auto, construa e guarde a regra outra vez para a incluir. Confirme também que o padrão corresponde mesmo aos nomes das suas campanhas. Um padrão que não corresponda a nada faria a regra guardada cobrir todas as campanhas.
{% endstep %}

{% step %}

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

Adicione três condições a 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

Adicione **Pause keyword** à zona THEN. Não recebe valor.
{% endstep %}

{% step %}

### Pré-visualizar e depois guardar

Clique em **Preview matches.** Suponha que reporta que a regra teria correspondido a 12 palavras-chave em 4 campanhas e lista as principais correspondências. Isso parece certo, por isso defina **Schedule** para Daily, deixe **Active** ligado e clique em **Save Rule.** A regra corre agora no seu agendamento diário e aparece na sua lista de Bid Rules, onde você pode rever o seu registo de execução uma semana depois. Pode também clicar em **Preview saved rule** para confirmar que a versão guardada corresponde às palavras-chave como você espera.
{% 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 ser pré-visualizados 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 target ACoS, pause campaign, add as negative e send alert são Beta - a aplicação diz que as regras guardadas que as usam vão simular mas não executar até haver uma atualização do worker. **Solução:** para automatização ao vivo hoje, use Adjust bid by %, Set bid (absolute), 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.
* **Um padrão de nome que não corresponde a nada.** A regra guardada acaba por cobrir todas as campanhas. **Solução:** confirme o padrão face aos nomes reais das suas campanhas antes de guardar, ou use Specific campaigns.
  {% endhint %}

{% hint style="warning" %}

* **Esperar que um botão execute a regra.** Nem o Preview matches nem o Preview saved rule alteram lances ou põem ações em fila. **Solução:** guarde a regra como Active e deixe o agendamento executá-la.
* **Guardar a mesma regra duas vezes.** Save Rule cria sempre uma regra nova, por isso um segundo clique cria um duplicado. **Solução:** guarde uma só vez e depois gira a regra a partir da página Bid Rules.
* **Definir o escopo como All campaigns por acidente.** All campaigns inclui também campanhas futuras. **Solução:** use Specific campaigns ou um padrão de nome quando você quer um escopo delimitado.
  {% endhint %}

</details>

## ✅ Boas práticas

* **Pré-visualize cada regra antes de guardar.** O Preview matches 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, verifique-as com o Preview saved rule, depois ligue-as a partir da página Bid Rules.

***

## 🔧 Solução de problemas

### A tela está vazia e não consigo adicionar 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. Em vez de arrastar, pode também clicar num item da paleta, ou premir Enter ou Space sobre ele |

### O Preview matches devolve zero correspondências

| Verificar                                   | Solução                                                                                                                       |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Os limites são demasiado restritos?         | Relaxe uma condição (ex. baixe um piso de Spend) e pré-visualize 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 padrão de nome - 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 target ACoS, pause campaign, add as negative e send alert aguardam uma atualização do worker. 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. Não há forma de a executar a pedido a partir do Builder, por isso aguarde pela próxima execução agendada e consulte o separador Last 30 runs |

### O Preview saved rule diz para guardar a regra primeiro

O Preview saved rule verifica a versão que você guardou por último nesta sessão. Clique primeiro em **Save Rule** (com o toggle Active desligado, se você só quer um rascunho) e depois clique outra vez em Preview saved rule.

### Tenho duas cópias da mesma regra

Save Rule cria sempre uma regra nova, por isso guardar duas vezes na mesma sessão cria duas. Abra a página [Regras de lances PPC](/pt-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-bid-rules.md) e desligue ou elimine a cópia a mais.

### O separador Last 30 runs está vazio

O separador mostra "No scheduled runs yet. Save an active rule to schedule it. Previews do not create a run." Só lista execuções de uma regra que você guardou durante esta visita, e uma execução só aparece depois de o agendamento ter realmente disparado. Se você vir "Could not load the run history. Check your connection and reopen this tab.", o histórico falhou ao carregar - isso não significa que a regra nunca correu.

***

## ❓ 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 [Regras de lances PPC](/pt-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 com o Rule Builder uma regra que fiz no modal?</strong></summary>

Não. O Rule Builder só cria regras novas; não consegue abrir uma regra existente, quer você a tenha feito no modal quer no próprio Builder. Guardar a partir do Builder acrescenta sempre uma regra nova. As regras das duas superfícies vivem juntas na página Bid Rules, onde você as pode ligar, desligar, editar ou eliminar. Para alterar a lógica da tela de uma regra do Builder, construa aqui a versão corrigida e depois remova a antiga na página Bid Rules.

</details>

<details>

<summary><strong>Porque é que posso construir um grupo OR mas o guia diz que corre como AND?</strong></summary>

O agrupamento OR está incorporado na interface e na pré-visualização 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 Preview matches e Preview saved rule? Posso executar uma regra agora?</strong></summary>

O **Preview matches** avalia a regra que está neste momento na tela face aos últimos 30 dias e mostra com que frequência teria disparado, um impacto mensal estimado e as principais correspondências. O **Preview saved rule** verifica a versão que você guardou por último e mostra quantas palavras-chave correspondem a ela. Nenhum dos dois altera lances nem põe ações em fila, e não há nenhum outro botão no Builder que execute uma regra a pedido. Para pôr uma regra a trabalhar, guarde-a com Active ligado e deixe o agendamento executá-la.

</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, com as colunas Started, Matched, Changed e Status, depois de você ter guardado a regra e de o seu agendamento ter disparado. Para o histórico completo, abra a regra na página Bid Rules e consulte o seu registo de execução.

</details>

<details>

<summary><strong>Uma regra com padrão de nome apanha campanhas que eu crie mais tarde?</strong></summary>

Não. O padrão é convertido numa lista fixa de IDs de campanha quando você guarda, por isso as campanhas posteriores que correspondam não são incluídas. Se o padrão não correspondia a nada no momento de guardar, a regra cobre antes todas as campanhas. Só o escopo **All campaigns** se destina a cobrir campanhas futuras.

</details>

***

## ➡️ O que vem a seguir?

{% content-ref url="/pages/IMFthwHhFFFix5HSFlmh" %}
[Regras de lances PPC](/pt-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-guia-do-sellermagnet/gestao-ppc-beta/ppc-manager-overview/ppc-approval-center.md)
{% endcontent-ref %}