匯入客群

您可以透過 Amazon Pinpoint，針對客群所屬的使用者，匯入包含使用者相關資訊的檔案，以定義使用者客群。如果您在 Amazon Pinpoint 以外的地方定義了使用者客群，但希望讓使用者參與 Amazon Pinpoint 行銷活動，那麼匯入客群很有用。

與您在主控台中使用區段建置器建立的動態區段不同，匯入的區段是一組不變的端點或使用者： IDs

端點

訊息傳送到的目的地，例如電子郵件地址、行動裝置識別符或行動電話號碼。端點定義可以包含屬性來描述訊息傳送到的裝置。也可以包含使用者 ID。

匯入端點定義的清單，可以定義客群。Amazon Pinpoint 建立客群，並使用新資訊更新您先前加入 Amazon Pinpoint 的任何端點。

使用者 ID

代表您的對象中個別使用者的 ID。此 ID 必須指派給一個或多個端點。例如，如果人員在多個裝置上使用您的應用程式，您的應用程式可以將該人員的使用者 ID 指派給每個裝置的端點。

IDs 只有在您已將與使用者相關聯的端點新增至 Amazon Pinpoint 時，才能透過匯入使用者IDs來定義客群。

匯入的區段包含端點IDs、使用者或兩者的組合。您使用 Amazon Pinpoint 向客群傳送訊息時，潛在的目的地包括：

您在匯入的檔案中列出的每個端點。
與您在匯入的檔案中列出的每個使用者 ID 相關聯的每個端點。

當您建立新的客群時，您可以使用匯入的客群做為基本客群。然後，您可以將篩選條件套用到基本客群，以根據您的需求來精簡它。

匯入的客群考量

當您建立匯入的客群時，請考慮下列因素：

建立行銷活動時，您必須選擇一個客群。若選擇動態客群，Amazon Pinpoint 會提供該客群規模的估算值。但若您選擇匯入的客群，Amazon Pinpoint 將無法提供估算值。
如果您建立的行銷活動會在特定事件發生時傳送訊息，則您不能使用匯入的客群。基於事件的行銷活動只能使用動態客群。如需有關建立動態客群的詳細資訊，請參閱建置客群。

客群檔案

您可以在逗號分隔值（CSV）或JSON檔案中定義屬於您客群IDs的端點或使用者。接著將檔案匯入 Amazon Pinpoint 以建立客群。

當您匯入客群時，請記住下列要點：

Amazon Pinpoint 無法匯入壓縮檔案。
您匯入的檔案必須使用 UTF-8 字元編碼。
如果是匯入新的端點，則 Address 和 ChannelType 是必要屬性。
如果是更新現有的端點，則您要更新的每個端點都需要有 Id 屬性。
您的端點定義只能包含特定屬性。如需清單，請參閱支援的屬性。此外，屬性名稱必須為 50 個字元或更少。屬性值必須為 100 個字元或更少。

客群範例檔案

本節的範例檔案是根據以下資料：

範例：端點屬性值
ChannelType	Address	Location.Country	Demographic.Platform	Demographic.Make	使用者。UserId
SMS	+16045550182	CA	Android	LG	example-user-id-1
APNS	1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f	美國	iOS	Apple	example-user-id-2
EMAIL	john.stiles@example.com	美國	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

這個表格中的每一列各代表一個端點。請注意，使用者 IDs example-user-id-2 和 example-user-id-3 會分別指派給兩個端點。

範例含有端點定義的檔案

CSV

您可以匯入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

第一行是標頭，其中包含端點屬性。如需可能屬性的完整清單，請參閱支援的屬性。

隨後的幾行提供標頭中每個屬性的值，以定義端點。

若要在值中包含逗號或雙引號，請將值括在雙引號中，如 "aaa,bbb" 所示。

CSV 檔案不能包含換行或索引標籤。如果您的檔案包含的資料有分行符號或定位點，可能無法匯入檔案中的資料，否則匯入程序可能失敗。

JSON

您可以匯入在新行分隔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"}}

如需可能屬性的完整清單，請參閱支援的屬性。

匯入客群

有兩種方法可以將區段匯入 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檔案。

匯入客群

在開啟 Amazon Pinpoint 主控台https://console.aws.amazon.com/pinpoint/。
在 All projects (所有專案) 頁面，選擇您要新增客群的專案。
在導覽窗格中，選擇 Segments (客群)。
選擇 Create a segment (建立客群)。
在 Create a segment (建立客群) 下，選擇 Import a segment (匯入客群)。
在 Import method (匯入方法) 下方，選擇 Upload files from your computer (從您的電腦上傳檔案)。
在 Files to import (要匯入的檔案) 下方，選取 Choose files (選擇檔案)。選取您要匯入的一或多個檔案。

注意
您也可以從電腦的檔案總管拖曳檔案並直接放到將檔案放置在這裡 (Drop files here)。
將檔案上傳到 Amazon Pinpoint 時，必須為匯入的每個檔案提供客群名稱。在區段名稱 下，輸入要匯入的每個檔案的區段名稱。

Amazon Pinpoint 預設會提供與匯入檔案名稱相同的客群名稱，不含副檔名。您可以將這些預設值變更為任何名稱。

注意
您可以對多個客群使用相同的名稱。如果您這麼做，Amazon Pinpoint 會為每個檔案建立不同的客群，並為每個檔案指定唯一的 ID。您匯入之每個檔案的建立日期也稍有不同。您可以使用這些因素來區分具有相同名稱的客群。
完成後，選擇 Create segment (建立客群)。

使用此程序匯入區段之前，您必須先建立 Amazon S3 儲存貯體，並將檔案上傳至該儲存貯體。您可以將不同客群的檔案組織到個別的資料夾中。當 Amazon Pinpoint 匯入區段IDs的端點或使用者時，它會包含屬於您指定之 Amazon S3 位置的所有資料夾和子資料夾內的檔案。

如需建立儲存貯體和上傳物件的簡介，請參閱 Amazon Simple Storage Service 使用者指南中的什麼是 Amazon S3？。

Amazon Pinpoint 每個區段只能匯入一個檔案格式（CSV 或 JSON），因此您指定的 Amazon S3 路徑應僅包含單一類型的檔案。

匯入客群

在開啟 Amazon Pinpoint 主控台https://console.aws.amazon.com/pinpoint/。
在 All projects (所有專案) 頁面，選擇您要新增客群的專案。
在導覽窗格中，選擇 Segments (客群)。
選擇 Create a segment (建立客群)。
在 Create a segment (建立客群) 下，選擇 Import a segment (匯入客群)。
針對區段名稱 ，輸入區段的名稱。
針對 Amazon S3 URL，輸入包含您區段檔案的 Amazon S3 儲存貯體位置。儲存貯體的地址必須為下列格式：
```
s3://bucket-name/folder-name
```
Amazon Pinpoint 會從您指定的路徑及該路徑中的所有子資料夾匯入檔案。
對於IAM角色 ，請完成下列其中一個步驟：
- 如果您要讓 Amazon Pinpoint 建立一個允許讀取 Amazon S3 儲存貯體的角色，請選擇自動建立角色。然後，針對IAM角色 ，輸入您要建立之角色的名稱。
- 如果您已建立允許 Amazon Pinpoint 從 Amazon S3 儲存貯體讀取IAM的角色，請選擇選擇現有角色。然後，針對IAM角色 ，選擇包含適當許可的角色。
如果您想要自行建立IAM角色，請參閱 Amazon Pinpoint 開發人員指南 中的IAM匯入端點或區段的角色。建立角色後，請在 Amazon Pinpoint 主控台中指定該角色。
在您要匯入的檔案類型下，選擇JavaScript 物件表示法（JSON） 或逗號分隔值（CSV），取決於您上傳到 Amazon S3 的格式。
選擇 Create segment (建立客群)。

支援的屬性

本節中的資料表會列出並描述您可以在端點定義中指定匯入 Amazon Pinpoint 的屬性。如果您使用 CSV 檔案匯入區段，檔案中的標頭應與屬性欄中顯示的名稱相符。

對於JSON檔案，屬性名稱中的句點表示句點後的名稱是巢狀在父物件中的物件，其名稱等於句點前面的值。例如，包含 Demographic.Make和 Demographic.Model 屬性JSON的檔案具有下列結構：


{
...
"Demographic": {
  ...
  "Make":"Apple",
  "Model":"iPhone"
  ...
  }
...
}

完整JSON結構與 Amazon Pinpoint API參考 中的範例端點請求非常相似。不過，當您匯入客群時，端點請求結構描述中的所有屬性並非都受支援，包括 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"]}。

屬性描述

Address

您傳送到端點的訊息或推播通知的唯一目的地地址，例如電子郵件地址、電話號碼或裝置權杖。

注意

如果端點地址是電話號碼，必須依 E.164 格式指定。有關 E.164 格式的詳細資訊，請參閱維基百科上的 E.164。

Attributes.custom_attribute 描述端點的自訂屬性。您可以在建立客群時使用此類型的屬性作為選取條件。您可以將 custom_attribute 替換成任何值。

ChannelType

傳送訊息或推送通知至端點時所使用的通道。例如：

APNS – 適用於可以接收推播通知的端點，您可以透過 Apple Push Notification 服務（APNs）頻道傳送至 iOS 裝置上執行的應用程式。
EMAIL – 適用於可以接收電子郵件訊息的端點。
GCM – 適用於可以接收推播通知的端點，您可以透過 Firebase Cloud Messaging （FCM）頻道傳送至在 Android 裝置上執行的應用程式。
SMS – 適用於可以接收SMS文字訊息的端點。

Demographic.AppVersion 與端點相關聯的應用程式版本編號。

Demographic.Locale 端點的地區設定，格式如下：ISO639-1 alpha-2 程式碼，後面加上底線（_），後面接著 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 資料庫

值。例如：America/Los_Angeles 適用於太平洋時間 (北美洲)。

注意

不再支援以下時區，並將自動重新對應到支援的時區。

時區	重新對應時區
`Canada/East-Saskatchewan`	`America/Managua`
`US/Pacific-New`	`America/Los_Angeles`

EffectiveDate 上次更新端點的日期和時間，ISO格式為 8601。例如，2019-08-23T10:54:35.220Z對於 2019 年 UTC8 月 23 日上午 10：54。

Id 端點的唯一識別碼。

Location.City 端點所在的城市。

Location.Country 端點所在的國家或地區的雙字元程式碼，採用 ISO 3166-1 alpha-2 格式。例如：US (美國)。

Location.Latitude 端點位置的緯度 (四捨五入到一位小數)。

Location.Longitude 端點位置的經度 (四捨五入到一位小數)。

Location.PostalCode 端點所在ZIP區域的郵遞區號。

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 使用者的唯一識別符

您可以為每個專案中的端點和使用者，建立多達 250 個自訂屬性。詳情請參閱《Amazon Pinpoint 開發人員指南》中的 Amazon Pinpoint 配額。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

管理客群

匯出客群

匯入客群

匯入的客群考量

客群檔案

客群範例檔案

範例 含有端點定義的檔案

匯入客群

匯入客群

注意

注意

匯入客群

支援的屬性

注意

注意

範例含有端點定義的檔案