Gaql Reference

Google Ads Query Language (GAQL) Reference — complete syntax, resource types, fields, operators, date macros, and ready-to-use query patterns

114 stars 16 forksMarketing, Sales & Business

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference
Manual install
git clone --depth 1 https://github.com/cognyai/claude-code-marketing-skills.git /tmp/claude-code-marketing-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-code-marketing-skills/skills/gaql-reference ~/.claude/skills/gaql-reference

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Google Ads Query Language (GAQL) Reference

Complete reference for GAQL syntax, resource types, fields, operators, date macros, and common query patterns for Google Ads reporting and optimization.

Full docs: https://cogny.com/docs/gaql-reference

## Usage

```
/gaql-reference                           # Show full syntax overview
/gaql-reference search terms              # Search terms report pattern
/gaql-reference quality score             # Quality Score analysis query
/gaql-reference impression share          # Budget & impression share query
/gaql-reference geographic                # Geographic performance query
/gaql-reference change history            # Change history audit query
```

## Instructions

You are a Google Ads Query Language (GAQL) expert. Use this reference to help users write correct GAQL queries, understand resource types, choose the right fields, and avoid common pitfalls.

When the user asks a question, find the relevant section below and provide precise, actionable answers with ready-to-use GAQL examples.

If the user provides a specific topic as an argument, focus on that area. Otherwise, provide an overview of the GAQL syntax and available resources.

When the user has Cogny MCP tools available, prefer using `mcp__cogny__mcp__Google_Ads__tool_execute_gaql` to run queries directly and `mcp__cogny__mcp__Google_Ads__tool_get_gaql_doc` or `mcp__cogny__mcp__Google_Ads__tool_get_reporting_view_doc` for API documentation lookups.

## Run it live
Read the full skill on GitHub

Details

Skill name
gaql-reference
Path
skills/gaql-reference/SKILL.md
Repo updated
12 October 2026

FAQ

What does the Gaql Reference skill do?

Google Ads Query Language (GAQL) Reference — complete syntax, resource types, fields, operators, date macros, and ready-to-use query patterns

How do I install the Gaql Reference skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Gaql Reference popular?

It lives in cognyai/claude-code-marketing-skills, which has 114 GitHub stars and 16 forks, and is included in 3 curated skill lists.

Related skills

Ad Copy Writer

114

cognyai/claude-code-marketing-skills

Generate ad copy variations for Google, Microsoft, Meta, LinkedIn, TikTok, Reddit, Snapchat and X Ads (plus Apple Search Ads guidance)

Marketing, Sales & BusinessIn 3 lists16

Ad Kill Rules

114

cognyai/claude-code-marketing-skills

Enforce a pre-declared evidence bar on every ad — after it spends enough, pause it if it misses (e.g. CTR < 1% or cost per lead over cap) across Meta, TikTok, LinkedIn, Google and Bing — as a dry-run report, an approved pause, or a scheduled pause-only Cogny script

Marketing, Sales & BusinessIn 3 lists16

Brand Kit

114

cognyai/claude-code-marketing-skills

Build a portable brand-kit.json for the user's product — colors, typography, voice — that other skills (video, ad creative, landing page) can consume. Multiple discovery paths so it works whether the user has access to their site's source code or only a public URL or just a logo image.

Frontend & DesignIn 3 lists16

Google Ads Audit

114

cognyai/claude-code-marketing-skills

Deep Google Ads account audit — keywords, quality scores, budget pacing, search terms

Marketing, Sales & BusinessIn 3 lists16

Demand Gen Audit

114

cognyai/claude-code-marketing-skills

Google Ads Demand Gen audit — audience strategy, creative format diversity, creative freshness, placements, CPA vs goal

Marketing, Sales & BusinessIn 3 lists16

Google Ads Audit

114

cognyai/claude-code-marketing-skills

Comprehensive Google Ads account audit (Microsoft Ads side by side when connected) — campaign structure, budget pacing, conversion tracking, wasted spend — across every campaign type, ranked by estimated $ impact

Marketing, Sales & BusinessIn 3 lists16

Browse the most popular Claude skills, all marketing, sales & business skills, or write your own with the skills generator.