ユーザープロパティとイベントプロパティ

ユーザープロパティは、イベントをトリガーするユーザーを表します（プランの種類、国、デバイス）。 イベントプロパティは、単一のイベントインスタンス（再生された曲、クリックされたボタン、チェックアウト合計）を記述します。 ユーザープロパティはユーザーのすべてのイベントにわたって持続します。イベントプロパティは各イベントに1つずつ属します。

属性がその人物を記述しており、その人物のアクティビティ全体にわたってそれに基づいてフィルタリングまたはセグメント化したい場合は、その属性をユーザープロパティとして添付します。属性が 1 つの特定のアクションのコンテキスト内でのみ意味を持つ場合に、イベントプロパティとしてこれを付加してください。

Amplitudeは以下の2種類をサポートしています。

1. ユーザープロパティ：個々のユーザーの属性です。 一般的なユーザープロパティには、デバイスの種類、位置情報、ユーザーID、ユーザーが有料カスタマーであるかの情報などが含まれます。ユーザープロパティは、その性質やITの更新頻度に応じて、現在の値または以前の値のいずれかを反映できます。
2. イベントプロパティ：特定のイベントの属性です。 これらの値は、イベントが発生した時点での現在の値です。 たとえば、JoinCommunityのイベントにはTypeのイベントプロパティがあり、イベントの発生時に参加していたコミュニティのタイプが表示されます。

この記事では、ユーザーとイベントのプロパティの機能、Amplitudeがそれらをどのように更新および適用するか、Amplitudeプロジェクトで個々のプロパティを非表示にする方法について説明します。

ユーザープロパティ

ユーザープロパティは、そのプロパティが関連付けられているユーザーに関する有用な詳細情報を記述する属性です。 Amplitudeでは、あらゆるイベントでユーザープロパティが送信されます。

AmplitudeのSDKでは、以下のユーザープロパティがデフォルトで追跡されます：

• プラットフォーム
• デバイスタイプ
• デバイスファミリ
• 国。
• 市区町村
• 地域
• 開始バージョン
• バージョン。
• キャリア。
• OS。
• 言語。
• ライブラリ
• IPアドレス

各プロパティの定義は、ユーザープロパティ定義で確認できます。

カスタムユーザープロパティを設定することもできます。ユーザーやユーザーが使用しているデバイスに固有の特性や特徴を選択してください。そうしないと、ユーザープロパティから収集したデータはあまり役に立ちません。カスタムユーザープロパティの一般的な例としては、紹介元、プランの種類、友達の数、ゲームの現在のレベルなどがあります。

Amplitudeのロゴを探すことで、デフォルトのAmplitudeユーザープロパティとカスタムユーザープロパティの違いを確認できます。 このプロパティが表示されている場合、このプロパティはデフォルトのユーザープロパティです。カスタムユーザープロパティの名前には、そのロゴの接頭辞が付いていません。

Amplitudeのお客様は通常、デフォルトのプロパティとともに最大20のカスタムユーザープロパティを実装しています。

Amplitudeがユーザープロパティを更新する方法

ユーザーがAmplitudeがキャプチャするイベントをトリガーすると、イベントには各ユーザープロパティの現在の値が含まれますが、これらの値は時間の経過とともに変化する可能性があります。 たとえば、ユーザーがニューヨークからダラスに引っ越したり、無料ユーザーから有料ユーザーに切り替えたりすることがあります。 この場合、Amplitudeはユーザープロパティを更新し、その時点以降にユーザーが送信するイベントに新しい値を適用します。 Amplitudeはユーザープロパティの更新を遡及的に適用しません。また、古い値は履歴データに残ります。 プロパティ値は、イベント発生時の値を反映します。

たとえば、このユーザーは午前10:11に記事を見ました。Cityのプロパティ値はSan Franciscoでした。

このユーザーも約1週間前に記事を見ました。 そのイベントを選択すると、CityのプロパティにはNew Yorkと表示されます。これは、ユーザーがview articleのイベントをトリガーした時点の値でした。

ユーザーの個々のイベントストリームで各イベントとともに表示されるユーザープロパティには、イベント発生時のユーザープロパティ値が記録されます。Amplitudeでは、送信された直近のイベントやIdentifyコールからこうした情報を取得しています。

古いユーザープロパティ値と新しいユーザープロパティ値が重複する場合

ユーザープロパティ値が変更された場合、Amplitudeのチャートでは、新しいユーザープロパティカテゴリと古いユーザープロパティカテゴリの両方でユーザーを確認できます。この重複は、プロパティ値が変更された特定の日にのみ適用されます。

たとえば、7月1日に、ユーザーがバージョン1.8のゲームアプリにログインし、いくつかのゲームをプレイするとします。その日のうちに、ユーザーはバージョン2.0にアップデートし、さらにプレイを続けます。毎日のアクティブユーザー数チャートをバージョン別にセグメント化し、バージョン1.0と2.0を比較した場合、当該ユーザーはその日の両方のセグメントに表示されます。7 月 2 日以降、ユーザーは新しいバージョンにアップデートするまでバージョン 2.0 セグメントにのみ表示されます。

ユーザーセグメントをチャートに適用した場合にも、同様のことが起こる可能性があります。イベント発生時にユーザーがユーザープロパティ値を有していなかった場合、Amplitudeでは(none)の値が表示されます。当初、最初のPlaySongイベントに対しては「isPaying=(none)」としていたが、その後、次のPlaySongイベントに対して「isPaying=True」とした場合、当該のユーザーは両方のバケットに表示されます。そのユーザーの [ユーザーアクティビティ] ページに移動すると、そのプロパティに対する最新の値のみがそのユーザーのプロファイルの上部に表示されます。

Amplitudeがユーザープロパティをイベントに適用する方法

ユーザープロパティをイベントに適用するには、次の3つの方法があります。

1. イベントの送信前にユーザープロパティを更新します。ユーザープロパティテーブル内のプロパティ値を更新し、Amplitudeに送信する次のイベントにそれを適用します。 これはユーザープロパティを更新するための推奨方法です。これにより、Amplitudeは更新された値をイベントに正しく適用できます。

2. イベントの送信後にユーザープロパティを更新します。Amplitudeにイベントを送信し、ユーザープロパティテーブル内のプロパティ値を更新します。 更新された値は、別のイベントを送信するまでユーザーインターフェイスに表示されません。

• イベント後にIdentifyコールを送信した場合、更新された値はイベントとともに表示されません。 ユーザーのプロフィールの上部にはこの値が表示されますが、チャート結果には、Identifyコール後に別のイベントが送信されるまで表示されません。

3. ユーザープロパティをイベントとともに送信します。 HTTP API を介して送信されたイベントの場合、サーバー側の呼び出しにユーザープロパティを含めることができます。 更新されたプロパティは、Amplitudeがイベントを受信するとすぐにユーザーインターフェイスに表示されます。 ユーザープロパティテーブルも、Amplitudeがイベントを取り込んだ後に更新されます。 今後のイベントでは、再度更新されるまで更新されたプロパティ値が保持されます。

新しいプロパティ値とともにイベントを送信するか、その直後にイベントを送信して、値がUIに表示されるようにします。ユーザープロパティは、IdentifyAPIを使用して更新できます。ITを使用する前に、IdentifyAPIドキュメントを十分に読み、理解してください。

イベントプロパティ

イベントプロパティとは、ユーザーがトリガーし、お客様がAmplitudeに送信するイベントの属性です。各イベントには、独自のイベントプロパティセットがあります。これらのプロパティの性質は、お持ちのプロダクトのタイプと、お探しの特定の情報によって異なります。たとえば、Swipeが追跡対象のイベントの場合、DirectionのイベントプロパティにはLeftまたはRightの値があります。

イベントプロパティの例としては、説明、カテゴリ、タイプ、期間、レベル、完了率、カウント、Target、ステータス、数、ライブ、認証、エラー番号、ランク、アクション、モードなどがあります。イベントプロパティを使用すると、追跡するイベントの数を減らしたり、イベントをより効果的に分析したりできます。

たとえば、ユーザープロパティ名とイベントプロパティ名がいずれもemailとなっている場合、チャート内で参照されているプロパティを確認してください。 そうでない場合、チャートは予想外のデータを返します。

プロパティを隠す

必要に応じて、古いプロパティやバグのあるプロパティを非表示にすることができます。 イベントやユーザープロパティを非表示にしても、プラットフォームのUIからそれらが非表示になるだけで、削除されることはありません。気が変わった場合は、プロパティの非表示化を解除できます。

ユーザープロパティの自動削除

Amplitudeは、過去14か月間にイベントデータがないユーザーのユーザープロパティを自動的に削除します。 過去14か月間にアプリまたはウェブサイトでユーザーアクティビティが認められる限り、Amplitudeではユーザーに関連付けられたユーザープロパティが保持されます。