overview
Every 20 min. Closes a money-losing campaign for the rest of today (budget → $1, not paused). Reopens overnight.
Every hour. Scales each bid by hour & weekday (e.g. ×0.30 = −70% at night).
Daily. Recomputes each bid toward a target ACoS.
$1 ≠ deleted. A campaign closed to $1 stays ENABLED (rank preserved); $1 just means "no budget left today". The list below shows what each one spent before it closed.
coverage
ASIN-centered ad-structure coverage. Keyword columns show N/M = active targets of the planned set for that match type (the recommendation engine decides which terms belong in Exact vs Phrase vs Broad per ASIN, using ad performance + SQP market demand; ≥3 clicks + ≥3 orders is always Exact). DUPLICATE = same canonical target in >1 active campaign. SBV has no live source yet (n/a).
review queue
One queue for every recommendation source (coverage · query · search-term). Review, approve/reject, then apply approved — negatives now write real negative keywords to Amazon on apply. Click a negative's "destination" cell to see which campaigns it will hit, with each campaign's own performance.
Give one ASIN and the AI derives targets from the product itself — first GENERIC buyer keywords from its title/bullets (origin Listing), then relevant high-volume queries from the latest SQP month (origin SQP). Both are written to this ASIN's review queue. Use this when the proven-term propagation only returns brand keywords.
eagle eye
Kurulum & teşhis
Kurulum — what this entity has wired up
Each row shows whether the selected entity (top-right dropdown) has that component wired. "Install" runs the safe, idempotent action. Installing only builds the machinery — nothing runs until you arm it in the capability list above, which is the one place that decides off / shadow / live.
| component | status | detail | |
|---|---|---|---|
| pick an entity, then refresh… | |||
AI model & usage
Which LLM answers for this entity. Default is the platform Anthropic key with each feature's own model. Pick a provider + model (and optionally the customer's own API key) to override every AI feature for this entity.
| feature | provider / model | calls | failed | tokens in | tokens out | cost (30d) |
|---|---|---|---|---|---|---|
| — | ||||||
hover a calls cell for the day-by-day breakdown of that feature
campaigns
✏️ toplu yeniden adlandır — isim kalıbını düzelt (örn. SPX → SPM)
| eski | yeni | durum |
|---|
Segments under management (target $ / ACoS% / envelope / no-sale / mode)
| segment | campaigns | target $ | ACoS% | envelope | no-sale $ | open $ | mode | enabled | |
|---|---|---|---|---|---|---|---|---|---|
| pick an entity above & open this tab | |||||||||
Portfolio summary
| portfolio | daily budget | live cap | #camp | target $ | now $ | budget | used | spend (today) | sales (today) | ACoS (today) | ACoS (30d) | ROAS (30d) | spend (30d) | sales (30d) | bid |
|---|
| campaign | portfolio | seg | engine | target $ | now $ | budget | budget used | spend (today) | sales (today) | ACoS (today) | ACoS (3d) | ACoS (7d) | ACoS (30d) | ROAS (30d) | spend (30d) | sales (30d) | clicks (30d) | orders (30d) | CVR (30d) | ad type | ad state | last decision (why) | today 0–23h → | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| loading… | |||||||||||||||||||||||||||||||||||||||||||||||
Grid: 🟩 open · 🟥 closed ($1) · faint = noop. Hover a cell for that hour's spend/sales/ACoS/reason. ACoS windows are cached ≤30 min; engine state / now $ / grid are live. Blank engine columns = campaign not under engine management.
products
— per-ASIN ad + organic (Business Report) performance for the picked date range. Click a row for a daily chart. Sessions/page views/organic sales/conv. rate/TACoS show "—" for an entity until Setup tab's "Business Report crons" + backfill have run.| campaign | impressions | clicks | spend | orders | sales | ACoS |
|---|---|---|---|---|---|---|
| loading… | ||||||
| pick a date range and click "load". |
Budget Guardrail Simulator — counterfactual: "if this rule had run, what would profit be?" · ENABLED campaigns, 14-day window
all segments (per-ASIN TACoS, ENABLED campaigns, last 14d)
| segment | ASINs | revenue | ad spend | TACoS | real net | sim net | gain | policy | |
|---|---|---|---|---|---|---|---|---|---|
| pick an entity above & open this tab | |||||||||
Decide on TACoS (organic+ad), not ACoS. Segment policy: A=grow · B=hold · C=guardrail · D=cut. Apply writes proposed daily budgets to Amazon for the segment's campaigns — read the numbers first.
all targets
| keyword | imp | clicks | CTR | spend | CPC | orders | sales | ACoS | CVR | placement T/R/P |
bid | default | → new | Δ% | actual | campaign | state | data | description | |||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| loading… | ||||||||||||||||||||||
per-rule performance
rule overrides
policy
budget engine thresholds
The values the hourly budget engine acts on — previously hardcoded, now editable. Band cutoffs decide which campaign is a winner/ok/watch/bleeder; grow/throttle knobs decide how it raises and caps budgets. Blank entity row = global defaults apply to everyone.
ads memory
decision quality leaderboard
| actor | kind | total | scored | avg_score | wins | losses |
|---|
add note
recent (decisions + notes, mixed)
| at | type | kind | actor | summary | outcome |
|---|
manual bid adjustment
| # | target_id / text | match | current | new bid ✏️ | Δ% | metrics / note | status | message | |
|---|---|---|---|---|---|---|---|---|---|
| queue rows from inventory (→ MB) or paste above + parse | |||||||||
recent manual changes
| when | scope | target | old | new | Δ% | operator | status | outbox | outcome | note |
|---|---|---|---|---|---|---|---|---|---|---|
| — | ||||||||||
dayparting —
📥 Yeni müşteri için hourly veri yükle (XLSX / CSV)
- Amazon Ads UI → Reports → Sponsored Products Campaign report → Time unit = Hourly → Export. (90 günlük tek dosya veya 2× 30-45 günlük olabilir.)
- Dosyaları operatör makinasında bir klasöre koy (örn.
~/Documents/AvocoreEcosystem/scratch/). - Terminal:
DATABASE_URL="..." python3 AVOCORE_INTEGRATIONS/scripts/import-amazon-ads-hourly.py <entity_slug> <file1> [file2 ...]
data coverage —
hourly breakdown —
| loading… |
multiplier heatmap (7d × 24h, PT)
recent apply ticks (hour by hour)
| when | day/hour | hour×dow | combined | avg base | avg applied | Δ% | rows | clamped | mode |
|---|---|---|---|---|---|---|---|---|---|
| loading… | |||||||||
baselines —
| source | entity | scope | target (name) | campaign (name) | ad group | base bid (USD) | floor (USD) | ceiling (USD) | notes | updated_at (PT) | ||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| loading… | ||||||||||||
queries
— SQP + Search Term Impression Share + ad metrics, joined per search queryuploaded periods
| period | date range | queries | uploaded | by | |
|---|---|---|---|---|---|
| no uploads yet — drop a SQP CSV above. | |||||
joined study
| search term | AI impr | AI traf (or/ad) | AI pos | AI or-rk | AI sp-rk | AI SV | H10 SV | H10 sp-rk | H10 or-rk | SQP vol | impr (brand/total) | brand share | SQP purch (brand/total) | SQP CVR (total) | SQP CVR (brand) | STI-SP | STI-SB | ad impr | ad clk | spend | orders | sales | ACOS | CVR |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| upload a SQP file to build the joined study. | ||||||||||||||||||||||||
Search Terms — 1. Analyzer — long-window SP+SB search-term triage from permanent report data. Flags negatives to add + profitable terms to harvest, then writes them to Target Discovery — review & apply on the Review Queue tab.
Negative candidates
| search term | channel | clicks | spend | sales | orders | ACoS | match | action | reason | status |
|---|---|---|---|---|---|---|---|---|---|---|
| click "analyze" (writes) or "preview candidates" (read-only). | ||||||||||
Positive / harvest candidates
| search term | ASIN | clicks | spend | sales | orders | ACoS | CVR | relevance | match | action | conf. | status |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| click "analyze" or "preview candidates". | ||||||||||||
Search Terms — 2. Review & Approve — relevance-checked keyword harvesting (SP). The analyzer above writes here → review → approve → open campaigns.
| search term | ASIN | classification | brand rel. | relevance | match | SQP vol | trend | mkt clk/purch | brand clk-share | brand purch-share | ad clk | ad ord | ACoS | SP cov (E/P/B) | action | destination | 7d CPC | bid | conf. | auto | risk | source | status | reason | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| click "analyze period" to generate recommendations. | |||||||||||||||||||||||||
Active Ads — Search Terms — pick a campaign, read its last-90-day search terms, tick the wasteful ones and add them as negatives
| campaign | type | spend | sales | ACoS |
|---|---|---|---|---|
| pick an entity from the top selector. | ||||
| search term | match | impr | clicks | CTR | spend | CPC | orders | sales | CVR | ACoS | ROAS | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| pick a campaign on the left. | ||||||||||||
create campaign
— spec: Amazon_Ads_Strategies.md §1.2Product ASIN | Tos Rate | Ros Rate | Budget | Match Type | Target | BidTarget keyword ise → match type
exact / phrase / broad ·
Target ASIN ise → otomatik product targeting, match type exact (sadece o ASIN)
veya expanded (o ASIN + Amazon'ın benzer gördükleri) ·
TOS/ROS boş bırakılabilir (0–900)
| # | ASIN | hedefleme | target | bid | budget | TOS | ROS | SKU | kampanya adı | durum |
|---|
| # | kampanya | sonuç | campaign_id | detay |
|---|
| when (PT) | name | campaign_id | ASIN | SKUs | type | budget | local state | operator | |
|---|---|---|---|---|---|---|---|---|---|
| click reload | |||||||||
hourly performance
— per-hour impressions / clicks / CVR / ACoS / TACoS for the picked day (PT)| hour (PT) | impr | clicks | CTR | DP % | bid flow | CPC | ad cost | ad orders | tot orders | ad sales | tot revenue | CVR | ACoS | TOS% | TACoS | cum CVR | cum ACoS | cum TACoS |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| pick a date and click refresh. | ||||||||||||||||||
How to use this screen — recommended flow
-
1
Trigger a tick. Hit ▶ run optimizer (propose) at the top of the page. The optimizer evaluates every active keyword across the short / mid / long windows and writes one experiment row per target_id. Counters in the top toolbar update: proposed (bid would change), no_change (rule fired but kept current bid), rejected (cooldown / guardrail blocked).
-
2
Review the proposed rows. Default filter is proposed + undecided only. The rightmost Notes column explains exactly which sub-formula fired, which window(s), and which guards bound the result — same narrative as the Excel spec sheet. Skim Notes, then bulk-tick the checkboxes for the rows you trust.
-
3
Approve or reject the selection. ✓ approve selected stages the bids for live apply; ✗ reject selected marks them as operator-rejected (stays out of cooldown). Approving a row sets approved_at but does NOT push yet — the optimizer apply pass picks them up.
-
4
Push approved bids to Amazon. Hit ▲ apply approved at the top. Each row transitions proposed → applied as the connector confirms. An observation window opens (default 48h) — the optimizer then auto-evaluates ACoS post-change and writes concluded (kept) or reverted.
-
5
Periodically audit no_change. Switch the status filter to
no_changeto see every keyword the optimizer considered but did NOT act on — the Notes column tells you which gate held (MinClicks, CriticalCPC, ImpressionLimit, TOS share). If a large bucket of keywords keeps hitting the same gate, tune the matching slider on the configs sub-tab.
experiments
| keyword | base bid | live | raw new | place adj | final new | Δ% | applied rule | date range | action | max chg | min/max | 3d ACoS | 7d ACoS | 30d ACoS | status | operator | proposed | notes | ||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| loading… | ||||||||||||||||||||
Amazon Marketing Cloud
Kitleler
| hesap | kitle | pencere | ölçüm | durum | audience id | not |
|---|---|---|---|---|---|---|
| loading… | ||||||
Instance erişimi
| hesap | instance | entity | token | erişim | not |
|---|---|---|---|---|---|
| loading… | |||||