导入联系人

上传单个 CSV 文件，即可一次性将联系人注册为电子邮件、短信、WhatsApp 和 Viber 的订阅者。将包含联系人地址的每一列映射到其所属的渠道。同一列（例如电话号码）可以映射到多个渠道，因此您不再需要为相同的短信和 WhatsApp 号码准备单独的文件。

注意

此向导取代了以前为电子邮件、短信、WhatsApp 和 Viber 存在的四个独立的 CSV 导入页面。任何指向旧页面的链接或书签现在都会打开此向导。

准备您的 CSV 文件

CSV 格式化规则

通用结构

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

联系人列

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

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

在导入过程中，如果电话号码不是有效的国际格式，则该渠道的该号码将被丢弃，而不会导致整行失败。

注意

您 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。

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 访问。

注意

“已添加”计数的是渠道注册数，而不是 CSV 行数，因此一个映射到两个渠道（例如短信和 WhatsApp）的联系人会使总数增加 2。

导入期间跳过的行

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

• 电子邮件地址无效
• 电话号码无效
• 行中没有联系人地址： 所有映射的列都为空

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

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

注意

在离开之前，请从此完成屏幕下载文件。该文件仅在此处可用，因为向导仍在内存中保留上传信息。如果您稍后从 Import CSV 中心的最近导入列表中打开同一次导入，原因计数仍然会显示，但下载链接不会显示。

导入未能注册的行

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

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