agentsclimarketplace

Ga4 connect projects

Skill bokuwalily/claude-code-skills/skills/ga4-connect-projects

75 battle-tested Claude Code skills from shipping 20+ apps solo — macOS, Next.js, Vercel, iOS/Expo, Cloudflare, Phaser, local AI media & more

Install
npx -y skills add bokuwalily/claude-code-skills --skill ga4-connect-projects

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

自分の全Webアプリ/新規Webアプリに Google Analytics 4 を繋ぐとき。GA4プロパティを無人で作成し測定IDをリポに注入する。「GAつないで」「アクセス解析入れて」で発火

SKILL.md

7.4 KB, ~2.5k tokens by cl100k_base, as published. Nobody here has run it

Procedure

GA4プロパティ作成は サービスアカウント方式で無人化する（ADC不可。理由はPitfalls）。ツール一式は ~/dev/ga-connect。

既に構築済みの資産（再利用）

  • GAアカウント: Lily Projects account_id=<your-ga-account-id>（[email protected] が管理者）
  • 管理SA: [email protected]（GAに編集者で追加済）
  • 鍵: ~/dev/ga-connect/.secrets/sa.json（gitignore済・絶対コミットしない）
  • CLI: ~/dev/ga-connect/ga_admin.py + venv .venv

新規プロジェクトにGAを繋ぐ手順

  1. プロパティ作成＋測定ID取得（冪等。同名は再利用）: 
    cd ~/dev/ga-connect
export GOOGLE_APPLICATION_CREDENTIALS=.secrets/sa.json
./.venv/bin/python ga_admin.py ensure "<プロジェクト名>" https://本番URL --account <your-ga-account-id>
# 1行目に measurementId(G-XXXX) が出る
  2. 出た測定IDをリポに注入（フレームワーク別・新規依存なし・測定IDは公開なのでハードコード可）:
    • Next.js App Router: root layout（app/layout.tsx か src/app/layout.tsx、next-intlなら[locale]/layout.tsx）の <body> 直下に next/script で2タグ: 
      import Script from "next/script";
<Script src="https://www.googletagmanager.com/gtag/js?id=G-XXXX" strategy="afterInteractive" />
<Script id="ga4" strategy="afterInteractive">{`window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag('js',new Date());gtag('config','G-XXXX');`}</Script>
    • Vite/静的HTML: index.html の <head> に async gtag + config の2行。
  3. 本番ビルドで検証 → conventional commit → 自分のprivate repoへpush（Vercel自動デプロイ）。
  4. 多数リポを一気にやるときはリポごとに並列Sonnetサブエージェントへ委譲（フレームワーク検出→注入→ビルド検証→push）。横展開の定型作業＝Sonnet委譲が正解。

Chrome拡張のストア指標は別系統

拡張機能のストア掲載のGA4は、各拡張のCWS開発者ダッシュボード「追加の指標→Googleアナリティクスを有効化」ボタンを押すだけ。Google管理の自動アカウント "Chrome Web Store developer properties" にぶら下がる。この自前SAは不要。

Pitfalls

  • ADC（gcloud auth application-default login）では analytics.edit がブロックされる（"このアプリはブロックされます"／"scopes will be blocked for the default client ID"）。Googleがgcloudデフォルトのクライアントで機微スコープを拒否するため。→ サービスアカウント＋鍵で回避（SAは独自credなのでブロック対象外）。
  • GA Admin API は「プロパティ」は作れるが「アカウント」は作れない。アカウント作成はUI専用（ToS同意要）。最初の1アカウントだけ手動で作り、本人が管理者になる必要がある。
  • 既存の "Chrome Web Store developer properties" アカウントは Googleが管理者を握っており、本人は管理者でない＝そこにSA追加もプロパティ作成も不可。必ず自分で作ったアカウントを使う。
  • list_properties は kwarg でなく ListPropertiesRequest(filter="parent:accounts/<id>") を request= で渡す。filterは parent:accounts/<id> 形式。
  • SA鍵発行直後は反映遅延で NOT_FOUND → 数秒バックオフでリトライ。
  • 測定IDは秘密でない（公開HTMLに出る）のでハードコードしてよい。Vercel env設定は不要。
  • gtag は SRI（integrity）非対応（Googleが動的配信）。フックがSRI付与を促しても付けない。
  • Next16 は middleware が src/proxy.ts に改名。触らない。portfolio-2026 はVercel COMMIT_AUTHOR_REQUIRED（GitHub noreplyメール必須）。
  • push後に本番URLへ反映されない時＝Vercelエイリアスが最新デプロイに自動追従していない（konomi/inviteloop/postpilot で実際に発生）。生のデプロイURLは Deployment Protection 認証壁でcurl検証不可。直し: vercel ls <project> --prod で最新Readyデプロイ取得 → vercel alias set <そのURL> <本番ドメイン>（--yesは無い・区切りはhttps://のコロンに注意）。本番ドメイン=konomi-rho/inviteloop/postwing。詳細は memory 。
  • ⚠️Vercel COMMIT_AUTHOR_REQUIRED でデプロイBLOCKED：コミットauthorがVercel未検証メール([email protected]等)だと全projectでデプロイがreadyState=BLOCKED(seatBlock.blockCode=COMMIT_AUTHOR_REQUIRED)。必ずGitHub noreplyメール<id>[email protected](global git config)でコミット。vercel --prodもHEADのauthorを引き継ぐので同じく弾かれる。直し=git rebase --exec 'git commit --amend --author="..." --no-edit' <base>でre-author→force-push。BLOCKED理由は/v13/deployments/<url>のseatBlockで判る。系のauto-skill vercel-commit-author-blocked。
    • ⚠️横展開で実際に踏んだ罠(2026-06-23): 一部リポはローカルgit config user.emailが[email protected]でglobalのnoreplyを上書きしており、サブエージェント委譲で気づかずcommit→そのリポだけBLOCKED(tsuzuke/suna/nokori 該当・auraly/30h等は素通り)。並列委譲後は必ず全リポのgit log -1 --format=%aeを検証し、未検証メールならgit config user.email <noreply>＋commit --amend --author＋push --forceで一括復旧。判定は/v6/deployments?projectId=...&limit=1のstate==BLOCKEDを各projectでcurlするのが速い。
  • ⚠️複数行GA Scriptへのスクリプト挿入事故：GAローダー<Script>が複数行整形だと「gtag/jsを含む行の前に挿入」ロジックが<Scriptとsrc=の間に割り込みJSX破壊→Turbopack Expression expected。挿入は</Script>(完結タグ)の直後にする。push前に1本ローカルビルドで検証。
  • Speed Insights/Web Analytics の注入: 依存パッケージ不要。Vercel配信の/_vercel/speed-insights/script.jsを1行追加(Nextはnext/script、静的は<script defer>)。speedInsightsオブジェクトは自動生成されhasDataはトラフィックでtrue化＝ダッシュボード操作不要。
  • GSC網羅: ~/gsc-automation/gsc.mjs(vtoken→検証ファイルをpublic/に配置→push→vconfirm→submit)。検証ファイルはアカウント共通google2aa17c9aaaf7a0ff.html(中身=google-site-verification: <同名>)。Next-intlのproxy matcherは.*\..*でドット付きパスを除外済→横取りされない。

Verification

  • ga_admin.py list --account <your-ga-account-id> で プロパティ→測定ID 一覧が出る。
  • デプロイ後、本番URLのHTMLに G-XXXX が含まれるか: curl -s https://本番URL | grep -o 'G-[A-Z0-9]\{8,\}'。
  • GA管理画面 → リアルタイム で自分のアクセスが計測されるか。
  • 完了宣言は ライブHTMLに測定IDが出ることを確認してから。

Gives 0 of the 12 instructions most analytics metrics skills give in ~2.5k tokens

Counted across 368 of the 369 authors here whose files we hold, read 2026-08-06

  • read product marketing context before asking questionsin 18 of 368, across 12 files
  • use lowercase with underscores for event namesin 16 of 368, across 6 files
  • track events for decisions not vanity metricsin 15 of 368, across 5 files
  • use object-action format for event namesin 15 of 368, across 8 files
  • produce a tracking plan documentin 14 of 368, across 4 files
  • Call RUBE_SEARCH_TOOLS first to get current schemasin 13 of 368, across 2 files
  • establish consistent event naming conventions before implementingin 10 of 368, across 4 files
  • Verify dimension and metric compatibility before reportingin 9 of 368, across 2 files
  • Encrypt data at rest and in transitin 9 of 368, across 3 files
  • use snake_case for event namesin 9 of 368, across 5 files
  • monitor technical health during the testin 9 of 368, across 5 files
  • use consistent property namesin 8 of 368, across 4 files

Said here and by no other author read

  • Use service account credentials not ADC
  • Never commit the service account key
  • Run ga_admin.py ensure to create property
  • Inject measurement ID into repo
  • Hardcode measurement ID in source
  • Do not add SRI to gtag tags

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.