google-ads

What This Skill Does

The Google Ads skill for OpenClaw provides a secure, streamlined interface for interacting with the Google Ads API. It abstracts the complexities of OAuth 2.0 flow, developer token management, and credential rotation. By utilizing the Maton.ai gateway, this skill allows users to execute GAQL (Google Ads Query Language) queries to retrieve real-time data on campaigns, ad groups, keywords, and granular performance metrics. It acts as a specialized proxy that injects necessary headers automatically, ensuring your queries hit the Google Ads infrastructure without manual token handling.

Installation

To integrate this capability into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/byungkyu/google-ads-api

Once installed, ensure your MATON_API_KEY environment variable is exported to your shell session. You must then establish a connection by visiting https://ctrl.maton.ai or using the provided API commands to initialize the Google Ads OAuth handshake. Once authorized, the skill is ready for use.

Use Cases

• Automated Reporting: Generate daily or weekly performance summaries for stakeholders without manual dashboard configuration.
• Campaign Optimization: Identify underperforming keywords or ad groups by querying CTR and conversion data through GAQL.
• Account Auditing: Programmatically verify account status, active campaigns, and budget pacing across multiple customer IDs.
• Data Pipelines: Export structured performance metrics directly into local databases or analysis tools via scriptable endpoints.

Example Prompts

1. "List all active campaigns in my account and show me their current impressions, clicks, and average CPC for the last 30 days."
2. "Find the top 10 keywords by conversion rate for my 'Search' campaign using GAQL and export them to a list."
3. "Check the current status and daily budget of all ad groups within my main account ID."

Tips & Limitations

• GAQL Mastery: Proficiency in GAQL (Google Ads Query Language) is highly recommended. Refer to Google's official documentation for field availability.
• Connection State: If your queries return 401 Unauthorized, verify your connection status at https://ctrl.maton.ai to ensure the token has not expired.
• Permissions: Ensure the Google account linked via OAuth has the appropriate read/write permissions for the specific Customer IDs you intend to query.
• API Limits: Be mindful of Google's API rate limits. While the gateway handles routing, the underlying Google Ads API limits still apply to your specific developer credentials.