Manage the budgets of multiple campaigns together

On this page you can bundle multiple campaigns into a portfolio (Amazon Ads’ grouping unit) and manage them with a budget cap applied to the group as a whole. Use it when you want to control budgets by grouping campaigns by brand, product line, seasonal initiative, and so on.

About this page

Item	Details
What you can do	Check portfolio structure and budgets, create new ones, change budgets, and check spend status
Applies to	Portfolios that bundle Sponsored Products (SP), Sponsored Brands (SB), and Sponsored Display (SD) campaigns
Data & connection needed	Listing and checking spend work with a connected account. Creating and changing budgets require write access to Amazon Ads (Prompt 3 in Connect ad accounts)
Scope	Varies by prompt. Checks are analysis only (read-only); creating and changing budgets change Amazon Ads settings after approval

When to use this

You want to bundle campaigns by brand or product line and control the budget for the group as a whole
You want to check your current portfolio structure and budget settings
You want to raise or lower a portfolio’s budget
You want to spot portfolios approaching their budget cap early

Before you run

Target account … if you handle multiple accounts, check that the target is correct.
Write access … creating and changing budgets require a write connection to Amazon Ads (not needed for checks alone).
Budget policy … when creating a new portfolio, decide in advance whether it is “monthly recurring” or “dated budget”.

Quick reference

Goal	What you get	Changes	Prompt
Check existing portfolio structure and budgets	A portfolio list (budgets, campaign count)	No change (read-only)	Prompt 1
Create a new portfolio	A preview of what will be created	Created in Amazon Ads after approval	Prompt 2
Change a portfolio’s budget	A before/after budget comparison	Changes the Amazon Ads budget after approval	Prompt 3
Check budget utilization at the portfolio level	A list with spend rates	No change (read-only)	Prompt 4

Prompt 1: Check existing portfolio structure and budgets

Lists the portfolios currently in your account along with each one’s budget settings. Use it to understand where you stand before reworking the design.

When to use — when you want to understand your current structure before reworking budget allocation.

What you need — (none; use it as is)

Please list the existing ad portfolios.

Sources:
1) The portfolio ledger (all rows): name / state / budget amount / budget policy (dated budget, monthly recurring, no cap)
2) The aggregation of budget and actual spend (including ended portfolios): budget cap / actual spend / spend share / total daily budget /
   number of running campaigns / total number of campaigns
3) For portfolios that don't appear in 2, count the "number of linked campaigns" by fetching every page of the
   Sponsored Products, Sponsored Brands, and Sponsored Display campaign lists and counting them per portfolio

Output items (one row per portfolio):
- Portfolio name
- State
- Budget amount (if there is no budget cap, state "no cap" explicitly; do not write 0 JPY)
- Budget policy (dated budget / monthly recurring / no cap)
- Number of linked campaigns (show both running and total. If you could not count them, state "not fetched" explicitly; do not write 0)
- Actual spend and spend share

Sort order:
- For portfolios that have a budget cap, sort in descending order of the spend rate ("actual spend ÷ budget cap," so that
  the high and low spend rates are visible at a glance
- For portfolios with no budget cap, do not compute a spend rate; state "no cap" explicitly and group them in a
  separate section sorted by actual spend (spend share) descending

Constraints:
- Use real data only; do not guess or interpolate numbers you did not fetch
- If pagination or next-page information is returned, keep going until the total count and the number fetched match
- Distinguish between null, not fetched, no data, and 0
- If the total number of campaigns does not match across sources, state the discrepancy and the candidate causes

Purpose: used as input for deciding on new portfolios and reallocating budgets.

This result is used in Prompt 4, "Check budget utilization at the portfolio level."

What you can change — (none)

What you get back — a table of portfolio name × state × budget amount × budget policy × campaign count.

Changes — no change (read-only).

Next steps — if you find a portfolio whose budget you want to change, go to Prompt 3.

Prompt 2: Create a new portfolio

Creates a new portfolio for a split such as by brand or product line.

When to use — when you want to start managing budgets by bundling campaigns under a new split.

What you need — the portfolio name, budget amount, and budget policy.

Create a new ad portfolio.
- Portfolio name: {{PORTFOLIO_NAME}}
- Budget: {{BUDGET_AMOUNT (e.g., 500000)}} JPY
- Budget policy: {{BUDGET_POLICY (monthly recurring / dated budget)}}

Let me review the details first, then execute if there are no issues.

What you can change — the portfolio name (unique within the account), the budget amount, and the budget policy (for a dated budget, also specify the start date). You can also create a portfolio with no budget set (no cap).

What you get back — a preview of what will be created. It is created after approval, in an enabled state.

Changes — creates the portfolio in Amazon Ads after approval.

Next steps — after creation, wait a few minutes for it to propagate, then link existing campaigns.

Prompt 3: Change a portfolio’s budget

Changes the budget amount or policy of an existing portfolio.

When to use — when you want to rework budget allocation and raise or lower a specific portfolio’s cap.

What you need — the portfolio name and the new budget amount.

Please change the budget of portfolio "{{PORTFOLIO_NAME (e.g., PF_NewProductLine_2026H2)}}"
to {{NEW_BUDGET_AMOUNT (e.g., 800000)}} JPY.

- Reason for the change: {{REASON_FOR_CHANGE (e.g., the spend rate is above 90% and opportunity loss is occurring)}}

Please follow these steps in order.

1. Fetch the target portfolio's current settings and present the portfolio ID, budget type, and current cap.
2. Line up the before and after amounts. If the current budget type is "no cap," state explicitly that this change
   is "establishing a new cap" (do not treat "no cap" as 0 JPY).
3. Show the expected impact on the linked campaigns, using only items you can fetch as real data:
   the number of enabled campaigns, the total number of campaigns, the total daily budget of the enabled campaigns,
   and the ad spend, sales, orders, ACoS, ROAS, and share of account-wide spend over the target period.
   State explicitly that items you cannot fetch cannot be fetched; do not fill them in with guessed or assumed values.
4. Present the change first as a diff in preview (a mode that performs no writes), and
   ask for approval. Do not apply anything to Amazon Ads until I approve.
5. State the rollback method before approval.
   - If the previous setting was a monetary cap: revert to the previous amount.
   - If the previous setting was "no cap": removing a cap cannot be carried out via the API, so MCP
     cannot return it to its original state. Tell me that, and that manual work in the ad console
     is required, before approval.

After approval, 7 days after the change, re-fetch the spend rate and ACoS with "measure the effect of an initiative," and
if ACoS has worsened past the target, roll back using the rollback method in step 5 above.

What you can change — the portfolio name and the new budget amount.

What you get back — a before/after comparison of the budget amount. Applied after approval.

Changes — changes the Amazon Ads portfolio budget after approval.

Next steps — check the spend after the change with Prompt 4.

Prompt 4: Check budget utilization at the portfolio level

Checks how much of the budget each portfolio has spent. Lets you spot portfolios approaching their cap early.

When to use — when you want to keep an eye on portfolios approaching their budget cap.