如何排查 Amazon Pinpoint 活动邮件故障？

解决方法

对于未处理或定向的端点

1.    验证活动是否已启用 Use recipients local time（使用收件人当地时间）设置。有关说明，请参阅《Amazon Pinpoint 用户指南》中的在特定日期和时间发送活动。

2.    如果已启用此设置，请确保每个端点定义包含有效的 Demographic.Timezone 属性。

**注意：**如果端点未定义有效的 Demographic.Timezone 属性并且已启用活动的 Use recipients local time（使用收件人当地时间）设置，则不会处理该端点。

对于已处理且定向但未接收邮件的端点

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) Rendering Failures（渲染故障）指标。此外，该指标通常还会指示电子邮件模板中包含无效变量或者缺少变量。

如果您在 CloudWatch 中看到事件类型为 _email.rendering_failure 的流式传输事件，或者任何 Amazon SES Rendering Failures 指标，请执行以下操作：

1.    验证端点定义（分段文件）中的模板文件中的所有邮件变量包含相应的端点属性。

2.    验证端点定义中的模板文件中的所有邮件变量均采用了正确的格式。

3.    为模板文件的所有邮件变量指定 Default attribute values（默认属性值）。有关更多信息，请参阅《Amazon Pinpoint 用户指南》中的创建电子邮件模板。

**注意：**如果您未指定默认值并且收件人值不存在，则 Amazon Pinpoint 不会发送该邮件。

有关更多信息，请参阅《Amazon Pinpoint 用户指南》中的在邮件模板中添加个性化内容。

---