如何排查 Amazon Pinpoint 行銷活動訊息失敗問題？

解決方案

對於未處理或鎖定目標的端點

1.    驗證行銷活動是否已啟用使用收件人本機時間設定。有關説明，請參閲 Amazon Pinpoint 用户指南中的以特定日期和時間傳送行銷活動。

2.    如果設定已啟用，請確保每個端點定義都包含有效的 Demographic.Timezone 屬性。

注意：如果端點沒有定義有效的 Demographic.Timezone 屬性，並且行銷活動的使用收件人本機時間設定處於啟用狀態，則不會處理該端點。

對於已處理和鎖定目標但未接收訊息的端點

出於多種原因，Amazon Pinpoint 行銷活動可能無法將訊息傳送到特定端點。要排查特定端點的訊息失敗問題，請首先將 Amazon Pinpoint 設定為向 Amazon Kinesis 傳送有關事件的資訊。然後，重新建立訊息失敗並在 Amazon Kinesis 中檢閱失敗的事件，以確定引發錯誤的原因。確定引發錯誤的原因後，請修復此問題。

**注意：**每個串流事件中的 event_type 值可指示大多數訊息失敗的原因。如果 event_type 值沒有明確指出引發訊息失敗的原因，請檢閱 Amazon CloudWatch 中行銷活動的 CampaignSendMessageThrottled 指標。此指標顯示由於 AWS 帳戶傳送訊息的能力受到限制而未傳送的行銷活動訊息數量。如需詳細資訊，請參閱 Amazon Pinpoint 配額。

對於失敗的電子郵件

確保識別具有以下 event_type 值的任何串流事件：_email.rendering_failure。此事件類型通常表示電子郵件範本包含無效或缺失的變數。

-或-

(如果您沒有啟用 Kinesis 串流) 檢閱 Amazon CloudWatch 中行銷活動的 Amazon Simple Email Service (Amazon SES) 轉譯失敗指標。此指標通常還表示電子郵件範本包含無效或缺失的變數。

如果您在 CloudWatch 中看到具有 _email.rendering_failure 事件類型的串流事件或任何 Amazon SES 轉譯失敗指標，請執行以下動作：

1.    驗證範本檔案中的所有訊息變數均在端點定義 (區段檔案) 中具有對應的端點屬性。

2.    驗證範本檔案中的所有訊息變數均在端點定義中具有正確的格式。

3.    為範本檔案中的所有訊息變數指定預設屬性值。有關更多資訊，請參閲 Amazon Pinpoint 使用者指南中的建立電子郵件範本。

**注意：**如果未指定預設值，且收件人的值不存在，則 Amazon Pinpoint 不會傳送該訊息。

有關更多資訊，請參閲 Amazon Pinpoint 使用者指南中的向訊息範本新增個人化內容。

---