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

CSVファイルからユーザーをインポートする

CSVファイルから、プロパティ付きでユーザーを作成・更新したり、Screeb上の既存ユーザーをユーザーIDまたはプロパティで照合してセグメントに追加したりできます。

ハウツー9 分で読めます、2026/10/15 更新

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

スプレッドシートやCRM、データベースにあるユーザーを、CSVファイルでScreebに取り込めます。インポートのたびにセグメントが作られるので、取り込んだユーザーをすぐにターゲットにできます。

  • セグメントを編集できるロール(EditorまたはAdmin)であること。
  • カンマまたはセミコロン区切りのCSVファイルを用意します。1行目に列名、2行目以降に1行につき1ユーザーを記載し、1ファイルにつき最大50,000行まで取り込めます。
  • インポートするには、サイトやアプリでユーザーを識別するときにScreebへ送っているユーザーIDの列がファイルに必要です。ない場合、既存のユーザーは更新されず、新しいユーザーが作成されます。詳しくはユーザープロパティを理解するをご覧ください。
  • インポートで作成されたユーザーはユーザー数のクォータに加算され、クォータに達するとインポートは停止します。詳しくはプラン、クォータ、請求をご覧ください。
  • ユーザーをインポートは、まだ存在しないユーザーを作成し、列のプロパティをすべてのユーザーに設定したうえで、全員をセグメントに追加します。
  • ユーザーを割り当ては、Screebにすでにいるユーザーをセグメントに追加するだけです。ユーザーの作成やプロパティの変更は行いません。たとえば、営業キャンペーン対象のアカウントなど、顧客リストにタグ付けしたいときに使います。

ユーザーをインポート・割り当てする

Section titled “ユーザーをインポート・割り当てする”
  1. サイドバーの観察からオーディエンスを開き、サイドメニューのユーザーをインポートをクリックします。セグメントページのインポートからも同じ画面に移動できます。
  2. ユーザーをインポートまたはユーザーを割り当てを選びます。
  3. セグメントで、新規作成を選んで名前を入力するか(255文字以内で、ドット以外の表示される文字を1文字以上含み、制御文字は使えません)、既存のセグメントに追加を選んで既存のセグメントを指定します。
  4. ファイル領域にCSVファイルをドロップするか、クリックしてファイルを選択します。サンプルが必要な場合は、テンプレートをダウンロードをクリックしてください。
  5. 列を設定します(下記参照)。
  6. 右上のボタンをクリックします。ボタンにはファイルの行数が表示されます。
ユーザーのインポートページ。ユーザーをインポートするカードとユーザーを割り当てるカード、新しいセグメントと既存のセグメントの選択肢が表示されています

列では、ファイルの各列にサンプル値と、そのサンプルから推測されたScreebフィールドが表示されます。

  • ユーザーIDには、列をちょうど1つだけ割り当てます。user_idまたはidという名前の列は自動で選ばれます。正しく割り当てられると、バッジにユーザーID割り当て済みと表示されます。
  • それ以外の列は、同じ名前のユーザープロパティになります。型はテキスト、数値、真偽値(trueまたはfalse)、日付(2026-01-15のような日付)のいずれかです。郵便番号のように先頭にゼロがある値は、テキストのままになります。
  • 取り込まない列は、インポートをオフにします。
列のセクション。ファイルの各列がサンプル値とScreebのフィールドとともに一覧表示され、ユーザーID列が割り当てられています

割り当てのための照合を設定する

Section titled “割り当てのための照合を設定する”

照合で照合する列を選び、照合先でその列の内容を指定します。ユーザーIDを選ぶか、ユーザープロパティを選んで、照合先のプロパティ(メールアドレスなど)を指定します。どの行にも一致しないユーザーは対象外になります。

インポートはバッチ単位で実行されます。インポートが完了するまでこのページを開いたままにしてください。完了すると、インポートまたは追加されたユーザー数と、スキップされた行(ユーザーIDのない行と、ユーザーIDが重複している行)の数がページに表示されます。セグメントのユーザーを表示をクリックすると、該当のユーザーを確認できます。

インポート完了時の画面。セグメントにインポートされたユーザー数と、ユーザーを表示するリンクが表示されています

ユーザーがセグメントに表示されるのは、インポート完了の数分後です。ほかのセグメントと同じように、アンケートのターゲティングやユーザーフィルターで使えます。詳しくはユーザーセグメントを作成するをご覧ください。

一部のユーザーでプロパティが欠けている。 数値の列にテキストがあるなど、列の型に合わない値はスキップされます。型またはファイルを修正して、もう一度インポートしてください。同じユーザーを再度インポートすると、更新されます。

「一致するユーザーなし」 列の値を持つユーザーがScreebにいません。照合先のフィールドが正しいか、Screeb上の値と同じ表記になっているかを確認してください。

「照合できるのはテキストと数値のプロパティのみです。」 照合先には、テキストまたは数値のプロパティを選んでください。

「この名前のセグメントはすでに存在します。」 別の名前を付けるか、既存のセグメントに追加を選んでください。

インポートに失敗しました。 ユーザー数のクォータに達した場合など、最初のエラーでインポートは停止します。それまでにインポートされたユーザー数はページに表示されます。原因を解消してから、もう一度ファイルをインポートしてください。インポート済みのユーザーは重複せず、更新されます。

ファイルの行数が50,000行を超えている。 複数のファイルに分割し、同じセグメントに順番にインポートしてください。