google-ads

The Google Ads skill provides a comprehensive bridge between your AI agent and the Google Ads advertising ecosystem. Built on top of the Membrane CLI, this tool abstracts away the complexities of OAuth authentication and API credential management, allowing users to interact directly with advertising data through a unified interface. It is designed for marketing professionals, data analysts, and developers who need to perform bulk campaign operations, retrieve performance metrics, or synchronize conversion data without navigating the manual Google Ads UI.

Key features and capabilities:

• Full campaign lifecycle management, including creating, updating, and removing campaigns, ad groups, and keyword targeting criteria.
• Advanced reporting and data extraction using GAQL (Google Ads Query Language) for complex cross-resource queries.
• Conversion tracking support, including the ability to upload offline conversion data to refine your audience models and bidding strategies.
• Account administration, such as listing accessible customer accounts and fetching detailed account-level metadata.
• Extensibility through the Membrane proxy, which allows for direct interaction with any Google Ads API endpoint, ensuring that even the most niche API requirements are supported.

Usage notes and practical tips:

• Always prefer the pre-built actions provided by Membrane for common tasks, as they incorporate built-in error handling, pagination, and type-safe input schemas, which significantly reduce the risk of runtime errors.
• Utilize the action discovery command by running membrane action list with a specific intent to find the exact action ID before initiating operations.
• When performing large-scale data updates, ensure that your GAQL queries are optimized to prevent hitting API rate limits.
• The skill maintains secure communication; credentials are managed server-side by Membrane, so you never need to manually handle or expose API keys or refresh tokens within your local repository.
• When standard actions do not meet your specific requirement, use the proxy request feature with defined HTTP methods like POST or PATCH to interact directly with the Google Ads API base path.