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

検証チェック

メールアドレス検証は、次のチェックに対して各アドレスを評価します:
チェック検出内容
構文検証必須コンポーネントが欠けている不正な形式のアドレス(例:@の欠如、無効なTLD)
タイプミス検出gnail.comgmail.conなどの一般的なドメインのスペルミス
MXレコード確認有効なメール交換レコードがないドメイン;ここに送信されたメールは配信不可
ロールベースアドレス個人のものである可能性が低いsales@info@admin@などのアドレス
使い捨てメール一時または使い捨てメールサービスに関連するドメイン
無料プランには構文検証とタイプミス検出が含まれます。有料プランには上記すべてに加え、MXレコード確認、ロールベースアドレス検出、使い捨てメールフィルタリングが含まれます。
アドレスがチェックに失敗した場合、メールアドレス検証は特定の問題を説明する人が読めるエラーを返します。アドレスが複数のチェックに失敗した場合、すべての失敗理由が一緒に返されるので、一度にすべてに対処できます。

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

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

CSVインポートを開始

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

検証を開始

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

メールで結果を受け取る

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

確認して再インポート

CSVをダウンロードしてフラグされたアドレスを確認します。
email、reason、suggested_email、created_at、last_opened、last_clickedの列を示すCSVエクスポート
受信者リストをクリーンアップするには、修正または処理されたアドレスを含む新しいCSVを作成し、次の列形式のいずれかを使用して再インポートします:
目標必須列
修正されたアドレスを再購読emailsubscribedsubscribed = yes
フラグされたアドレスを購読解除emailsubscribedsubscribed = no
フラグされたアドレスを抑制emailsuppressedsuppressed = true

結果

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

検証エラーリファレンス

検証結果に次のエラーが表示される場合があります:
エラー意味対処方法
無効な入力アドレスの形式が正しくなく、基本的な構文要件を満たしていません(例:@の欠如、無効なTLD)。アドレスを修正または削除してください。
メールアドレスのタイプミスドメインに誤りが検出されました。隣の列に提案された修正が表示されます。提案された修正を適用するか、アドレスを削除してください。
MXレコードが見つかりませんドメインに有効なメール交換レコードがありません。このアドレスにはメールを配信できません。アドレスを削除または抑制してください。
ロールベースのメールアドレスローカル部分(@の前)がsales@support@などの既知のロールベースパターンと一致します。これらのアドレスは個人のものである可能性が低いです。アドレスがユースケースに適切かどうかを確認してから、抑制または削除してください。
使い捨てメールアドレスドメインが一時または使い捨てメールサービスに関連しています。アドレスを抑制または削除してください。

APIエラーレスポンス

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

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

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

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

ユーザーを作成またはサブスクリプションを作成エンドポイントを通じて無効なメールでユーザーまたはサブスクリプションを作成する場合:
{
  "errors": [
    {
      "title": "Invalid `token` format for device type email"
    }
  ]
}

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

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