ユーザー プロパティ

ユーザー プロパティは、言語設定や地理的位置などのユーザーベースのセグメントを表現します。アナリティクスでは、一部のユーザー プロパティが自動的にログに記録されます。他のプロパティを収集したい場合は、プロジェクトごとに最大 25 個のユーザー プロパティを追加設定することができます。ユーザー プロパティの設定と登録の方法について詳しくは、カスタム ユーザー プロパティをご覧ください。

ユーザー プロパティを使用するとユーザー セグメントを拡張できますが、ユーザー プロパティのデータは、多くの場合、サーバーサイドでのみ利用できます。Measurement Protocol を使用すると、サーバーサイドのデータでクライアントサイドの測定を補強できます。これは通常、クライアントサイドのソリューションだけでは実現不可能です。

予約済みの名前

一部のユーザー プロパティ名は予約済みのため、測定では使用できません。

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

また、ユーザー プロパティ名の先頭を以下にすることはできません。

  • google_
  • ga_
  • firebase_

使用例

以下の例では、測定に追加するユーザー プロパティ(customer_tier)が CRM に含まれています。customer_tierpremium または standard に設定できます。レポートでこのユーザー プロパティを取得するための手順は、以下のとおりです。

まずは、クライアントで、CRM システムにアクセスできるサーバー API に対して、add_payment_info イベントと呼び出しを送信します。

クライアント コード

FirebaseAnalytics.logEvent("add_payment_info")
ServerAPI.addCustomerTier(
  FirebaseAnalytics.getAppInstanceId(),
  "[{name: \"add_payment_info\"}"]
);

次に、サーバーでは、Measurement Protocol を使って customer_tier ユーザー プロパティで測定が強化されます。

サーバーコード

const firebaseAppId = 'X:XX:XX:XX';
const apiSecret = '<secret_value>';

function addCustomerTier(appInstanceId, events) {

  // Request the customer tier from the CRM.
  const customerTier = getCustomerTier(appInstanceId);

  const queryParams = `?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`;
  fetch(`https://www.google-analytics.com/mp/collect${queryParams}`, {
    method: "POST",
    body: JSON.stringify({
      "app_instance_id": appInstanceId,
      "user_properties": {
        "customer_tier": {
          "value": customerTier
        }
      },
      "events": JSON.parse(events)
    })
  });
}

このユーザー プロパティでは、premiumstandard の 2 種類のセグメントがレポートされます。

Measurement Protocol を使用してイベントを送信する方法について詳しくは、イベントの送信をご覧ください。