Skip to main content
メールアドレス検証は、メールアドレスが受信者に届く前に一般的な問題を検出します。バウンス率を高めたり送信者の評判を傷つけたりする可能性のある、タイプミス、無効なドメイン、ロールベースのアドレス、使い捨てメールサービスをフラグします。 CSVインポート中に自動的に実行され、既存の受信者リストに対する一括検証ツールとしても使用できます。
メールアドレス検証はOneSignalの検証基準に基づいてアドレスを確認します。これはリアルタイムのバウンス検証チェックではなく、配信可能性を保証するものではありません。

検証チェック

メールアドレス検証は、次のチェックに対して各アドレスを評価します:
無料プランには構文検証とタイプミス検出が含まれます。有料プランには上記すべてに加え、MXレコード確認、ロールベースアドレス検出、使い捨てメールフィルタリングが含まれます。
アドレスがチェックに失敗した場合、メールアドレス検証は特定の問題を説明する人が読めるエラーを返します。アドレスが複数のチェックに失敗した場合、すべての失敗理由が一緒に返されるので、一度にすべてに対処できます。

CSVインポート中のアドレス検証

CSVをインポートする際、インポートを確認する前にレビューステップでメールアドレス検証設定を構成できます。
1

CSVインポートを開始

Audience > Importに移動してファイルをアップロードします。UploadMap Fieldsステップを完了します。無効なメールアドレスが検出された場合、Map Fieldsステップに警告が表示されます。
無効メール検出警告を示すCSVインポートMap Fieldsステップ

Map Fieldsステップの無効メール検出警告

2

レビューステップで検証設定を構成

レビューステップでメールアドレス検証設定を展開します。次のオプションが利用可能です:
メールアドレス検証設定が展開されたCSVインポートレビューステップ

レビューステップのメールアドレス検証設定

  • メールドメイン(MXレコード)を検証:ドメインがメールを受信できることを確認
  • 使い捨てメールアドレスを除外:エンゲージメントを低下させる可能性のある一時または使い捨てアドレスを防止
  • ロールベースメールアドレスを除外:エンゲージメントが低いことが多いinfo@support@などの共有アドレスを防止
3つすべてがデフォルトで有効になっています。このインポートに適用したくないものはチェックを外してください。
無効なメールアドレスをインポートする必要がある場合(例:抑制または購読ステータスを更新する場合)、無効なメールアドレスを許可をチェックしてください。これにより検証がバイパスされ、任意の文字列がメールアドレスとして受け入れられます。
3

確認してインポート

確認してインポートをクリックします。インポートが完了すると、結果を要約したメールが届きます:
  • 追加されたサブスクリプション
  • 変更されたサブスクリプション
  • インポートされなかった行(拒否された行のダウンロードリンク付き)

結果

有効なアドレスが受信者リストに追加されます。インポートが完了するとメールが届きます。検証に失敗したアドレスは除外され、結果メールのリンクからダウンロードできます。

既存の受信者リストを一括検証

一括検証を使用して、OneSignalの受信者リストにすでに登録されているメールアドレスを確認します。結果はCSVエクスポートとしてメールで受け取れます。
1

メールアドレス検証ツールを開く

Audience > Subscriptions(またはAudience > Users)に移動し、Update/Import UsersをクリックしてValidate Email Addressesを選択します。
Validate Email Addressesオプションが強調表示されたUpdate/Import Usersドロップダウン

Update/Import UsersメニューのValidate Email Addressesオプション

2

検証を開始

モーダルでStart validationをクリックします。アプリのすべてのメールアドレスに対してメールアドレス検証が実行されます。
Start validationボタンを示すValidate Email Addressesモーダル

メールアドレス検証確認モーダル

3

メールで結果を受け取る

検証が完了すると、OneSignalからCSV エクスポートをダウンロードリンクが記載されたメールが届きます。リンクは72時間有効です。メールには失敗したアドレス数が次の項目別に要約されています:
検証サマリーとCSVエクスポートダウンロードボタンを示すOneSignal結果メール

分類とCSVエクスポートダウンロードリンクが記載されたOneSignal検証結果メール

  • タイプミス
  • ロールベースアドレス
  • 使い捨てドメイン
  • 無効なMXレコード
4

確認して再インポート

CSVをダウンロードしてフラグされたアドレスを確認します。
email、reason、suggested_email、created_at、last_opened、last_clickedの列を示すCSVエクスポート

メール検証結果のCSVエクスポート

受信者リストをクリーンアップするには、修正または処理されたアドレスを含む新しいCSVを作成し、次の列形式のいずれかを使用して再インポートします:

結果

エラータイプ別に分類された検証結果の要約と共に、フラグされたアドレスのCSVエクスポートが記載されたメールが届きます。

検証エラーリファレンス

検証結果に次のエラーが表示される場合があります:

APIエラーレスポンス

メールアドレス検証はAPIを通じて送信されたアドレスにも適用されます。以下のセクションでは発生する可能性のあるエラーレスポンスを説明します。
API検証はメールアドレスの形式が正しいかどうかのみを確認します。タイプミス、MXレコード、ロールベースアドレス、使い捨てドメインは確認しません。これらのチェックはCSVインポートおよび一括検証中のみ利用可能です。

メール送信:メッセージを作成

メッセージを作成エンドポイントを通じて1つ以上の無効なアドレスに送信すると、無効なアドレスは配信から除外され、invalid_email_tokensの下に返されます。

ユーザーまたはサブスクリプションの追加:ユーザーモデルAPI

ユーザーを作成またはサブスクリプションを作成エンドポイントを通じて無効なメールでユーザーまたはサブスクリプションを作成する場合:

デバイスの追加:レガシーPlayers API

レガシーPlayers APIを通じて無効なメールでプレイヤーレコードを追加または編集する場合:
レガシーPlayers APIは非推奨です。より詳細な検証エラーを受け取り、現在の機能にアクセスするにはユーザーモデルAPIに移行してください。