**支援結束通知：**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="message-templates-personalizing"></a>

若要在使用範本的訊息中提供動態、個人化的內容，請將*訊息變數*新增至訊息範本。*訊息變數*是個預留位置，指的是您或 Amazon Pinpoint 建立的特定屬性，用於儲存有關您使用者的資訊。每個屬性通常對應於使用者的特性，例如使用者的名字或他們居住的城市。在範本中新增訊息變數後，您就能使用這些屬性來將自訂內容傳遞給使用該範本之訊息的每個收件人。

如果範本包含訊息變數，Amazon Pinpoint 會為每個收件人將每個變數替換成目前對應的屬性值。它會在每次傳送使用範本的訊息時執行此動作。這表示您可以傳送個人化內容給每位收件者，而無需建立多個自訂版本的訊息或訊息範本。您也可以確認訊息中包含您提供給收件者的最新資訊。

例如，如果您的專案是為跑步者提供的健身應用程式，且其中包含每個使用者名字、偏好活動和個人記錄的屬性，您就可以在範本中使用下列文字和訊息變數：

`Hi {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!`

您傳送使用了範本的訊息時，Amazon Pinpoint 會為每個收件人將變數替換成目前對應的屬性值。下列範例將顯示此情況。

**範例 1**  
`Hi Sofia, congratulations on your new half marathon record of 1:42:17!`

**範例 2**  
`Hi Alejandro, congratulations on your new 5K record of 20:52!`

如果收件人沒有對應值，Amazon Pinpoint 可以將變數替換成您為變數指定的預設值。例如，如果您的健身應用程式使用者尚未選擇他們偏好的活動，您可以將 `running` 做為 `{{User.UserAttributes.Activity}}` 變數的預設值。在這種情況下，Amazon Pinpoint 會替換變數，如以下範例所示：

**範例 1**  
`Hi Jane, congratulations on your new running record of 1:42:17!`

**範例 2**  
`Hi John, congratulations on your new running record of 20:52!`

如果您沒有指定預設值，且收件人沒有值，Amazon Pinpoint 向該收件人傳送訊息時，會省略變數的所有文字。例如：

`Hi Mary, congratulations on your new record of 20:52!`

最佳實務是，建議您為範本中包含的每個變數指定預設值。

## 新增訊息變數
<a name="message-templates-add-variables"></a>

您可以在建立的新範本或現有範本中，加入訊息屬性。如果您將變數加入現有範本，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. 在訊息詳細資料區段中，決定您要新增訊息變數的位置。您可以將變數新增至任何類型範本的內文。如為電子郵件和推送通知範本，您也可以將變數新增至訊息主旨或標題。

1. 在 **Attribute finder (屬性搜尋工具)** 中，展開您要為其新增訊息變數之屬性類型區段。您可以從下列屬性類型中進行選擇：  
**標準屬性**  
這些是 Amazon Pinpoint 為任何專案自動建立的屬性。這意味著您可以在為任何專案傳送的訊息中使用它們。如需這些屬性的詳細資訊，請參閱 [支援的屬性](#message-templates-variables)。  
若要為標準屬性新增變數，請從清單中選擇屬性。  
**自訂屬性**  
這些是您可以選擇性地為個別專案建立的屬性。由於某些專案可能無法使用這些屬性，因此 Amazon Pinpoint 可能無法將變數取代為使用範本之訊息的每個收件人的值。為了避免這個問題，Amazon Pinpoint 提供一些選項，幫助您選擇特定專案或所有專案都有的屬性。  
若要新增自訂屬性：  

   1. 選擇**自訂屬性**，然後選擇**載入自訂屬性**。Amazon Pinpoint 會在出現的視窗中，列出了您建立的所有專案。選擇各專案時，所選專案的通用屬性將顯示在右側導覽面板。如果沒有顯示任何屬性，表示這些專案之間沒有共同的屬性。

   1. 執行以下任意一項：
      + 若要使用所選專案共同的所有屬性，請選擇**載入自訂屬性**。
      + 若要使用清單中的特定屬性，請在搜尋欄位中輸入屬性名稱的任何部分。與輸入文字相符的屬性。您要使用的屬性顯示時，選擇**載入自訂屬性**。**屬性尋找工具**顯示新增的自訂屬性。
**注意**  
您無法從不同的專案集新增常見屬性，或修改**屬性搜尋工具**的**自訂屬性**區段。若要變更自訂屬性，請選擇 **X** 以清除**屬性搜尋工具，**然後重新開始。

   1. 在 **Attribute finder (屬性搜尋工具)** 中，選擇要新增變數的屬性。  
**建議的屬性**  
這些屬性是您將 Amazon Pinpoint 設成要從推薦者模型擷取個人化推薦時，為帳戶建立的 (選用)。如需使用建議者模型的相關資訊，請參閱[機器學習模型](ml-models.md)。您可以將此類屬性的變數新增至電子郵件範本、推送通知範本和 SMS 範本。您無法將它們新增至語音範本。  
若要為建議的屬性新增變數，請從清單中選擇該屬性。如果**屬性搜尋工具**未列出任何建議的屬性，您必須先將範本連接到推薦模型。  
若要新增建議的屬性：  

   1. 然後選擇**連線模型**。

   1. 選取當您傳送使用了該範本的訊息時，要擷取建議的模型。

   1. 然後選擇**連線模型**。


1. 若您從**屬性搜尋工具**選擇屬性，Amazon Pinpoint 會建立屬性的訊息變數，並複製到剪貼簿。將變數貼到您想要的位置。如果屬性清單很長，請輸入搜尋文字，縮小清單的搜尋範圍。選擇 **X**，清除搜尋欄位。

   您貼上變數之後，Amazon Pinpoint 會以相關聯的屬性名稱顯示變數，並用兩組大括弧括起來，例如 `{{User.UserAttributes.FirstName}}`。

1. 針對您要新增的每個訊息變數重複步驟 4-6。

1. 若要指定訊息變數的預設值，請展開 **Default attribute values (預設屬性值)** 區段。然後，在變數清單中輸入您要用於變數的預設值。
**注意**  
我們建議您針對範本中的每個變數執行此作業。否則 Amazon Pinpoint 可能無法傳送使用了範本的訊息，或者該訊息不能依預期的方式正常顯示。

1. 完成後，請執行下列其中一項操作：
   + 如果您已將訊息變數新增至新範本，請選擇 **Create (建立)**。
   + 如果您已將訊息變數新增至現有範本，而且您想將變更儲存為新的範本版本，請選擇 **Save as new version (儲存為新版本)**。
   + 如果您已將訊息變數新增至現有範本，而且您想將變更儲存為最新版本的範本更新，請選擇 **Update version (更新版本)**。只有當您在步驟 3 中開啟的是最新版範本時，才可以使用此選項。

## 支援的屬性
<a name="message-templates-variables"></a>

每個專案都可以有標準屬性和自訂屬性。標準屬性是 Amazon Pinpoint 為任何專案自動建立的屬性。自訂屬性則是您選擇為專案建立的屬性。有三種自訂屬性類型：
+ **使用者屬性** – 這些屬性描述使用者，例如使用者的名字、姓氏和出生日期。*使用者*是獨立個體，具有專案特定的使用者 ID。
+ **端點屬性** – 這些屬性描述使用者的特定端點。*端點*是訊息的目的地，例如使用者的電子郵件地址、電話號碼或行動裝置。每個使用者可以與一或多個端點建立關聯。假設您透過電子郵件、SMS 和電話與使用者通訊，使用者可能與三個端點建立關聯，一個是使用者的電子郵件地址，另一個是使用者的行動電話號碼，還有一個是使用者的住家電話號碼 (市話)。
+ **指標屬性** – 這些屬性是您的應用程式向 Amazon Pinpoint 回報各端點的數值指標，例如行動應用程式的工作階段數或購物車商品棄置數。
+ **Pinpoint 屬性** – 這些屬性是應用程式、行銷活動或旅程的唯一識別符。

除了您或 Amazon Pinpoint 為專案建立的自訂和標準屬性之外，Amazon Pinpoint 還支援*建議的屬性*。*建議的屬性*可為使用者或端點暫時儲存個人化建議。Amazon Pinpoint 會從您指定要使用的推薦者模型，擷取這些建議。建議的屬性與特定的專案沒有相關聯。而是與您的 Amazon Pinpoint 帳戶建立關聯。如需使用建議者模型的相關資訊，請參閱[機器學習模型](ml-models.md)。

您可以使用訊息變數中的任何標準、自訂或建議屬性。下表指出每個支援屬性的訊息變數中出現的文字，並說明每個屬性。在表格中，*custom\$1attribute* 指出在自訂屬性變數中出現的文字。在這些情況下，請以自訂屬性名稱取代 *custom\$1attribute*。例如，如果您的專案將使用者的名字儲存在名為 `FirstName` 的自訂使用者屬性中，且您為該屬性新增變數，則變數的文字為 `{{User.UserAttributes.FirstName}}`。


| 屬性 | Description | 
| --- | --- | 
| Address | 您傳送到端點的訊息或推播通知的目的地地址，例如電子郵件地址、電話號碼或裝置權杖。 | 
| Pinpoint.ApplicationId | 應用程式的唯一識別符。 | 
| Attributes.custom\$1attribute | 描述端點的自訂端點屬性。 | 
| Pinpoint.CampaignId | 行銷活動的唯一識別碼。 | 
| ChannelType | 傳送訊息或推送通知至端點時所使用的通道。例如：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/message-templates-personalizing.html) | 
| CreationDate | 將端點新增至專案的日期和時間 [(ISO 8601 格式](https://en.wikipedia.org/wiki/ISO_8601))。例如，2019-06-30T11:45:25.220Z 即為 2019 年 6 月 30 日上午 11 點 45 分 (UTC)。 | 
| Demographic.AppVersion | 與端點相關聯的應用程式版本編號。 | 
| Demographic.Locale | 端點的地區設定，格式如下：[ISO 639-1 α-2](https://en.wikipedia.org/wiki/ISO_639-1) 碼，後接下劃線 (\$1)，然後是 [ISO 3166-1 α-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 值。例如，en\$1US 是美國的英文語言地區設定。 | 
| Demographic.Make | 端點裝置的製造商，例如 apple 或 samsung。 | 
| Demographic.Model | 端點裝置的型號名稱或號碼，例如：iPhone 或 SM-G900F。 | 
| Demographic.ModelVersion | 端點裝置的型號版本。 | 
| Demographic.Platform | 端點裝置的作業系統，例如：ios 或 android。 | 
| Demographic.PlatformVersion | 端點裝置上的作業系統版本。 | 
| Demographic.Timezone | 端點的時區，做為 [tz 資料庫](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)值。例如：America/Los\$1Angeles 適用於太平洋時間 (北美洲)。 | 
| EffectiveDate | 端點上次更新的日期和時間 ([ISO 8601 格式](https://en.wikipedia.org/wiki/ISO_8601))。例如，2019-08-23T10:54:35.220Z 即為 2019 年 8 月 23 日上午 10 點 54 分 (UTC)。 | 
| EndpointId | 端點的唯一識別碼。 | 
| EndpointStatus | 是否要傳送訊息或推送通知至端點：ACTIVE、傳送訊息至端點，或 INACTIVE，請勿傳送訊息至端點。 | 
| Id | 端點的唯一識別碼。 | 
| Pinpoint.JourneyId | 旅程的唯一識別符。 | 
| Location.City | 端點所在的城市。 | 
| Location.Country | 端點所在國家或區域的兩字元代碼 ([ISO 3166-1 alpha-2 格式](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2))。例如：US (美國)。 | 
| Location.Latitude | 端點位置的緯度 (四捨五入到一位小數)。 | 
| Location.Longitude | 端點位置的經度 (四捨五入到一位小數)。 | 
| Location.PostalCode | 端點所在地區的郵遞區號。 | 
| Location.Region | 端點所在的區域名稱，例如州或省。 | 
| Metrics.custom\$1attribute | 您的應用程式向 Amazon Pinpoint 回報端點的自訂數值指標。 | 
| OptOut | 無論使用者選擇不接收來自您的訊息和推送通知：ALL、使用者選擇不接收任何訊息或推送通知，還是 NONE，使用者尚未選擇不接收所有訊息和推送通知。 | 
| RecommendationItems | 標準建議屬性，此會存放端點或使用者的一個建議。此屬性包含由建議者模型直接提供的文字。 | 
| RecommendationItems.[\$1] |  標準建議屬性，會儲存要給端點或使用者的 2-5 個建議排序清單。此屬性包含由建議者模型直接提供的文字。 數字預留位置 (. [\$1]) 表示屬性包含多個值。此屬性的訊息變數可指向清單中的特定值。  | 
| Recommendations.custom\$1attribute | 自訂建議屬性，此會存放端點或使用者的一個建議。此屬性包含由推薦者模型提供並由 AWS Lambda 函數增強的內容。 | 
| Recommendations.custom\$1attribute.[\$1] |  自訂建議屬性，此會存放端點或使用者的多個建議。此屬性包含由建議者模型所提供，並由 AWS Lambda 函數增強的內容。 數字預留位置 (. [\$1]) 表示屬性包含多個值。此屬性的訊息變數可以特別指向其中一個值。  | 
| RequestId | 更新端點的最新請求唯一識別碼。 | 
| User.UserAttributes.custom\$1attribute | 描述使用者的自訂使用者屬性。 | 
| User.UserId | 使用者的唯一識別符 |