`google_ads_get_conversion_actions`

List Google Ads Conversion Actions

Google

Description

List conversion actions for a Google Ads account, including (a) the account-default goal flag, (b) **effective** inclusion across active campaigns (factoring in custom conversion goals and selective optimization), and (c) measured \

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_get_conversion_actions",
    "arguments": {
      "customer_id": "1234567890",
      "reason": "Audit which conversion actions are firing"
    }
  }
}

hopkin google conversion-actions get

Flag	Type	Required	Description
`--customer-id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)
`--login-customer-id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accounts
`--status`	`string`	Optional	Filter by status (default: returns all non-REMOVED). ENABLED, REMOVED, HIDDEN
`--limit`	`number`	Optional	Maximum number of conversion actions to return (default: 100, max: 500)
`--lookback-days`	`integer`	Optional	Lookback window (days) for recent conversion counts. Default 30.
`--include`	`array`	Optional	Which optional blocks to compute. 'effective' = goal-hierarchy walk (3 extra GAQL queries). 'recent' = metrics.conversions over the lookback window (1 extra query). 'campaign_overrides' = list the contributing campaign IDs per action, grouped by source (HEAVY — full list, no cap; only request when the user explicitly asks 'which campaigns?'). Implies 'effective'. 'tag_snippets' = include tag snippet HTML per row. 'attribution' = include attribution-model + value settings. Default: ['effective','recent']. Pass [] for the lightest possible response.

{
  "mcpServers": {
    "google-ads": {
      "url": "https://google.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`customer_id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)minLength: 1
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (5)

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountsminLength: 1
`status`	`string`	Optional	Filter by status (default: returns all non-REMOVED). ENABLED, REMOVED, HIDDEN `ENABLED` `REMOVED` `HIDDEN`
`limit`	`number`	Optional	Maximum number of conversion actions to return (default: 100, max: 500)min: 1, max: 500
`lookback_days`	`integer`	Optional	Lookback window (days) for recent conversion counts. Default 30.min: 1, max: 90
`include`	`array`	Optional	Which optional blocks to compute. 'effective' = goal-hierarchy walk (3 extra GAQL queries). 'recent' = metrics.conversions over the lookback window (1 extra query). 'campaign_overrides' = list the contributing campaign IDs per action, grouped by source (HEAVY — full list, no cap; only request when the user explicitly asks 'which campaigns?'). Implies 'effective'. 'tag_snippets' = include tag snippet HTML per row. 'attribution' = include attribution-model + value settings. Default: ['effective','recent']. Pass [] for the lightest possible response.

Examples

List all (default: effective + recent)

{
  "customer_id": "1234567890",
  "reason": "Audit which conversion actions are firing"
}

hopkin google conversion-actions get --customer-id 1234567890

Enabled only

{
  "customer_id": "1234567890",
  "status": "ENABLED",
  "reason": "Active conversion actions"
}

hopkin google conversion-actions get --customer-id 1234567890 --status ENABLED

Lightweight list

{
  "customer_id": "1234567890",
  "include": [],
  "reason": "Just list the conversion actions, no goal walk"
}

hopkin google conversion-actions get --customer-id 1234567890 --include

Custom lookback (7 days)

{
  "customer_id": "1234567890",
  "lookback_days": 7,
  "reason": "Recent week of conversions"
}

hopkin google conversion-actions get --customer-id 1234567890 --lookback-days 7

Which campaigns count this action?

{
  "customer_id": "1234567890",
  "include": [
    "effective",
    "campaign_overrides"
  ],
  "reason": "Per-campaign attribution audit"
}

hopkin google conversion-actions get --customer-id 1234567890 --include effective,campaign_overrides