导入联系人

通过一个 CSV 文件为电子邮件、短信、WhatsApp 和 Viber 注册联系人。一个电话号码列即可同时为联系人注册短信和 WhatsApp，因此您无需为每个渠道单独准备文件。

准备您的 CSV 文件

文件格式

• 第一行必须包含描述每列数据的列标题。
• 随后的每一行代表一个联系人，其值与标题相对应。
• 值必须用逗号分隔。
• 以 UTF-8 编码保存文件，以确保字符正确显示。
• 最大文件大小为 100 MB。

联系人列

根据您想要为联系人注册的渠道，至少包含以下一列：

• 电子邮件： 收件人的电子邮件地址。
• 电话号码（用于短信、WhatsApp 和 Viber）：国际格式，以 + 和国家代码开头，例如 +120XXXXX234。请输入不带 whatsapp: 或 viber: 前缀的纯号码。当您将该列映射到相应渠道时，Pushwoosh 会自动添加前缀。

如果电话号码不是有效的国际格式，该号码会在对应渠道中被跳过。该行的其余部分仍会导入。

注意

您 CSV 文件中的列名不必与这些标签匹配。在导入过程中，您可以在向导中将现有的列名映射到一个渠道。例如，名为 Mobile 的列可以映射到 SMS 或 WhatsApp 渠道。

可选列

• User ID： 用户的唯一标识符（例如姓名或电子邮件）。非必需，但建议使用，以便联系人的各个渠道共享一个用户个人资料，而不是多个。
• 任何其他列都可以映射到系统标签，用于细分和个性化，例如 Location、Birthday、Language 或 Customer type。

CSV 文件示例

Email,Mobile,User ID,Name,Location
john.smith@email.com,+120XXXXX234,john.smith@email.com,John Smith,New York
jane.smith@email.com,+131XXXXX890,jane.smith@email.com,Jane Smith,Los Angeles

上传并映射 CSV 文件

1. 前往 Audience → Import CSV → Import Contacts。

   

2. 点击 Upload CSV 并选择您的文件。要替换文件，请点击 Upload Another CSV。

   警告

   上传文件时，Pushwoosh 会检查整个文件。只要有一行无法解析（其列数与表头不一致，或带引号的值未闭合），文件就会立即被拒绝。提示消息会指明该行及原因，例如“Row 42: the number of values does not match the header.”。在这种情况下不会导入任何内容。修正该行后重新上传文件。

3. 为导入的联系人输入一个 Segment name。

4. 在 Contact column in CSV 下，选择一个列，并在其旁边选择它注册的 Channel（Email、SMS、WhatsApp 或 Viber）。点击 + Add channel 以映射另一列，或将同一列映射到其他渠道。

5. 在 UserId column in CSV 下，选择包含唯一用户标识符的列（如果您的文件中有）。

6. 要包含用于细分的额外数据，请从您的 CSV 中选择一个 Column Name 并为其分配一个 Tag。点击 + Add Column 以映射更多属性。

   

7. 点击 Start Import。

导入后，这些联系人即可用于您所映射渠道的营销活动。它们将作为新细分出现在 Segments 列表中，也可以通过 User explorer 访问。

完成屏幕会显示两个计数：

• Created： 应用中新增的渠道注册。
• Updated： 已存在的渠道注册，包括同一地址或号码以不同的 User ID 或在不同设备平台上重新注册的情况。

两者统计的都是渠道注册数，而不是联系人数或 CSV 行数。映射到两个渠道（例如短信和 WhatsApp）的联系人会计为 2。

对于已更新的联系人，只有在第 6 步中映射的标签会发生变化，其值会被 CSV 中的值覆盖。联系人上已设置的其他标签保持不变。

注意

最近导入列表中较早的导入会显示单一的 Imported 计数，而不是 Created 和 Updated。

导入期间跳过的行

完成屏幕会按原因对跳过的行进行分组：

• Email address is not valid（电子邮件地址无效）
• Phone number is not valid（电话号码无效）
• No contact address in the row（行中没有联系人地址）：所有映射的列都为空

一行可能被部分导入，但仍会显示在此分类中。例如，电子邮件列成功，但电话列验证失败。

点击 Download skipped rows 以获取仅包含这些行的 CSV 文件。该文件会添加一个额外的列来说明跳过原因，以便您修复这些行并重新上传。

注意

请在离开完成屏幕之前下载该文件。如果您稍后从 Import CSV 中心的最近导入列表中打开同一次导入，会看到各原因的计数，但不会显示下载链接。

导入未能注册的行

有些行在文件中看起来没有问题，但仍然无法通过。例如，一个电子邮件地址可能拼写正确，但仍被拒绝，因为它属于一次性或退信域名。Pushwoosh 将此类行计为 Failed，与 Created、Updated 或 Skipped 分开统计。

失败的行不会按原因进行分类，也不会包含在跳过行的下载文件中。要找到它们，请将您的源 CSV 文件与导入的细分进行比较。修复缺失的地址（例如，删除一次性或退信域名），然后在新的导入中仅重新上传这些行。