ユーザー プロパティとは、ユーザーベースの特定部分を表す属性（言語設定、地理的位置など）であり、自由に定義できます。これらを使用して、アプリのオーディエンスを定義できます。このガイドでは、アプリでユーザー プロパティを設定する方法について説明します。
Analytics では一部のユーザー プロパティが自動的にロギングされます。それらのログを有効にするためのコードを追加する必要はありません。それ以外のデータを収集する必要がある場合は、ユーザー プロパティをプロジェクトごとに最大 25 個まで設定できます。ユーザー プロパティ名では大文字と小文字が区別されます。そのため、大文字と小文字の使い方だけが異なっている同じ名前の 2 つのユーザー プロパティは、2 つの別個のユーザー プロパティとしてロギングされます。
以下のユーザー プロパティ名は、Google によって予約されているため使用できません。
- 年齢
- 性別
- 興味 / 関心
始める前に
プロジェクトを設定し、Analytics を使ってみるの説明に沿って Analytics にアクセスできることを確認してください。
ユーザー プロパティを設定する
アプリのユーザー層を説明するために、Analytics のユーザー プロパティを設定できます。ユーザー プロパティを活用するには、カスタム定義を作成してレポートで比較条件に使用するか、オーディエンスの判定基準として使用します。
ユーザー プロパティを設定する手順は次のとおりです。
- Firebase コンソールの [アナリティクス] の [カスタム定義] ページで、ユーザー プロパティのカスタム定義を作成します。詳しくは、カスタム ディメンションとカスタム指標をご覧ください。
setUserProperty()メソッドを使用して、アプリのユーザー プロパティを設定します。
次の例は、架空の「favorite food」（好きな食べ物）プロパティを追加する方法を示しています。このプロパティは、アクティブ ユーザーに文字列 food の値を割り当てます。
Web
import { getAnalytics, setUserProperties } from "firebase/analytics";
const analytics = getAnalytics();
setUserProperties(analytics, { favorite_food: 'apples' });
Web
firebase.analytics().setUserProperties({favorite_food: 'apples'});
このデータには、Firebase コンソールの Analytics の [カスタム定義] ページからアクセスできます。このページには、アプリに定義したユーザー プロパティのリストが表示されます。このプロパティは、Google Analytics で利用可能なレポートの多くで比較条件として使用できます。ダッシュボードの詳細をご覧ください。