视频指南
了解如何在Bird中导入和管理联系人。本指南涵盖导入CSV文件、创建联系人列表、管理订阅状态以及将单个联系人添加到现有列表中。
逐步指南
将联系人导入Bird，可以通过批量上传联系人信息来高效管理您的受众。此指南提供了使用CSV文件导入联系人的分步骤过程。
访问 Contacts 页面
去 Marketing > Audience > Contacts
您也可以去 CRM > Contacts
点击 Manage data > Import from CSV
准备您的CSV File
下载模型文件：在CSV导入器中，下载提供的模型文件作为模板以确保格式正确。
确保正确的结构：您的CSV文件必须包含至少一个标识符，如电话号码或电子邮件地址。您还可以包含额外的属性，如国家、名、姓等。
如果您的CSV文件像下面的示例，您将能够成功完成导入。
请注意，并非所有字段都已完成，但每个联系人在电话或电子邮件列中都有数据。
firstName | lastName | country | phone | |
|---|---|---|---|---|
Jane | Smith | US | +911234567892 | jane-smith@sample.com |
Daan | Bakker | DE | daan-bakker@sample.com | |
Maria | UK | +911234567891 | ||
fatima-khan@sample.com |
重复和合并：
请注意，任何重复的行将被忽略，不会创建重复的联系人。同时，注意由于电话和电子邮件都被视为标识符，如果两行具有相同的电子邮件和不同的电话号码，它们将合并为一个联系人。同样适用于两行具有相同的电话和不同的电子邮件。
添加属性列
您还可以在csv上传中添加任何属性的值，方法是在csv头中引用它们的名称。例如，为了在您的csv上传中添加城市属性的值，请在属性名称字段中（而非显示名称）在属性之后添加突出显示的部分，即attributes.city到csv头。
您可以在Contacts > Data Management > Attributes下找到这些名称。
请注意，列名在这种情况下应该是city而不是显示名称City。
以下是csv格式：
phone | country | city | birthday | |
|---|---|---|---|---|
jane-smith@sample.com | +911234567891 | US | New York | 2025-07-25T12:00:00Z |
上传日期类型属性的格式为YYYY-MM-DDTHH:MM:SSZ
自定义标识符
上传自定义标识符和通信属性时，您可能不需要电子邮件或电话作为必填列，但自定义标识符列将是必填的。如果您的自定义标识符属性名称是attributes.userId（不是显示名称），那么您应该使用的列应该是identifier.userId。
对于电话或电子邮件的通信属性，您需要像使用其他属性名称的列一样使用它们的名称。如果您的通信属性是attributes.phone_number和attributes.email_address，那么csv导入将如下所示
identifier.userId | phone_number | email_address | country | city |
|---|---|---|---|---|
1234 | +911234567891 | a@b.com | US | New York |
上传您的CSV文件
将准备好的CSV文件拖放到指定区域，或点击浏览从您的设备中选择文件。
上传后，检查字段以确保所有数据已正确映射。
滚动浏览列以验证准确性。
确认无误后，点击继续。
映射 Columns
在地图列部分，您会看到一个映射，其中左侧是您的CSV文件列，右侧是映射到联系属性。
一些映射会为您预先填写，您可以根据需要更新它。更新后，点击保存映射。
您可以点击任意映射旁的齿轮图标，以查看联系属性的高级设置，例如：
如果您想要覆盖现有值或仅在为空时设置它。默认情况下，导入设置为覆盖。
如果您希望值为必填项，这意味着如果缺少必填属性的值，联系行将不会被导入。默认情况下，属性不是必需的。
提供进一步的配置
在配置步骤中，您可以定义其他设置，例如订阅、标识符、列表以及启用automations。
Identifier mapping: 您可以配置并选择您要定义的任何标识符，并将其映射到csv文件的列标题。您还可以通过键入并从下拉列表中选择来创建新的自定义标识符。
添加到列表：您可以选择一个或多个现有列表以添加联系人。您也可以创建一个新列表并添加到其中。
启用automations： 您可以配置是否希望journeys和flows之类的automations在创建或更新联系人时根据导入自动触发。默认情况下，如果automations是基于联系人创建或更新，它们将被触发。
Subscription Management： 您可以为每个平台定义如何设置导入联系人的Subscription属性值。请注意，只有Subscribed的联系人将在Campaigns中显示为预计的收件人。
审查和{
检查所有设置和映射。
点击继续以导入部分
您可以点击运行审计在导入前检查数据是否有错误
如果一切正常，点击导入
您将被重定向到导入选项卡，您可以在此处监控进度并查看所有导入的详细信息
导入时的常见问题
为什么我的列表中的联系人数量少于导入的数量
导入视图显示了CSV文件中所有处理过的行数，但是如果您的文件中有重复的标识符（例如电话或电子邮件），那么创建并添加到列表中的联系人总数将会少于预期。
请注意，如果您有相同的标识符，则您的联系人将会被创建为一个，其他标识符将被添加到其中。例如，如果您有2个联系人，电子邮件不同但电话号码相同，您将只获得一个创建的联系人，其中包含2个电子邮件和1个电话号码。
