导入客户细分

使用 Amazon Pinpoint，您可以定义一个用户客户细分，方法是导入包含有关属于客户细分的用户的信息的文件。如果您在 Amazon Pinpoint 之外定义用户客户细分，但又想通过 Amazon Pinpoint 活动吸引用户，则导入客户细分非常有用。

与在控制台中使用客户细分生成器创建的动态客户细分不同，导入客户细分是一组不变的端点或用户 ID：

导入客户细分由端点、用户 ID 或这二者的组合组成。使用 Amazon Pinpoint 向客户细分发送消息时，可能的目的地包括：

创建新客户细分时，您可以使用一个导入客户细分作为基本客户细分。然后，您可以对该基本客户细分应用筛选条件，以根据您的需求对其进行优化。

导入客户细分注意事项

创建导入客户细分时，请考虑以下因素：

客户细分文件

您可以在逗号分隔值 (CSV) 或 JSON 文件中定义属于您的客户细分的端点或用户 ID。然后，将此文件导入 Amazon Pinpoint 来创建客户细分。

导入客户细分时，请记住以下几点：

示例客户细分文件

本节中的示例文件基于以下数据：

此表中的每一行代表一个端点。请注意，用户 ID example-user-id-2 和 example-user-id-3 将分别分配给两个端点。

导入客户细分

将客户细分导入 Amazon Pinpoint 有两种办法：一是直接从计算机上传文件，二是导入存储在 Amazon Simple Storage Service（Amazon S3）存储桶中的文件。

建议您从计算机上传文件，当计算机上已有客户数据时尤其要这样做。但是，您一次只能导入 10 个文件，并且只能上传小于 1 GB 的文件。

如果您需要一次导入 10 个以上的文件，或者需要上传大于 1 GB 的文件，则应从 Amazon S3 导入文件。如果您已经具有将客户数据文件发送到 Amazon S3 以进行存储的流程，则 Amazon S3 导入选项也很有用。

此部分包含使用这两种方法导入客户细分的过程。

支持的属性

本节中的表列出并描述了您可以在导入到 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"]} 格式。

您可以为每个项目中的端点和用户创建多达 250 个自定义属性。有关更多信息，请参阅《Amazon Pinpoint 开发者指南》中的 Amazon Pinpoint 限额。