メールアドレスをインポートする – Repro Help&Support

この記事では、メールアドレスをReproに連携する方法を説明します。メールを配信するには、配信先となるユーザーのメールアドレスを、事前にReproに連携しておく必要があります。

連携方法には、以下の3つがあります。用途に合わせて連携方法を選択してください。

連携方法	概要	用途
管理画面からCSVをアップロードする	Reproの管理画面から、メールアドレスのリストをCSVファイルにしてアップロードします。	メールの利用開始時にまとめて取り込みたいときや、CDPや自社のシステムから取り出したメールアドレスを取り込みたいとき。
S3へアップロードする	Reproが用意しているAWS S3 bucket(データの保管場所)に、メールアドレスのリストをCSVファイルにしてアップロードします。	CDPや自社のシステムで持っているメールアドレスを、継続的に取り込みたいとき。
SDK経由でセットする(ユーザープロフィール)	アプリやWebサイトに組み込んだSDKを使い、ユーザープロフィールとしてメールアドレスを登録します。実装は開発側で行います。	アプリやサービスでメールアドレスを取得したタイミングで、Reproにも登録したいとき。

管理画面からCSVをアップロードする

管理画面から、メールアドレスを記載したCSVファイルをアップロードする方法です。

管理画面の左メニューより[設定] > [メール設定] > [メール配信用ユーザー情報インポート]をクリックします。

メール配信用ユーザー情報インポートの画面が表示されます。

ファイルを選択

指定されたフォーマットに沿って作成したCSVファイルを選択します。

すでに Repro に存在するユーザーIDをインポートした場合

インポートするCSVファイルに、すでにReproに登録されているユーザーが含まれている場合の、ステータスの更新方法を選択します。

[Reproのステータスを維持する]にチェックを入れると、そのユーザーの今のステータスがそのまま残ります。チェックを入れない場合は、インポート時に選んだステータスで上書きされます。

例えば、配信停止にしているユーザーを誤って配信可能に戻したくない場合は、チェックを入れてください。

なお、チェックを入れた場合、インポートできるのは配信可能ユーザーのみになります。

Reproのステータスを維持する	インポートするステータス	インポート前のステータス	インポート後のステータス
チェックする	配信可能ユーザー	配信停止ユーザー	配信停止ユーザー
チェックしない	配信可能ユーザー	配信停止ユーザー	配信可能ユーザー

注釈💬

インポート前のステータスがバウンスユーザーの場合、ほかのステータスには上書きできません。チェックの有無にかかわらず、バウンスユーザーのままです。

インポートするメールアドレスの種別

Reproではメールアドレスごとの配信可否をステータスで管理しています。ステータスは以下の4種類です。

ステータス	説明	配信可否
配信可能ユーザーとしてインポート	現在メールを正常に送信できる状態のユーザーのメールアドレス。購読解除・バウンス・配信停止に該当しないもの。	配信できる
購読解除ユーザーとしてインポート	Webサイトやアプリ設定、配信されたメールから購読解除（オプトアウト）を行ったユーザーのメールアドレス。	配信できない
配信停止ユーザーとしてインポート	事業者側の判断など上記以外の理由でメール配信を行わないユーザーのメールアドレス。	配信できない
バウンスユーザーとしてインポート	メールアドレスやドメインが存在せず恒久的なエラー状態のメールアドレス。	配信できない

注釈💬 ユーザーとメールアドレスの関係

1人のユーザーに登録されるメールアドレスは1つです。

同じユーザーに別のメールアドレスをインポートすると、最後にインポートしたものが登録され、以前のメールアドレスは外れます。

同じファイル内に同じユーザーが複数行ある場合も、最後の行のメールアドレスが登録されます。例えば、以下の2行を含むファイルをインポートした場合、user-01のメールアドレスはmail-address-02@example.comになります。

user-01,mail-address-01@example.com
user-01,mail-address-02@example.com

警告⚠

登録されたことのないメールアドレスをユーザーIDなしでインポートすると、ユーザーIDが設定されていない状態のユーザーが内部的に新しく作成されます。

この場合、あとから同じメールアドレスにユーザーIDを紐づけようとしても、うまく情報がつながらず、「Reproのステータスを維持する」にチェックを入れていても、以前のステータスが正しく引き継がれないことがあるのでご注意ください。

配信チャネル

インポートするメールアドレスに紐づける配信チャネルを選択します。

配信チャネルの指定は必須です。特定の配信チャネルに分ける必要がない場合は、「全てのユーザー」を利用してください。

配信チャネルは事前の設定が必要です。詳細はメールチャネル設定を参照してください。

注釈💬

「全てのユーザー」以外のチャネルを指定してCSVをインポートした場合も、そのチャネルだけでなく「全てのユーザー」チャネルに対しても情報が紐づきます。

ただし、「全てのユーザー」にも情報が紐づけられるのは、対象となるユーザーが「全てのユーザー」チャネルに対する購読情報が存在しない時のみです。

インポート履歴（直近7日間）

直近7日間にインポートしたファイルのチャネル名、ファイル名、インポート日時、インポートするメールアドレスの種別、ステータス、アップロードしたユーザーを確認できます。

「エラー」になった場合は、エラーログ列からエラー内容を記載したCSVファイルをダウンロードできます。

項目	説明
チャネル名	インポート時に選択した配信チャネルを表示します。
ファイル名	インポートしたCSVファイルの名前を表示します。
インポート日時	インポートを実行した日時を表示します。
インポートするメールアドレスの種別	インポート時に選択したステータス（配信可能ユーザー、購読解除ユーザーなど）を表示します。
ステータス	インポートの処理状況を表示します。「初期化中」「アップロード中」「インポート中」「インポート完了」「利用不可」「エラー」のいずれかが表示されます。「インポート完了」になっていれば、取り込みは完了しています。
アップロードしたユーザー	インポートを実行したRepro管理画面のユーザーを表示します。
エラーログ	エラーになった場合、エラー内容が記載されたCSVファイルのダウンロードリンクを表示します。

警告⚠

ステータスは自動的に更新されません。ブラウザを更新してご確認ください。

S3へアップロードする

Reproが提供するストレージ領域（AWS S3 bucket）へCSVファイルをアップロードしてメールアドレスを登録する方法です。

S3経由でインポートする場合は、あらかじめアップロード用の認証情報を発行しておく必要があります。アップロード先のAWS S3 bucketやパスは、管理画面のサイドメニューから[設定] > [メール設定] > [メール配信用ユーザー情報インポート]から確認できます。

注釈💬

利用する際には、Reproの提供するAWS S3 bucketに対してオブジェクトをアップロードするための認証情報を事前に発行する必要があります。詳細についてはこちらの項目をご確認ください。

警告⚠

アップロードするCSVファイルは、名前に / 及び空白文字を含めることはできません。
アップロードするCSVファイルは、500MBまでのサイズである必要があります。

コマンド例

例として、AWS CLIを利用した場合には以下のようなコマンドでメールアドレスの記載されたCSVをS3にアップロードできます。

AWS S3 bucketへのパスに含まれるyear、month、dayはすべて指定が必須です。ファイルアップロード日をyyyy/mm/dd(例:2026/09/30)の形式で指定してください。

$ export AWS_ACCESS_KEY_ID=AKIAXXXXXXX
$ export AWS_SECRET_ACCESS_KEY=XXXXXX
$ aws s3 cp user_profiles.csv s3://repro-data-store/<YOUR_APP_ID>/email_address/:year/:month/:day/(insert|subscribe|unsubscribe|stopped|bounced)/<EMAIL_CHANNEL_ID>/mail_address.csv

指定する箇所 指定する値

<YOUR_APP_ID> 管理画面に表示されている値を指定します。

(insert｜subscribe｜unsubscribe｜stopped｜bounced)

インポートするステータスを、1つだけ指定します。

指定する値とステータスの対応は、コマンドで指定するステータスの表を参照してください。

<EMAIL_CHANNEL_ID>

紐づけるチャネルのチャネルIDを指定します。

チャネルIDは、メールチャネル設定の該当チャネルで確認できます。

コマンドで指定するステータス

AWS S3 bucketへのパスに含めるステータスによって、インポートされるメールアドレスの扱いが以下のように変わります。

すでにReproに存在するユーザーIDをインポートした場合の挙動はこちらの例も参照ください。

指定する値	取り込み種別	説明	すでにReproに存在するユーザーIDを取り込んだ場合。
insert	配信可能ユーザー	メールの配信対象として、オプトインされたメールアドレスをインポートできます。	すでにReproに存在するユーザーのステータスを維持します。
subscribe	配信可能ユーザー	メールの配信対象として、オプトインされたメールアドレスをインポートできます。	配信可能ユーザーに上書きされます。
unsubscribe	購読解除ユーザー	Webサイトやアプリで購読解除したメールアドレスをインポートできます。	購読解除ユーザーに上書きされます。
stopped	配信停止ユーザー	購読解除やバウンス以外の理由で配信を行いたくないメールアドレスをインポートできます。	配信停止ユーザーに上書きされます。
bounced	バウンスユーザー	存在しないアドレスなど、ハードバウンスしたメールアドレスをインポートできます。	バウンスユーザーに上書きされます。

注釈💬 複数ファイルを並行してアップロードする場合

複数のファイルを並行してアップロードできます
S3パスとファイル名が同じファイルをアップロードすると、最初のデータが処理されず、最後のデータが複数回処理されることがあります
同日に同名のファイルをアップロードする場合は、ファイル名を変更することを推奨します

CSVフォーマット

フォーマット

CSVファイルは、以下のフォーマットに沿って作成してください。

user_id,email_address
123456,aaaa@example.com
234567,jjjj@example.com

取り込み種別によって、必須となるカラムが異なります。

取り込み種別	必須カラム	任意カラム
配信可能ユーザー	user_id 、 email_address	なし
購読解除ユーザー	email_address	user_id
配信停止ユーザー	email_address	user_id
バウンスユーザー	email_address	user_id

ファイルの制限

CSVファイルのアップロードには、以下の制限があります。

ファイルサイズは最大500MBまで
文字コードはUTF-8のみ利用可能
BOM(バイトオーダーマーク)なしのファイルのみ利用可能
ユーザーIDの指定は必須

アップロード時にエラーになるCSVファイル

以下に該当するCSVファイルは、アップロード時にエラーとなります。

ファイル中に日本語などを含み、UTF-8以外の文字コードで保存されている
別のファイルの拡張子を.csvに変更しただけの不正なファイル
UTF-8で解釈できない文字が記述されている
必須のカラムが、CSVヘッダー(1行目)に記述されていない
同じカラムが、CSVヘッダーに複数存在する
メールアドレスが空、または不正な形式である場合、アップロード自体は成功するが、インポート失敗のエラーメールが届く

インポート時のエラーログは以下のような内容のCSVファイルとしてダウンロードできます。

user_id,email_address
has_error_mail_address,CSVの書式が正しくありません、不正なダブルクォーテーションが使われています

注釈💬

ファイルのアップロードが完了したかどうかは、インポート処理の完了時に送信される通知メールで確認できます。

この通知メールには、インポートしたメールアドレスファイルの情報が記載されています。

なお、エラーが発生した場合は、エラー内容をまとめたCSVファイルのダウンロードリンクもあわせて記載されます。

警告⚠

新規のメールアドレスを登録する場合、必ずユーザーIDとセットでインポートしてください。

登録されたことのないメールアドレスをユーザーIDなしでインポートすると、内部的にユーザーIDが設定されていないユーザーが作成されてしまいます。

後続のインポート時にメールアドレスに対して改めてユーザーIDが設定されると、ユーザー情報が繋がらずに Reproのステータスを維持するを選択しても、事前のステータスを正しく紐づけられません。

SDK経由でセットする(ユーザープロフィール)

アプリやWebサイトに組み込んだSDKから、標準ユーザープロフィールとしてユーザーのメールアドレスをセットする方法です。セットしたメールアドレスは、メールの配信に利用できます。

SDKの設定は実装が必要です。設定方法の詳細は、各SDKの開発ドキュメントを参照してください。

警告⚠

メールアドレスを連携した後で、サービス側にてユーザーが退会しても、Reproのユーザー情報が自動で削除されることはありません。配信対象に含まれるとメールが送信されてしまいます。
「退会ユーザーをメールの配信対象から除外する」対応が必要となります。

以上でメールアドレスのインポート作業が完了しました。