> ## Documentation Index > Fetch the complete documentation index at: https://moengage.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # AMP イベント分析の設定と統合 > MoEngage AMP 分析プラグインを使用して、AMP ページでユーザー属性とイベントをトラッキングします。 MoEngage AMP イベント分析プラグインは、ユーザー属性とイベントのトラッキング、およびサードパーティの JavaScript の実行に役立ちます。MoEngage AMP イベント分析プラグインは、ユーザー属性とイベントをトラッキングする際の、AMP ページと HTML ページの制限の違いに対処します。 MoEngage AMP イベント分析プラグインは、AMP 分析モジュールとは異なります。 AMP ページにイベントのトラッキングとユーザー属性のトラッキングを追加するには、次の手順に従います。 ## AMP 分析スクリプトの追加 AMP 分析を使用してユーザー属性とイベントをトラッキングしたいすべての AMP ページで、.amp ファイルの `` セクションにスクリプトを必ず含めてください。 ```HTML HTML lines wrap theme={null} ``` ### HTML 内の任意の場所に追加 ```HTML HTML lines wrap theme={null} ``` 注意 Your\_Workspace\_ID は、MoEngage ダッシュボード -> Settings -> App -> General Settings にある実際の Workspace Id に必ず置き換えてください。 dataCenter の詳細については、サポートチームにお問い合わせください。注意データをテスト環境にリダイレクトするには、appId に '\_DEBUG' を付加します。たとえば、appId が \ YOUR\_WORKSPACE\_ID の場合、テスト環境では YOUR\_WORKSPACE\_ID\_DEBUG になります。 ## ユーザーのトラッキング上記の手順を実施すると、AMP ページにアクセスするすべてのユーザーが自動的にトラッキングされます。\ ただし、これらのユーザーはデフォルトで匿名ユーザーになります。\ ただし、以前に通常の HTML ページにアクセスし、Cookie を削除していない Web サイトのユーザーは、AMP ページでも同じユーザーとして扱われます。 ## イベントのトラッキング上記の手順を実施した場合、Page Viewed イベントはデフォルトでトラッキングされます。\ ただし、AMP フレームワークにはイベントのトラッキングに関する制限があるため、トラッキングできるのは `Page Viewed`、`Element Clicked`、`Page Scroll` など、一部の種類のイベントのみです。イベントの一覧の詳細については、[AMP Analytics Examples](https://amp.dev/documentation/examples/components/amp-analytics/) を参照してください。 ### 例 1: 要素のクリックイベント次のように、id が `test` の HTML 要素がクリックされたときのクリックイベントをトラッキングできます。 ```HTML HTML lines wrap theme={null} ``` | パラメーター | 説明 | | - | - | | `on` | イベントのタイプ | | `selector` | 標準の CSS セレクター | | `request` | 常に event である必要があります | | `a` | イベント属性。この例では、`title` が属性です。ボタン要素の `data-vars-title` を使用して、変数 `title` の変更を確認してください。 | | `e` | イベント名 | ### 例 2: ページスクロールイベント ```HTML HTML lines wrap theme={null} ``` スクロールイベントには、`verticalBoundaries` と `horizontalBoundaries` を含む `scrollSpec` オブジェクトが必要です。スクロールイベントを発生させるには、2 つのプロパティのうち少なくとも 1 つが必要です。両方のプロパティの値は、スクロールイベントが生成される境界を含む数値の配列である必要があります。たとえば、上記のコードスニペットでは、ページが垂直方向に 25%、50%、90% スクロールされたときにスクロールイベントが発生します。ここで送信される属性は `scrolledUpto` で、ユーザーが上端からスクロールしたピクセル数を示す組み込み変数 `scrollTop` を保持します。サポートされているすべての変数の一覧の詳細については、[Supported Variables](https://github.com/ampproject/amphtml/blob/main/docs/spec/amp-var-substitutions.md) を参照してください。 ### 例 3: フォーム送信イベント ```HTML HTML lines wrap theme={null} ``` 上記の例では、フォームの id をセレクターの値 (**#testForm**) として設定しています。"extraUrlParams" 内の "e" はイベント名で、"a" にはこのイベントでトラッキングしたいキーと値が含まれます。 ## ユーザー属性のトラッキング重要アカウントでユーザー属性が ID として設定されている場合は、このセクションで示すように単にユーザー属性としてトラッキングするのではなく、[ログイン](#tracking-user-login-and-logout)の一部としてトラッキングしてください。詳細については、[こちらのドキュメント](https://www.moengage.com/docs/user-guide/data/user-data/unified-identity-identity-resolution)を参照してください。 "EVENT\_ACTION\_USER\_ATTRIBUTE" イベントを使用してユーザー属性をトラッキングできます。たとえば、Web サイトに次のボタンがあるとします。 ```HTML HTML lines theme={null} ``` この場合、名 (ユーザーの名とみなします) を次のようにトラッキングします。 ```HTML HTML lines wrap theme={null} ``` 同様に、以下のボタンをクリックしたときにユーザーのメールアドレスをトラッキングするには、次のようにします。 ```HTML HTML lines theme={null} ``` ```HTML HTML lines wrap theme={null} ``` 同じ方法で、他の**事前定義済みのユーザー属性**もトラッキングできます。 ```HTML HTML lines wrap theme={null} ``` ```HTML HTML lines wrap theme={null} ``` ここで、USER\_ATTRIBUTE\_NAME は次のいずれかに置き換える必要があります。 ```javascript JavaScript lines wrap theme={null} USER_ATTRIBUTE_USER_EMAIL //for user email - value needs to be string, eg: "dom@level5.com" USER_ATTRIBUTE_USER_NAME //for user name - value needs to be string, eg: "Dominick (Dom) Cobb" USER_ATTRIBUTE_USER_FIRST_NAME //for user first name - value needs to be string, eg: "Dominick" USER_ATTRIBUTE_USER_LAST_NAME //for user last name - value needs to be string, eg: "Cobb" USER_ATTRIBUTE_USER_MOBILE //for user mobile - value needs to be string, eg: "+12399999999" USER_ATTRIBUTE_USER_GENDER //for user gender - value needs to be string, eg: "M" USER_ATTRIBUTE_USER_BDAY //for user birthday - value needs to be in date format, eg: new Date(1980, 2, 31) ``` **カスタムユーザー属性**をトラッキングするには、USER\_ATTRIBUTE\_NAME の代わりに独自のカスタム属性名を使用する必要があります。例: ```HTML HTML lines wrap theme={null} ``` 上記の例では、"colors" という名前のカスタム属性をトラッキングしています。この属性の値は配列 `["blue","green","red"]` です。 ## ユーザーのログインとログアウトのトラッキング [ユーザーをログインさせる以前の方法](/docs/ja/developer-guide/web-sdk/other-supported-web-sdk-integration/user-login-in-amp-older-process)は変更されました。以下の方法は、MoEngage の User Identity Resolution 機能に従っています。[詳細はこちら](https://www.moengage.com/docs/user-guide/data/user-data/unified-identity-identity-resolution)。 Web サイトへの訪問中にユーザーのログインとログアウトが正しく実装され、ユーザーが認証されていることを確認してください。重要ユーザーのログインとログアウトが正しく処理されない場合、ユーザーデータが破損する可能性があります。詳細については、[こちらのセクション](https://www.moengage.com/docs/developer-guide/web-sdk/data-tracking/web-sdk-user-attributes-tracking#User-Login-and-Logout)を参照してください。 ### ログインのトラッキング ```HTML HTML lines wrap theme={null} ``` ここでは、ID "someUniqueId" と Email "[emailValue@emailDomain.com](mailto:emailValue@emailDomain.com)" をユーザーの ID としてトラッキングします。重要 ID を設定する場合は、`identifiers` -> `moe_user_id` と `identifiers` -> `user_identities` の両方でその値を追加/更新してください。 ```html HTML lines wrap theme={null} ``` ここで、`uid` は ID 属性、`u_em` は Email (Standard) 属性です。標準のユーザー属性を ID として設定する際に使用するキー名については、以下の表を参照してください。 | ユーザー属性名 | user\_identities で使用するキー名 | | - | - | | ID | uid | | Email (Standard) | u\_em | | Gender | u\_gd | | Birthday | u\_bd | | Name | u\_n | | First Name | u\_fn | | Last Name | u\_ln | | Mobile Number (Standard) | u\_mb | たとえば、携帯電話番号のみでユーザーを識別したい場合は、次のようにします。 ```HTML HTML lines wrap theme={null} ``` ```html HTML lines wrap theme={null} ``` 注意 Mobile と ID はユーザーの異なる 2 つの属性であるため、ここでは携帯電話番号の値を `identifiers` -> `moe_user_id` で送信する必要はありません。ID を追加/更新する場合にのみ、ID の値を `moe_user_id` と `user_identities` の両方で送信する必要があります。重要ログインをトラッキングした後は、ログアウトイベントが実行されるまで、以降のすべての属性とイベントのトラッキングコード内に、上記のように "identifiers" オブジェクト ("moe\_user\_id" および/または "user\_identities" を含む) を定義する必要があります。そうしないと、その属性やイベントのトラッキングは、MoEngage ダッシュボードでこのログイン済みユーザーに関連付けられません。たとえば、ユーザーに ID が設定された後にイベントをトラッキングしたい場合は、次のようにします。 ```html HTML wrap theme={null} ``` ```html HTML lines wrap theme={null} ``` ### ID の更新のトラッキング ID の値を更新する場合は、変更された ID を `identifiers` -> `previous_identities` で送信します。たとえば、最初に ID と Email をユーザーの ID として設定したとします。 ```HTML HTML lines wrap theme={null} ``` ```html HTML lines wrap theme={null} ``` 次に、ユーザーの ID を更新したいとします。 ```HTML HTML lines wrap theme={null} ``` ```HTML HTML lines wrap theme={null} ``` 注意上記の例では、ID を更新しました。複数の ID を更新することもできますが、変更されるすべての ID を必ず `previous_identities` で送信する必要があります。 ### ログアウトのトラッキング ```HTML HTML lines wrap theme={null} ``` ```html HTML lines wrap theme={null} ``` 重要上記の MoEngage ログアウトイベントを実行した後は、以降のトラッキングコードで "identifiers" を送信しないでください。ユーザーはログアウトしており、以降の属性/イベントのトラッキングをこのユーザーに関連付けてはならないためです。