Google I/O 2022 で発表された Firebase の最新情報をご覧ください。詳細

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

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

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

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

  • Age
  • Gender
  • Interest

始める前に

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

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

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

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

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

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

Swift

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。
Analytics.setUserProperty(food, forName: "favorite_food")

Objective-C

注: この Firebase プロダクトは、macOS ターゲットでは使用できません。
[FIRAnalytics setUserPropertyString:food forName:@"favorite_food"];

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