User Manual

Overview

bddr.ai is a Chrome extension that augments Amazon's Advertising Console with real-time bid optimization, health scoring, analytics, and bulk editing. It works directly inside the pages you're already using — no separate dashboard, and by default, no API keys, no data leaving your browser (Pro+ users will be able to opt into API integration once it ships — see Privacy).

How it works

When you visit a campaign, ad group, or targeting page, bddr.ai reads the grid data that Amazon shows you and analyzes it in real time. It overlays color-coded badges, heatmaps, and trend indicators on the grid, and shows a side panel with prioritized recommendations. You decide what to act on — bddr.ai makes changes by writing directly into the bid cells on the page, the same way you would manually, just faster.

What it doesn't do

• It never runs in the background or makes changes while you're away.
• By default it doesn't connect to Amazon's API — it reads what's on screen. (Pro+ API integration is coming soon; opt-in only when it launches.)
• It doesn't send your campaign data, keywords, bids, or spend to our servers. (Pro+ API integration, when it launches, will send bid changes directly to Amazon via proxy; we never receive them.)

Panel layout

The side panel slides in from the right side of the Amazon page. It's a single scrollable view with these sections (from top to bottom):

1. Header — bddr.ai logo, tier badge (click to see plans), History (clock icon), Settings (gear icon), close button.
2. Session Bar — Shows when you've made changes. Displays count of changes and an Undo button.
3. Page Readiness — Column and sort status with a Fix button.
4. ACoS Hero Card — Your actual ACoS vs. target at a glance.
5. Budget Pacing — Daily spend rate vs. budget (campaign pages).
6. Campaign Health — Health distribution across campaigns (campaign pages).
7. Your Priority List — Targets organized by health tier with batch action buttons.
8. Search Term Sections — Harvest candidates and wasteful terms (search terms page).
9. ACoS Trend — Sparkline chart showing ACoS over time from your visits.
10. Recent Changes — Bid changes you've made, scoped to the current context.
11. Account Dashboard — Snapshot data on non-grid pages.
12. Diagnostics Footer — Connection status, last scan time, entity counts.

History, Settings, and Bulk Edit open as overlay sheets that slide in on top of the main panel. Press Escape to close them.

Page readiness

Before bddr.ai can analyze your data effectively, certain columns need to be visible on the grid and the sort order needs to be optimal.

What it checks

• Required columns — Spend, Sales, Orders, Clicks, Impressions. Each feature has specific column requirements (e.g., health scoring needs Clicks + Spend + Sales + Orders).
• Sort order — Spend descending (highest first) ensures the most impactful targets are scanned first.
• Page size — Larger page sizes mean more data per scan.

The Fix button

If any checks fail, a pulsing Fix button appears. Clicking it:

1. Opens Amazon's "Customize columns" dialog
2. Enables any missing columns
3. Applies the changes
4. Sorts by Spend descending

Click Fix and wait a few seconds while it configures your columns and sort.

Health scoring

Every target (keyword, product, category, or auto group) is classified into one of 8 health tiers based on its current performance metrics:

The 8 tiers

How thresholds work

Thresholds are time-normalized — they scale with the Amazon date range you've selected. A target with 25 clicks over 7 days is treated differently than 25 clicks over 90 days. Longer date ranges require proportionally more clicks for confident classification.

Breakeven ACoS is calculated from your fee percentage: breakeven = 100% - fees. If your fees are 30%, your breakeven is 70% ACoS — anything above that loses money.

ACoS heatmap

ACoS and ROAS cells on the grid are color-coded based on how they compare to your target:

• Deep green — Well below target (excellent efficiency)
• Light green — Below target (performing well)
• Light red — Above target (needs attention)
• Deep red — Well above target (significantly over goal)

A small colored circle appears next to each value. Hover over it to see a tooltip with:

• Both ACoS and ROAS together (they're two views of the same metric)
• Your target and breakeven with margin headroom
• Cost per order
• A mini ACoS sparkline showing the trend over time

Trend badges

Small arrow badges appear next to entity names showing whether performance is improving or worsening compared to your previous visit:

• ↘ -3.2% — ACoS improving (green, arrow down-right)
• ↗ +1.8% — ACoS worsening (red, arrow up-right)
• → +0.3% — Flat, within ±2 percentage points (gray)

Trend badges require at least 2 visits to the same page (with different date ranges or spaced more than 1 hour apart). The more you visit, the more trend data accumulates.

Bid optimization

The ACoS-ratio formula

For most tiers, bddr.ai calculates the optimal bid using:

newBid = currentBid × (targetACoS ÷ actualACoS)

This is then dampened to prevent overcorrection. Each tier has a different dampening factor:

• Unprofitable — 50% dampening (aggressive correction)
• High ACoS — 70% dampening (gentle correction)
• Heroes — 30% dampening (conservative boost)

Safety caps

Every bid change is capped at:

• Max increase — 20% per adjustment (configurable)
• Max decrease — 25% per adjustment (configurable)
• Absolute bounds — Amazon's minimum ($0.02) and maximum bid limits

Cooldown & whipsaw prevention

• Cooldown — After changing a bid, bddr.ai waits 7 days (default) before suggesting another change to the same target. This gives Amazon's data time to settle.
• Direction lock — If the last change was an increase, a decrease requires 2× the cooldown (and vice versa). Prevents flip-flopping.

Changeset preview

Before any changes are applied, you see a preview of every proposed change:

• Entity name with checkbox — click to deselect items you don't want to change. Shift-click for range selection.
• Old bid → New bid — crossed-out old value, green new value.
• Reasoning — Why this change is recommended (tier, formula, dampening).
• ACoS trend — If observation data exists, shows whether the entity is improving or worsening.
• Cooldown warning — Amber badge if this target was recently edited.

You can also download as a bulksheet (Excel file) for offline review or uploading to Amazon's bulk operations.

The Apply button shows the count of selected items and is disabled when none are selected.

Quick Optimize

One-click optimization across the 4 highest-confidence tiers:

1. Slash bleeders (50% bid cut)
2. Optimize unprofitable (ACoS-ratio, 50% dampening)
3. Optimize high-ACoS (ACoS-ratio, 70% dampening)
4. Boost heroes (ACoS-ratio, 30% dampening)

Access via the Quick Optimize button in the Priority List, or press Cmd+K and select "Quick Optimize".

Speculative tiers (untapped, dormant, low-relevance) are excluded from Quick Optimize — use their individual batch buttons if you want to act on those.

Search terms

On the search terms page, bddr.ai identifies two categories:

Top harvest candidates

Search terms with orders and good ACoS that haven't been added as keywords yet. These are proven converters — promoting them to exact-match keywords gives you more control over bidding. Pro tier required.

Wasteful search terms

Search terms spending money with zero orders. Consider adding these as negative keywords to stop wasting budget. Each term shows spend, clicks, and a one-click negate button.

Keyword dedup

bddr.ai builds a cross-campaign keyword index as you visit targeting pages. When the same keyword (same text + same match type) appears in 2+ campaigns, an amber "Dupe?" badge appears on the grid row.

How it works

• The index builds incrementally as you visit pages — it can only detect duplicates for campaigns you've visited.
• Only enabled keywords count. Paused keywords are tracked but don't trigger the badge. Archived keywords are removed from the index.
• Same keyword in different match types (exact vs. phrase) is NOT a duplicate — that's intentional campaign structure.
• The index expires after 14 days. If you haven't visited a campaign recently, its keywords age out.

Hover over the badge to see which campaigns share the keyword, with bids and last-seen dates.

Analytics & trends

Every time bddr.ai scans a grid page, it captures a range observation — a snapshot of each entity's metrics for the current Amazon date range. Over time, these observations build a picture of how your account performs.

ACoS trend sparkline

The panel shows a sparkline chart that reconstructs your daily ACoS from overlapping range observations. The more you visit with different date ranges, the sharper the picture. A dashed line at the end marks the last 4 days (Amazon's attribution window is still settling).

Grid tooltip sparklines

Hovering over the ACoS heatmap badge shows a per-entity sparkline — the same reconstruction technique applied to just that one target. This loads on-demand (sub-millisecond) and shows whether that specific entity is trending up or down.

Data quality

Confidence scoring accounts for observation count, date range precision, recency, and Amazon's 7-day attribution settlement window. Higher confidence = more observations from different date ranges.

Recent changes

Near the bottom of the panel, the Recent Changes section shows bid and budget changes you've made using bddr.ai, scoped to the current page context:

• On a targeting page: shows target bid changes for that ad group
• On campaign-manager: shows campaign-level changes across the account
• On ad-groups page: shows ad group changes for that campaign

Each entry shows a colored recency dot, the entity name, what changed (bid/budget, old → new), and when.

History & undo

Session tracking

While you're actively making changes, bddr.ai tracks them in a session. Edited rows get an orange left border on the grid. The session bar at the top of the panel shows the change count.

Undo

Click Undo in the session bar to revert the most recent batch of changes. bddr.ai scrolls to each row and restores the original bid, one by one.

Audit history

Click the clock icon in the panel header to open the full audit trail. Every change made through bddr.ai is logged with timestamps, old/new values, and the reasoning. Retention: 7 days (Free), 90 days (Pro), 365 days (Power/Agency).

Bulk edit

The Bulk Edit overlay (accessible via Cmd+K → "Bulk Edit" or from the panel) lets you apply custom operations to all selected targets:

• Adjust by percentage — Increase or decrease all bids by X%
• Adjust by fixed amount — Add or subtract a fixed dollar amount
• Set to value — Set all bids to a specific amount
• Set to suggested bid — Use Amazon's suggested bid (low or high)
• Pause / Enable — Batch pause or re-enable targets

Pro tier required for bulk editing.

Settings

Click the gear icon in the panel header. Key settings:

• Target ACoS — Your goal. All recommendations are relative to this.
• Fee percentage — Amazon fees as % of revenue. Sets your breakeven.
• Min/Max bid — Absolute bounds bddr.ai will never exceed.
• Optimization preset — Conservative, Moderate, or Aggressive (controls cooldown and cap).
• Kill switch — Emergency stop. When enabled, bddr.ai won't write any changes.
• Auto-scan — Automatically reads all table rows after page load.
• Language — 11 languages: EN, DE, JA, ES, FR, IT, PT-BR, NL, SV, PL, AR.
• Telemetry — Toggle anonymous diagnostics.
• License key — Enter your key to unlock Pro, Power, or Agency features.

Command Palette

Press Cmd+K (Mac) or Ctrl+K (Windows) to open the command palette. Available commands:

• Open / Close / Toggle panel
• Open Bulk Edit, History, Settings
• Start guided tour
• Quick Optimize
• Report issue
• Export audit log
• Export diagnostics

Tiers & pricing

See full pricing details on our homepage.

Privacy & data

bddr.ai is designed with privacy as architecture, not policy:

• Local processing by default. All analysis runs in your browser. Your campaign data, keywords, bids, and spend don't leave your device except when you choose to send bid changes via Pro+ API integration (coming soon).
• No API connection by default. By default, no OAuth, no Amazon API keys — bddr.ai reads and writes through the Advertising Console page DOM. Pro+ users will be able to optionally enable API integration (coming soon), which uses Login with Amazon OAuth (tokens stored in your browser, refreshed every 50 minutes, never sent to us except to proxy the refresh).
• IndexedDB storage. Observations, edit history, and the keyword index are stored locally in your browser's IndexedDB. Clearing browser data removes it.
• Optional telemetry. Anonymous diagnostics (selector health, session duration, error reports) can be sent to help us catch bugs. No campaign names, keywords, bids, or spend are ever included. You can opt out in Settings.

Troubleshooting

Panel doesn't appear

Make sure you're on an Amazon Advertising Console page (advertising.amazon.com). The extension only activates on Amazon Ads pages. Try refreshing the page.

"bddr.ai can't read this page reliably"

Amazon occasionally changes their page structure. If you see this message, the extension's selectors may be outdated. Check for extension updates in chrome://extensions or email hello@fazr.ai — we typically fix selector issues within hours.

Health badges not appearing

Check Page Readiness — you may need columns like Clicks, Spend, Sales, and Orders visible. Click the Fix button to enable them automatically.

Bid changes aren't saving

bddr.ai writes bids by clicking into the bid cell on Amazon's grid, typing the new value, and pressing Enter — just like you would manually. If Amazon's page is slow or has changed, a write might fail. Check the terminal log for error messages. Make sure the Kill Switch in Settings is turned off.

Export diagnostics

Go to Settings → About → Export Diagnostics. This downloads a JSON file with selector health, recent errors with stack traces, terminal log, settings (license key redacted), and storage usage. Attach this to any support email.

Contact support

Email hello@fazr.ai with your diagnostics export attached. We typically respond within one business day.