匯入客群 - Amazon Pinpoint
匯入的客群考量客群檔案匯入客群支援的屬性

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

匯入客群

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

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

端點

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

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

使用者 ID

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

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

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

  • 您在匯入的檔案中列出的每個端點。

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

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

匯入的客群考量

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

  • 建立廣告活動時，您必須選擇區隔。若選擇動態客群，Amazon Pinpoint 會提供該客群規模的估算值。但若您選擇匯入的客群，Amazon Pinpoint 將無法提供估算值。

  • 如果您建立的行銷活動會在特定事件發生時傳送訊息，則您不能使用匯入的客群。基於事件的行銷活動只能使用動態客群。如需有關建立動態客群的詳細資訊，請參閱建置客群。

客群檔案

您可以使用IDs逗號分隔值 (CSV) 或JSON檔案來定義屬於您區段的端點或使用者。接著將檔案匯入 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

這個表格中的每一列各代表一個端點。請注意，使用者IDsexample-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 簡單儲存服務 (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/。

  2. 在 All projects (所有專案) 頁面，選擇您要新增客群的專案。

  3. 在導覽窗格中，選擇 Segments (客群)。

  4. 選擇 Create a segment (建立客群)。

  5. 在 Create a segment (建立客群) 下，選擇 Import a segment (匯入客群)。

  6. 在 Import method (匯入方法) 下方，選擇 Upload files from your computer (從您的電腦上傳檔案)。

  7. 在 Files to import (要匯入的檔案) 下方，選取 Choose files (選擇檔案)。選取您要匯入的一或多個檔案。

    注意

    您也可以從電腦的檔案總管拖曳檔案並直接放到將檔案放置在這裡 (Drop files here)。

  8. 將檔案上傳到 Amazon Pinpoint 時，必須為匯入的每個檔案提供客群名稱。在「區段名稱」下，為您要匯入的每個檔案輸入區段名稱。

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

    在區段建立頁面上顯示「區段名稱」區段。使用者已上傳兩個檔案：High Value Customers.csv和Top Users by Activity.json。
    注意

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

  9. 完成後，選擇 Create segment (建立客群)。

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

如需建立值區和上傳物件的簡介，請參閱什麼是 Amazon S3？ 在 Amazon 簡單存儲服務用戶指南。

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

匯入客群

  1. 打開亞馬遜精確控制台，位於https://console.aws.amazon.com/pinpoint/。

  2. 在 All projects (所有專案) 頁面，選擇您要新增客群的專案。

  3. 在導覽窗格中，選擇 Segments (客群)。

  4. 選擇 Create a segment (建立客群)。

  5. 在 Create a segment (建立客群) 下，選擇 Import a segment (匯入客群)。

  6. 在「節段名稱」 中，輸入節段的名稱。

  7. 對於 Amazon S3 URL，請輸入包含區段檔案的 Amazon S3 儲存貯體的位置。儲存貯體的地址必須為下列格式：

    s3://bucket-name/folder-name

    Amazon Pinpoint 會從您指定的路徑及該路徑中的所有子資料夾匯入檔案。

  8. 對於 IAMrole，請完成下列其中一個步驟：

    • 如果您要讓 Amazon Pinpoint 建立一個允許讀取 Amazon S3 儲存貯體的角色，請選擇自動建立角色。然後，針對IAM角色，輸入您要建立之角色的名稱。

    • 如果您已經建立允許 Amazon Pinpoint 從 Amazon S3 儲存貯體讀取的IAM角色，請選擇選擇現有角色。然後，針對IAM角色選擇包含適當權限的角色。

    如果您想要自行建立IAM角色，請參閱 Amazon Pinpoint 開發人員指南中的用於匯入端點或區段的IAM角色。建立角色後，請在 Amazon Pinpoint 主控台中指定該角色。

  9. 在您匯入的檔案類型下，選擇JavaScript 物件標記法 (JSON) 或逗號分隔值 (CSV)，視您上傳到 Amazon S3 的檔案格式而定。

  10. 選擇 Create segment (建立客群)。

支援的屬性

本節中的表格列出並說明您可以在端點定義中指定匯入 Amazon Pinpoint 的屬性。如果您使用檔案匯入區段，CSV檔案中的標題應與「屬性」(A ttribute) 欄中顯示的名稱相符。

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

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

完整JSON結構與 Amazon 精確定位參考中的範例端點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 推播通知服務 (APNs) 通道傳送至 iOS 裝置上執行之應用程式的推播通知的端點。

  • EMAIL – 適用於可以接收電子郵件訊息的端點。

  • GCM— 對於可以接收您通過 Firebase 雲消息傳遞（FCM）通道發送到在 Android 設備上運行的應用程序的推送通知的端點。

  • SMS— 適用於可接收SMS文字訊息的端點。
Demographic.AppVersion 與端點相關聯的應用程式版本編號。
Demographic.Locale 端點的語言環境，格式如下：ISO639-1 字母 2 字母代碼，後跟一個底線 (_)，後跟一個 3166-1 阿爾法 2 的值。ISO例如，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於二零一九年UTC八月二十三日上午 10 時 54 分。
Id 端點的唯一識別碼。
Location.City 端點所在的城市。
Location.Country 用於端點所在國家或地區的兩個字元代碼，採用 ISO3166-1 α-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 配額。