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


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

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

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

  • 年齢
  • 性別
  • 興味 / 関心

始める前に

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

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

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

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

  1. Firebase コンソールの Analytics の [カスタム定義] ページで、ユーザー プロパティのカスタム定義を作成します。詳しくは、カスタム ディメンションとカスタム指標をご覧ください。
  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[カスタム定義] ページからアクセスできます。このページには、アプリに定義したユーザー プロパティのリストが表示されます。このプロパティは、Google Analytics で利用可能なレポートの多くで比較条件として使用できます。ダッシュボードの詳細をご覧ください。