CSVファイルからユーザーをインポートする
CSVファイルから、プロパティ付きでユーザーを作成・更新したり、Screeb上の既存ユーザーをユーザーIDまたはプロパティで照合してセグメントに追加したりできます。
このページは自動翻訳されています。英語版が正式な内容です。
スプレッドシートやCRM、データベースにあるユーザーを、CSVファイルでScreebに取り込めます。インポートのたびにセグメントが作られるので、取り込んだユーザーをすぐにターゲットにできます。
- セグメントを編集できるロール(EditorまたはAdmin)であること。
- カンマまたはセミコロン区切りのCSVファイルを用意します。1行目に列名、2行目以降に1行につき1ユーザーを記載し、1ファイルにつき最大50,000行まで取り込めます。
- インポートするには、サイトやアプリでユーザーを識別するときにScreebへ送っているユーザーIDの列がファイルに必要です。ない場合、既存のユーザーは更新されず、新しいユーザーが作成されます。詳しくはユーザープロパティを理解するをご覧ください。
- インポートで作成されたユーザーはユーザー数のクォータに加算され、クォータに達するとインポートは停止します。詳しくはプラン、クォータ、請求をご覧ください。
モードを選ぶ
Section titled “モードを選ぶ”- ユーザーをインポートは、まだ存在しないユーザーを作成し、列のプロパティをすべてのユーザーに設定したうえで、全員をセグメントに追加します。
- ユーザーを割り当ては、Screebにすでにいるユーザーをセグメントに追加するだけです。ユーザーの作成やプロパティの変更は行いません。たとえば、営業キャンペーン対象のアカウントなど、顧客リストにタグ付けしたいときに使います。
ユーザーをインポート・割り当てする
Section titled “ユーザーをインポート・割り当てする”- サイドバーの観察からオーディエンスを開き、サイドメニューのユーザーをインポートをクリックします。セグメントページのインポートからも同じ画面に移動できます。
- ユーザーをインポートまたはユーザーを割り当てを選びます。
- セグメントで、新規作成を選んで名前を入力するか(255文字以内で、ドット以外の表示される文字を1文字以上含み、制御文字は使えません)、既存のセグメントに追加を選んで既存のセグメントを指定します。
- ファイル領域にCSVファイルをドロップするか、クリックしてファイルを選択します。サンプルが必要な場合は、テンプレートをダウンロードをクリックしてください。
- 列を設定します(下記参照)。
- 右上のボタンをクリックします。ボタンにはファイルの行数が表示されます。

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

割り当てのための照合を設定する
Section titled “割り当てのための照合を設定する”照合で照合する列を選び、照合先でその列の内容を指定します。ユーザーIDを選ぶか、ユーザープロパティを選んで、照合先のプロパティ(メールアドレスなど)を指定します。どの行にも一致しないユーザーは対象外になります。
インポート結果
Section titled “インポート結果”インポートはバッチ単位で実行されます。インポートが完了するまでこのページを開いたままにしてください。完了すると、インポートまたは追加されたユーザー数と、スキップされた行(ユーザーIDのない行と、ユーザーIDが重複している行)の数がページに表示されます。セグメントのユーザーを表示をクリックすると、該当のユーザーを確認できます。

ユーザーがセグメントに表示されるのは、インポート完了の数分後です。ほかのセグメントと同じように、アンケートのターゲティングやユーザーフィルターで使えます。詳しくはユーザーセグメントを作成するをご覧ください。
トラブルシューティング
Section titled “トラブルシューティング”一部のユーザーでプロパティが欠けている。 数値の列にテキストがあるなど、列の型に合わない値はスキップされます。型またはファイルを修正して、もう一度インポートしてください。同じユーザーを再度インポートすると、更新されます。
「一致するユーザーなし」 列の値を持つユーザーがScreebにいません。照合先のフィールドが正しいか、Screeb上の値と同じ表記になっているかを確認してください。
「照合できるのはテキストと数値のプロパティのみです。」 照合先には、テキストまたは数値のプロパティを選んでください。
「この名前のセグメントはすでに存在します。」 別の名前を付けるか、既存のセグメントに追加を選んでください。
インポートに失敗しました。 ユーザー数のクォータに達した場合など、最初のエラーでインポートは停止します。それまでにインポートされたユーザー数はページに表示されます。原因を解消してから、もう一度ファイルをインポートしてください。インポート済みのユーザーは重複せず、更新されます。
ファイルの行数が50,000行を超えている。 複数のファイルに分割し、同じセグメントに順番にインポートしてください。