使用 Amazon Pinpoint 將取消訂閱標頭新增至電子郵件 - Amazon Pinpoint

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

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

使用 Amazon Pinpoint 將取消訂閱標頭新增至電子郵件

注意

在使用電子郵件標頭之前，如果您是從行銷活動或旅程傳送電子郵件，則必須設定電子郵件協同運作傳送角色。對於直接傳送電子郵件，您必須擁有 ses:SendEmail和 的許可ses:SendRawEmail。如需詳細資訊，請參閱《Amazon Pinpoint 使用者指南》中的建立電子郵件協同運作傳送角色。

在電子郵件中加入取消訂閱連結是最佳做法，在某些國家/地區也是法律規定。若要新增一鍵式取消訂閱連結，請新增下列標頭：

  1. 將標頭名稱設定為 List-Unsubscribe，並將值設定為取消訂閱連結。連結必須支援 HTTP POST 請求，才能處理收件人取消訂閱請求。

  2. 將標頭名稱設定為 List-Unsubscribe-Post，並將值設定為 List-Unsubscribe=One-Click。

您最多可以將 15 個標頭新增至電子郵件訊息。如需支援的標頭清單，請參閱《Amazon SES Simple Email Service 開發人員指南》中的 Amazon SES 標頭欄位。 https://docs.aws.amazon.com/ses/latest/DeveloperGuide/

下列範例示範如何使用 傳送具有取消訂閱標頭的電子郵件訊息 AWS Command Line Interface。如需設定 的詳細資訊 AWS CLI，請參閱AWS Command Line Interface 《 使用者指南》中的設定 AWS CLI。

在下列命令中，執行下列動作：

  • 將 AppId 取代為您的應用程式 ID。

  • 以收件人的電子郵件地址取代 richard_roe@example.com。

  • 將 https://example.com/unsub 取代為您的取消訂閱連結。

  • 將 example123456 取代為收件人的唯一識別符。

aws pinpoint send-messages --application-id AppId --message-request '{
 "Addresses": {
   "richard_roe@example.com": {
     "ChannelType": "EMAIL"
   }
 },
 "MessageConfiguration": {
   "EmailMessage": {
     "Substitutions": {
       "url": [
         "https://example.com/unsub"
       ],
        "id1": [
          "/example123456"
        ]
     },
     "SimpleEmail": {
       "TextPart": {
         "Data": "Sample email message with an subscribe header",
         "Charset": "UTF-8"
       },
       "Subject": {
         "Data": "Hello",
         "Charset": "UTF-8"
       },
       "Headers": [
         {
           "Name": "List-Unsubscribe",
           "Value": "{{url}}{{id1}}"
         },
         {
           "Name": "List-Unsubscribe-Post",
           "Value": "List-Unsubscribe=One-Click"
         }
       ]
     }
   }
 }
}'