ユーザー プロパティを設定する

ユーザー プロパティとは、ユーザーベースを示す属性のことを言います。たとえば、言語や地域などがあり、自由に定義できます。これらを使用して、アプリのオーディエンスを定義できます。このガイドでは、アプリでユーザー プロパティを設定する方法について説明します。

アナリティクスは一部のユーザー プロパティに関するログを自動で記録します。それらのログを有効にするコードを追加する必要はありません。それ以外のデータを収集する必要がある場合は、アナリティクスのユーザー プロパティをプロジェクトごとに最大 25 個まで設定できます。ユーザー プロパティ名では大文字と小文字が区別されます。そのため、大文字と小文字の使い方だけが異なっている同じ名前の 2 つのユーザー プロパティは、2 つの別個のユーザー プロパティとしてログに記録されます。

以下のユーザー プロパティ名は、Google によって予約されているため使用できません。

  • 年齢
  • 性別
  • インタレスト

始める前に

プロジェクトを設定し、アナリティクスを使ってみるの説明に従ってアナリティクスにアクセスできることを確認してください。

ユーザー プロパティを設定する

アプリのユーザー層を示す、アナリティクスのユーザー プロパティを設定できます。設定したプロパティはフィルタとしてレポートに適用し、さまざまなユーザー セグメントの行動分析に利用できます。

ユーザー プロパティを設定するには、次のように操作します。

  1. Firebase コンソールの [アナリティクス] の [ユーザー プロパティ] ページでプロパティを登録します。詳細については、ユーザー プロパティの設定と登録をご覧ください。

  2. setUserProperties() メソッドを使用してアナリティクスのユーザー プロパティを設定するコードを追加します。各プロパティの名前と値は自由に設定できます。

次の例では、好きな食べ物に関する架空のプロパティを追加します。このプロパティは、アクティブ ユーザーの food に値を割り当てます。

firebase.analytics().setUserProperties({favorite_food: 'apples'});

このデータには、Firebase コンソールの [User Properties] ダッシュボードからアクセスできます。このダッシュボードには、アプリに定義したユーザー プロパティのリストが表示されます。こうしたプロパティは、Google アナリティクスで作成できるレポートの多くでフィルタとして使用できます。アナリティクスのレポート ダッシュボードの詳細については、Firebase ヘルプセンターをご覧ください。