ga4-bigquery-schema — скилл для Claude Code
Справочник по схеме экспорта GA4 в BigQuery: вложенные поля, готовые SQL-запросы и советы по производительности. Пригодится, когда нужно разобрать event_params или собрать воронку.
npx skills add cognyai/claude-code-marketing-skills --skill ga4-bigquery-schema -a claude-codeЧто делает ga4-bigquery-schema
Скилл отвечает на вопросы про структуру экспорта GA4 в BigQuery и даёт готовый SQL. Внутри — разбор верхнеуровневых полей (event_date, event_name, user_pseudo_id, ecommerce, items), вложенных структур event_params и user_properties, а также типовые шаблоны запросов: воронка конверсии, поля электронной коммерции, извлечение параметров события через UNNEST.
Вызов идёт как слэш-команда с аргументом-темой: /ga4-bigquery-schema event_params разбирает структуру параметров, /ga4-bigquery-schema conversion funnel показывает шаблон воронки. Без аргумента скилл выдаёт обзор схемы. Среди разрешённых инструментов — WebSearch, Read, Write, Bash и набор read-only вызовов Cogny MCP: list_datasets, list_tables, inspect_schema, execute_bigquery_sql, плюс инструменты Google Analytics 4 для сверки отчётов.
Запросы к BigQuery через MCP работают только в облачном режиме Cogny. На Solo скилл отдаёт SQL и на этом останавливается. Перед написанием запроса стоит вызвать inspect_schema на одной дневной таблице: наборы ключей в event_params и user_properties у каждого ресурса свои, и без этой проверки запрос легко уедет в пустой результат.
Какие задачи решает
- разобрать структуру
event_paramsи вытащить нужный ключ черезUNNEST - написать SQL для воронки конверсии по событиям GA4
- найти поля электронной коммерции в экспорте и связать их с
items - сверить счётчики событий из экспорта с отчётом в интерфейсе GA4
- проверить реальную схему дневной таблицы перед запросом
Примеры запросов агенту
- Покажи структуру
event_paramsи как достатьpage_location - Дай шаблон запроса для воронки конверсии по событиям
- Объясни поля
ecommerceв экспорте GA4
Как установить ga4-bigquery-schema
1Через Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill ga4-bigquery-schema -a claude-code2Вручную: положить файлы
~/.claude/skills/ga4-bigquery-schema/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ga4-bigquery-schema/
1Через Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill ga4-bigquery-schema -a codex2Вручную: положить файлы
.agents/skills/ga4-bigquery-schema/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill ga4-bigquery-schema -a cursor2Вручную: положить файлы
.cursor/skills/ga4-bigquery-schema/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cognyai/claude-code-marketing-skills ga4-bigquery-schema2Вручную: положить файлы
.github/skills/ga4-bigquery-schema/SKILL.md1Через Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill ga4-bigquery-schema -a gemini-cli2Командой платформы
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skills/ga4-bigquery-schemaВручную: положить файлы
.devin/skills/ga4-bigquery-schema/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill ga4-bigquery-schema -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ga4-bigquery-schema
Как установить ga4-bigquery-schema в Claude Code?
Выполните npx skills add cognyai/claude-code-marketing-skills --skill ga4-bigquery-schema -a claude-code. После этого файл скилла лежит в ~/.claude/skills/ga4-bigquery-schema/SKILL.md.
Что делает ga4-bigquery-schema?
Это справочник по схеме экспорта GA4 в BigQuery: верхнеуровневые поля, вложенные структуры, шаблоны запросов и советы по производительности. Скилл помогает писать корректный SQL против этих данных.
Нужен ли доступ к BigQuery, чтобы скилл работал?
Нет. Все запросы в справочнике можно скопировать и выполнить самому. Вызовы BigQuery через MCP доступны только при подключённом облаке Cogny, и там они ограничены read-only SELECT.
