{"id":23878812,"url":"https://github.com/justusbluemer/gtm-guidelines","last_synced_at":"2025-07-23T08:33:42.030Z","repository":{"id":223142476,"uuid":"118910718","full_name":"justusbluemer/gtm-guidelines","owner":"justusbluemer","description":"A collection of best practices for your daily Google Tag Manager routine","archived":false,"fork":false,"pushed_at":"2019-10-08T14:04:10.000Z","size":29,"stargazers_count":47,"open_issues_count":0,"forks_count":7,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-06-08T02:57:25.372Z","etag":null,"topics":["analytics","google","google-analytics","googletagmanager","gtm","tracking","web-analytics","webanalytics"],"latest_commit_sha":null,"homepage":"https://www.owntag.eu/resources/gtm-guidelines/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/justusbluemer.png","metadata":{"files":{"readme":"README.jp.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2018-01-25T12:34:34.000Z","updated_at":"2025-06-04T17:05:31.000Z","dependencies_parsed_at":"2024-02-18T16:01:54.979Z","dependency_job_id":null,"html_url":"https://github.com/justusbluemer/gtm-guidelines","commit_stats":null,"previous_names":["justusbluemer/gtm-guidelines"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/justusbluemer/gtm-guidelines","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justusbluemer%2Fgtm-guidelines","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justusbluemer%2Fgtm-guidelines/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justusbluemer%2Fgtm-guidelines/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justusbluemer%2Fgtm-guidelines/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/justusbluemer","download_url":"https://codeload.github.com/justusbluemer/gtm-guidelines/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justusbluemer%2Fgtm-guidelines/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266645150,"owners_count":23961658,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","google","google-analytics","googletagmanager","gtm","tracking","web-analytics","webanalytics"],"created_at":"2025-01-03T21:50:00.699Z","updated_at":"2025-07-23T08:33:41.979Z","avatar_url":"https://github.com/justusbluemer.png","language":null,"funding_links":[],"categories":["📦 Legacy \u0026 Inactive Projects"],"sub_categories":[],"readme":"# GTM ガイドライン      \n\nこのガイドラインは、[Google Tag Manager（GTM）](https://www.google.com/analytics/tag-manager/)ユーザーが実際に GTM を使用してトラッキング設定を実装する前に、認識、理解する必要事項を記載しています。    \nGTM は 誰でも使用できるシンプルな WYSIWYG トラッキングエディタとして提供されていると理解されていますが、GTM はユーザーにウェブサイト全体と、そのデータ、機能への無制限のアクセスを提供する強力なツールです。 大きな力があれば大きな責任が生まれます。このガイドラインは、複雑なトラッキング設定の設定指針を持つのに役立つはずです。  \n\n## JavaScript\n\nGoogle Tag Managerの JavaScript は、意図しない予期しない方法で Web サイトの JavaScript と干渉する可能性があります。 GTM の実装がサイトの円滑な運営に与える影響が少ないことを確認するために、次の基本的なガイドラインに従ってください。           \n\n### 匿名関数により、カスタム JavaScript を分離する      \n\nGTM の JS はグローバル空間を汚染してはいけません。 コードを匿名関数でラップすることで、必ず変数スコープを制限してください。          \n\n    // 良い例\n    (function() {\n        var foo = 'bar'\n    })()\n\n    // 悪い例\n    var foo = 'bar'\n\nページビューの処理期間で変数情報を保持する必要がある場合、または複数のタグから同じ変数にアクセスする必要がある場合は、dataLayer 変数を使用します。     \n\n    // 1st tag\n    (function() {\n        dataLayer.push({\n            foo: 'bar'\n        })\n    })()\n\n    // 2nd tag\n    console.log({{dl.foo}})\n\n### カスタム JavaScript変数 に関数を設定し、コードを再利用する\n\n単純な文字列または整数の代わりに、 関数自体を GTM 変数の結果として関数を返すことができます。      \n\n    // Custom JavaScript variable: js.double\n    function () {\n        var doubleSize = function(number) {\n            return number * 2\n        }\n        return doubleSize\n    }\n\n無名外部関数は他の関数、この例では `doubleSize` を返します。      \nその後、他のJavaScript ベースの GTM タグと変数の中で関数として{{js.double}}を使用できます。     \n\n    {{js.double}}(2)\n    // Output: 4\n\t\n### ウェブサイトのブラウザサポートガイドラインに従う      \n\nあなたのウェブサイト/あなたの会社が公式にサポートしているブラウザを把握してください。 残念ながら、まだ普及していないブラウザではサポートされていない JavaScript 機能がたくさんあります。 フォールバックやプログラムによるブラウザサポートの事前チェックを行わずにこれらを実装すると、トラッキング設定や Web サイトの機能自体が損なわれる可能性があります。   \n\n### 組み込みの機能 で十分な場合は、カスタムJavaScriptを使用しない    \nカスタム JavaScript は、Google Tag Manager の組み込みの機能よりもエラーが発生しやすいものです。 可能であれば、JavaScript の代わりに組み込みのタグテンプレートを使用してください。\n\n* トラッキングコードの実装を要求された場合は、GTM ネイティブのタグテンプレートがあるかどうかを確認する。   \n* if…else 構文の代わりにルックアップテーブル、または正規表現の表を使う。       \n\n### すべての機能を文書化する      \n\nJavaScript 関数を書くのであれば、[JSDoc3構文を使って](http://usejsdoc.org/about-getting-started.html)それらを文書化してください。    \n\n\t/**\n\t * Increases the supplied number by one\n\t * @param  {number} number The number to increase\n\t * @return {number}        The number increased by 1\n\t */\n\tfunction increaseByOne(number) {\n\t\treturn number + 1;\n\t}\n\n### JS エラーレポート を使用する    \n\nすべてのデバイス上のすべてのユーザーに、すべてのコードを問題なく動作させることは困難です。 考えられるすべての設定でGTMの実装をテストすることはできません。  \nテストが困難な状況下でのみ発生するバグを検出するには、Sentry、New Relic 等の JavaScript のエラー報告ツールを使用します。    \n\nJavaScriptエラーが発生するたびに検出され、問題の根本原因を評価できるデータベースに保存されます。\nJavaScriptエラー検出に自前のエラー報告ツールを使用しないでください、それらはあなたのビジネスとは関係ありません。         \n\n### 本番環境でconsole.logを使用しない\n\n本番環境では `console.log`を使わないでください。 不必要にあなたのコードとユーザーのブラウザコンソールの両方を雑然とさせます。    \nプレビューモードでの開発中は、デバッグ目的で自由に使用してください。         \n\n## セキュリティ    \n\n### サブリソース完全性 Subresource Integrity (SRI) を使用する   \n\nサードパーティのスクリプトを実装する場合は、気付かないうちにリソースが変更されないようにサブリソース整合性ハッシュを使用してください。     \n詳細については https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity を参照してください。   \n\n### コンテンツセキュリティポリシー（CSP）を要求する     \n\nコンテンツセキュリティポリシーでは、ブラウザがスクリプト、フォント、スタイルシートなどをロードできるホストを定義できます。 詳細については https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP を参照してください。    \nCSP はあなたのウェブサイト全体とフロントエンドの開発に大きな技術的影響を与えるので、すべての開発者が CSPの設定に関与する必要があります。    \nCSP はあなたが承認しなかった第三者の不正なスクリプトが突然実行されるのを防ぐことができます。        \n\n### 他の開発者に相談する         \n\n自分が何をしているのかよくわからない場合は、担当の1人以上のプロの JavaScript 開発者、または Web サイトで JavaScript をコーディングしている人に相談してください。 \n\n\n## dataLayer \n\n### ツール固有の dataLayer の命名と構造を使用しない    \n\ndataLayer 変数の名前は常にできるだけわかりやすいものにしてください。\nたとえ便利に見えるかもしれませんが、ツール固有のキーを使用しないでください。 ウェブサイトからツールロジックを分離することは、Google Tag Manager を使用することの最も重要な目標の1つです。      \n\n    // 良い例\n    dataLayer.push({\n        loginStatus: true\n    })\n\n    // 悪い例\n    dataLayer.push({\n        dimension17: 1\n    })\n\n必要に応じて、カスタム JavaScript 変数を使用して個々のツールのデータを前処理します。    \n\n### 個人を特定できる情報（PII）を dataLayer に設定しない     \n\n第三者が個人またはデバイスを識別するために使用できる情報は、dataLayer で使用しないでください。\nそれは電子メールと IP アドレスを含みます。\n\nあなただけが個人を特定できるのであれば、あなたの所有するユーザー ID を設定するのは問題ありません。しかし、それだとしてもあなたは最初にプライバシーの専門家に相談するべきです。      \n\n### Google Tag Manager から dataLayer に値を設定しない    \n\nほとんどの場合、GTM の外部と内部の両方からイベントが発生する可能性があるため混乱する可能性があるため、Google Tag Manager 内部のカスタム HTML / JS コードで `dataLayer.push`を使用することはお勧めできません。    \n\nタグ間の依存関係を実装しようとしている場合、又は、競争条件（タグをある順序で処理したいが、その順序を保証することができない状況）を避けたい場合には、可能な限り組み込みの[タグシーケンス](https://www.simoahava.com/analytics/understanding-tag-sequencing-in-google-tag-manager/)機能を使用してください。     \n\n## アクセス管理    \n\nコンテナの公開アクセス権限を持つユーザをできるだけ少なくします。 公開権限を必要としない人は読み取りアクセス権を設定すべきです。四半期ごとにユーザをより制限されたアクセスレベルに移動できるか、完全に削除できるかを確認します。       \n\n## ワークフロー\n\n### ワークスペース\n\n緊急の事態に備えて、「デフォルトワークスペース」は常に空のままにしてください。 突然バグ修正が必要になっても、以下を行う必要はありません。   \na) 空のワークスペースが残っていないという理由だけで、すでに行われている作業を犠牲にする。      \nb) バグ修正、動作確認、公開のため他の変更が行われたワークスペースを使用する。     \n\n１つの作業ごとに 1 つのワークスペースを使用します。1 つのワークスペースでさまざまな問題を解決しないでください。     \n\n### すべての設定に定数を使う      \n\n複数のタグが同じ設定値（トラッキングアカウント ID など）を使用したらすぐに、タイプが \"Constant\" の GTM 変数を作成し、それをタグから参照します。    \n\n### 必要な組み込み変数だけを有効にします     \n\n積極的に使用しているものだけをアクティブにしてください。 非アクティブな組み込み変数の値を計算する必要がないため、リソースを節約できます。     \n\n### バージョン名と Note(注意書き)    \n\n* すべてのバージョンに名前を付けます。バージョンの変更は、名前だけで直感的に明らかになります。技術的な詳細ではなく、変更による「ビジネスへの影響」に注目して名前を記載してください。 JIRA などのチケットまたはタスクシステムを使用している場合は、バージョン名にチケットID を含めます。     \n\n* 各バージョンのバージョンノートを書きます。 ノートには以下の内容を記載すべきです。    \n    * 誰が変更を要求したのか?       \n    * リリース前のトラッキング動作は正常か? 今の動作は正常か?      \n    * この GTM の実装が依存している Web サイトの変更はあったか？ もしそうなら、どんな変更か？        \n\n\n### フォルダ   \n\nフォルダーを使用して、目的別に要素をグループ化します。\n\n| Type          | Description                                                                 |\n| :------------ | :-------------------------------------------------------------------------- |\n| Ad Tech       | 広告技術、AdformやCriteoなどのサードパーティトラフィックパートナー |\n| Web Analytics | Google AnalyticsやWebtrekkなどのウェブ解析ソフトウェア          |\n| Utilities     | さまざまな目的に使用できるヘルパー関数と小さなスクリプト |\n\n## ネーミング\n\n### タグ\n\n### トリガー      \n\n`Type` `Description`\n\n| Type       | Description                                                                                                                                   |\n| :--------- | :-------------------------------------------------------------------------------------------------------------------------------------------- |\n| Conversion | 即座にビジネスにプラスの影響を与えるユーザーアクション                                                                                         |\n| Pageview   | ページビュー 実際のフルページロードなのか、それともSPAの新しい画面なのか区別しない |\n| Event      | 上記の種類のいずれにも一致しないカスタムGTMイベント                                                                        |\n| State      | ウェブサイトの特定の状態を説明し、通常はトリガーとしてではなく例外として使用される                                           |\n\n### 変数\n\n`type.[tool.]name`\n\n`type`は利用可能なさまざまな種類のGoogle Tag Manager変数を指します。 変数の型は `{{myVariable}}`のような参照を見てもすぐには見えないので、データがどこから来たのかを識別するのは困難です。    \n\n| Variable type             | Type value  |\n| :------------------------ | :---------- |\n| HTTP Referrer             |  ref        |\n| URL                       | url         |\n| 1st Party Cookie          | cookie      |\n| Custom JavaScript         | js          |\n| Data Layer Variable       | dl          |\n| JavaScript Variable       | global      |\n| Auto-Event Variable       | auto        |\n| DOM Element               | dom         |\n| Element Visibility        | vis         |\n| Constant                  | const       |\n| Custom Event              | custom      |\n| Environment Name          | env         |\n| Google Analytics Settings | settings    |\n| Lookup Table              | lookup      |\n| Random Number             | rnd         |\n| RegEx Table               | regexlookup |\n| Container ID              | gtm         |\n| Container Version Number  | gtm         |\n| Debug Mode                | debug       |\n\n`tool`は、1つのツールにのみ関連している（そして関連することになる）変数のオプションの部分です。 例えば、定数としての特定のサードパーティツールの1つのタグのためにデータを特定のフォーマット提供する JavaScript のデータ変換スクリプトに付与します。    \nこの場合の「tool」は、「adform」、「hotjar」、「kissmetrics」のような製品、または共通の略語「eec」を持つ Google Analytics Enhanced eコマースのような普遍的な概念のいずれかです。     \n\n`name`はこの変数を説明する名前です。 短くしても `type`や` tool`と組み合わせると、それが何を表しているのかすぐに理解できるはずです。    \n\n#### 変数名の例    \n\n* Adform 発行者 ID： `const.adform.id`    \n* ヤフーだけに関連する特定のフォーマットで商品データを提供する JavaScript のデータ変換スクリプト: `js.yahoo.productData`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustusbluemer%2Fgtm-guidelines","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustusbluemer%2Fgtm-guidelines","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustusbluemer%2Fgtm-guidelines/lists"}