google_ads_get_asset_report

Description

Asset-level performance report across hierarchy levels (AD_GROUP, CAMPAIGN, CUSTOMER, ASSET_GROUP). CAMPAIGN level automatically includes PMax asset groups. When levels is omitted, all levels are queried. Conversion breakdown, change history, and PMax audience signals (audiences and search themes) are opt-in to control response size. Video metrics are not available on asset resources. For creative inventory or copy exports, set include_asset_content: true — it resolves full sitelink copy (link text + both description lines), callout text, structured snippet values, call numbers, promotion targets, price offerings, and final URLs; without it, content is null for those asset types. Paginated: when a response includes nextCursor, call again with the same parameters plus cursor=<nextCursor>, and repeat until nextCursor is absent to get every row. A query that fails is named in warnings rather than silently returning nothing: a failed level's assets are missing from data and count, not absent from the account. If every level's row query fails, the call fails with the platform's error instead of returning an empty report. A cursor continues the queries page 1 read — a level that failed on the first page stays missing on later pages (omit cursor to retry it), and a level page 1 read that fails on a later page fails that call, which can be retried with the same cursor.

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_get_asset_report",
    "arguments": {
      "customer_id": "1234567890",
      "date_preset": "LAST_30_DAYS",
      "reason": "Review asset performance across all levels"
    }
  }
}

hopkin google asset-report get

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

Parameters

Examples

{
  "customer_id": "1234567890",
  "date_preset": "LAST_30_DAYS",
  "reason": "Review asset performance across all levels"
}

{
  "customer_id": "1234567890",
  "date_preset": "LAST_7_DAYS",
  "levels": [
    "AD_GROUP"
  ],
  "reason": "Ad group asset analysis"
}

{
  "customer_id": "1234567890",
  "date_preset": "LAST_30_DAYS",
  "levels": [
    "CAMPAIGN"
  ],
  "reason": "PMax asset group analysis"
}

{
  "customer_id": "1234567890",
  "date_preset": "LAST_30_DAYS",
  "field_types": [
    "HEADLINE"
  ],
  "order_by": "impressions",
  "limit": 20,
  "reason": "Top headline analysis"
}

{
  "customer_id": "1234567890",
  "date_preset": "LAST_30_DAYS",
  "levels": [
    "ASSET_GROUP"
  ],
  "include_audience_signals": true,
  "reason": "PMax audience signal audit"
}

{
  "customer_id": "1234567890",
  "date_preset": "LAST_30_DAYS",
  "asset_types": [
    "SITELINK"
  ],
  "include_asset_content": true,
  "reason": "Export full sitelink copy and final URLs"
}

Related Tools