背景:GTMのClosure CompilerとES5制約
Google Tag Manager(GTM)のカスタムHTMLタグ内に <script> を記述する際、LLMにコードを生成させると const、アロー関数、テンプレートリテラルを含むES6+のコードが出力され、GTMの公開時に以下のコンパイルエラーで弾かれます。
Error: This language feature is only supported for ECMASCRIPT_2015 mode or better: const declaration.
GTMは内部のバンドラ(Google Closure Compiler)でカスタムHTML内のスクリプトを検証しており、デフォルトで ECMAScript 5(ES5)構文のみ を受け付けます。毎回手動で var や function に書き直す手間を省くため、Claude Code向けのSkillとしてルールと検証チェックリストをパッケージ化しました。
リポジトリと変換ルール
GitHub - ekusiadadus/claude-skill-gtm-javascript
Skillを読み込むと、GTM向けのスクリプト生成時に以下のES5制約が適用されます。
| 構文 | ES6+(GTMでエラー) | ES5(GTMで通過) |
|---|---|---|
| 変数宣言 | const, let | var |
| 関数定義 | () => {} | function() {} |
| 文字列結合 | `${var}` | 'str' + var |
| 分割代入 | const { a, b } = obj | var a = obj.a; var b = obj.b; |
| ループ | for (const x of arr) | for (var i = 0; i < arr.length; i++) |
ファイル構成
Skillは以下の4ファイルで構成しています。
SKILL.md— ES5コード生成の制約条件、即時実行関数式(IIFE)によるスコープ分離、例外ハンドリングの規約reference.md— ES6+ から ES5 への書き換えパターン一覧examples.md—dataLayer.push、GA4 Ecommerce、Consent Mode v2 のテンプレートchecklist.md— GTM プレビューモード(Tag Assistant)での発火確認手順
2024–2025年のGTM / GA4仕様変更への対応
古いスニペットをそのまま流用しないよう、直近の仕様変更もルールに含めています。
- Consent Mode v2(2024年3月〜):
ad_user_dataおよびad_personalizationパラメータの明示的な指定 - GA4 Ecommerce スキーマ: 旧UA(Universal Analytics)の
ecommerce.purchase.productsではなく、GA4標準のitems配列と事前の{ ecommerce: null }クリア処理 - IE11サポート終了(2024年7月): ES5構文自体はGTMコンパイラ通過のために必須である一方、IE11固有のDOMポリフィルは不要
インストール方法
グローバル環境に配置する場合:
git clone https://github.com/ekusiadadus/claude-skill-gtm-javascript.git ~/.claude/skills/gtm-javascript特定のリポジトリ内にのみ配置する場合:
mkdir -p .claude/skills
cp -r skills/gtm-javascript .claude/skills/生成されるコード例
GA4 purchase イベント
IIFE(即時実行関数)でグローバル汚染を防ぎ、直前の ecommerce オブジェクトを null でリセットしてから dataLayer.push を実行します。
(function() {
'use strict';
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
event: 'purchase',
ecommerce: {
transaction_id: 'T_12345',
value: 99.99,
currency: 'USD',
items: [{
item_id: 'SKU_001',
item_name: 'Product Name',
price: 99.99,
quantity: 1
}]
}
});
})();Consent Mode v2 デフォルト設定
window.dataLayer = window.dataLayer || [];
function gtag() { dataLayer.push(arguments); }
gtag('consent', 'default', {
ad_storage: 'denied',
ad_user_data: 'denied',
ad_personalization: 'denied',
analytics_storage: 'denied'
});ソースコードとテンプレート一式は github.com/ekusiadadus/claude-skill-gtm-javascript で公開しています。