> 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/ppc-management-beta/ppc-manager-overview/ppc-settings.md).

# PPC Settings

Connect your Amazon Ads account, configure marketplaces, set optimization targets, automation, budget and notification preferences, and check your data sync status in the PPC Manager.

{% hint style="info" %}
**Difficulty:** 🟡 Intermediate · **Reading time:** \~20 min
{% endhint %}

{% hint style="success" icon="rocket" %}
**Open this page in your dashboard:** [**Go to PPC Settings \[BETA\] →**](https://dashboard.sellermagnet.com/ppc/settings)
{% endhint %}

{% hint style="warning" icon="triangle-exclamation" %}
**BETA:** The PPC Manager is currently in beta. Some features may behave unexpectedly or change based on user feedback. Please report any issues at <info@sellermagnet.com>.
{% endhint %}

## 📋 Overview

The **PPC Settings** page is where you manage your Amazon Advertising connection, set your target ACoS (Advertising Cost of Sale) and bid boundaries, choose how much the system may do on its own, configure budget rules and notifications, and check the status of your data sync. This is the **first place to visit** when setting up the PPC Manager, every other feature (AI Optimizer, Analytics, Keyword Research) depends on the configuration you establish here.

> **New to SellerMagnet PPC?** Complete the Getting Started Checklist at the bottom of this page before moving on to the AI Optimizer. A properly configured Settings page is the foundation for every automated action the system takes on your behalf.

***

## 🎥 Video Walkthrough

{% hint style="warning" %}
**Video tutorial coming soon.** A full guided walkthrough of this feature will be available here shortly.
{% endhint %}

***

## 🗂️ Page Layout

The Settings page uses a **sidebar navigation** with **nine panels**. They are grouped under three small section labels - **Setup**, **AI Engine**, and **Notifications & Health** - but each entry is a single panel you click to open:

| Panel                 | What it covers                                                                                        |
| --------------------- | ----------------------------------------------------------------------------------------------------- |
| **Connection**        | Connect, re-authorize or disconnect your Amazon Advertising account via OAuth                         |
| **Profiles**          | View and set the default advertising profile (marketplace + account)                                  |
| **Optimization**      | Target ACoS, optimization goal presets, bid strategy, bid floor and cap, and lookback window          |
| **Automation**        | Automation mode, safety envelope, kill-switch, protected items, schedule, and the automation toggles  |
| **Budget Rules**      | Monthly budget cap, daily spend limit, pacing, and spend safety rules                                 |
| **Notifications**     | Performance alerts, Slack / Teams / email / in-app delivery, digest frequency, and Enterprise add-ons |
| **Data Sync**         | A read-only status view of your synced data (see [Data Sync Status](#data-sync-status))               |
| **Scheduled Reports** | Automated email reports (weekly KPIs, monthly executive, top movers, custom CSV)                      |
| **Summary**           | A health overview - credential status, data-sync freshness, report delivery, and a settings audit log |

Each nav item carries a small status dot and chip so you can see at a glance whether a panel is configured.

You can link straight to a panel with `/ppc/settings?tab=<name>`. The names are `connection`, `profiles`, `optimization`, `automation`, `budget`, `alerts`, `sync`, `scheduled-reports`, and `summary`.

### Page header

The header above the panels gives you the controls that apply to the whole page:

| Element                                               | What it does                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Save All**                                          | Saves every change you have made across all panels. Shortcut: Ctrl/Cmd + S                                                                                                                                                                                                                                                                   |
| **Unsaved changes** badge                             | Appears while you have edits that are not saved yet                                                                                                                                                                                                                                                                                          |
| **Last saved** text                                   | Shows when the settings were last saved                                                                                                                                                                                                                                                                                                      |
| **N/8 configured** pill                               | Counts how many settings sections you have configured beyond their defaults. It always shows "/8", even though there are nine panels                                                                                                                                                                                                         |
| Account chips                                         | The active marketplace, the currency (read-only, used for bid and budget amounts), and an "Account-wide" chip - settings apply to every active campaign on the connected profile                                                                                                                                                             |
| "You haven't customised your PPC settings yet" banner | A one-time nudge that you can dismiss                                                                                                                                                                                                                                                                                                        |
| **Settings Doctor**                                   | A check that runs in your browser over the loaded settings and flags combinations that look inconsistent. Click a finding to jump to the control. It collapses to just its heading when every finding is informational, and only stays open automatically when a finding is an error; it stays hidden entirely when there is nothing to flag |

Each panel also has its own **Save Settings** button.

***

## Connecting Your Amazon Ads Account

### Step-by-Step

{% stepper %}
{% step %}

### PPC Settings > Connection

Open the **Connection** panel in the PPC Settings sidebar.
{% endstep %}

{% step %}

### Select your advertising region

Under **Select your advertising region**, choose **Europe** (UK, DE, FR, IT, ES, NL, SE, PL, BE), **North America** (US, CA, MX) or **Far East** (JP, AU, SG). Europe is selected by default. Pick the region of your Amazon Advertising account, because it decides which Amazon sign-in page you are sent to.
{% endstep %}

{% step %}

### Accept the Terms of Service

Tick **I accept the Terms of Service for Amazon Advertising data processing by SellerMagnet.** This checkbox is required.
{% endstep %}

{% step %}

### Connect Amazon Advertising

Click **Connect Amazon Advertising**. You will be redirected to Amazon's OAuth authorization page.
{% endstep %}

{% step %}

### Log in and grant access

Log in with the Amazon account that owns (or has been granted access to) your advertising campaigns, and grant SellerMagnet access to your advertising data.
{% endstep %}

{% step %}

### Return to SellerMagnet

After authorization, you are redirected back to SellerMagnet. The panel shows **Connected - Syncing Your Data** while your profiles and campaigns are imported. This usually takes a few minutes - you will receive an email once everything is ready, and you can safely leave the page.
{% endstep %}
{% endstepper %}

Above the steps, the panel shows a three-step overview: **Select Region**, **Authorize Access**, **Data Sync**. A note under the connect button explains what to expect: by default nothing changes on Amazon until you approve it in the Approval Center. Automations you turn on yourself - bid rules, the overspend breaker - act on the rules you set, and the kill switch stops everything instantly.

**Connection status** is shown as a pill at the top of the panel, and the panel header also shows **Region**, **Status** and **Seller ID** chips:

| Status                  | Colour               | Meaning                                                                                                                                           |
| ----------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connected**           | Green                | Account linked and working                                                                                                                        |
| **Connected - Syncing** | Blue                 | Initial sync in progress - the UI says this usually takes a few minutes, and you get an email when it is done                                     |
| **Not Connected**       | Red                  | No account connected: choose a region and click Connect Amazon Advertising to begin                                                               |
| **Error fetching**      | Blue (pending style) | SellerMagnet could not read the connection status just now. This is about the status check, not your connection - reload the page and check again |

Once connected, the panel shows your **Seller ID** (as a link), a **Switch or re-authorize region** selector, and a **Re-authorize** button.

{% hint style="warning" %}
**Re-authorize keeps your data. Remove Connection & Delete Data does not.** Re-authorizing (for example to renew an expiring authorization or to switch region) keeps your data and settings. Only **Remove Connection & Delete Data** destroys anything - see [Disconnecting](#disconnecting).
{% endhint %}

{% hint style="danger" %}
**Common Mistake:** Do not connect with a sub-user Amazon account that has restricted advertising permissions. The connection will succeed, but the sync will fail for campaigns the sub-user cannot access. Always connect with the account that has **full advertising console access**.
{% endhint %}

***

## Profiles & Marketplaces

After connecting, all your Amazon Advertising profiles are listed. Each profile card shows:

* **Country flag**
* **Account name** as registered in Amazon Ads
* A line with the **country code, marketplace and account type**
* A **Default** badge on the profile currently set as default
* A **radio button** to choose which profile is your default

The default profile is the one used for API calls and data sync. You can also filter by profile on individual PPC pages. The panel header shows the total number of profiles, the current default, and the marketplace.

### Scenario: Managing 3 EU Marketplaces

> You sell on Amazon DE, FR, and IT. After connecting, you see three separate profile cards. You set DE as your default (it is your largest market). On individual PPC pages you can filter by profile to look at FR or IT.

> **Quick Win:** Set your highest-revenue marketplace as the default profile, so the profile your PPC data sync and API calls use is the one that matters most to you.

***

## ⚙️ Optimization Settings

![SellerMagnet PPC Settings](https://4139654583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fih2knSvVpBcq5rIeXVjM%2Fuploads%2Fgit-blob-f9093d0e592637fd82883a40114b5ac793ee9eb5%2Fppc-settings.png?alt=media)

![SellerMagnet PPC Settings - Notifications & Alerts panel with thresholds](https://4139654583-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fih2knSvVpBcq5rIeXVjM%2Fuploads%2Fgit-blob-2201cc3190de206b53bed86fe55c9c2093a3e5c1%2Fppc-settings-2.png?alt=media)

These settings define the **global boundaries** the AI Optimizer and all automation rules use when generating recommendations. They apply to every active campaign on your account. The panel is organised as **Baseline**, **Goal**, **Bidding**, and **Caps & Floors**.

### Baseline

**Current Performance Snapshot** shows your account-wide rolling 30-day metrics - **Avg ACoS**, **ROAS**, **Avg CPC** and **CTR** - as your starting point before you change anything below.

### Goal

**Optimization goal presets** fill in editable targets, bid strategy, automation mode, harvest and negative thresholds, and dayparting in one click. Choosing a preset shows a banner with an **Undo** button, and nothing is saved until you click Save. A preset can change your Automation settings too, so review both the Optimization and Automation panels before saving.

| Preset                              | Success metric shown on the card                                                                                                         |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Max profit** (tagged **Default**) | Net profit >= 40% of ad spend                                                                                                            |
| **Max ad-attributed sales**         | Ad sales WoW growth >= 15%                                                                                                               |
| **Max share of voice**              | Top-of-search impression share measured by Amazon over the last 30 days, or "No automatic tracking yet" when no measurement is available |
| **New product launch**              | 100+ impressions/day, 5+ converters/14d. The card has an **Open Honeymoon wizard** link for the full launch setup                        |
| **Brand defense**                   | Brand-share >= 3% of total ad sales                                                                                                      |
| **Wind-down / minimise spend**      | Daily spend -50% in 14d                                                                                                                  |

Under the presets:

| Setting             | What it does                                                                                                                                                                                                                    | Default | Range |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ----- |
| **Required margin** | How much of your product margin the engine must protect before it pushes for more sales. Applies with whichever preset is selected. A profit-coverage line underneath shows how many of your advertised products have COGS data | 20%     | 0-95  |

### Bidding

**Performance Targets**

| Setting                 | What it does                                                                                                                         | Default | Notes                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------- | ----------------------------------------------------- |
| **Target ACoS**         | Global target used across analytics, AI suggestions, and automation rules                                                            | 25%     | 1-100. Recommended range: 15-40% depending on margins |
| **Target ROAS**         | Read-only. Calculated automatically as 1 / ACoS                                                                                      | 4.0x    | Follows Target ACoS                                   |
| **Amazon referral fee** | Your category referral fee, used by the net-profit forecast                                                                          | 15%     | 0-50                                                  |
| **COGS fallback**       | Cost of goods as a % of sale price, used when per-ASIN COGS are not configured. Sales-weighted ASIN data overrides it when available | 35%     | 0-100                                                 |

Next to Target ACoS, **Check against my numbers** tests your target against your last 60 days (conversion rate, order value and what a click costs you). If your target is far looser than your actual ACoS, a "loose target" hint appears next to the field.

**Smart Target Adjustment Ramp (advanced)** eases a new Target ACoS in over a number of days rather than applying it abruptly. Enter a **New target ACoS** (placeholder 20%) and **Over how many days** (placeholder 14), then click **Start ramp**. While a ramp runs, a progress bar shows with a **Clear** button to cancel it. The ramp is account-wide, not per-portfolio.

#### How to Choose Your Target ACoS

Your target ACoS should reflect your **profit margins after all costs** (product cost, FBA fees, shipping, returns). Use this formula as a starting point:

> **Target ACoS = (Selling Price - Total Costs) / Selling Price x 100**

For example, if you sell a product for 30.00 and your total costs are 18.00:

> Target ACoS = (30 - 18) / 30 x 100 = **40%**

This is your **break-even ACoS**. Set your target below this to leave yourself a margin. How far below is a business decision: the lower the target, the more margin you keep per sale and the less volume you are likely to win.

> **Pro Tip:** If you are in a **product launch phase**, consider temporarily setting a higher Target ACoS (e.g., 50-60%) to prioritize visibility and keyword ranking. Lower it once you have established organic sales velocity. The ramp above is one way to bring the target back down gradually.

#### Per-Portfolio Target ACoS Overrides

A **portfolio** is Amazon's own way of grouping related campaigns together (for example, all campaigns for one brand or product line) so you can manage and budget them as a set. Each portfolio lives inside one marketplace profile.

The Target ACoS above is your **global default**. In the **Per-Portfolio Target ACoS** table you can set a different target for an individual Amazon advertising portfolio. Where an override exists, the AI uses it for that portfolio; everywhere else, it falls back to your global default. If you have no portfolios yet, the table shows "No portfolios found. Sync portfolios first or create one in Amazon Ads."

Each override row stores:

* the **portfolio** it applies to
* the **Target ACoS** value for that portfolio

{% hint style="success" %}
**Why per-portfolio targets matter:** A single flat target over-pauses on your high-margin marketplaces and over-spends on your low-margin ones. If you sell the same catalog across, say, DE, IT, and UK, give each its own Target ACoS that reflects that market's margins and maturity instead of forcing one number on all of them.
{% endhint %}

{% hint style="info" icon="circle-info" %}
**What stays global:** Per-portfolio overrides currently apply to **Target ACoS** only. Your **Minimum Bid Floor**, **Maximum Bid Cap**, **Bid Adjustment Limit**, and other automation settings are **global defaults** that apply across the whole account, they are not set per portfolio or per marketplace.
{% endhint %}

**Bid Strategy** controls how aggressively bids are adjusted. Choose one of six cards:

| Strategy                                       | What it does                                                                                                                                                                      |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Balanced** (tagged **Recommended**, default) | Balances sales volume and profitability with moderate bid adjustments                                                                                                             |
| **Aggressive (Growth)**                        | Prioritizes visibility and sales growth with higher bids. For launches and market share expansion                                                                                 |
| **Conservative (Profit)**                      | Prioritizes profitability over volume with lower bids. For mature, high-margin products                                                                                           |
| **Profit Maximizer**                           | AI-driven: adjusts bids per keyword based on conversion probability, reducing bids on underperformers and investing in winners                                                    |
| **Target ACoS**                                | Adjusts bids toward your target ACoS using observed performance. Actual ACoS varies with traffic, conversion rates and reporting delays, so the target is not a guaranteed result |
| **Max Conversions**                            | Pushes for as many orders as your budget allows, even at higher ACoS. For launches, rank pushes and clearance windows                                                             |

### Caps & Floors

**Bid Caps & Safety Limits** guide base-bid limits and adjustment size. Amazon bidding strategies and placement adjustments can increase the effective auction bid, so these limits do not cap every effective bid.

| Setting                              | What it does                                                                           | Default | Notes                                                   |
| ------------------------------------ | -------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------- |
| **Maximum Bid Cap**                  | No bid will exceed this amount, regardless of strategy                                 | 5.00    | Recommended: 2.00-10.00. Shown in your account currency |
| **Minimum Bid Floor**                | No bid will go below this minimum                                                      | 0.15    | The field itself accepts values from 0.02               |
| **Bid Adjustment Limit**             | The maximum % a bid can change in a single optimization cycle (per cycle, not per day) | 25%     | 5-100, in steps of 5                                    |
| **Optimization Lookback Window**     | How many days of performance data each bid decision uses                               | 14 Days | Choose 7, 14, 30 or 60 Days                             |
| **Min. Clicks Before Optimization**  | A keyword needs at least this many clicks before a bid change is suggested             | 10      | 1-100                                                   |
| **Top-of-Search Placement Modifier** | Additional bid increase for top-of-search placements                                   | 0%      | 0-900                                                   |

**Auto campaign bids by match group** sets what share of the default bid new Auto Discovery campaigns use for each match group (10-200% each):

| Match group     | Default |
| --------------- | ------- |
| **Close match** | 100%    |
| **Substitutes** | 80%     |
| **Loose match** | 60%     |
| **Complements** | 40%     |

{% hint style="warning" %}
**Important:** The Minimum Bid Floor and Maximum Bid Cap apply to **all** AI-generated bid suggestions. If your Maximum Bid Cap is set too low for competitive categories, the AI may be unable to bid effectively on high-value keywords. Check your category's average CPC before setting this limit.
{% endhint %}

Changes in this panel apply on the next optimization cycle.

#### Lookback Window: Which to Choose?

| Lookback Window       | Best For                                                                 | Trade-off                                                                 |
| --------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
| **7 Days**            | Fast-moving categories, daily deal products, recently launched campaigns | Reacts quickly but on thinner data, which means more, noisier suggestions |
| **14 Days** (default) | Most sellers: good balance of recency and statistical significance       | Recommended starting point                                                |
| **30 Days**           | Stable, evergreen products with consistent demand                        | Steadier decisions that react more slowly to sudden changes               |
| **60 Days**           | Seasonal analysis, long-term trend identification                        | Use sparingly, data may be stale for bid decisions                        |

***

## ⚙️ Automation Settings

These settings control **how and when** automated changes are executed. The panel is organised as a status strip and autonomy ladder at the top, then **Policy**, **Bids & Placement**, **Keywords & Search Terms**, and **Account Structure**. All actions respect the bid caps configured in Optimization and are logged in the Activity Log.

### Status and Autonomy Ladder

**"Right now the engine will:"** A status strip at the top tells you in plain words what the engine will do right now, and **because:** which of your settings lead to that. If auto-apply is not yet active, an **Enable auto-apply** button is offered. If you have not accepted the PPC Terms of Service, an inline checkbox appears: "I accept the PPC Terms of Service - the worker may change bids in my Amazon Ads account within the caps I configure." with an **Accept and enable** button.

**Autonomy ladder** shows, for each type of action, whether SellerMagnet has enough evidence to let it auto-apply. Under it, **Autonomy ladder bar** lets you override how much evidence is required. Leave the fields blank to use the SellerMagnet default (30 scored decisions, 60% win rate):

| Setting                 | Placeholder | Range  | Notes                                                                  |
| ----------------------- | ----------- | ------ | ---------------------------------------------------------------------- |
| **Minimum sample size** | 30          | 10-500 | Number of scored decisions needed                                      |
| **Minimum win rate**    | 60%         | 50-95  | Cannot be set below 50%, because that would authorize a coin-flip lane |

### Policy

#### Automation Mode

Choose one of three cards:

| Factor                     | Suggestions Only (tag **Read-only**)                                                                                                           | Manual Approval (tag **Recommended**)                                                                                                                                                                     | Fully Automatic (tag **Advanced**)                                                                                                                                                          |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Default?**               | Yes                                                                                                                                            | No                                                                                                                                                                                                        | No                                                                                                                                                                                          |
| **How it works**           | The AI queues its recommendations in the Approval Center, where you review and apply them manually. Nothing is ever changed without your click | Every suggestion lands in the Approval Center. With the **Auto-apply conservative bid changes** switch ON, bid changes scored at 55% confidence or higher are applied automatically, within your bid caps | The worker applies bid and budget changes on its own as soon as they score high confidence, within your bid caps and the per-run limits. Every change is audit-logged and undoable for 24 h |
| **Still needs your click** | Everything                                                                                                                                     | Everything except bid changes at 55% confidence or higher - and those only once auto-apply is ON and the PPC Terms are accepted                                                                           | Pauses, negatives, campaign state changes, and budget raises above the per-run cap are queued for your review, never applied automatically                                                  |
| **Requirements**           | None                                                                                                                                           | PPC Terms of Service accepted for auto-apply                                                                                                                                                              | Accepted PPC Terms of Service                                                                                                                                                               |

In every mode, pauses, negative keywords and campaign state changes are queued for review and never applied automatically.

> **Best Practice:** Start with the default, **Suggestions Only**, and review the suggestions in the Approval Center for the first 1-2 weeks. Once the suggestions match your own judgment, move to **Manual Approval**, and only then consider **Fully Automatic**. Keep the **Bid Adjustment Limit** (in the Optimization panel) at a level you are comfortable with as a safety net.

{% hint style="danger" %}
**Common Mistake:** Switching to Fully Automatic on day one without reviewing any suggestions first. If your Target ACoS or bid boundaries are misconfigured, the AI will optimize toward the wrong goals. Always validate your settings with Suggestions Only or Manual Approval first.
{% endhint %}

#### Safety envelope

The **Safety envelope** appears only under **Manual Approval** and **Fully Automatic**. It is the most the worker may do in a single cycle before it stops and queues the rest for your approval. Leave a field empty to use the default.

| Setting                     | Placeholder | Range  | Notes                                                                                                                  |
| --------------------------- | ----------- | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| **Actions per run**         | 25          | 1-100  | Everything beyond the limit waits in the Approval Center - nothing is dropped                                          |
| **Budget increase per run** | 100         | 0-1000 | Calibrated in US dollars and scaled to your account currency. 0 means the worker never raises a budget                 |
| **Minimum confidence**      | 30%         | 30-95  | Raise it to make the worker pickier. Anything scored below the floor is queued for you instead. It cannot go below 30% |

A line under the envelope shows what it held back on the last cycle.

#### Auto-apply conservative bid changes

Visible only under **Manual Approval**, and **OFF by default**. ON: bid changes scored at 55% confidence or higher apply automatically within your bid caps. Pauses, negatives, budget changes and everything else still wait for your approval. It needs the accepted PPC Terms of Service - without them the worker stays in suggest-only even with this ON.

#### Let the autopilot apply bid cuts, even with little data

Visible only under **Fully Automatic**, and **OFF by default**. A bid cut normally waits in the Approval Center when the keyword or target does not yet have enough clicks and orders to be sure of it. ON: in Fully Automatic mode, such a thin-data cut is applied automatically instead, within your Min/Max bid caps and the per-cycle limits. Bid raises, pauses and negative keywords still wait for your approval either way. OFF: those cuts wait for you in the Approval Center, which explains in plain words why it is holding them (see [PPC Approval Center](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview/ppc-approval-center.md)). **Run autopilot now** (the on-demand run on the AI Optimizer page) honors this switch exactly like the scheduled automation cycle.

#### Emergency stop (kill-switch)

A checkbox. When ON, Autopilot performs **zero** live changes to your Amazon campaigns - recommendations still queue to the Approval Center. It instantly pauses all automation, scheduled and on-demand, and **takes effect immediately - no need to save the page**.

#### Protected from automation

Items that automation must leave alone: no suggestions, no automatic changes, no rule changes, and approvals are refused. To add one, choose a campaign or enter an ASIN, pick a scope, optionally add a reason, and click **Protect**. You can also protect a row from the Approval Center.

Scopes: **All automation**, **Bid changes**, **Budget changes**, **Pausing or enabling**, **Negative keywords**, **Keyword harvesting**, **Pausing keywords**, **Placement adjustments**, **Placement rebalancing**.

#### Schedule

| Setting                                                                                             | Options                                    | Default                           |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------ | --------------------------------- |
| **Optimization Frequency** - how often the worker runs a cycle                                      | Daily, Every 3 Days, Weekly, Every 2 Weeks | Every 3 Days (tagged Recommended) |
| **Quiet Period After Changes** - wait period after a bid change before that keyword is re-evaluated | 24, 48, 72 hours                           | 48 hours                          |

**Per-Action Apply Cooldown (advanced)** stops the engine from re-applying the same type of action to the same item within a window, even if the recommendation fires again. Leave a field empty to use the safe defaults (all placeholders show 168 hours):

| Field                           | Notes                                                                                                                                                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Budget changes (hrs)**        | Placeholder 168                                                                                                                                                                                                           |
| **Bid changes (hrs)**           | Placeholder 168, minimum 72                                                                                                                                                                                               |
| **Campaign pause/resume (hrs)** | Placeholder 168                                                                                                                                                                                                           |
| **Placement modifier (hrs)**    | Placeholder 168                                                                                                                                                                                                           |
| **After an undo (days)**        | Placeholder 14, range 1-90. After you undo a change in the Activity Log, the engine does not suggest or apply the same change to that item, in the same direction, for this many days. The opposite change stays possible |

### Bids & Placement

| Setting                        | What it does                                                                                                                      | Default |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- | ------- |
| **Automatic Bid Optimization** | Continuously adjusts keyword bids towards your target ACoS using historical performance data                                      | ON      |
| **Placement Optimization**     | Automatically adjusts placement modifiers (Top-of-Search, Product Pages) based on where your ads convert best                     | OFF     |
| **Dayparting**                 | Increases bids during peak conversion hours and decreases them during low-performance periods, using your hourly performance data | OFF     |

### Keywords & Search Terms

| Setting                                              | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Default           |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
| **Negatives: flag for auto-apply (Fully Automatic)** | Losing search terms are suggested as negatives in every mode, whatever this switch says. ON lets Fully Automatic mode flag them for auto-apply, but negatives count as destructive, so every one is still queued for your review                                                                                                                                                                                                                                                                                                                                                                                                                                | OFF               |
| **Min. Clicks (no orders) to Negate**                | Clicks without a single order before a negative is suggested                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 20 (range 5-100)  |
| **Negative Match Type**                              | **Negative Exact** or **Negative Phrase**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Negative Exact    |
| **Apply harvests without asking (Fully Automatic)**  | Converting search terms are suggested as exact keywords in every mode. ON: in Fully Automatic mode, with **Search Term Isolation** also on, the autopilot adds them on its own once its confidence is at least 70%, including into the manual campaign of the same product created for this purpose (see Search Term Isolation below) - at most 5 per run and 5 per day, only while the extra spend they can bring stays within your safety limits, and only when every word of the search term is found in the product's own titles or your brand. Any other search term waits in the Approval Center. OFF: they wait for your approval in the Approval Center | OFF               |
| **Min. Orders to Harvest**                           | Only search terms with at least this many orders are suggested for harvest                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 3 (range 1-50)    |
| **Max ACoS for Harvest**                             | Only search terms that converted at or below this ACoS are suggested for harvest                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 30% (range 1-100) |
| **Search Term Isolation**                            | Converting search terms of an automatic campaign are suggested as exact keywords in a manual campaign of the same product. When the product has no manual campaign yet, the Approval Center proposes creating one as a **Create manual campaign** suggestion (see [PPC Approval Center](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview/ppc-approval-center.md)): nothing is created until you approve it                                                                                                                                                                                                                                | OFF               |

### Account Structure

| Setting                             | What it does                                                                                                                                                                                                                                                                               | Default                                    |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ |
| **Budget Rules**                    | Automatically manages campaign budgets based on performance rules. Opens **Budget Rule Mode**: **Performance** (adjusts budgets based on ACoS and ROAS targets), **Schedule** (disabled - "Coming soon"), **Hybrid** (runs the performance rules today; time-based boosts are coming soon) | OFF. Budget Rule Mode default: Performance |
| **Campaign Structure Optimization** | Analyzes your campaign structure: detects overlapping targeting and duplicate keywords, and suggests restructuring                                                                                                                                                                         | OFF                                        |

### Promotions and Busy Shopping Events

SellerMagnet has no blackout calendar. If you want manual control during Prime Day, Black Friday / Cyber Monday, a Lightning Deal, a coupon, or a low-stock period, use these tools instead:

* **Protected from automation:** add the campaigns or ASINs involved, so automation leaves them alone. This keeps the rest of your account optimizing.
* **Emergency stop (kill-switch):** stops all automation instantly across the account, and takes effect immediately. Turn it off again when the event is over.
* **Suggestions Only mode:** the AI keeps analyzing and queues recommendations, but nothing is applied without your click.

***

## 🛡️ Safety Guardrails

Your **Minimum Bid Floor** and **Maximum Bid Cap** are not just hints for the AI, they are enforced as **clamps at the write boundary**, the last checkpoint before a bid change is sent to Amazon. This applies regardless of where the change came from:

* An **AI Optimizer** suggestion
* A **Bid Rule** execution
* A **manual** change you apply yourself

Every bid and budget change passes through this final clamp on its way out. If a value lands outside the limits, it is **clamped back inside them before it reaches Amazon**, not rejected silently and not sent through unbounded.

| Guardrail                | What it enforces                                                                                                                                            |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Minimum Bid Floor**    | No bid is written below your floor                                                                                                                          |
| **Maximum Bid Cap**      | No bid is written above your cap                                                                                                                            |
| **Bid Adjustment Limit** | A single bid cannot move by more than your configured percentage in one step                                                                                |
| **Budget-change limit**  | There is no budget-change setting in the UI. A daily-budget change is limited to a percentage derived from your Bid Adjustment Limit (1.5 times that value) |

On top of your own limits, SellerMagnet also enforces **platform-level hard bounds** (an absolute maximum bid - the equivalent of 50.00 USD - and maximum daily budget, and Amazon's own minimum bid and budget) so a typo or a malfunctioning rule cannot push an extreme value through, even if your own limits were left wide open. Your floor and cap always win over the percentage step limit, so a change can pace toward your cap but never past it.

{% hint style="success" %}
**Why this matters:** The guardrails are your protection against **extreme bids.** Even if you enable automatic applying and walk away, a bid change cannot be written at 50.00 when your Maximum Bid Cap is 5.00. Set these bounds deliberately and you can automate with more confidence.
{% endhint %}

{% hint style="info" icon="circle-info" %}
**What the guardrails do not do:** Bid limits and evidence thresholds constrain the optimization actions SellerMagnet applies. They do not guarantee performance, and they do not cap every effective auction bid, because Amazon bidding strategies and placement adjustments can increase the effective bid.
{% endhint %}

{% hint style="info" icon="circle-info" %}
**Set your bounds before turning on auto-apply.** The guardrails only protect you to the limits you configure. Confirm your Minimum Bid Floor, Maximum Bid Cap, and Bid Adjustment Limit reflect your category and risk tolerance, then enable automation.
{% endhint %}

***

## Sandbox / Preview Mode

**Sandbox / Preview Mode** is a safe practice mode. When it is **ON**, autopilot and approval actions write a synthetic "would have done this" entry in your [Activity Log](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview/ppc-activity-log.md) **instead of calling Amazon**, so nothing on your live account changes. It lets you see exactly what the system *would* do before trusting it with real changes.

You will find the toggle in the **Notifications** panel, under **Enterprise Add-Ons**. It is **OFF by default**. While it is on, a compact status-line chip - "Sandbox - changes are not sent to Amazon" with a **Go live in Settings** link - shows on PPC pages so you always know changes are simulated.

When you switch Sandbox **off**, a **Go live?** confirmation opens: "Turn off sandbox mode? Changes will then be sent to Amazon and spend real money." Click **Turn sandbox off** to confirm. As with the other settings, the change is saved when you click Save.

{% hint style="success" %}
**Turn it on while you are learning.** Leave Sandbox ON so you can review recommendations risk-free. When you are confident the AI's suggestions look right, turn Sandbox **OFF** to let approvals and autopilot make real changes on Amazon.
{% endhint %}

***

## Budget Rules

The **Budget Rules** panel (labelled "Budget Rules & Spend Management" in the app) lets you cap and pace advertising spend. The whole panel is governed by a **master on/off toggle** - while it is OFF, no caps or spend rules apply and the AI optimizes freely within Amazon's own campaign budgets. Every cap field is opt-in: leave it empty and there is no cap.

{% hint style="info" icon="circle-info" %}
**Checks are not exact limits.** The panel's help notes that budget checks use available reports during runs, so they cannot guarantee that spend stops exactly at a limit.
{% endhint %}

### Budget Caps

* **Monthly Budget Cap:** an optional ceiling on total monthly ad spend across all campaigns. Empty by default (no monthly cap). Below it, a **Spent this month** bar shows the amount spent, the % used and the amount remaining.

### Daily Limit & Pacing

* **Daily Spend Limit:** an optional per-day cap; campaigns are paused when daily spend approaches it. Empty by default (no daily cap).
* **Spend Pacing:** how quickly the daily budget is delivered through the day - **Even** (spread evenly across the day, the default), **Accelerated** (spend as fast as possible until the budget runs out), or **Front-loaded** (spend more in the first half of the day).

### Spend Safety Rules

Two rules sit under **Spend Safety Rules**:

| Rule                          | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Default                           |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------- |
| **Pause on Budget Overspend** | Automatically pauses any campaign that reaches a percentage of its **daily** budget, set with the **Pause threshold** field beside the toggle (100-200%, in steps of 10, default 100%). At 100% it pauses as soon as the daily budget is reached; raising it (e.g. to 120%) lets a campaign run a bit past budget before it pauses, instead of being paused and re-enabled by hand on a normal day's overage. This is a per-campaign rule based on each campaign's **daily** budget, not a monthly rule. Campaigns that are performing well are spared: a campaign whose recent ACoS is at or under twice your target (60% at the lowest) is not paused. The brake also does nothing in sandbox mode or while the emergency stop is on, and it skips anything on your protected list | ON, 100%                          |
| **ACoS Circuit Breaker**      | Pauses individual campaigns if ACoS exceeds a critical threshold                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | OFF. Threshold 80% (range 10-500) |

> **Quick Win:** Set a **Daily Spend Limit** with **Even** pacing so budget lasts through the evening shopping window instead of draining by mid-afternoon, and keep **Pause on Budget Overspend** on as a safety rule.

### Scenario: Limiting Runaway Spend

> You manage 15 campaigns across DE and FR. You set a **Monthly Budget Cap** and a **Daily Spend Limit**, choose **Even** pacing, and leave **Pause on Budget Overspend** enabled. You also switch on the **ACoS Circuit Breaker** at 80% for campaigns that start burning budget at a poor ACoS. These rules act on the data available to them during each run, so keep checking your spend: they reduce the risk of a runaway campaign, but they cannot guarantee that spend stops exactly at a limit.

{% hint style="info" icon="circle-info" %}
**Spend and budget alerts vs. rules:** The Budget Rules panel *enforces* caps, pacing and spend safety rules. If you also want to be *notified* about spend events, configure those in the **Notifications** panel (see below).
{% endhint %}

***

## Data Sync Status

The **Data Sync** panel is a **read-only status view**. There is no schedule to set and no "Sync Now" button - the panel itself says "Data synchronization is handled automatically. Your data refreshes every few hours." Synchronization runs automatically in the background and no manual action is needed.

At the top, three chips summarize the sync:

| Chip          | Shows                                                                                               |
| ------------- | --------------------------------------------------------------------------------------------------- |
| **Last sync** | How recently your data was refreshed                                                                |
| **Entities**  | The number of data types tracked. This is a fixed label reading 6, not a measurement                |
| **Cadence**   | The approximate refresh rhythm, a fixed label reading about 6 hours rather than a measured interval |

Below the chips, a table lists the status and last sync time of each data type:

| Entity                                                                                 | Columns                      |
| -------------------------------------------------------------------------------------- | ---------------------------- |
| **Profiles**, **Campaigns**, **Ad Groups**, **Keywords**, **Product Ads**, **Reports** | **Status** and **Last Sync** |

When per-marketplace report sync information is available, a "sync lanes" block also appears under the table.

Two banners can appear on this panel:

* **Amazon Ads authorization expires soon** (or **expired**): Amazon now expires Ads authorizations 365 days after consent. The banner tells you how many days are left. **Reconnect Amazon Advertising on this page to renew it** - your data and settings are kept. Use the **Re-authorize** button in the Connection panel.
* **Your advertising data is being loaded:** shown while your initial data is being imported. It may take a few minutes, and you will receive an email notification once your data is ready.

***

## Notifications

The **Notifications** panel (titled "Notifications & Alerts") controls performance alerts and where they are delivered. A **COGS coverage** chip in the panel header shows how much of your catalog has COGS filled in.

### Performance Alerts

Toggle each alert on or off and tune its threshold. Alerts fire as soon as the condition is met; how often you actually receive them is governed by the digest setting below. All five are ON by default:

| Alert                            | What it watches                                                                           | Threshold (default, range)      |
| -------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------- |
| **ACoS Spike Alert**             | Account ACoS exceeds an absolute % (not a multiple of your Target ACoS)                   | **Above (% abs)**: 40% (5-200)  |
| **Budget Exhaustion Warning**    | Monthly budget usage exceeds a percentage                                                 | **At**: 80% (10-100)            |
| **CTR Drop Alert**               | Click-through rate drops significantly, which can indicate ad fatigue or relevance issues | **Drop**: 30% (10-80)           |
| **Zero Impressions Alert**       | Active campaigns receive zero impressions for 48+ hours                                   | No threshold                    |
| **Competitor Activity Detected** | Average CPC for top keywords rises over the last 7 days                                   | **CPC Rise (7d)**: 50% (10-200) |

### Delivery Channels

Choose which channels receive alerts:

| Channel                                  | Default | Notes                                                                                                                                                                           |
| ---------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Email Notifications**                  | ON      | Sends alert emails to your account address. Best for critical alerts you must not miss. You can turn it off                                                                     |
| **In-App Notifications**                 | ON      | Shows alerts in your SellerMagnet notification center. You can turn it off                                                                                                      |
| **Slack incoming webhook URL**           | Empty   | Paste a Slack incoming webhook URL (per project; leave blank to disable). A **Send test message** button verifies it. Mirrors autopilot, dayparting, and weekly-digest events   |
| **Microsoft Teams incoming webhook URL** | Empty   | Paste a Teams incoming webhook URL (Office 365 / Workflow schema, compatible with classic Connectors and the new Workflow webhooks). A **Send test message** button verifies it |

**Alert Digest Frequency** batches notifications so you stay informed without notification fatigue: **Real-time** (send immediately), **Daily Digest** (one summary per day, the default), or **Weekly Digest** (one summary per week). Choose **Real-time** to receive each alert as it fires.

### Enterprise Add-Ons

A dedicated **Enterprise Features** block adds advanced configuration. A readiness list at the top tracks four items: **Brand Terms**, **TACoS Goal**, **Slack**, and **Inventory Guard**.

| Setting                              | What it does                                                                                                                                                                                                                                                                                                                                    | Default      |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **Brand keywords (comma-separated)** | A tag editor for brand-name terms. Keywords containing any of them are tagged branded vs generic, which powers the "Brand vs Generic spend split" report. Case-insensitive whole-word match. When the list is empty and SellerMagnet can infer likely terms, a card says "We detected your likely brand terms" with **Add all** and **Dismiss** | Empty        |
| **TACoS Goal**                       | Your target TACoS %. Shows as a goal line on the TACoS chart                                                                                                                                                                                                                                                                                    | 0 (no goal)  |
| **Slack webhook URL**                | A second, separate Slack field. When set, batch summaries (autopilot runs, approval batches, bulk-apply results) are also sent to your Slack channel. The URL must start with `https://hooks.slack.com/`                                                                                                                                        | Empty        |
| **Inventory min units**              | When an ASIN drops below this stock level, the engine throttles bid suggestions for that ASIN to avoid paying for clicks on items that may go out of stock                                                                                                                                                                                      | 0 (disabled) |
| **Sandbox / Preview Mode**           | See the Sandbox / Preview Mode section above                                                                                                                                                                                                                                                                                                    | OFF          |

{% hint style="info" icon="circle-info" %}
**Two Slack fields:** **Slack incoming webhook URL** (in Delivery Channels) and **Slack webhook URL** (in Enterprise Add-Ons) are two separate settings with their own values. They are not shared, so fill in the one for the notifications you want to receive.
{% endhint %}

**Cost of Goods (COGS) Coverage** is a read-only block showing **Total ASINs**, **With COGS**, **Missing COGS** and **Coverage** (as a % with a progress bar). COGS is not entered here - use the **Manage COGS in Products tab** link to enter it in Products, where it feeds the PPC profit forecaster automatically.

***

## Scheduled Reports

The **Scheduled Reports** panel (titled "Scheduled Email Reports") emails PPC reports to your team automatically. Click **Create scheduled report** to open the **Schedule a PPC report** modal. It has three sections: **Basics**, **Cadence** and **Delivery**.

**Basics:** a **Report name** (up to 180 characters) and a **Report type**:

| Type                  | Contents                                                              |
| --------------------- | --------------------------------------------------------------------- |
| **Weekly KPIs**       | Spend, sales, ACoS, and TACoS - your headline numbers week over week  |
| **Monthly executive** | A board-ready summary with trends, top movers, and a profit waterfall |
| **Top movers (7d)**   | The biggest wins and worst regressions over the last 7 days           |
| **Custom CSV export** | Raw rows for your own BI tool (Sheets / Excel)                        |

**Cadence:** Daily, Weekly, Monthly, or **Custom cron**.

| Field                     | Notes                                                                          |
| ------------------------- | ------------------------------------------------------------------------------ |
| **Day of week**           | For weekly schedules. Default Friday                                           |
| **Day of month**          | For monthly schedules. 1-28, default 1                                         |
| **Time (24h)**            | Default 09:00                                                                  |
| **Timezone**              | Default UTC                                                                    |
| **Custom cron (5-field)** | Format: min hour dom month dow. Example: "0 9 \* \* 1" = every Monday at 09:00 |

The default cadence is Weekly. A **Next run** chip previews when the report will next be sent.

**Delivery:**

* **Recipients (comma-separated):** one or more email addresses, with a running count.
* **Format:** Email (HTML), Email + CSV attachment, CSV only, or PDF attachment.
* **Profile scope:** a free-text field. Leave it blank to include all profiles (an **All profiles** badge shows), or enter comma-separated profile IDs.

Existing schedules appear in a table with **Name**, **Cadence**, **Recipients**, **Next run**, **Status**, and **Actions**. Each row has four icon buttons: **Send test now**, **Pause / Resume**, **Edit**, and **Delete**.

{% hint style="success" %}
**Set it and forget it:** A **Weekly KPIs** report every Monday morning keeps your team aligned on ACoS, spend, and top movers without anyone logging in to pull numbers.
{% endhint %}

***

## Summary

The **Summary** panel (titled "PPC Summary Report") is a consolidated health overview of your PPC setup. A status banner at the top reports your Amazon Advertising credential state (checking, connected, pending, or disconnected), and three stat tiles summarize readiness:

| Stat           | Shows                      |
| -------------- | -------------------------- |
| **Credential** | OAuth refresh token status |
| **Data Sync**  | Initial sync state         |
| **Reports**    | Last reports refresh       |

Use the Summary panel as your first stop when something looks off - it tells you at a glance whether the problem is your connection, your data sync, or report freshness. Three buttons jump you to related pages: **Open Full Analytics**, **Search Term Report**, and **PPC Dashboard**.

At the bottom, the **Settings audit log** (last 30 days) records every change to your settings and bid rules for governance. Its columns are **When**, **User**, **Setting**, **Old value**, **New value**, and **Source** (how the change was made, for example UI, API or autopilot). Click **Refresh** to reload it.

***

## Disconnecting

To disconnect your Amazon Ads account:

1. Open the **Connection** panel and scroll to the bottom.
2. Read the red warning message carefully.
3. Tick the checkbox **"I understand this action is permanent and cannot be undone."** The button stays disabled until you do.
4. Click **Remove Connection & Delete Data**.
5. Two confirmation dialogs follow. The first is titled **Disconnect Amazon Advertising?** (button **Disconnect**). The second is titled **Last chance - really continue?** (button **Yes, delete everything**). The data is only removed after you confirm both.

{% hint style="danger" %}
**Warning - this permanently deletes your PPC data.** Disconnecting does not just stop syncing: it **permanently deletes all synced PPC data** - campaigns, keywords, performance history, settings, and bid rules - along with any pending AI suggestions in the Approval Center. This action cannot be undone. If you reconnect later, your history starts fresh.
{% endhint %}

{% hint style="warning" %}
**Re-authorize is not the same as disconnect.** If your authorization is expiring or has expired, use **Re-authorize** in the Connection panel - your data and settings are kept. Only **Remove Connection & Delete Data** deletes anything.
{% endhint %}

**Who can disconnect:** only the project owner. Disconnecting needs both the admin role and the project-level admin role, and other team members who try it get a 403 error.

**Shared profiles are kept:** if an Ads profile is also linked to another project with an active credential, that profile's campaign data is kept for the other project, and everything else of this project's is deleted. In that case you see: "Amazon Advertising disconnected and this project's data deleted. Campaign data of {n} Ads profile(s) that is still linked to another connection was kept."

If some of this project's data could not be fully removed, the server reports: "Amazon Advertising disconnected, but some of this project's data could not be fully removed. Contact support if you still see old campaign data here." Note that the page only surfaces that wording when a shared profile was kept; otherwise it shows the plain "All data has been removed." message, so if you still see old campaign data afterwards, contact support even though the toast looked clean.

{% hint style="info" icon="lightbulb" %}
**Tip:** If you need to temporarily stop automation without losing your configuration, turn on the **Emergency stop (kill-switch)** in the Automation panel, or switch **Automation Mode** to **Suggestions Only**, instead of disconnecting entirely.
{% endhint %}

***

## Recommended Configuration Templates

Use these templates as starting points based on your seller profile. Adjust values as you learn what works for your specific products and margins.

### New Seller (< 6 months on Amazon)

| Setting                      | Recommended Value | Rationale                                                                |
| ---------------------------- | ----------------- | ------------------------------------------------------------------------ |
| Target ACoS                  | 35-45%            | Higher target allows the AI to prioritize visibility and data collection |
| Minimum Bid Floor            | 0.15              | The default floor keeps you competitive                                  |
| Maximum Bid Cap              | 3.00              | Conservative cap while you learn your category CPCs                      |
| Optimization Lookback Window | 7 Days            | Shorter window to adapt quickly as you learn the market                  |
| Automation Mode              | Suggestions Only  | Review every suggestion to learn how PPC optimization works              |
| Bid Adjustment Limit         | 15%               | Tighter limit for more gradual changes                                   |

### Experienced Seller (6+ months, established products)

| Setting                      | Recommended Value                                            | Rationale                                                                                                     |
| ---------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| Target ACoS                  | 20-30%                                                       | Tighter target focused on profitability                                                                       |
| Minimum Bid Floor            | 0.15                                                         | Default floor                                                                                                 |
| Maximum Bid Cap              | 5.00-8.00                                                    | Higher cap for competitive keywords you have validated                                                        |
| Optimization Lookback Window | 14 Days                                                      | Balanced recency and statistical reliability                                                                  |
| Automation Mode              | Manual Approval, with Auto-apply conservative bid changes ON | Trust conservative bid changes after the initial validation period, while everything else still waits for you |
| Bid Adjustment Limit         | 20-25%                                                       | Standard range for established campaigns                                                                      |

### Agency Managing Multiple Clients

| Setting                      | Recommended Value                                                                 | Rationale                                                 |
| ---------------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------- |
| Target ACoS                  | Per client (use per-portfolio overrides where clients are in separate portfolios) | Each client has different margins and goals               |
| Minimum Bid Floor            | 0.15                                                                              | Default floor across clients                              |
| Maximum Bid Cap              | Per client                                                                        | Varies by client budget and category                      |
| Optimization Lookback Window | 14 Days                                                                           | Consistent baseline across clients                        |
| Automation Mode              | Suggestions Only or Manual Approval                                               | Agencies should review before changes hit client accounts |
| Bid Adjustment Limit         | 15%                                                                               | Conservative to protect client relationships              |
| Budget Rules                 | Enabled (Monthly Budget Cap + Daily Spend Limit, Pause on Budget Overspend ON)    | Critical for agency accountability                        |

{% hint style="success" icon="rocket" %}
**Agency Pro Tip:** For every client account, set a **Monthly Budget Cap** and **Daily Spend Limit** in Budget Rules and keep **Pause on Budget Overspend** on, then mirror spend notifications into the client's **Slack or Teams** channel. Nothing damages client trust faster than an unexpected budget overrun. Caps and thresholds should be agreed upon with the client as part of onboarding.
{% endhint %}

***

<details>

<summary><strong>⚠️ Common Mistakes to Avoid</strong></summary>

| Mistake                                           | Why It Hurts                                                                       | How to Fix                                                                                                                              |
| ------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Setting Target ACoS without knowing your margins  | AI optimizes toward the wrong goal, you may generate sales at a loss               | Calculate your break-even ACoS first (see formula above), then set target at 60-80% of break-even                                       |
| Maximum Bid Cap set too low for your category     | AI cannot compete for high-value keywords; you lose impressions to competitors     | Research average CPCs in your category via Amazon Ads console and set Maximum Bid Cap at 1.5-2x the average CPC                         |
| Switching to Fully Automatic on day one           | Misconfigured settings + no human review = potentially wasteful changes            | Start with Suggestions Only or Manual Approval for 1-2 weeks minimum                                                                    |
| Leaving automation running during a big promotion | The AI may over-bid during artificially inflated competition, draining your budget | Add the promoted campaigns or ASINs to **Protected from automation**, or switch on the **Emergency stop (kill-switch)** for the event   |
| Disconnecting to "pause" PPC                      | Disconnecting permanently deletes your synced PPC data                             | Use the kill-switch or Suggestions Only to stop automation without losing anything. Use Re-authorize to renew an expiring authorization |
| Connecting with a restricted Amazon sub-account   | Sync succeeds partially but misses campaigns the sub-account cannot access         | Always connect with the primary account that has full advertising permissions                                                           |

</details>

## 🔧 Troubleshooting

### Connection Issues

| Problem                                                         | Likely Cause                                                              | Solution                                                                                                                             |
| --------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| OAuth redirect fails                                            | Browser blocks pop-ups or cookies                                         | Disable pop-up blocker for SellerMagnet domain; clear cookies and retry                                                              |
| "Access Denied" after authorization                             | Amazon account lacks Advertising API permissions                          | Verify the account has Amazon Ads access (not just Seller Central); contact Amazon support if needed                                 |
| Clicking Connect Amazon Advertising only shows an error message | The Terms of Service checkbox is not ticked                               | Tick **I accept the Terms of Service for Amazon Advertising data processing by SellerMagnet.** and click Connect again               |
| Connection status shows "Connected - Syncing" for a long time   | Initial import is still running, which can take longer for large accounts | You can leave the page and you will get an email when it is done. If it is still syncing much later, contact support                 |
| Status shows "Error fetching"                                   | The status check itself failed, not necessarily the connection            | Reload the page. If it persists, open the Summary panel to check the credential state                                                |
| "Amazon Ads authorization expires soon" or "expired" banner     | Amazon expires Ads authorizations 365 days after consent                  | Click **Re-authorize** in the Connection panel. Your data and settings are kept                                                      |
| Connection drops after a few days                               | Amazon OAuth token expired                                                | Re-authenticate by clicking **Re-authorize**; SellerMagnet automatically refreshes tokens, but edge cases can require manual re-auth |

### Sync Problems

Data sync is automatic and has no controls you can change. Use the **Data Sync** panel to see which data type is behind.

| Problem                                               | Likely Cause                                                                 | Solution                                                                                                                                                                           |
| ----------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Last sync time looks old                              | The data refreshes automatically every few hours, so a short delay is normal | Check the Last Sync column in the Data Sync panel again later. If a data type stays behind for a long time, check the Summary panel and the credential state, then contact support |
| "Your advertising data is being loaded" banner        | The initial import is still running                                          | Wait. You will receive an email notification once your data is ready                                                                                                               |
| Missing campaigns in the dashboard                    | Campaigns created after the last sync                                        | They appear after the next automatic sync, which runs every few hours                                                                                                              |
| Data mismatch between SellerMagnet and Amazon console | Amazon Ads reporting delay (up to 12 hours for some metrics)                 | This is normal Amazon behavior, metrics like attributed sales can take up to 72 hours to finalize                                                                                  |

### Budget & Notification Issues

| Problem                                  | Likely Cause                                                                        | Solution                                                                                                                                                                                          |
| ---------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Not receiving email alerts               | Email channel disabled in Notifications, or email in spam                           | Open the Notifications panel, enable Email Notifications; add SellerMagnet to your email whitelist                                                                                                |
| Slack/Teams alerts not arriving          | Webhook URL missing or wrong                                                        | Paste the incoming webhook URL in Notifications and use the **Send test message** button to verify it                                                                                             |
| Pause on Budget Overspend not triggering | Budget Rules master toggle off, or no campaign has reached 100% of its daily budget | Enable the Budget Rules master toggle and confirm Pause on Budget Overspend is on. The rule acts per campaign against its **daily** budget, so a campaign must actually reach 100% of that budget |
| Spend went slightly past a limit         | Budget checks use available reports during runs                                     | This can happen. The checks cannot guarantee spend stops exactly at a limit, so leave some headroom                                                                                               |

***

## ❓ FAQ

<details>

<summary><strong>Can I connect multiple Amazon Ads accounts?</strong></summary>

The Connection panel shows one Amazon Advertising connection per project. If one connection gives you access to several marketplaces and accounts, each appears as a separate card in the Profiles panel.

</details>

<details>

<summary><strong>Does disconnecting delete my historical data?</strong></summary>

Yes. Disconnecting **permanently deletes all synced PPC data** - campaigns, keywords, performance history, settings, and bid rules - and cannot be undone. The one exception is an Ads profile that is also linked to another project with an active credential: its campaign data is kept for that other project. If you only need to stop automation without losing anything, use the **Emergency stop (kill-switch)** or switch **Automation Mode** to **Suggestions Only** instead. If your authorization is expiring, use **Re-authorize**, which keeps your data and settings.

</details>

<details>

<summary><strong>Who can disconnect the Amazon Ads account?</strong></summary>

Only the project owner. Other team members who try it get a 403 error.

</details>

<details>

<summary><strong>How long does the initial sync take?</strong></summary>

The app says it usually takes a few minutes, and you will receive an email once everything is ready. You can safely leave the page while it runs.

</details>

<details>

<summary><strong>Can I trigger a sync or change how often data is refreshed?</strong></summary>

No. Data synchronization is handled automatically and your data refreshes every few hours. The Data Sync panel is read-only - it shows the status and last sync time per data type.

</details>

<details>

<summary><strong>Can I set different Target ACoS values for different marketplaces?</strong></summary>

Yes. The Target ACoS in Settings is a **global default**, but you can set a **per-portfolio Target ACoS override** for an individual portfolio (typically a single marketplace profile). See **Per-Portfolio Target ACoS Overrides** above. The global value is used as a fallback wherever no portfolio-specific target is set. Note that the bid boundaries (Minimum Bid Floor / Maximum Bid Cap) and other automation settings remain global, only Target ACoS can be overridden per portfolio.

</details>

<details>

<summary><strong>What happens if I change settings while the AI has pending suggestions?</strong></summary>

Existing pending suggestions in the Approval Center are **not retroactively updated**. They were generated under the previous settings. New suggestions generated after the change will use the updated configuration. You can dismiss old suggestions and wait for fresh ones.

</details>

<details>

<summary><strong>Is my Amazon Ads API data secure?</strong></summary>

Yes. SellerMagnet uses OAuth 2.0 for authentication (we never see your Amazon password), and all data is encrypted in transit (TLS 1.2+) and at rest (AES-256). Your advertising data is never shared with third parties.

</details>

<details>

<summary><strong>What Amazon Ads API permissions does SellerMagnet require?</strong></summary>

SellerMagnet requests read and write access to Sponsored Products, Sponsored Brands, and Sponsored Display campaigns. The connect panel states that SellerMagnet uses the official Amazon Advertising API with read/write access only to your advertising data, and that you can revoke access at any time.

</details>

***

## Getting Started Checklist

Use this checklist to ensure your PPC Settings are properly configured before moving to the AI Optimizer:

* [ ] **Select your advertising region, accept the Terms of Service, and connect your Amazon Ads account** via OAuth, then verify the connection pill shows "Connected"
* [ ] **Review your marketplace profiles** and set your primary marketplace as the default
* [ ] **Calculate your break-even ACoS** and set your Target ACoS at 60-80% of that value (optionally pick an Optimization goal preset first, then review the values it fills in)
* [ ] **Set the Minimum Bid Floor and Maximum Bid Cap** appropriate for your product category
* [ ] **Choose an Optimization Lookback Window** (start with 14 Days if unsure)
* [ ] **Leave Automation Mode on Suggestions Only** for your first 1-2 weeks, and review the suggestions in the Approval Center
* [ ] **Check the Bid Adjustment Limit** (25% is the default; lower it for more gradual changes)
* [ ] **Add anything automation must leave alone** to Protected from automation before a promotion, and know where the Emergency stop (kill-switch) is
* [ ] **Set your Budget Rules** (Monthly Budget Cap / Daily Spend Limit), keep Pause on Budget Overspend on, and consider the ACoS Circuit Breaker
* [ ] **Set up Notifications:** choose your channels, add Slack/Teams webhooks if you use them (with **Send test message**), and pick a digest frequency
* [ ] **Open the Data Sync panel** and confirm your data types show a Last Sync time once the initial import has finished
* [ ] **Open the Summary panel** and confirm Credential, Data Sync and Reports look healthy

***

## ➡️ What's Next?

{% content-ref url="/pages/iWrHWpvfg4usrjbVNyFz" %}
[PPC Manager: Overview](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview.md)
{% endcontent-ref %}

{% content-ref url="/pages/pQTsyjXdDCQAMg0Eueka" %}
[PPC Analytics](https://docs.sellermagnet.com/ppc-management-beta/ppc-manager-overview/ppc-analytics.md)
{% endcontent-ref %}
