Google conversions by action (`adsap_google_get_conversion_breakdown`)

Platform: Google Ads · Read or write: Read · Plan: Early Access · Consumes a task: No · Preview supported: No

What it does

Splits a Google Ads account’s conversions by conversion action, such as purchase, lead or phone call, instead of one lumped total. Each row shows all conversions, bidding conversions, value, view-through conversions and share of the total. You can view it per account or per campaign.

When to use it

Use it to see which conversion actions produce your conversions, or why all_conversions is far above conversions.
It needs the 10-digit customer ID from adsap_google_list_ad_accounts. A campaign_id comes from adsap_google_list_campaigns.
Passing campaign_id switches the report to campaign level, even when level says account. The response flags this in meta.level_promoted.
Each row is a total for the whole date range, sorted by all_conversions. The default range is last_30d and limit goes up to 500.
It returns no cost or cost per conversion. For cost, use adsap_google_get_insights.

Worked example

You ask

“Which conversion actions did Google Ads account 1234567890 record over the last 30 days?”

The assistant calls `adsap_google_get_conversion_breakdown`


{
  "ad_account_id": "1234567890",
  "level": "account",
  "date_preset": "last_30d"
}

Adsap returns

The field names are the ones Adsap returns. The values are examples.


{
  "ok": true,
  "data": [
    {
      "conversion_action_id": "7000000001",
      "conversion_action_name": "Purchase",
      "category": "PURCHASE",
      "all_conversions": 120,
      "all_conversions_value": 9600,
      "conversions": 120,
      "conversions_value": 9600,
      "view_through_conversions": 8,
      "share_of_total": 60
    },
    {
      "conversion_action_id": "7000000002",
      "conversion_action_name": "Newsletter sign-up",
      "category": "SIGNUP",
      "all_conversions": 80,
      "all_conversions_value": 0,
      "conversions": 0,
      "conversions_value": 0,
      "view_through_conversions": 0,
      "share_of_total": 40
    }
  ],
  "meta": {
    "total_count": 2,
    "truncated": false,
    "level": "account",
    "level_promoted": false,
    "date_range": { "from": "2026-08-19", "to": "2026-09-17" },
    "campaign_id": null,
    "total_all_conversions": 200
  }
}

How to read it

conversions counts only the actions marked primary for a goal, the ones bidding optimizes toward. all_conversions counts every action. Here the sign-up action is secondary, which is why all_conversions reads 200 for the account and conversions reads 120. share_of_total is each action’s percentage of meta.total_all_conversions.

meta.note (not shown) explains the same difference in a sentence. When meta.truncated is true, the shares are left out because the total is incomplete. Narrow with campaign_id or raise limit. For each action’s status and primary flag, the assistant can call adsap_google_list_conversion_actions.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Name	Type	Required	Description
`ad_account_id`	string	Yes	Bare 10-digit Google Ads customer ID (from adsap_google_list_ad_accounts). No dashes, no act_ prefix.
`level`	one of `account`, `campaign`	No	’account’ = one row per conversion action for the whole account (default). ‘campaign’ = one row per campaign x conversion action. Passing campaign_id implies ‘campaign’.
`date_preset`	one of `today`, `yesterday`, `last_7d`, `last_14d`, `last_30d`, `this_month`, `last_month`	No	Date range preset (default last_30d). Ignored when date_from/date_to are set.
`date_from`	string	No	Custom range start, YYYY-MM-DD. Use with date_to.
`date_to`	string	No	Custom range end, YYYY-MM-DD. Use with date_from.
`campaign_id`	string	No	Restrict to one campaign (numeric id from adsap_google_list_campaigns). Forces campaign level.
`limit`	number	No	Max rows returned, ordered by all_conversions descending. Rows are (campaigns x conversion actions) aggregated over the whole range, so the default covers almost every account.

Example prompts

“Which conversion actions is my Google Ads account actually getting this month?”
“Why is All conversions so much higher than Conversions in my account?”
“Break down conversions by action for my Search campaign over the last 30 days.”

Notes

Google does not report cost split by conversion action, so there is no spend or CPA column here. Use the insights report for cost.

adsap_google_list_conversion_actions: List a Google Ads account’s conversion actions (name, type, category, status, primary-for-goal, counting type, origin).

Guide

Read Insights and reporting for the workflow around this tool, and the Tool reference for every tool.

The Google Ads MCP server page shows how to connect Google Ads to Claude, ChatGPT or Perplexity.

Google conversions by action (adsap_google_get_conversion_breakdown)