【第51回】 List Detective に該当するメールアドレスを API で検証する

List Detective 機能とは、Salesforce Marketing Cloud が独自に「不正」と判定しているメールアドレスを以下のタイミングで事前に送信対象から除外させる機能になります。

この機能により、メール送信の配信到達性の問題の原因になる可能性のあるメールアドレスへの送信を避けて IP レピュテーションの低下のリスクを避けることができます。

このデータベースには以下のようなものが含まれます。

List Detective に該当するメールアドレスやロジックが格納されているデータベースは一般には開示されていないものになります。Salesforce サポートの案内によると「個々のメールアドレスが List Detective データベースに含まれている理由については、説明いたします」となっており、ケースを挙げる必要があるのですが、毎回、サポートにケース申請をするのも面倒ですよね。

そこで、今回は自分で検証する方法のお知らせです。

ちなみに List Detective に該当してしまう ユーザー名（アカウント名）の代表的なところは、下記のようなものがあります。

このような ユーザー名を持つメールアドレスの他に spam、blacklist、blocklist のような単語が含まれるメールアドレスも事前に除外されます。

それでは、今回の例として、以下の 2 つのパターンで検証します。
・「info@gmail.com」→ List Detective の対象となる想定
・「info2@gmail.com」→ List Detective の対象とならない想定

以下のスコープが API セットアップで選択されている必要があります。

それでは、List Detective となるメールアドレスを API で検証してみます。

Talend API Tester のリクエストを開き、以下を入力してください。まずは、「info@gmail.com」を検証してみます。

--- メソッド 
POST

--- エンドポイント
[REST ベース URL].rest.marketingcloudapis.com/address/v1/validateEmail

--- ヘッダー
Content-Type：application/json
Authorization：Bearer [アクセストークン]

--- ボディ（サンプル）
{
"email": "info@gmail.com",
"validators": [ "SyntaxValidator", "MXValidator", "ListDetectiveValidator" ]
}

これで「送信」ボタンを押しますと、

「info@gmail.com」が、List Detective であると返されます。

では、一方で「info2@gmail.com」は どうでしょう。検証します。

こちらは、List Detective では無いようですね。想定通りでした。

ちなみに、こちらの API（address/v1/validateEmail） は、以下のように「info@@gmail.com」のようなメールアドレスの「構文エラー」（@が2つあるなど）の検証もできます。覚えておいて下さい。

いかがでしたでしょうか？

最後に一言、この API には難点がありまして、それは 1件ずつしか検証ができないというところです。これが、データエクステンション内のメールアドレスを一括チェックできると便利なんですがね・・・。

今回は以上です。

Click here for English version

次の記事はこちら

前回の記事はこちら

私の note のトップページはこちら