Marketing Cloud のトリガーによる送信が購読者に送信されない

※この記事は英語版を翻訳しており、一部機械翻訳を含むため内容は後日更新される可能性があります。最新の内容は英語版を参照してください。表示言語は画面右下の言語名から切り替えられます。

概要

トリガーによる送信定義によって、Marketing Cloud メールを送信すると、送信がトリガーによる送信 API 呼び出しに指定された購読者に配信されないことがありました。

トリガーによる送信は、購読者が行ったアクションによって作成されるため、データエクステンションやリスト送信とは少し異なります。Email Studio のトリガーによるメールでは、SOAP または REST API のいずれかを使用する必要があるため、送信が成功したかどうかのトラブルシューティング時に複雑さが増します。

購読者にトリガーによるメールが送信されない一般的な理由がいくつかあります。各セクションで、動作の概要と、それがメールが送信されない原因となっているかどうかを確認する方法を示します。

⚠️: このナレッジ記事は、Email Studio 経由のトリガーによる送信専用です。一部の情報は Transactional API にも当てはまりますが、この記事は、Email Studio 経由のトリガーによる送信のみに焦点を合わせています。

トリガーによる送信の状況

トリガーによる送信でメールが送信されるためには、実行中/有効状況である必要があります。UI の 4 つの状況と SOAP API の使用時の追加の状況があります。

新規 (UI) と新規 (API)
一時停止 (UI) と無効 (API)
実行中 (UI) と有効 (API)
アーカイブ済み (UI) とキャンセル済み (API)
削除済み (API のみ)

Email Studio 内でトリガーによる送信の状況を確認するには、次の手順を使用します。

MC テナントにログインし、Email Studio に移動します
[インタラクション] を選択し、メニュー内の [トリガーによるメール] を選択します
フォルダ構造内でトリガーによる送信を見つけます
右側で、[状況] 列を確認して、トリガーによる送信が [実行中] であることを確認します

トリガーによる送信が一時停止/無効状況である場合、メールはキューに登録され、トリガーによる送信が実行中/有効状況になると送信されます。[開始/再開] を押すとすぐに、システムによってキューに登録されているメールの送信が試みられます。キューに登録されているメールの送信に懸念がある場合は、「トリガーによる送信のキューオプション」を参照して、キューに登録されたメールを識別し、トリガーによる送信キューを消去します。

⚠️: Marketing Cloud には 3 日間のトリガーによる送信の有効期限ポリシーがあります

除外管理

ドメイン除外データエクステンションまたは除外スクリプトを使用して、トリガーによる送信から購読者を除外できます。除外された購読者はメールの SendLog に表示されませんが、NotSent データ抽出に表示されます。

ドメイン除外データエクステンション

ドメイン除外データエクステンションは、「DomainExclusion」テンプレートで作成されるデータエクステンションです。トリガーによる送信の設定時に、「DomainExclusion」テンプレートで作成されたデータエクステンションのみがドメイン除外フォルダツリーに表示されます。

ドメイン除外データエクステンションには、事前定義された「ドメイン」項目が付属し、トリガーによる送信に適切で適合すると考えられる数のドメインを入力できます。ドメイン除外データエクステンションにドメインが含まれている EmailAddress に送信を試みるすべての API 呼び出しは送信されません。

API 呼び出し内の EmailAddress は、[すべての購読者] リスト内の SubscriberKey の EmailAddress とは違うものを指定できます。[すべての購読者] リストでその SubscriberKey を確認することは、送信からの除外を確認する正確な方法ではない可能性があります。

ドメイン除外データエクステンションによって除外される購読者を確認するには、NotSent データ抽出を設定して、ファイルを確認すると、除外される購読者が次のように表示されます。

SendID = 送信の JobID
EventType = NotSent
Reason = Domain Exclusion

除外スクリプト

除外スクリプトでは AMPscript を使用して、トリガーによる送信の受信から購読者を制限します。「トリガーによる送信を一度に 1 人の購読者へのメール送信に制限する除外スクリプトの作成」の記事には、この機能を使用した例を示しています。

購読者が除外スクリプトによって除外されている場合、購読者には除外スクリプトを指す理由が表示されるため、NotSent データ抽出を確認してください。

SendID = 送信の JobID
EventType = NotSent
Reason = Excluded by Send Time Filter

⚠️: トリガーによる送信定義内に除外スクリプトを作成できない場合、この機能を有効にするカスタマーサポートのケースを作成してください。

API 呼び出しのトラブルシューティング

トリガーによる送信メールメッセージを作成するときは、TriggeredSendDataExtension テンプレートを使用して、トリガーによる送信データエクステンションを作成することをお勧めします。トリガーによる送信データエクステンションをトリガーによる送信メールに関連付けると、API 呼び出しと購読者に関する特定の詳細を記録することで、配信の問題のトラブルシューティングに役立ちます。

⚠️: API 呼び出しの詳細なトラブルシューティングのために、Marketing Cloud に対して行う完全な API リクエストと応答をログに記録することをお勧めします。

Marketing Cloud では、同期 (sync) と非同期 (async) の両方の API 呼び出しが許可されます。以下のセクションでは、システムで同期呼び出しと非同期呼び出しを処理する方法の違いについて説明します。

同期 API 呼び出し

非同期のトリガーによる送信 API 呼び出しを実行すると、Marketing Cloud では単一のトランザクションでリクエストが処理され、応答されます。Marketing Cloud エンドポイントによって提供された API 応答を確認し、API 呼び出しがトリガーによる送信メールの送信に失敗した理由を判断します。

最も一般的な ErrorCode は 180008 です。SOAP エラーコード開発者ドキュメントでエラーコードの完全なリストを確認してください。

非同期 API 呼び出し

トリガーによる送信 API 呼び出しを非同期で実行すると、Marketing Cloud で API 呼び出しの構造が正しいことが確認された後、処理キューにリクエストが入れられます。システムでは、初期応答を送信する前に、呼び出しを処理しようとしたり、提供されたデータでメールの送信が成功するかどうかを評価したりしません。

非同期 API 呼び出しは応答前に完全に処理されないため、初期の成功応答を受信しても、API 呼び出し内の誤ったデータや欠落しているデータのために、メールの送信が失敗する可能性があります。

非同期処理のドキュメントを読んで、この API 処理方法が適切かどうかを判断することをお勧めします。非同期 API 呼び出しを使用している場合、非同期呼び出しの最終結果を確認する非同期呼び出しのコールバック処理を実装していることを確認してください。

コールバック処理を実装していない場合は、非同期の代わりに、同じ API 呼び出しを同期的に実行して、呼び出しの応答でリアルタイムエラーを取得できます。

同期または非同期呼び出しが失敗した場合は、SendLog (設定されている場合) または NotSent データ抽出を確認して、購読者が送信から除外されたかどうか、およびその理由を確認してください。

⚠️: 一部のエラーコードは SendLog データエクステンションに記録され、API 呼び出しのトラブルシューティングに使用できますが、送信の除外された購読者を識別するには、NotSent データ抽出が推奨されるソースになります。

API を使用し、deliveryRecords URI 経由で、messageDefinitionSends サービスの結果を返すこともできます。エンドポイントには、messageDefinitionSends サービスの応答からの RecipientSendId 値が必要であるため、この値をログに記録していることを確認し、次にそれを URL パラメータとして追加して、トリガーによる送信メッセージの配信 (または未配信) を確認してください。

messageDefinitionSends ルートからの応答の例を次に示します。

{ "requestId": "9719beb7-7447-4c19-ae56-b16e863be863", "responses": [ { "recipientSendId": "9719beb7-7447-4c19-ae56-b16e863be863", "hasErrors": false, "messages": [ "Queued" ] } ] }

recipientSendId 値を書き留めたら、これを次のように URL に挿入します。

https://xxxxxxxxxxxxxxx.rest.marketingcloudapis.com/messaging/v1/messageDefinitionSends/key:PasswordReset/deliveryRecords/9719beb7-7447-4c19-ae56-b16e863be863

GET 呼び出しを実行して、送信に関する情報が返されたら、応答に、送信が成功したか失敗したかに関する情報が提供されます。次に失敗した送信の例を示します。

{ "id": "fe9fbb4c-d316-ec11-b835-48df37d1df5a", "messageId": "af6d0b88-fa96-4815-a7d9-d7312978a5c2", "status": "Error", "to": { "address": "", "id": 0, "key": "" }, "messageErrors": [ { "messageErrorStatus": "There are required data extension fields missing for the subscriber" } ] }

標準メールトラブルシューティング

トリガーによる送信が有効で、API 呼び出しが正しいことを確認したら、標準メールトラブルシューティングステップを実行します。