skills.rest
cognyai
cognyaiOFFICIAL
Explore all skills by this author →
Website𝕏@cognyaiGitHub

gaql-reference

Build, validate, and execute GAQL queries for Google Ads data.

90|10|Updated Mar 25, 2026
Search Tags:#analytics#queries#reporting#campaigns#google-ads#gaql
One-click install
npx skills add https://github.com/cognyai/claude-code-marketing-skills --skill gaql-reference
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gaql-reference
Source: https://github.com/cognyai/claude-code-marketing-skills/tree/main/skills/gaql-reference
Command: npx skills add https://github.com/cognyai/claude-code-marketing-skills --skill gaql-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GAQL reference navigates the Google Ads Query Language landscape, helping users craft correct queries, identify available resources and fields, and avoid common syntax pitfalls.

Core Features & Use Cases

  • Comprehensive GAQL syntax coverage including resource types, fields, operators, and date macros
  • Ready-to-use query patterns for common reporting tasks (campaign performance, keyword insights, geographic breakdown)
  • API and MCP tool integration guidance to execute GAQL queries against Google Ads data

Quick Start

Run a basic GAQL query such as: SELECT campaign.name, metrics.impressions, segments.date FROM campaign DURING LAST_30_DAYS LIMIT 100

Frequently Asked Questions about gaql-reference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a GAQL query to retrieve Google Ads campaign performance metrics?▼

To write a GAQL query, use the SELECT statement to specify fields like campaign.name and metrics.impressions, define the source resource, and apply date macros like DURING LAST_30_DAYS to retrieve campaign performance data.

What resources and fields are available when building Google Ads query language statements?▼

Available resources and fields in Google Ads query language include campaigns, keywords, and reports, which expose specific metrics and segments for building targeted data retrieval statements.

Can I execute GAQL queries through an API or MCP tool integration?▼

Yes, you can execute GAQL queries by leveraging API and MCP tool integration guidance to directly query and retrieve your Google Ads data from the source.

What are common GAQL syntax pitfalls when querying Google Ads data?▼

Common GAQL syntax pitfalls include incorrect field selection, invalid resource references, and misapplied date macros. Using established query patterns helps avoid these errors and ensures valid data retrieval.

Related Skills

Explore More Data & Analytics Skills→
enowdevenowdev
13

google-ads-report

Retrieve Google Ads performance metrics via the Google Ads API and GAQL.

Community
Intermediate
stratagastrataga

paid-ads

Plan, create, and optimize paid ad campaigns across Google Ads, Meta, LinkedIn, and Twitter/X.

Community
Advanced
juanpvhjuanpvh

google-ads-ratos

Manage Google Ads campaigns and metrics using GAQL queries.

Community
Advanced
hanabi-jpnhanabi-jpn
3

google-ads-agent

Manage Google Ads campaigns via plain-English commands with GAQL and Keyword Planner API.

Community
Advanced