> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Tag Managerを設定する

> Google Tag ManagerのNotiflyテンプレートでSDKの初期化、ユーザー情報とイベントの連携を設定する方法を説明します。

Google Tag Manager（GTM）にNotiflyのカスタムテンプレートを追加すると、アプリケーションのコードを変更せずに、SDKの初期化、ユーザー情報、イベントの連携を設定できます。

## 1. Notiflyのカスタムテンプレートをインストールする

1. 最新のテンプレートをダウンロードします。
   [リリースページ](https://github.com/notifly-tech/notifly-gtm-template/releases)からテンプレートをダウンロードします。
   * 韓国語版（`template.ko.tpl`）
   * 英語版（`template.tpl`）。以降の手順では英語版を使用します。
2. GTMの左側メニュー下部にある**テンプレート**を開き、**タグ テンプレート**で新しいテンプレートを作成します。一覧が空の場合は、**タグ テンプレートを追加**をクリックします。

   ![テンプレートを新規作成](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/cafe24/gtm-import-1.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=24e51f079ee7f7e4eaa48fc540feb22b)
3. テンプレートエディターの右上の「**⋮ > インポート**」を選択し、ダウンロードした`.tpl`ファイルを読み込みます。

   ![テンプレートをインポート](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/cafe24/gtm-import-2.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=39f3b0182a3db54a016d3c1ffb0a8c0f)
4. **保存**をクリックします。左下に「テンプレートを作成しました」と表示されたら、インストールは完了です。

   ![テンプレートの作成完了](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-import-3.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=81c1c5fe76e00d7f0ace6b26f7e0fd06)

## 2. SDK初期化タグを作成する

1. Google Tag Managerの左側メニューで**タグ**を開き、**新規**をクリックします。
2. タグに名前を付け、**タグの設定**をクリックします。
3. タグタイプ一覧の一番下にある**カスタム**から**Notifly Javascript SDK**を選択します。

   ![カスタムテンプレートの選択](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-init-1.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=6c6756fba317a4aee78eb7ffb8a64d7a)
4. タグの設定を開き、**Tag Type**から**Initialize (initialize)**（韓国語版は **SDK 초기화 (initialize)**）を選択し、**Project ID**と**Username**を入力します。**Password**は後方互換性のためのプレースホルダーです。実際のパスワードやAPI Secret Keyは入力せず、**Username**と同じ空でない値を入力してください。[Notifly SDKの初期化オプション](https://docs.notifly.tech/ja/developer-guide/javascript-sdk.md#2-sdkを初期化する)を参照してください。

   ![タグタイプ](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-init-2.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=5578194ee0655d4ef0c325240eb0c171)
5. 詳細設定

* **タグ呼び出しオプション**を**1 ページにつき 1 度**に設定します。
* トリガーを**Initialization - All Pages**に設定します。

  ![詳細設定](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-init-3.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=cba05c54378695d70baa7868599bb635)

  ![トリガー](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-init-4.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=7badf646fdb295b94f23fe821212a27a)

## 3. ユーザー情報を管理する

キャンペーンのターゲティングやパーソナライズに使用する`userId`と`userProperties`を設定します。プッシュ通知の受信同意なども`userProperties`に保存し、条件で絞り込むことができます。

> [!NOTE]
>
> 必ず**SDK初期化タグ**を先に実行してください。

### 1. ユーザーIDを設定する（setUserId）

1. **タグ > 新規**からタグを作成し、**Notifly – setUserId**などの名前を付けて**タグの設定**をクリックします。

2. **Tag Type**で**Set User ID (setUserId)**（韓国語版は **유저 아이디 등록 (setUserId)**）を選択し、ユーザーIDの入力欄に`{{User ID}}`などの[GTM変数](https://support.google.com/tagmanager/answer/7683362)を指定します。\\

   ![タグタイプ](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-set-user-id-1.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=45b938cd257b5e1e821d90b41753abd6)

3. **タグの順序付け**で、SDK初期化タグを先に実行するよう設定します。**初期化タグが実行されていないと、ほかのタグは動作しません。**

   ![タグの順序付け](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-set-user-id-2.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=85e9b93ac24c8f42ce8b26bcd6282e68)

4. ログイン完了時のカスタムイベント（例: `login_success`）をトリガーに使用します。

   ![トリガー](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-set-user-id-3.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=d6da60083f957f5aa81c70a73ace038b)

### 2. ユーザー属性を設定する（setUserProperties）

> [!NOTE]
>
> **機密性の高いユーザー属性を送信する前に**
>
> 氏名や住所など、保護が必要なカスタムユーザー属性は、データの送信前にコンソールの**ユーザー管理** > **ユーザー一覧**の**属性管理**で送信するキーと同じ名前で登録し、暗号化を有効にしてください。
>
> 設定方法と利用時の制限は、[属性管理ガイド](https://docs.notifly.tech/ja/user-guide/users/properties.md)を参照してください。

1. **タグ > 新規**からタグを作成し、**Notifly – setUserProperties**などの名前を付けて**タグの設定**を開きます。

2. **Tag Type**で**Set User Properties (setUserProperties)**（韓国語版は **유저 속성 등록 (setUserProperties)**）を選択し、登録する属性に対応する[GTM変数](https://support.google.com/tagmanager/answer/7683362)を割り当てます。

   ![タグタイプ](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-set-user-props-1.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=6709b7cefcd61c785801871f3d722397)

3. **タグの順序付け**で、`setUserId`の後に`setUserProperties`が実行されるよう設定します。

   ![タグの順序付け](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-set-user-props-2.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=942b9d59626073d2bfd17fb24a6a9ead)

> [!NOTE]
>
> * メール配信には`$email`、カカオアリムトーク、カカオフレンドトーク、SMSの配信には`$phone_number`、LINEメッセージの配信には`$line_user_id`の予約キーが必要です。
> * 予約キーは、`$email`、`$phone_number`、`$line_user_id`のように、指定された表記どおりに使用してください。

> [!WARNING]
>
> ログアウト時に実行する\*\*Set User ID (setUserId)\*\*タグでは、**User ID**を空欄にします。現在のデバイスとユーザーの関連付けが解除されます。

## 4. イベントを記録する（trackEvent）

クリック、閲覧、購入などのユーザー行動をイベントとして送信し、セグメント分け、トリガー、効果分析に利用します。

> [!NOTE]
>
> * イベントタグが**SDK初期化タグの実行後**に動作するように、タグの順序付けを設定してください。
> * **Set of Keys for User Segmentation**（`segmentationEventParamKeys`）には、キーを**最大1つ**追加できます。

1. **タグ > 新規**からタグを作成し、**Notifly – trackEvent**などの名前を付けて**タグの設定**を開きます。
2. **Tag Type**で**Track Event (trackEvent)**（韓国語版は **이벤트 로깅 (trackEvent)**）を選択し、イベント名を入力します。必要に応じて、イベントパラメーターにGTM変数を割り当て、**Set of Keys for User Segmentation**にキーを追加します。

   ![タグタイプ](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-track-event-1.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=dbf1c5a548117bbdda6c46e2744df8f9)
3. **タグの順序付け**で、SDK初期化タグの後に実行されるよう設定します。
4. たとえば、GTMのクリックIDを取得する[組み込み変数](https://support.google.com/tagmanager/answer/7182738)（画像の例では `Click ID`）を使い、[組み込みトリガー](https://support.google.com/tagmanager/answer/7679320)で全要素のクリックを指定して、クリックされた要素の`id`を`element_id`として送信します。`element_id`を**Set of Keys for User Segmentation**にも追加します。

   ![変数](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-track-event-2.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=d6b1b16105f6a932dfa03912b42f1ffe)

   ![イベントトリガー](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/gtm/gtm-track-event-3.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=00bcfce41222069a6adeb2d2a9121c8b)

## 5. 連携をテストする

SDKのインストール後、以下のページで実際のイベント収集とプッシュ通知の受信をテストしてください。\
[連携をテストする](https://docs.notifly.tech/ja/integration-test.md)

## 6. Webプッシュ通知を設定する（応用）

* Webプッシュ通知を使用するには、Google Tag Managerの設定に加えて、Webサイトにスクリプトを追加する必要があります。
* [JavaScript SDKガイドのWebプッシュ設定](https://docs.notifly.tech/ja/developer-guide/javascript-sdk.md#1-基本設定)を参照し、サイトに`notifly-service-worker.js`を追加してください。
* 連携に関するご質問は、[contact@notifly.tech](mailto:contact@notifly.tech)までメールでお問い合わせください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.