メール配信用ユーザー情報インポート¶

メールを配信したいユーザーのメールアドレスをReproに連携する方法は3つあります。用途に合わせて後述する手順を参照し、メールアドレスを連携してください。

連携方法	概要	用途
管理画面からCSVをアップロードする	Reproの管理画面からメールアドレスリストをCSVファイルとしてアップロードします。	Reproのメール利用開始時の一括取り込み、CDPや自社基盤で抽出したメールアドレスの取り込み等
S3へアップロードする	Reproの提供するAWS S3 bucketに対してメールアドレスリストをCSVファイルとしてアップロードします。	CDPや自社基盤で保有しているメールアドレスの継続的取り込み
SDK(iOS/Android/Web)経由でセットする	SDKでユーザープロフィールとしてメールアドレスをセットします。	アプリやサービスでメールアドレスを取得した際の取り込み

取り込むべきメールアドレス種別¶

取り込み種別	説明	配信可否
配信可能ユーザー	現在メールを正常に送信できる状態のユーザーのメールアドレス。購読解除・バウンス・配信停止に該当しないもの。	行われる
購読解除ユーザー	Webサイトやアプリ設定、配信されたメールから購読解除（オプトアウト）を行ったユーザーのメールアドレス	行われない
バウンスユーザー	メールアドレスやドメインが存在せず恒久的なエラー状態のメールアドレス	行われない
配信停止ユーザー	上記以外の理由でメール配信を行わないほうがよいユーザーのメールアドレス	行われない

注釈

Reproでメールアドレスを取得しているユーザーがすでに退会済みの場合でも、Reproからメールが送信されます。退会ユーザーにつきましては、退会ユーザーを表すユーザープロフィールをSDKやユーザープロフィールAPIから付与した上で、配信対象から外すことを推奨いたします。

管理画面からメールアドレスをインポートする¶

メール配信用ユーザー情報インポート画面に遷移¶

設定 > メール設定 > メール配信用ユーザー情報インポートにアクセスします。

メールアドレスをインポートする¶

[CSVファイルをインポート] > [ファイルを選択]をクリックしてCSVファイル（拡張子 .csv のみ選択可能）を選び、[配信チャネルを選択]で紐づけ先のチャネルを選択し、[インポートするメールアドレスの種別]を選択して[インポートを実行]をクリックします。インポート時は後述するCSV仕様に基づいて作成したCSVを選択してください。ファイルサイズが上限（500MB）を超えている場合はアップロードできません。

取り込み種別	説明	配信可否
配信可能ユーザーとしてメールアドレスをインポート	メールの配信対象として、オプトインされたメールアドレスをインポートできます	行われる
購読解除ユーザーとしてメールアドレスをインポート	Webサイトやアプリで購読解除したメールアドレスをインポートできます	行われない
配信停止ユーザーとしてメールアドレスをインポート	購読解除やバウンス以外の理由で配信を行いたくないメールアドレスをインポートできます	行われない
バウンスユーザーとしてメールアドレスをインポート	存在しないアドレスなど、ハードバウンスしたメールアドレスをインポートできます	行われない

メールチャネルの指定¶

どのチャネルに対してメールアドレスおよびユーザーIDを紐づけるかを指定するために、[配信チャネルを選択]でチャネルを選択します。

注釈

「全てのユーザー」以外のチャネルを指定してCSVをインポートした場合、「全てのユーザー」チャネルに対しても情報が紐づけられます。ただし、「全てのユーザー」にも情報が紐づけられるのは、対象となるユーザーが「全てのユーザー」チャネルに対する購読情報が存在しない時のみです。

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

Reproにすでに存在するユーザーIDがインポートするメールアドレスリストに含まれている場合、[すでにReproに存在するユーザーIDをインポートした場合]のチェックボックスで、Reproにすでに存在するユーザーのステータスを維持するか、インポート時のステータスで上書きするかを選択できます。

例）

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

ステータスを維持したい場合、[Reproのステータスを維持する]にチェックを入れてください。チェックを入れた場合、配信可能ユーザーとしてのインポートのみが選択可能になります。

注釈

取り込み前のユーザーのステータスがバウンスユーザーの場合、その他のステータスに上書きすることはできません。

インポート履歴を確認する¶

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

ステータスは「初期化中」「アップロード中」「インポート中」「インポート完了」「利用不可」「エラー」のいずれかで表示されます。エラーが発生した場合、エラーログ列からエラー内容を記載したCSVファイルをダウンロードできます。

警告

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

CSV仕様¶

アップロードする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`

警告

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

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

アップロード可能なCSVファイルは最大500MBです。なお、BOMなしのCSVファイルのみ利用可能です。
CSVファイルの文字コードはUTF-8のみ利用可能です。ファイル中に日本語などを含みUTF-8以外で保存されているとアップロード時にエラーとなります。
以下のケースは「不正なCSVファイル」としてアップロード時にエラーとなります。
- 別のファイルの拡張子を .csv にしただけのような不正なファイル
- UTF-8で解釈できない文字が記述されている
- 必須のカラムがCSVヘッダー(1行目)に記述されていない
- 同じカラムがCSVヘッダーに複数存在する
メールアドレスが空の場合、あるいはメールアドレスの形式が不正な場合はアップロードに成功しますが、その後インポートに失敗した旨のエラーメールが送信されます。
インポート時のエラーログは以下のような内容のCSVファイルとしてダウンロードできます。

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

S3アップロード¶

Reproの提供するAWS S3 bucketに対してCSVファイルをアップロードすることで、メールアドレスの登録を行うことができます。利用するバケット名・パスは、メール配信用ユーザー情報インポート画面に表示されるため、そのままご利用いただけます。

注釈

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

警告

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

例として、AWS CLIを利用した場合には以下のようなコマンドでメールアドレスの記載されたCSVをS3にアップロードできます。 <EMAIL_CHANNEL_ID> の部分はメールチャネル設定の該当チャネルに表示されているチャネルIDを指定してください。また <YOUR_APP_ID> の部分は管理画面に記載されているものをお使いください。 (insert|subscribe|unsubscribe|stopped|bounced) の部分は、取り込みオペレーションを1種類のみ指定してください。

取り込みオペレーションと挙動は以下のようになります。すでにReproに存在するユーザーIDをインポートした場合の挙動はこちらの例も参照ください。

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

$ 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

よくあるご質問¶

ファイルのアップロードが完了したかはどのように知ることができますか？¶

インポート処理が完了すると、インポートしたメールアドレスファイルの情報を記載した通知メールが送信されます。エラーが発生した場合は、エラー用CSVファイルのダウンロードリンクも合わせて記載されます。

S3パスに含まれるyear、month、dayはいずれも指定が必須ですか？¶

全て指定が必須です。ファイルアップロード日をyyyy/mm/dd（例：2025/04/30）形式で指定するようにしてください。

S3へのアップロード中、さらに別のファイルをアップロードすることは可能ですか？¶

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

同一ユーザーに対して違うメールアドレスを設定して取り込んだ場合、そのユーザーのメールアドレスはどのように設定されますか？¶

メールアドレスは最後に取り込まれたものが反映されます。例えば以下のような2行があるファイルを取り込んだ場合、 user-01 のメールアドレスは mail-address-02@example.com になります。

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

SDKを利用してメールアドレスをセットする¶

iOS/Android SDK、Web SDKから標準ユーザープロフィールとしてユーザーのメールアドレスをセットすることで、一斉配信メールの配信に利用できます。各SDKの設定方法の詳細は以下を参照してください。