> 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/it-sellermagnet-guida/gestione-ppc-beta/ppc-manager-overview/ppc-rule-builder.md).

# PPC Costruttore di regole

{% hint style="info" %}
**Difficoltà:** 🔴 Avanzato · **Tempo di lettura:** \~12 min
{% endhint %}

{% hint style="success" icon="rocket" %}
**Apri questa pagina nella tua dashboard:** [**Vai a PPC Rule Builder \[BETA\] →**](https://dashboard.sellermagnet.com/ppc/rules/builder)
{% endhint %}

{% hint style="warning" icon="triangle-exclamation" %}
**BETA:** Il PPC Manager è in beta, e il Rule Builder è una delle sue superfici più recenti. Alcune azioni avanzate e la logica dei gruppi OR arrivano nell'interfaccia prima del worker di automazione - la guida segnala ciascun caso dove si applica. Segnala qualsiasi cosa inaspettata a <info@sellermagnet.com>.
{% endhint %}

## 📋 Panoramica

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

Il **Rule Builder** è un canvas visivo drag-and-drop per assemblare regole di offerta automatizzate. Invece di compilare un modulo, trascini **condizioni** (ACoS, CTR, spesa, clic e altro) e **azioni** (aumenta o abbassa le offerte, metti in pausa una parola chiave, aggiungi una negativa, invia un avviso) su un canvas, le colleghi con logica AND/OR e salvi.

È importante capire cosa il Rule Builder **non** è: non è un motore di automazione separato. Sotto il cofano il canvas viene serializzato esattamente nello stesso schema JSON usato dalla pagina [Bid Rules](/it-sellermagnet-guida/gestione-ppc-beta/ppc-manager-overview/ppc-bid-rules.md), e salva attraverso lo stesso endpoint. Una regola che costruisci qui appare nella tua lista Bid Rules, viene eseguita sulla stessa pianificazione e appare nella stessa cronologia di esecuzione. Pensa al Rule Builder come a un editor più ricco sopra lo stesso motore di regole.

**Rule Builder vs il modale Create Rule**

La pagina [Bid Rules](/it-sellermagnet-guida/gestione-ppc-beta/ppc-manager-overview/ppc-bid-rules.md) ha un semplice modale **Create Rule** perfetto per una singola regola a una sola azione dove ogni condizione è unita da AND. Il Rule Builder è la superficie per utenti esperti per la stessa idea. Usalo quando vuoi:

| Vuoi...                                                                                    | Modale Create Rule | Rule Builder       |
| ------------------------------------------------------------------------------------------ | ------------------ | ------------------ |
| Aggiungere diverse condizioni AND                                                          | Sì                 | Sì                 |
| Raggruppare condizioni con logica **OR**                                                   | No                 | Sì (gruppi visivi) |
| Scegliere tra azioni avanzate (bid to breakeven, pause campaign, add negative, send alert) | No                 | Sì                 |
| Definire l'ambito tramite **pattern del nome campagna** (wildcard)                         | No                 | Sì                 |
| Impostare una **finestra di lookback per condizione**                                      | No                 | Sì                 |
| **Simulare** la regola rispetto allo storico prima di salvare                              | No                 | Sì (Test Rule)     |
| Rivedere le **ultime 30 esecuzioni** nel pannello                                          | No                 | Sì                 |
| Caricare un **template** pronto all'uso                                                    | No                 | Sì                 |

{% hint style="info" icon="lightbulb" %}
**Quando usare quale:** Ricorri al modale per paletti rapidi come "ACoS > 35% e Clic > 25, diminuisci offerta 10%." Ricorri al Rule Builder quando una regola necessita di rami OR, un'azione diversa dall'offerta, un ambito a pattern, o vuoi vederne in anteprima l'impatto prima che vada in produzione.
{% endhint %}

***

## Il Canvas a colpo d'occhio

Il Rule Builder è un'area di lavoro a tre pannelli.

| Pannello                               | Cosa fa                                                                                                                                                                                      |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Building Blocks** (sinistra)         | La palette. Trascina Conditions, Logic (AND/OR) e Actions sul canvas                                                                                                                         |
| **Canvas** (centro)                    | Dove la regola prende forma: una sezione **WHEN** per le condizioni e una sezione **THEN** per le azioni, con la card dell'ambito campagna in cima                                           |
| **Properties / Last 30 runs** (destra) | Modifica le impostazioni del blocco selezionato, o cambia scheda per rivedere le esecuzioni recenti. Sotto c'è la barra delle azioni: Schedule, toggle Active, Test Rule, Run Now, Save Rule |

Il canvas si legge dall'alto in basso come una frase: **Apply to** (ambito) queste campagne, **WHEN** queste condizioni corrispondono, **THEN** fai questo.

{% hint style="warning" %}
**Connessione Amazon Ads richiesta.** Il Rule Builder necessita di un account Amazon Advertising connesso. Se vedi un banner "Connect Your Amazon Advertising Account", connettilo prima in Settings - altrimenti il selettore dell'ambito campagna e la simulazione non hanno dati con cui lavorare.
{% endhint %}

***

## Costruire una regola passo per passo

{% stepper %}
{% step %}

### Passo 1: Nomina la regola

Digita un nome descrittivo nel campo in cima al canvas (di default è "Untitled Rule"). Uno stile di denominazione coerente come `[Azione]-[Condizione]-[Ambito]` mantiene leggibile una lunga lista di regole, ad esempio `Cut-HighACoS-AllCampaigns`.
{% endstep %}

{% step %}

### Passo 2: Imposta l'ambito (Apply to)

La card dell'ambito sta in cima al canvas. Scegli quali campagne la regola tocca:

| Modalità ambito           | Comportamento                                                                                                    |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **All campaigns**         | La regola valuta ogni campagna, incluse quelle che crei in seguito                                               |
| **Specific campaigns**    | Scegli le campagne da una lista a selezione multipla (tieni premuto Ctrl/Cmd per selezionarne diverse)           |
| **Match by name pattern** | Inserisci un pattern con wildcard come `SP - Auto - *` o `*brand*`. Non fa distinzione tra maiuscole e minuscole |
| **Match by tag**          | Coming soon - l'opzione è visibile ma disabilitata                                                               |

{% hint style="danger" %}
**"All campaigns" include il futuro.** Una regola con ambito All campaigns verrà eseguita anche su qualsiasi nuova campagna che lanci in seguito. Se la vuoi solo sulle campagne di oggi, scegli Specific campaigns e selezionale esplicitamente.
{% endhint %}
{% endstep %}

{% step %}

### Passo 3: Trascina le condizioni (il blocco WHEN)

Dalla sezione **Conditions** della palette, trascina una metrica sul canvas. Metriche di condizione disponibili:

| Metrica         | Unità | Uso tipico                                           |
| --------------- | ----- | ---------------------------------------------------- |
| **ACoS**        | %     | Limitare il costo pubblicitario delle vendite        |
| **CTR**         | %     | Trovare parole chiave a bassa rilevanza              |
| **CVR**         | %     | Individuare convertitori forti o deboli              |
| **Spend**       | €     | Impostare un minimo di spesa prima di agire          |
| **Clicks**      | -     | Richiedere dati sufficienti per essere significativi |
| **Impressions** | -     | Filtrare in base al volume di visibilità             |
| **Orders**      | -     | Colpire parole chiave a zero ordini o ad alti ordini |
| **Sales**       | €     | Filtrare per fatturato                               |

Ogni condizione rilasciata parte con un valore predefinito sensato (ad esempio ACoS è di default `> 30`). Seleziona il blocco per aprire le sue **Properties** a destra e regola **Metric**, **Operator** (`>`, `≥`, `<`, `≤`, `=`), **Value** e **Lookback (days)** - 7, 14 o 30. La finestra di lookback è per condizione, così una regola può misurare l'ACoS su 14 giorni richiedendo al contempo i Clicks su 30 giorni.

{% hint style="info" icon="lightbulb" %}
**Aggiungi sempre un paletto sul volume di dati.** Abbina ogni condizione di efficienza (ACoS, CTR, CVR) a una condizione `Clicks >` o `Spend >` così la regola non agisce mai su una parola chiave con due clic e un ACoS temporaneamente impazzito.
{% endhint %}
{% endstep %}

{% step %}

### Passo 4: Aggiungi la logica - AND vs OR

Le condizioni all'interno dello stesso gruppo sono unite da **AND** (tutte devono corrispondere). AND è il predefinito: rilascia semplicemente un'altra metrica nello stesso gruppo e si concatena automaticamente con un divisore "AND" tra i blocchi.

Per la logica **OR**, aggiungi un secondo gruppo. Trascina il blocco **OR** dalla palette (o clicca **+ Add OR group**) per creare un nuovo gruppo. Il canvas mostra un divisore **OR** tra i gruppi, così la regola si legge "corrisponde al gruppo 1 **OR** corrisponde al gruppo 2." Ogni gruppo porta il proprio set di condizioni AND.

{% hint style="warning" %}
**I gruppi OR sono in anticipo sul worker.** Puoi costruire e salvare gruppi OR oggi, e Test Rule li valuterà, ma finché non arriva l'aggiornamento del worker di automazione, le regole salvate concatenano **tutte** le condizioni come AND quando vengono effettivamente eseguite. Il Rule Builder mostra un toast di promemoria quando salvi una regola a più gruppi. Se hai bisogno di un vero comportamento OR live proprio adesso, dividila in due regole separate a gruppo singolo.
{% endhint %}
{% endstep %}

{% step %}

### Passo 5: Rilascia un'azione (il blocco THEN)

Dalla sezione **Actions** della palette, trascina un'azione nella zona THEN. Azioni disponibili:

| Azione               | Richiede un valore?    | Disponibilità                                             |
| -------------------- | ---------------------- | --------------------------------------------------------- |
| **Change bid by %**  | Sì (es. `+10` o `-30`) | Live                                                      |
| **Set bid to value** | Sì (es. `0,50 €`)      | Live                                                      |
| **Pause keyword**    | No                     | Live                                                      |
| **Enable keyword**   | No                     | Live                                                      |
| **Bid to breakeven** | No                     | Beta - simula ora, esegue dopo l'aggiornamento del worker |
| **Pause campaign**   | No                     | Beta - simula ora, esegue dopo l'aggiornamento del worker |
| **Add negative**     | No                     | Beta - simula ora, esegue dopo l'aggiornamento del worker |
| **Send alert**       | No                     | Beta - simula ora, esegue dopo l'aggiornamento del worker |

Le azioni che portano un tag **Beta** arrivano nell'interfaccia prima del worker. Quando ne selezioni una, il suo pannello Properties mostra la 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." Sono sicure da costruire e testare - semplicemente non cambieranno ancora nulla su Amazon.

Per **Change bid by %**, un valore positivo aumenta le offerte e un valore negativo le abbassa; al salvataggio questo mappa automaticamente a un tipo di regola Increase o Decrease.
{% endstep %}

{% step %}

### Passo 6: Testa prima di salvare

Clicca **Test Rule** nella barra delle azioni. Il builder valuta le tue condizioni rispetto agli **ultimi 30 giorni** di dati e restituisce un riepilogo in linguaggio semplice, ad esempio: quante volte al giorno la regola si sarebbe attivata, quante parole chiave e campagne avrebbero corrisposto, un impatto stimato mensile su spesa e vendite, e fino a cinque parole chiave campione corrispondenti. Tratta i numeri di impatto come stime direzionali dalle prestazioni recenti, non come garanzie.
{% endstep %}

{% step %}

### Passo 7: Pianifica, attiva e salva

Nella barra delle azioni:

* **Schedule:** Daily, Hourly o Weekly.
* **Active:** lascia il toggle attivo per distribuire la regola live, o disattivalo per salvare una bozza che non viene eseguita.
* Clicca **Save Rule.** La regola viene scritta attraverso l'endpoint standard di Bid Rules e ora appare nella pagina [Bid Rules](/it-sellermagnet-guida/gestione-ppc-beta/ppc-manager-overview/ppc-bid-rules.md).

**Run Now** applica una regola salvata una volta, su richiesta. Devi prima salvare la regola - Run Now agisce sulla regola salvata, quindi ti chiede di salvare se non l'hai ancora fatto.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Load Template per partire in fretta.** Il menu **Load Template** (in alto a destra) rilascia sul canvas una regola iniziale completamente cablata - come mettere in pausa parole chiave a basso CTR, potenziare convertitori forti, tagliare la spesa sprecata o auto-negare le bombe di ACoS. Caricane una, poi aggiusta le soglie per adattarle al tuo account prima di salvare.
{% endhint %}

***

## Come il Canvas si mappa al motore Bid Rules

Quando salvi, il Rule Builder appiattisce il canvas visivo nella stessa struttura JSON che il motore Bid Rules legge:

* Ogni blocco condizione diventa una voce `{metric, operator, value, lookback_days}` - identica a una riga di condizione del modale.
* Il primo blocco azione diventa l'azione primaria della regola. Un'azione **Change bid by %** si risolve in un tipo di regola Increase Bid o Decrease Bid in base al segno del valore.
* La tua scelta di ambito diventa il filtro campagna (una lista di campagne specifiche, un pattern di nome o tutte le campagne).
* Il layout visivo viene memorizzato insieme alla regola così il canvas può essere ricostruito.

Poiché lo schema di output e l'endpoint di salvataggio sono condivisi, tutto ciò che già sai su Bid Rules continua ad applicarsi: la stessa semantica di cadenza giornaliera/settimanale, lo stesso log di esecuzione e lo stesso flusso di revisione dell'Approval Center se esegui in modalità revisione manuale. Il Rule Builder è un modo più amichevole di scrivere la regola, non una cosa diversa da gestire.

***

## Esempio pratico: fermare le parole chiave sprecone, visivamente

Costruiamo end to end una regola "metti in pausa le voragini di denaro".

**Obiettivo:** Mettere in pausa qualsiasi parola chiave che ha speso soldi veri senza convertire, ma solo sulle campagne auto.

{% stepper %}
{% step %}

### Nome e ambito

* **Nome:** `Pause-NoSales-AutoCampaigns`
* **Ambito:** scegli **Match by name pattern** e inserisci `* Auto *` così la regola tocca solo le tue campagne auto-targeting.
  {% endstep %}

{% step %}

### Condizioni WHEN (tutte AND)

Trascina tre condizioni in un gruppo così si concatenano con AND:

| Condizione | Operatore | Valore | Lookback  |
| ---------- | --------- | ------ | --------- |
| **Orders** | `=`       | `0`    | 14 giorni |
| **Clicks** | `>`       | `20`   | 14 giorni |
| **Spend**  | `>`       | `15 €` | 14 giorni |

I paletti `Clicks > 20` e `Spend > 15` assicurano che la regola si attivi solo su parole chiave con dati significativi e statisticamente affidabili - non una parola chiave che ha avuto tre clic.
{% endstep %}

{% step %}

### Azione THEN

Trascina **Pause keyword** nella zona THEN. Non richiede alcun valore.
{% endstep %}

{% step %}

### Testa, poi distribuisci

Clicca **Test Rule.** Supponiamo che riporti che avrebbe corrisposto a 12 parole chiave su 4 campagne ed elenchi i peggiori trasgressori. Sembra corretto, quindi imposta **Schedule** su Daily, lascia **Active** attivo e clicca **Save Rule.** La regola ora viene eseguita quotidianamente e appare nella tua lista Bid Rules, dove puoi rivedere il suo log di esecuzione una settimana dopo.
{% endstep %}
{% endstepper %}

> **Piano di recupero:** Rivedi le parole chiave in pausa mensilmente. Alcune falliscono a causa di un problema del listing (esaurito, immagini scarse) piuttosto che per essere cattive parole chiave. Correggi la causa principale e riattivale.

***

<details>

<summary><strong>⚠️ Errori comuni da evitare</strong></summary>

{% hint style="danger" %}

* **Nessun paletto sul volume di dati.** Una regola tipo "ACoS > 40%, abbassa offerta" senza una condizione di clic o spesa si attiverà su parole chiave con quasi nessun dato. **Soluzione:** aggiungi sempre `Clicks > 20` o `Spend > 10 €` nello stesso gruppo.
* **Aspettarsi che OR venga eseguito live oggi.** Due gruppi uniti da OR simuleranno correttamente, ma finché non arriva l'aggiornamento del worker, l'esecuzione tratta ogni condizione come AND. **Soluzione:** per un vero comportamento OR adesso, salva invece due regole separate a gruppo singolo.
* **Salvare un'azione Beta e aspettarsi cambiamenti su Amazon.** Bid to breakeven, pause campaign, add negative e send alert sono Beta - simulano ma non eseguono ancora. **Soluzione:** per l'automazione live oggi, usa Change bid by %, Set bid to value, Pause keyword o Enable keyword.
* **Cambi percentuali troppo aggressivi su una pianificazione giornaliera.** Una modifica di offerta giornaliera `-30%` fa collassare un'offerta di 1,00 € a circa 0,08 € in una settimana. **Soluzione:** mantieni i cambi percentuali giornalieri modesti (all'incirca 5-15%) e riserva le oscillazioni più grandi alle pianificazioni settimanali.
  {% endhint %}

{% hint style="warning" %}

* **Dimenticare di salvare prima di Run Now.** Run Now agisce sulla regola salvata. Se non hai salvato, te lo chiederà. **Soluzione:** clicca prima Save Rule, poi Run Now.
* **Definire l'ambito su All campaigns per sbaglio.** All campaigns include anche le campagne future. **Soluzione:** usa Specific campaigns o un Name pattern quando vuoi un ambito delimitato.
  {% endhint %}

</details>

## ✅ Best Practice

* **Simula ogni regola prima di salvarla.** Test Rule rispetto a 30 giorni di storico è il modo più economico per intercettare una regola che corrisponderebbe a troppe (o zero) parole chiave.
* **Un compito chiaro per regola.** Una regola che sia taglia lo spreco sia scala i vincitori tende a combattere contro sé stessa. Costruisci regole focalizzate e lasciale correre fianco a fianco.
* **Fai il paletto sul volume, poi sull'efficienza.** Metti una condizione di Clicks o Spend accanto a ogni condizione ACoS/CTR/CVR così dati scarsi non possano innescare un'azione.
* **Parti da un template.** Load Template ti dà una baseline sensata; aggiusta le soglie ai tuoi margini invece di partire da un canvas vuoto.
* **Mantieni i nomi descrittivi.** `[Azione]-[Condizione]-[Ambito]` rende auto-documentante una lista di regole in crescita.
* **Fai le bozze con Active disattivato.** Salva le idee promettenti con il toggle Active disattivato, testale per qualche giorno, poi mettile live.

***

## 🔧 Risoluzione dei problemi

### Il canvas è vuoto e non riesco a trascinare nulla

| Controlla                             | Soluzione                                                                                                           |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Il tuo account Amazon Ads è connesso? | Cerca il banner di connessione in alto. Connettiti prima in Settings                                                |
| Hai trascinato su una drop zone?      | Rilascia le condizioni nella zona WHEN e le azioni nella zona THEN; il target si evidenzia quando ci trascini sopra |

### Test Rule restituisce zero corrispondenze

| Controlla                                             | Soluzione                                                                                                                             |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Le soglie sono troppo severe?                         | Allenta una condizione (es. abbassa un minimo di Spend) e testa di nuovo                                                              |
| Dati sufficienti nella finestra di lookback?          | Allarga il lookback per condizione a 30 giorni                                                                                        |
| L'ambito corrisponde effettivamente a delle campagne? | Controlla il tuo pattern di nome - non fa distinzione tra maiuscole e minuscole ma deve comunque corrispondere ai nomi delle campagne |

### Ho salvato una regola ma nulla è cambiato su Amazon

| Controlla                                         | Soluzione                                                                                                                                         |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| L'azione è un'azione Beta (parità con il worker)? | Bid to breakeven, pause campaign, add negative e send alert simulano ma non eseguono ancora. Usa un'azione live                                   |
| Hai costruito gruppi OR?                          | La logica OR a più gruppi viene eseguita come AND fino all'aggiornamento del worker. Dividi in regole separate se necessario                      |
| Il toggle Active è attivo?                        | Una regola salvata con Active disattivato è una bozza e non viene eseguita                                                                        |
| La pianificazione è trascorsa?                    | Una regola giornaliera viene eseguita una volta al giorno; una regola settimanale una volta a settimana. Usa Run Now per applicare immediatamente |

### Run Now non fa nulla

Run Now agisce su una regola salvata. Salva prima la regola, poi clicca Run Now.

***

## ❓ FAQ

<details>

<summary><strong>Una regola che costruisco qui è la stessa cosa di una Bid Rule?</strong></summary>

Sì. Il Rule Builder salva attraverso lo stesso endpoint e schema del modale Create Rule sulla pagina [Bid Rules](/it-sellermagnet-guida/gestione-ppc-beta/ppc-manager-overview/ppc-bid-rules.md). La tua regola appare in quella lista e viene eseguita sullo stesso motore. Il builder è solo un modo più ricco di scriverla.

</details>

<details>

<summary><strong>Posso modificare una regola che ho creato nel modale usando il Rule Builder?</strong></summary>

Entrambe le superfici scrivono nello stesso archivio di regole, quindi le regole vivono in un unico posto sulla pagina Bid Rules. Il Rule Builder è ideale per scrivere nuove regole visivamente e per regole che necessitano di gruppi OR, azioni avanzate, ambito a pattern o simulazione.

</details>

<details>

<summary><strong>Perché posso selezionare un'azione OR ma la guida dice che viene eseguita come AND?</strong></summary>

Il raggruppamento OR è integrato nell'interfaccia e nel simulatore in anticipo sul worker di automazione. Finché non arriva l'aggiornamento del worker, una regola salvata a più gruppi concatena tutte le condizioni come AND quando viene effettivamente eseguita. Il builder te lo ricorda con un toast quando ne salvi una.

</details>

<details>

<summary><strong>Qual è la differenza tra Test Rule e Run Now?</strong></summary>

Test Rule è una prova a vuoto: valuta la tua regola rispetto agli ultimi 30 giorni di dati e mostra cosa avrebbe corrisposto, senza cambiare nulla. Run Now esegue una regola salvata una volta, per davvero, su richiesta.

</details>

<details>

<summary><strong>Cosa fa la finestra di lookback?</strong></summary>

Imposta quanti giorni passati misura ogni condizione - 7, 14 o 30. È per condizione, così una regola può richiedere l'ACoS su 14 giorni e i Clicks su 30 giorni allo stesso tempo.

</details>

<details>

<summary><strong>Dove rivedo cosa una regola ha effettivamente fatto?</strong></summary>

Cambia il pannello di destra sulla scheda **Last 30 runs** per vedere le esecuzioni recenti (ora di avvio, entità corrispondenti, entità modificate e stato) una volta salvata la regola. Per la cronologia completa, apri la regola sulla pagina Bid Rules e controlla il suo log di esecuzione.

</details>

***

## ➡️ Cosa fare dopo?

{% content-ref url="/pages/fuFZD0oEa8chDDkvLVjn" %}
[PPC Regole di Offerta](/it-sellermagnet-guida/gestione-ppc-beta/ppc-manager-overview/ppc-bid-rules.md)
{% endcontent-ref %}

{% content-ref url="/pages/HdMVosXJdgpbNaqlpahk" %}
[PPC Centro Approvazioni](/it-sellermagnet-guida/gestione-ppc-beta/ppc-manager-overview/ppc-approval-center.md)
{% endcontent-ref %}