**支援結束通知：**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 最終使用者傳訊支援。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在訊息中使用建議
若要在訊息中新增動態、個人化的建議，請建立並使用包含建議屬性之訊息變數的訊息範本。*訊息變數*是個預留位置，指的是您或 Amazon Pinpoint 建立的特定屬性，用於儲存有關您使用者的資訊。*建議的屬性*可為您的使用者暫時儲存建議。Amazon Pinpoint 會從您部署為 Amazon Personalize 行銷活動的推薦者模型擷取這些建議，並設定要使用的 Amazon Pinpoint。
如果範本包含訊息變數，Amazon Pinpoint 會為每個收件人將每個變數替換成目前對應的屬性值。對於推薦，此程序包括從 Amazon Personalize 行銷活動，為每個收件人擷取最新推薦。Amazon Pinpoint 每次傳送使用了範本的訊息時，都會執行此操作。這表示您可以確認訊息中包含給收件人的最新建議。
例如，如果您的專案是向使用者建議電影和電視節目的應用程式，每個使用者可能會具備下列屬性：
+ 使用者的名字。
+ 使用者最近提交的評分。
+ 使用者最近評分的影片或節目標題。
+ 前三部電影的標題，並顯示該模型向使用者提供建議。
對於此專案，您可以在範本中使用下列文字和訊息變數：
`Hi {{User.UserAttributes.FirstName}}, based on your recent {{User.UserAttributes.LatestRating}}-star rating for {{User.UserAttributes.LatestRatedTitle}}, we think you might also enjoy: {{RecommendationItems.[0]}}, {{RecommendationItems.[1]}}, and {{RecommendationItems.[2]}}.`
您傳送使用了範本的訊息時，Amazon Pinpoint 會為每個收件人將變數替換成目前對應的屬性值。下列範例將顯示此情況。
**範例 1**
`Hi Sofia, based on your recent 5-star rating for The Marvelous Mrs. Maisel – Season 3, we think you might also enjoy: Fleabag, Late Night, and Catastrophe.`
**範例 2**
`Hi Alejandro, based on your recent 4-star rating for Tom Clancy's Jack Ryan – Season 2, we think you might also enjoy: Hanna, Hunters, and Agatha Christie's The ABC Murders.`
如果您已設定建議者模型，透過使用 AWS Lambda 函數來增強建議，範本和產生的訊息可能會使用其他變數和建議的屬性。例如，他們也可能會針對提供影像的屬性使用變數，以及針對每個建議的影片或節目使用 URL。
如需在範本中使用訊息變數的相關詳細資訊，請參閱[將個人化內容新增至訊息範本](message-templates-personalizing.md)。
## 將建議新增至訊息
若要在訊息中新增個人化的建議，請建立並使用訊息範本，其中包含您要使用的建議訊息變數。您可以將這些變數新增至下列類型的訊息範本：
+ 電子郵件範本，適用於您從行銷活動或旅程傳送的電子郵件訊息。
+ 推播通知範本，用於您從行銷活動傳送的推播通知。
+ SMS 範本，適用於您從行銷活動傳送的 SMS 文字訊息。
每個範本一次可以使用來自一個建議者模型的變數和建議屬性。
您可以在建立範本時將變數新增至新範本，或將變數新增至現有範本。如果您將變數加入現有範本，Amazon Pinpoint 不一定會將變更套用到使用了該範本且尚未傳送的訊息，例如排定在稍後傳送的行銷活動訊息。這取決於您新增變數的範本版本，以及使用該範本之訊息的設定方式。如需詳細資訊，請參閱[管理訊息範本的版本](message-templates-versioning.md)。
**將建議新增至訊息範本**
1. 開啟位於 [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 的 Amazon Pinpoint 主控台。
1. 在導覽窗格中，選擇 **Message templates (訊息範本)**。
1. 在 **Message templates (訊息範本)** 頁面中，執行以下其中一項操作：
+ 若要建立新範本並在其中新增建議，請選擇 **Create template (建立範本)**。然後，在範本頁面中輸入範本的名稱，並輸入範本的描述 (非必要)。
+ 若要將建議新增至現有範本，請選擇您要的範本。然後，在範本頁面中選擇 **Edit (編輯)**。在 **Template details (範本詳細資訊)** 下，使用版本選取器來選擇您要做為起點使用的範本版本。如果您選擇的是最新版本，則可將變更直接儲存至該範本版本。或者，您可以將變更儲存為新的範本版本。
1. 在 **Attribute finder (屬性搜尋工具)** 中，展開 **Recommended attributes (建議的屬性)** 區段。
如果您尚未為範本選取建議者模型，請選擇 **Connect model (連接模型)**。接下來，選取當您傳送使用範本的訊息時，要從中擷取建議的模型。然後選擇 **Connect model (連接模型)**。
1. 在**建議的屬性**下，選擇要新增訊息變數的屬性。Amazon Pinpoint 為該屬性建立變數，並複製到剪貼簿。然後，在訊息編輯器中，將變數貼到您希望建議在訊息中出現的位置。
您貼上變數之後，Amazon Pinpoint 會以相關聯的屬性名稱顯示變數，並用兩組大括弧括起來，例如 `{{RecommendationItems}}`。
1. 如果建議者模型提供一個以上的建議屬性，請針對您要新增變數的每個額外屬性重複上述步驟。
您也可以為其他類型的屬性新增變數。若要這樣做，展開 **Attribute finder (屬性搜尋工具)** 中的其他區段，選擇您想要的每個額外屬性，然後將該變數貼到您想要的位置。若要了解如何將變數用於其他類型的屬性，請參閱[將個人化內容新增至訊息範本](message-templates-personalizing.md)。
1. 若要指定訊息變數的預設值，請展開 **Default attribute values (預設屬性值)** 區段。然後，在變數清單中輸入您要用於變數的預設值。我們建議您針對範本中的每個變數執行此作業。
1. 完成後，請執行下列其中一項操作：
+ 如果您已將訊息變數新增至新範本，請選擇 **Create (建立)**。
+ 如果您已將訊息變數新增至現有範本，而且您想將變更儲存為新的範本版本，請選擇 **Save as new version (儲存為新版本)**。
+ 如果您已將訊息變數新增至現有範本，而且您想將變更儲存為最新版本的範本更新，請選擇 **Update version (更新版本)**。只有當您在步驟 3 中開啟的是最新版範本時，才可以使用此選項。
您現在可以使用範本，將個人化建議併入您從行銷活動和旅程傳送的訊息中。
請注意，您無法在傳送給受限對象的訊息中包括建議做為直接或測試訊息。雖然您可以更廣泛地在這些訊息中使用範本，但 Amazon Pinpoint 無法將模型中的建議，與直接訊息或測試訊息的收件人相互關聯。若要測試使用建議之範本的外觀和格式，請為參考建議屬性的每個訊息變數指定預設值，然後傳送使用範本的測試訊息。
## 從訊息移除建議
若要從訊息中移除個人化建議，請更新訊息所使用的訊息範本。當您更新範本時，請移除建議的所有訊息變數或只移除部分訊息變數。
如果您從範本移除建議，Amazon Pinpoint 不一定會將變更套用到使用了該範本且尚未傳送的訊息，例如排定稍後傳送的行銷活動訊息。這取決於您從中移除建議的範本版本，以及使用該範本之訊息的設定方式。如需詳細資訊，請參閱[管理訊息範本的版本](message-templates-versioning.md)。
**從訊息範本移除建議**
1. 開啟位於 [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 的 Amazon Pinpoint 主控台。
1. 在導覽窗格中，選擇 **Message templates (訊息範本)**。
1. 在 **Message templates (訊息範本)** 頁面中，選擇您要從中移除建議的範本。然後，在範本頁面中選擇 **Edit (編輯)**。
1. 在 **Template details (範本詳細資訊)** 下，使用版本選取器來選擇您要做為起點使用的範本版本。如果您選擇的是最新版本，則可將變更直接儲存至該範本版本。或者，您可以將變更儲存為新的範本版本。
1. 在訊息編輯器中，針對您要移除的每個建議屬性，刪除訊息變數的所有文字。每個訊息變數都由兩組大括弧和相關屬性的名稱組成，例如 `{{RecommendationItems}}`。
若要將建議者模型完全從範本中刪除，請刪除該模型提供的建議屬性之所有變數。然後，在 **Attribute finder (屬性搜尋工具)** 中，展開 **Recommended attributes (建議的屬性)** 區段，然後選擇模型名稱旁邊的 **X**。
1. 完成後，請執行下列其中一項操作：
+ 若要將變更儲存為新的範本版本，請選擇 **Save as new version (儲存為新版本)**。
+ 若要將變更儲存為最新版本的範本更新，請選擇 **Update version (更新版本)**。只有當您在步驟 4 中選擇的是最新版範本時，才可以使用此選項。