Read tools
Pull performance, structure, plans, audits, and history from the warehouse. All safe.
Read tools never move money. They read the warehouse, so check freshness first if you're about to act on the numbers.
Strategy
| Tool | Purpose |
|---|---|
asa_get_optimization_plan | Targets, current pacing, and a ranked action feed (scale / improve / protect / reallocate). The ground truth for strategy — quote pacing and CPA-vs-band from it. |
asa_get_account_overview | Headline KPIs and trends for the account. |
asa_get_segment_performance | Performance by storefront, device, daypart, age/gender. |
asa_run_report | A custom report over the warehouse dimensions and metrics. |
Structure
| Tool | Purpose |
|---|---|
asa_list_campaigns | Campaigns with status and metrics. |
asa_list_ad_groups | Ad groups (there's no ad-group page in the app — this is the direct read). |
asa_list_keywords | Keywords with match type, status (ACTIVE|PAUSED), bids, and metrics. |
asa_list_negative_keywords | Negative keywords across the account. |
asa_list_ads | Ad creatives. |
asa_get_search_terms | The queries that triggered ads — the Search Match harvest source. |
Audit, history & policy
| Tool | Purpose |
|---|---|
asa_list_audit_runs | Past audit runs. |
asa_get_audit_report | A specific report: findings, deltas, and the outcome review of past changes. |
asa_list_action_history | This app's ledger of its own changes (what / when / why / who / result). |
asa_list_pending_actions | The approval queue — proposals awaiting a decision. |
asa_explain_policy | Why a proposed change would auto-apply or queue, without proposing it. |
Strategic reads return a dataFreshness signal. If it warns, run asa_get_sync_status →
asa_trigger_sync, wait, and re-read before acting.