**支援結束通知：**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 Pinpoint 行銷活動，那麼匯入客群很有用。 與您在主控台使用客群建置器所建立的動態客群不同，匯入的客群一組不變的*端點*或*使用者 ID*： **Endpoint** 訊息傳送到的目的地，例如電子郵件地址、行動裝置識別符或行動電話號碼。端點定義可以包含屬性來描述訊息傳送到的裝置。也可以包含使用者 ID。 匯入端點定義的清單，可以定義客群。Amazon Pinpoint 建立客群，並使用新資訊更新您先前加入 Amazon Pinpoint 的任何端點。 **使用者 ID** 代表您的對象中個別使用者的 ID。此 ID 必須指派給一個或多個端點。例如，如果人員在多個裝置上使用您的應用程式，您的應用程式可以將該人員的使用者 ID 指派給每個裝置的端點。 只有在您已將與使用者 ID 相關聯的端點加入 Amazon Pinpoint 時，才可以藉由匯入使用者 ID 來定義客群。 匯入的客群由端點、使用者 ID 或這兩者的組合所構成。您使用 Amazon Pinpoint 向客群傳送訊息時，潛在的目的地包括： + 您在匯入的檔案中列出的每個端點。 + 與您在匯入的檔案中列出的每個使用者 ID 相關聯的每個端點。 當您建立新的客群時，您可以使用匯入的客群做為基本客群。然後，您可以將篩選條件套用到基本客群，以根據您的需求來精簡它。 ## 匯入的客群考量 當您建立匯入的客群時，請考慮下列因素： + 建立行銷活動時，您必須選擇一個客群。若選擇動態客群，Amazon Pinpoint 會提供該客群規模的估算值。但若您選擇匯入的客群，Amazon Pinpoint 將無法提供估算值。 + 如果您建立的行銷活動會在特定事件發生時傳送訊息，則您不能使用匯入的客群。基於事件的行銷活動只能使用動態客群。如需有關建立動態客群的詳細資訊，請參閱[建置客群](segments-building.md)。 ## 客群檔案 您可以在逗號分隔值 (CSV) 或 JSON 檔案中，定義屬於您的客群的端點或使用者 ID。接著將檔案匯入 Amazon Pinpoint 以建立客群。 當您匯入客群時，請記住下列要點： + Amazon Pinpoint 無法匯入壓縮檔案。 + 您匯入的檔案必須使用 UTF-8 字元編碼。 + 如果是匯入新的端點，則 `Address` 和 `ChannelType` 是必要屬性。 + 如果是更新現有的端點，則您要更新的每個端點都需要有 `Id` 屬性。 + 您的端點定義只能包含特定屬性。如需清單，請參閱[支援的屬性](#segments-importing-available-attributes)。此外，屬性名稱必須少於 50 個字元。屬性值必須為 100 個或更少的字元。 ### 客群範例檔案 本節的範例檔案是根據以下資料： **範例：端點屬性值** | ChannelType | 地址 | Location.Country | Demographic.Platform | Demographic.Make | User.UserId | | --- | --- | --- | --- | --- | --- | | SMS | \+16045550182 | CA | Android | LG | example-user-id-1 | | APNS | 1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f | 美國 | iOS | Apple | example-user-id-2 | | 電子郵件 | john.stiles@example.com | 美國 | iOS | Apple | example-user-id-2 | | GCM | 4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c | CN | Android | Google | example-user-id-3 | | 電子郵件 | wang.xiulan@example.com | CN | Android | OnePlus | example-user-id-3 | 這個表格中的每一列各代表一個端點。請注意，使用者 ID `example-user-id-2` 和 `example-user-id-3` 會各自指派至兩個端點。 **Example 含有端點定義的檔案** 您可以匯入在 CSV 檔案中定義的端點，如以下範例所示： ``` ChannelType,Address,Location.Country,Demographic.Platform,Demographic.Make,User.UserId SMS,+16045550182,CA,Android,LG,example-user-id-1 APNS,1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f,US,iOS,Apple,example-user-id-2 EMAIL,john.stiles@example.com,US,iOS,Apple,example-user-id-2 GCM,4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c,CN,Android,Google,example-user-id-3 EMAIL,wang.xiulan@example.com,CN,Android,OnePlus,example-user-id-3 ``` 第一行是標頭，其中包含端點屬性。如需可能屬性的完整清單，請參閱 [支援的屬性](#segments-importing-available-attributes)。 隨後的幾行提供標頭中每個屬性的值，以定義端點。 若要在值中包含逗號或雙引號，請將值括在雙引號中，如 `"aaa,bbb"` 所示。 CSV 檔案不能包含分行符號或定位點。如果您的檔案包含的資料有分行符號或定位點，可能無法匯入檔案中的資料，否則匯入程序可能失敗。 您可以匯入換行分隔 JSON 檔案中定義的端點。在這個格式中，每一列是一個完整的 JSON 物件，其中包含個別端點定義，如下列範例所示： ``` {"ChannelType":"SMS","Address":"+16045550182","Location":{"Country":"CA"},"Demographic":{"Platform":"Android","Make":"LG"},"User":{"UserId":"example-user-id-1"}} {"ChannelType":"APNS","Address":"1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f","Location":{"Country":"US"},"Demographic":{"Platform":"iOS","Make":"Apple"},"User":{"UserId":"example-user-id-2"}} {"ChannelType":"EMAIL","Address":"john.stiles@example.com","Location":{"Country":"US"},"Demographic":{"Platform":"iOS","Make":"Apple"},"User":{"UserId":"example-user-id-2"}} {"ChannelType":"GCM","Address":"4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c","Location":{"Country":"CN"},"Demographic":{"Platform":"Android","Make":"Google"},"User":{"UserId":"example-user-id-3"}} {"ChannelType":"EMAIL","Address":"wang.xiulan@example.com","Location":{"Country":"CN"},"Demographic":{"Platform":"Android","Make":"OnePlus"},"User":{"UserId":"example-user-id-3"}} ``` 如需可能屬性的完整清單，請參閱 [支援的屬性](#segments-importing-available-attributes)。 ## 匯入客群 有兩種方式可將區段匯入 Amazon Pinpoint：您可以直接從電腦上傳檔案，也可以匯入存放在 Amazon Simple Storage Service (Amazon S3) 儲存貯體中的檔案。 我們建議您從電腦上傳檔案，尤其是在電腦上已有客戶資料的情況下。不過，您一次只能匯入 10 個檔案，也只能上傳小於 1 GB 的檔案。 如果您需要一次匯入超過 10 個檔案，或者需要上傳大於 1 GB 的檔案，則應從 Amazon S3 匯入檔案。如果您已制定了將客戶資料檔案傳送到 Amazon S3 儲存的程序，Amazon S3 匯入選項也很有用。 本節包含使用這兩種方法匯入客群的程序。 ### 透過從電腦上傳檔案來匯入客群 您可從您的電腦直接上傳最多 10 個檔案來建立客群。上傳的檔案可以是 CSV 或 JSON 格式。您可以上傳任意格式組合的檔案。例如，您可以上傳一個 JSON 檔案和三個 CSV 檔案。 **匯入客群** 1. 開啟位於 [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 的 Amazon Pinpoint 主控台。 1. 在 **All projects (所有專案)** 頁面，選擇您要新增客群的專案。 1. 在導覽窗格中，選擇 **Segments (客群)**。 1. 選擇 **Create a segment (建立客群)**。 1. 在 **Create a segment (建立客群)** 下，選擇 **Import a segment (匯入客群)**。 1. 在 **Import method (匯入方法)** 下方，選擇 **Upload files from your computer (從您的電腦上傳檔案)**。 1. 在 **Files to import (要匯入的檔案)** 下方，選取 **Choose files (選擇檔案)**。選取您要匯入的一或多個檔案。 **注意** 您也可以從電腦的檔案總管拖曳檔案並直接放到**將檔案放置在這裡 (Drop files here)**。 1. 將檔案上傳到 Amazon Pinpoint 時，必須為匯入的每個檔案提供客群名稱。在**區段名稱**下，輸入您要匯入的每個檔案的區段名稱。 Amazon Pinpoint 預設會提供與匯入檔案名稱相同的客群名稱，不含副檔名。您可以將這些預設值變更為任何名稱。 ![在區段建立頁面上顯示區段名稱區段。使用者已上傳兩個檔案： High Value Customers.csv和 Top Users by Activity.json。](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/images/segments-import-names.png) **注意** 您可以對多個客群使用相同的名稱。如果您這麼做，Amazon Pinpoint 會為每個檔案建立不同的客群，並為每個檔案指定唯一的 ID。您匯入之每個檔案的建立日期也稍有不同。您可以使用這些因素來區分具有相同名稱的客群。 1. 完成後，選擇 **Create segment (建立客群)**。 ### 從 Amazon S3 儲存的檔案匯入客群 使用此程序匯入客群之前，您必須先建立 Amazon S3 儲存貯體，並將檔案上傳至該儲存貯體。您可以將不同客群的檔案組織到個別的資料夾中。當 Amazon Pinpoint 匯入區段的端點或使用者 IDs 時，它會包含屬於您指定之 Amazon S3 位置的所有資料夾和子資料夾中的檔案。 如需建立儲存貯體和上傳物件的簡介，請參閱《[Amazon Simple Storage Service 使用者指南》中的什麼是 Amazon S3？](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)。 在每個客群中，Amazon Pinpoint 都只能匯入一種檔案格式 (CSV 或 JSON)，所以您指定的 Amazon S3 路徑，只應包含單一類型的檔案。 **匯入客群** 1. 開啟位於 [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/) 的 Amazon Pinpoint 主控台。 1. 在 **All projects (所有專案)** 頁面，選擇您要新增客群的專案。 1. 在導覽窗格中，選擇 **Segments (客群)**。 1. 選擇 **Create a segment (建立客群)**。 1. 在 **Create a segment (建立客群)** 下，選擇 **Import a segment (匯入客群)**。 1. 針對**客群名稱**，輸入客群的名稱。 1. 在 **Amazon S3 URL** 中，輸入包含客群檔案的 Amazon S3 儲存貯體位置。儲存貯體的地址必須為下列格式： ``` s3://{{bucket-name}}/{{folder-name}} ``` Amazon Pinpoint 會從您指定的路徑及該路徑中的所有子資料夾匯入檔案。 1. 為 **IAM 角色**完成以下其中一個步驟： + 如果您要讓 Amazon Pinpoint 建立一個允許讀取 Amazon S3 儲存貯體的角色，請選擇**自動建立角色**。接著，針對 **IAM role (IAM 角色)**，輸入您要建立的角色的名稱。 + 如果您已建立一個允許 Amazon Pinpoint 讀取 Amazon S3 儲存貯體的 IAM 角色，請選擇**選擇現有角色**。接著，對於 **IAM role (IAM 角色)**，選擇包含適當許可的角色。 如果您要自行建立 IAM 角色，請參閱*《Amazon Pinpoint 開發人員指南》*中的[用於匯入端點或客群的 IAM 角色](https://docs.aws.amazon.com/pinpoint/latest/developerguide/permissions-import-segment.html)。建立角色後，請在 Amazon Pinpoint 主控台中指定該角色。 1. 在**您要匯入的檔案類型**下，選擇 **JavaScript 物件標記法 (JSON)**或**逗號分隔值 (CSV)**，視您上傳到 Amazon S3 的檔案格式而定。 1. 選擇**建立客群**。 ## 支援的屬性 本節中的表格列出並描述您可以在端點定義中指定匯入 Amazon Pinpoint 的屬性。如果您使用 CSV 檔案匯入客群，則檔案中的標頭應該符合 **Attributes (屬性)** 欄所顯示的名稱。 如果是 JSON 檔案，屬性名稱中的點號表示點號後面的名稱是巢狀於父物件中的物件，而該父物件的名稱就等於點號前面的值。例如，包含 `Demographic.Make` 和 `Demographic.Model` 屬性的 JSON 檔案具有以下結構： ``` { ... "Demographic": { ... "Make":"Apple", "Model":"iPhone" ... } ... } ``` 完整的 JSON 結構與 *Amazon Pinpoint API 參考*中的[範例端點請求](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html#apps-application-id-endpoints-endpoint-id-schemas)非常類似。不過，當您匯入客群時，端點請求結構描述中的所有屬性並非都受支援，包括 `EndpointStatus` 和 `EffectiveDate`。 若要讓自訂欄位在 CSV 中具有多個值，您必須複寫標頭，並為每個標頭保留一個值。例如： ``` ...,User.UserId, User.UserAttributes.new_multi_field,User.UserAttributes.new_multi_field ...,example-user-id-2,test10,test20 ``` 您可以將顯示為 `{{custom_attribute}}` 的屬性名稱替換成任何值。例如，如果您要將使用者的名字和姓氏儲存在名為 `FirstName` 和 `LastName` 的屬性中，您可以分別建立名為 `User.UserAttributes.FirstName` 和 `User.UserAttributes.LastName` 的自訂屬性。屬性名稱最多可包含 50 個字元。屬性值最多可包含 100 個字元。屬性名稱區分大小寫。 在 JSON 中，自訂屬性必須在 進行格式化`"Attributes":{"Ride":["Bus"]}`。 | 屬性 | Description | | --- | --- | | 時區 | 重新對應時區 | | --- | --- | | Address | 您傳送到端點的訊息或推播通知的唯一目的地地址，例如電子郵件地址、電話號碼或裝置權杖。 如果端點地址是電話號碼，必須依 E.164 格式指定。有關 E.164 格式的詳細資訊，請參閱維基百科上的 [E.164](https://en.wikipedia.org/wiki/E.164)。 | | Attributes.{{custom\_attribute}} | 描述端點的自訂屬性。您可以在建立客群時使用此類型的屬性作為選取條件。您可以將 {{custom\_attribute}} 替換成任何值。 | | ChannelType | 傳送訊息或推送通知至端點時所使用的通道。例如：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/segments-importing.html) | | Demographic.AppVersion | 與端點相關聯的應用程式版本編號。 | | Demographic.Locale | 端點的地區設定，格式如下：[ISO 639-1 α-2](https://en.wikipedia.org/wiki/ISO_639-1) 碼，後接下劃線 (\_)，然後是 [ISO 3166-1 α-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 值。例如，en\_US 是美國的英文語言地區設定。 | | 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\_Angeles 適用於太平洋時間 (北美洲)。不再支援以下時區，並將自動重新對應到支援的時區。 [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/pinpoint/latest/userguide/segments-importing.html) | | EffectiveDate | 端點上次更新的日期和時間 ([ISO 8601 格式](https://en.wikipedia.org/wiki/ISO_8601))。例如，2019-08-23T10:54:35.220Z 即為 2019 年 8 月 23 日上午 10 點 54 分 (UTC)。 | | Id | 端點的唯一識別碼。 | | 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\_attribute}} | 您的應用程式向端點的 Amazon Pinpoint 回報的自訂數字指標 (例如工作階段數或購物車中剩餘的商品數) 以用於區隔。您可以將 {{custom\_attribute}} 替換成任何值。這些自訂值只能是數值。因為是數字，所以 Amazon Pinpoint 可以對其執行算術運算，例如平均值或總和。 | | OptOut | 指出使用者是否選擇不接收來自您的訊息和推送通知。可接受的值為：ALL、使用者選擇退出且不想接收任何訊息或推送通知，或 NONE、使用者尚未選擇退出且想要接收所有訊息和推送通知。 | | RequestId | 更新端點的最新請求唯一識別碼。 | | User.UserAttributes.{{custom\_attribute}} | 描述使用者的自訂屬性。您可以將 {{custom\_attribute}} 替換成任何值，例如 FirstName 或 Age。 | | User.UserId | 使用者的唯一識別符 | | Canada/East-Saskatchewan | America/Managua | | US/Pacific-New | America/Los\_Angeles | 您可以為每個專案中的端點和使用者，建立多達 250 個自訂屬性。詳情請參閱*《Amazon Pinpoint 開發人員指南》*中的 [Amazon Pinpoint 配額](https://docs.aws.amazon.com/pinpoint/latest/developerguide/quotas.html)。