**支援結束通知：**2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 [Amazon Pinpoint 終止支援](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：**與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 對行銷活動進行故障診斷
<a name="campaigns-troubleshooting"></a>

確認已開啟記錄功能，以協助識別失敗的原因。如需詳細資訊，請參閱[監控和記錄](troubleshooting.md#troubleshooting-logging)和[行銷活動事件](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-campaign.html)。

## 行銷活動未成功處理或鎖定某些端點
<a name="troubleshooting-campaign-endpoints"></a>

 **目標端點**：行銷活動針對所選頻道執行時，目標端點的總數。此總數不包括客群中重複或非作用中的端點。

**處理的端點**：行銷活動執行成功鎖定目標的端點總數。

對於**動態區段**，端點計數可以根據為對象定義的條件隨時間變更，因此每個頻道的端點數量僅為估計值。您可以匯出客群，以取得任何指定時間的端點總數。
+ 根據交付管道限制進行調節
+ 如果您排定行銷活動使用收件人的當地時間 (isLocalTime 設定為 true)
+ 如果行銷活動沒有設定足夠的時間來處理所有端點
+ 下游交付問題或轉譯問題
+ 永久故障

### 限流
<a name="troubleshooting-campaign-throttling"></a>
+ 在行銷活動執行`CampaignSendMessageThrottled`的時間範圍內檢閱 Amazon CloudWatch 指標，以確認是否為問題。如需詳細資訊，請參閱[在 CloudWatch 中檢視 Amazon Pinpoint 指標](monitoring-view-metrics.md)。
+ 超出端點交付速率能力時，我們會限流。詳情請參閱 Amazon Pinpoint [配額](https://docs.aws.amazon.com/pinpoint/latest/developerguide/quotas.html)。

### 使用收件人時區
<a name="troubleshooting-campaign-time"></a>

當行銷活動排程為針對行銷活動使用收件人的當地時間 ([isLocalTime](https://docs.aws.amazon.com//pinpoint/latest/apireference/apps-application-id-campaigns.html) 設為 true) 時，所有端點都必須在端點定義中具有正確格式化的`Demographic.Timezone`屬性值，否則端點將無法成功成為目標。這是因為 [isLocalTime](https://docs.aws.amazon.com//pinpoint/latest/apireference/apps-application-id-campaigns.html) 選項會根據每個收件人的本機時區來決定交付時間。

### 處理時間
<a name="troubleshooting-campaign-processing-time"></a>
+ 當行銷活動沒有足夠的時間處理所有目標端點時，不會處理端點，且日誌會顯示 `campaign_send_status`的 [https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-campaign.html#event-streams-data-campaign-attributes-attrs](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-campaign.html#event-streams-data-campaign-attributes-attrs)。
+ 根據行銷活動鎖定的端點數目，確認是否根據您的使用案例和交付管道，設定了**行銷活動執行的時間上限**和**每秒訊息數上限**。如需詳細資訊，請參閱[編輯專案的預設設定](projects-manage-edit.md)。

### 交付、轉譯或永久失敗
<a name="troubleshooting-campaign-other"></a>
+ 到達不同的端點類型時，可能發生交付問題。確認已啟用記錄功能，以協助識別失敗的原因。若要進一步疑難排解下游交付問題，請參閱與對應端點類型 [對電子郵件管道進行故障診斷](channels-email-troubleshooting.md)、[對語音頻道進行故障診斷](channels-voice-troubleshooting.md)、 [對 SMS 管道進行故障診斷](channels-sms-troubleshooting.md)和 相關聯的交付問題[對推送通道進行故障診斷](channels-push-troubleshooting.md)。
+ 轉譯問題發生的原因如下：使用訊息範本時，範本資料遺失、範本資料格式不正確，或範本參數和端點資料不符。如需詳細資訊，請參閱交付問題下的電子郵件區段。
+ 永久失敗，是指 Amazon Pinpoint 可能無法連線到端點地址的情況。永久錯誤的原因顯示在日誌中。永久失敗不會重試。永久失敗包括無效的地址 (例如電子郵件地址或電話號碼)，以及許可問題、沙盒中的帳戶或配額不足。