pp-amazon-ads

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/commerce/amazon-ads/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Amazon Ads — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `amazon-ads-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install amazon-ads --cli-only
   ```
2. Verify: `amazon-ads-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/commerce/amazon-ads/cmd/amazon-ads-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## Start here: profitability

For a seller focused on organic + advertising profitability, start with these commands before browsing the full API surface:

1. `amazon-ads-pp-cli break-even-acos` — Calculate the maximum ACOS a product can carry before it loses money.
2. `amazon-ads-pp-cli true-profit` — Calculate product profit after COGS, estimated Amazon fees, and ad spend.
3. `amazon-ads-pp-cli acos-vs-tacos --report product-performance.csv --seller-store ~/.config/amazon-seller-pp-cli/store.db` — Join ad spend to seller-store sales for ACOS and TACOS by ASIN when the seller store has matching data.
4. `amazon-ads-pp-cli portfolio-dashboard --report campaign-performance.csv` — Summarize spend, sales, orders, ACOS, CPC, CTR, and CVR.
5. `amazon-ads-pp-cli product-ad-profitability --report product-performance.csv --cogs-file products.toml` — Estimate per-ASIN profit from ad performance and COGS.
6. `amazon-ads-pp-cli campaign-comparison --report campaign-performance.csv` — Compare campaigns by spend, sales, ACOS, CPC, CTR, and CVR.

Use `amazon-ads-pp-cli reports recipe <command>` when a command asks for `--report`; it prints the exact report kind, required columns, export path, and sample header. The schema-aware flows support console CSV/TSV exports and Ads API JSON/GZIP report artifacts.

`acos-vs-tacos` covers ad spend joined to seller-store sales and TACOS by ASIN when the seller store overlaps the ads report. It does not yet cover organic sessions, conversion rate, parent/child ASIN rollups, refunds, COGS unless `--cogs-file` is provided to profit commands, or TACOS by portfolio. For the seller-side dashboard workflow, cross-check `amazon-seller-pp-cli sales-intel dashboard`.

## Command Reference

**amazon-ads-dsp-dsp** — Manage amazon ads dsp dsp

- `amazon-ads-pp-cli amazon-ads-dsp-dsp get` — Returns advertiser information based on given advertiser id.
- `amazon-ads-pp-cli amazon-ads-dsp-dsp list` — Returns a list of advertisers with information which satisfy the filtering criteria.

**amazon-ads-profiles-profiles** — Manage amazon ads profiles profiles

- `amazon-ads-pp-cli amazon-ads-profiles-profiles get-by-id` — This operation does not return a response unless the current account has created at least one campaign using the
- `amazon-ads-pp-cli amazon-ads-profiles-profiles list` — Note that this operation does not return a response unless the current account has created at least one campaign using
- `amazon-ads-pp-cli amazon-ads-profiles-profiles update` — Note that this operation is only used for Sellers using Sponsored Products.

**amazon-ads-sponsored-reports** — Manage amazon ads sponsored reports

- `amazon-ads-pp-cli amazon-ads-sponsored-reports <reportId>` — Uses the `reportId` value from the response of a report previously requested via `POST` method of the

**assets** — Manage assets

- `amazon-ads-pp-cli assets get` — Retrieves an asset along with the metadata
- `amazon-ads-pp-cli assets get-upload-location` — Creates an ephemeral resource (upload location) to upload Assets to Creative Assets tool.
- `amazon-ads-pp-cli assets register` — The API should be called once the asset is uploaded to the location provided by the /asset/upload API endpoint.
- `amazon-ads-pp-cli assets search` — Search assets

**attribution** — Manage attribution

- `amazon-ads-pp-cli attribution get-advertisers-by-profile` — For sellers, an attribution profile has one associated advertiser.
- `amazon-ads-pp-cli attribution get-publisher-macro-tag` — Some third-party publishers do not support tags that include macro parameters.
- `amazon-ads-pp-cli attribution get-publisher-tag-template` — Third-party publishers, such as Google Ads, Facebook, Microsoft Ads
- `amazon-ads-pp-cli attribution get-publishers` — Use the response to determine whether to use either the macroTags or nonMacroTemplateTags resource to get tags for a
- `amazon-ads-pp-cli attribution get-tags-by-campaign` — Gets an attribution report for a specified list of advertisers.

**audiences** — Manage audiences

- `amazon-ads-pp-cli audiences fetch-taxonomy` — Returns a list of audience categories for a given category path **Requires one of these permissions**
- `amazon-ads-pp-cli audiences list` — Returns a list of audience segments for an advertiser.

**benchmarks** — Manage benchmarks

- `amazon-ads-pp-cli benchmarks get-brands` — Gets a list of brands that the advertising account has promoted in their SB campaigns **Requires one of these
- `amazon-ads-pp-cli benchmarks get-report-data` — Provides overview of metrics for all brands and categories that the entity has access to.
- `amazon-ads-pp-cli benchmarks get-time-series` — Provides time series data for the specified brand and category filtered by optional parameters **Requires one of these

**billing** — Manage billing

- `amazon-ads-pp-cli billing bulk-get-notifications` — Gets an array of all currently valid billing notifications associated for each advertising account.
- `amazon-ads-pp-cli billing bulk-get-status` — Gets the current billing status associated for each advertising account.

**brands** — Manage brands

- `amazon-ads-pp-cli brands` — Gets an array of Brand data objects for the Brand associated with the profile ID passed in the header.

**currencies** — Manage currencies

- `amazon-ads-pp-cli currencies` — Gets an array of localized currencies in their target marketplaces using advertiser identifier in header

**dp** — Manage dp

- `amazon-ads-pp-cli dp create` — Creates a new data provider audience. Note that the API call rate is limited to 1 transaction per second (TPS).
- `amazon-ads-pp-cli dp get` — Gets metadata for an audience specified by identifier.
- `amazon-ads-pp-cli dp update` — Associates or disassociates a record with an audience.
- `amazon-ads-pp-cli dp update-audiencemetadata` — Updates metadata of an existing audience specified by identifier.
- `amazon-ads-pp-cli dp update-users` — Deletes user data originally sourced from the client. The API call rate is limited to 1 transactions per second (TPS).

**dsp** — Manage dsp

- `amazon-ads-pp-cli dsp associate-line-items-to-creatives` — Create/delete association between line item and creative. Callout - Do not pass in startDate, endDate and weight.
- `amazon-ads-pp-cli dsp create-file-uploads-policy` — Create file upload policy that used to upload file to AWS S3. File upload policy will expire in 15 minutes.
- `amazon-ads-pp-cli dsp create-image-creative` — Create an image creative. Callout - A future update will add support to create multiple Image crea