# Send Google Ads to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "google-ads",
    "name": "Google Ads",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/jdrhyne/google-ads",
    "canonicalUrl": "https://clawhub.ai/jdrhyne/google-ads",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/google-ads",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-ads",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "references/api-setup.md",
      "references/browser-workflows.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "google-ads",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T20:39:39.582Z",
      "expiresAt": "2026-05-10T20:39:39.582Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-ads",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-ads",
        "contentDisposition": "attachment; filename=\"google-ads-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "google-ads"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/google-ads"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/google-ads",
    "downloadUrl": "https://openagent3.xyz/downloads/google-ads",
    "agentUrl": "https://openagent3.xyz/skills/google-ads/agent",
    "manifestUrl": "https://openagent3.xyz/skills/google-ads/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/google-ads/agent.md"
  }
}
```
## Documentation

### Google Ads Skill

Manage Google Ads accounts via API or browser automation.

### Mode Selection

Check which mode to use:

API Mode - If user has google-ads.yaml configured or GOOGLE_ADS_* env vars
Browser Mode - If user says "I don't have API access" or just wants quick checks

# Check for API config
ls ~/.google-ads.yaml 2>/dev/null || ls google-ads.yaml 2>/dev/null

If no config found, ask: "Do you have Google Ads API credentials, or should I use browser automation?"

### Browser Automation Mode (Universal)

Requirements: User logged into ads.google.com in browser

### Setup

User opens ads.google.com and logs in
User clicks Clawdbot Browser Relay toolbar icon (badge ON)
Use browser tool with profile="chrome"

### Common Workflows

Get Campaign Performance

1. Navigate to: ads.google.com/aw/campaigns
2. Set date range (top right date picker)
3. Snapshot the campaigns table
4. Parse: Campaign, Status, Budget, Cost, Conversions, Cost/Conv

Find Zero-Conversion Keywords (Wasted Spend)

1. Navigate to: ads.google.com/aw/keywords
2. Click "Add filter" → Conversions → Less than → 1
3. Click "Add filter" → Cost → Greater than → [threshold, e.g., $500]
4. Sort by Cost descending
5. Snapshot table for analysis

Pause Keywords/Campaigns

1. Navigate to keywords or campaigns view
2. Check boxes for items to pause
3. Click "Edit" dropdown → "Pause"
4. Confirm action

Download Reports

1. Navigate to desired view (campaigns, keywords, etc.)
2. Click "Download" icon (top right of table)
3. Select format (CSV recommended)
4. File downloads to user's Downloads folder

For detailed browser selectors: See references/browser-workflows.md

### API Mode (Power Users)

Requirements: Google Ads API developer token + OAuth credentials

### Setup Check

# Verify google-ads SDK
python -c "from google.ads.googleads.client import GoogleAdsClient; print('OK')"

# Check config
cat ~/.google-ads.yaml

### Common Operations

Query Campaign Performance

from google.ads.googleads.client import GoogleAdsClient

client = GoogleAdsClient.load_from_storage()
ga_service = client.get_service("GoogleAdsService")

query = """
    SELECT campaign.name, campaign.status,
           metrics.cost_micros, metrics.conversions,
           metrics.cost_per_conversion
    FROM campaign
    WHERE segments.date DURING LAST_30_DAYS
    ORDER BY metrics.cost_micros DESC
"""

response = ga_service.search(customer_id=CUSTOMER_ID, query=query)

Find Zero-Conversion Keywords

query = """
    SELECT ad_group_criterion.keyword.text,
           campaign.name, metrics.cost_micros
    FROM keyword_view
    WHERE metrics.conversions = 0
      AND metrics.cost_micros > 500000000
      AND segments.date DURING LAST_90_DAYS
    ORDER BY metrics.cost_micros DESC
"""

Pause Keywords

operations = []
for keyword_id in keywords_to_pause:
    operation = client.get_type("AdGroupCriterionOperation")
    operation.update.resource_name = f"customers/{customer_id}/adGroupCriteria/{ad_group_id}~{keyword_id}"
    operation.update.status = client.enums.AdGroupCriterionStatusEnum.PAUSED
    operations.append(operation)

service.mutate_ad_group_criteria(customer_id=customer_id, operations=operations)

For full API reference: See references/api-setup.md

### Audit Checklist

Quick health check for any Google Ads account:

CheckBrowser PathWhat to Look ForZero-conv keywordsKeywords → Filter: Conv<1, Cost>$500Wasted spendEmpty ad groupsAd Groups → Filter: Ads=0No creative runningPolicy violationsCampaigns → Status columnYellow warning iconsOptimization ScoreOverview page (top right)Below 70% = action neededConversion trackingTools → ConversionsInactive/no recent data

### Output Formats

When reporting findings, use tables:

## Campaign Performance (Last 30 Days)
| Campaign | Cost | Conv | CPA | Status |
|----------|------|------|-----|--------|
| Branded  | $5K  | 50   | $100| ✅ Good |
| SDK Web  | $10K | 2    | $5K | ❌ Pause |

## Recommended Actions
1. **PAUSE**: SDK Web campaign ($5K CPA)
2. **INCREASE**: Branded budget (strong performer)

### Browser Mode Issues

Can't see data: Check user is on correct account (top right account selector)
Slow loading: Google Ads UI is heavy; wait for tables to fully load
Session expired: User needs to re-login to ads.google.com

### API Mode Issues

Authentication failed: Refresh OAuth token, check google-ads.yaml
Developer token rejected: Ensure token is approved (not test mode)
Customer ID error: Use 10-digit ID without dashes
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jdrhyne
- Version: 1.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T20:39:39.582Z
- Expires at: 2026-05-10T20:39:39.582Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/google-ads)
- [Send to Agent page](https://openagent3.xyz/skills/google-ads/agent)
- [JSON manifest](https://openagent3.xyz/skills/google-ads/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/google-ads/agent.md)
- [Download page](https://openagent3.xyz/downloads/google-ads)