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

ユーザー プロパティとは、ユーザーベースの特定部分を表す属性(言語設定、地理的位置など)であり、自由に定義できます。これらを使用して、アプリのオーディエンスを定義できます。このガイドでは、アプリでユーザー プロパティを設定する方法について説明します。

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

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

  • Age
  • Gender
  • Interest

始める前に

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

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

アプリのユーザー層を説明するために、アナリティクスのユーザー プロパティを設定できます。ユーザー プロパティを活用するには、カスタム定義を作成してレポートで比較条件に使用したり、オーディエンスの判定基準として使用します。

ユーザー プロパティを設定する手順は次のとおりです。

  1. Firebase コンソールで、[Analytics] の [Custom Definitions] ページに移動し、ユーザー プロパティのカスタム定義を作成します。詳しくは、カスタム ディメンションとカスタム指標をご覧ください。
  2. setUserProperty() メソッドを使用して、アプリのユーザー プロパティを設定します。

次の例は、架空の「favorite food」(好きな食べ物)プロパティを追加する方法を示しています。このプロパティは、アクティブ ユーザーに文字列 food の値を割り当てます。

ウェブ向けのモジュラー API

import { getAnalytics, setUserProperties } from "firebase/analytics";

const analytics = getAnalytics();
setUserProperties(analytics, { favorite_food: 'apples' });

ウェブ向けの名前空間 API

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

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