コンテンツにスキップ
Screeb Help Centerヘルプセンター
Screeb を開く

ユーザープロパティを理解する

ユーザープロパティとは何か、Screebが予約しているプロパティ名、ユーザーが匿名ではなく識別済みとみなされる条件を説明します。

コンセプト5 分で読めます、2026/10/15 更新

このページは自動翻訳されています。英語版が正式な内容です。

ユーザープロパティとは、サイトやアプリの1人のユーザーに関する情報のことです。たとえばプラン、役割、会社、登録日などがあります。Screebは、各プロパティの最新の値をユーザーのプロファイルに保存します。

  • アンケートやメッセージのターゲティング。 特定のプランや役割のユーザーにだけ、アンケートを表示できます。
  • 回答の分析。 各回答には回答したユーザーのプロパティが表示されるので、フィードバックを文脈の中で読み解けます。
  • 質問のパーソナライズ。 名前などのプロパティを、質問文に差し込めます。

プロパティは、サイトやアプリ(Screeb SDK)、バックエンド(Screeb API)、ソースとして接続したツール、CSVインポートからScreebに届きます。Screebが自動で計算するプロパティもあります。プロパティの送信方法は、ユーザープロパティの送信と管理をご覧ください。

値には、テキスト、数値、真偽値、日付を使えます。オブジェクトを使うと、company.name のようにドットでつないだパスで表されるネストしたプロパティをまとめられます。値が空(null)のプロパティを送信すると、そのプロパティはユーザーから削除されます。

1人のユーザーのプロパティを確認するには、オーディエンスを開き、ユーザーをクリックして、プロパティタブを開きます。Workspaceで受信したすべてのプロパティは、設定のユーザープロパティに一覧表示されます。

Propertiesタブを開いたユーザープロファイル。ユーザーのプロパティとその値が一覧表示されている

Screebでは、一部のプロパティ名を予約し、それぞれ決まった形式の値を想定しています。データがある場合はこれらを使ってください。Screebはこれらを使って、ユーザーの名前や詳細情報を表示します。

プロパティ 想定される値
firstname, lastname, first_name, last_name, name, fullname, username テキスト
email 有効なメールアドレス
owner 有効なメールアドレス
avatar 画像のURL
mrr, arr, ltv 数値
country, language テキスト
ip IPv4またはIPv6アドレス
created_at, signup_at, last_seen_at 日付
last_survey_displayed_at, last_survey_responsed_at, last_survey_closed_at 日付

予約済みプロパティの値の型や形式が正しくない場合、Screebはそのプロパティを破棄し、一緒に送信された他のプロパティは保持します。

識別済みユーザーと匿名ユーザー

Section titled “識別済みユーザーと匿名ユーザー”

Screebは、SDKが動作しているページや画面に誰かがアクセスすると、すぐにユーザーを作成します。このユーザーは最初は匿名です。次のいずれかの場合に、識別済みになります。

  • サイトやアプリがユーザーIDを渡した場合(Segmentなど、接続したソースがIDを送信した場合も含みます)
  • firstname、lastname、first_name、last_name、name、username、email のいずれかのプロパティを持っている場合

fullname だけでは、ユーザーは識別されません。オーディエンスでは、匿名ユーザーは匿名と表示され、識別済みユーザーには識別済みユーザーの割合が表示されます。

ユーザーの識別には、メールアドレスではなく、変更されない社内IDを使いましょう。メールアドレスは変わることがあり、その場合、同じ人が2人のユーザーとして表示されてしまいます。

  • プロパティ名は128文字までです。
  • 1回の呼び出しで設定できるプロパティは1,000個までです。
  • 設定からプロパティを削除すると、そのプロパティをターゲットにしているアンケートが表示されなくなる場合があります。