Product

解决方案

资源

Company

Product

解决方案

资源

Company

G

G

M

M

将您的联系人导入 bird

使用CSV文件导入添加或更新联系人

视频指南

视频指南

视频指南

了解如何在Bird中导入和管理联系人。本指南涵盖导入CSV文件、创建联系人列表、管理订阅状态以及将单个联系人添加到现有列表中。

逐步指南

将联系人导入Bird,可以通过批量上传联系人信息来高效管理您的受众。此指南提供了使用CSV文件导入联系人的分步骤过程。

访问 Contacts 页面

  1. 去 Marketing > Audience > Contacts

  2. 您也可以去 CRM > Contacts

  3. 点击 Manage data > Import from CSV


  1. 去 Marketing > Audience > Contacts

  2. 您也可以去 CRM > Contacts

  3. 点击 Manage data > Import from CSV


  1. 去 Marketing > Audience > Contacts

  2. 您也可以去 CRM > Contacts

  3. 点击 Manage data > Import from CSV


准备您的CSV File

  • 下载模型文件:在CSV导入器中,下载提供的模型文件作为模板以确保格式正确。



  • 确保正确的结构:您的CSV文件必须包含至少一个标识符,如电话号码或电子邮件地址。您还可以包含额外的属性,如国家、名、姓等。

如果您的CSV文件像下面的示例,您将能够成功完成导入。

请注意,并非所有字段都已完成,但每个联系人在电话电子邮件列中都有数据。

firstName

lastName

country

phone

email

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格式:

email

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文件拖放到指定区域,或点击浏览从您的设备中选择文件。

上传后,检查字段以确保所有数据已正确映射。

  1. 滚动浏览列以验证准确性。

  2. 确认无误后,点击继续。


映射 Columns

在地图列部分,您会看到一个映射,其中左侧是您的CSV文件列,右侧是映射到联系属性。

  • 一些映射会为您预先填写,您可以根据需要更新它。更新后,点击保存映射。


  • 您可以点击任意映射旁的齿轮图标,以查看联系属性的高级设置,例如:

    • 如果您想要覆盖现有值或仅在为空时设置它。默认情况下,导入设置为覆盖。



    • 如果您希望值为必填项,这意味着如果缺少必填属性的值,联系行将不会被导入。默认情况下,属性不是必需的。



在地图列部分,您会看到一个映射,其中左侧是您的CSV文件列,右侧是映射到联系属性。

  • 一些映射会为您预先填写,您可以根据需要更新它。更新后,点击保存映射。


  • 您可以点击任意映射旁的齿轮图标,以查看联系属性的高级设置,例如:

    • 如果您想要覆盖现有值或仅在为空时设置它。默认情况下,导入设置为覆盖。



    • 如果您希望值为必填项,这意味着如果缺少必填属性的值,联系行将不会被导入。默认情况下,属性不是必需的。



在地图列部分,您会看到一个映射,其中左侧是您的CSV文件列,右侧是映射到联系属性。

  • 一些映射会为您预先填写,您可以根据需要更新它。更新后,点击保存映射。


  • 您可以点击任意映射旁的齿轮图标,以查看联系属性的高级设置,例如:

    • 如果您想要覆盖现有值或仅在为空时设置它。默认情况下,导入设置为覆盖。



    • 如果您希望值为必填项,这意味着如果缺少必填属性的值,联系行将不会被导入。默认情况下,属性不是必需的。



提供进一步的配置

在配置步骤中,您可以定义其他设置,例如订阅、标识符、列表以及启用automations。

  • Identifier mapping: 您可以配置并选择您要定义的任何标识符,并将其映射到csv文件的列标题。您还可以通过键入并从下拉列表中选择来创建新的自定义标识符。


  • 添加到列表:您可以选择一个或多个现有列表以添加联系人。您也可以创建一个新列表并添加到其中。

  • 启用automations: 您可以配置是否希望journeys和flows之类的automations在创建或更新联系人时根据导入自动触发。默认情况下,如果automations是基于联系人创建或更新,它们将被触发。



  • Subscription Management: 您可以为每个平台定义如何设置导入联系人的Subscription属性值。请注意,只有Subscribed的联系人将在Campaigns中显示为预计的收件人。


审查和{

检查所有设置和映射。

  1. 点击继续以导入部分

  2. 您可以点击运行审计在导入前检查数据是否有错误

  3. 如果一切正常,点击导入


您将被重定向到导入选项卡,您可以在此处监控进度并查看所有导入的详细信息


导入时的常见问题

为什么我的列表中的联系人数量少于导入的数量

导入视图显示了CSV文件中所有处理过的行数,但是如果您的文件中有重复的标识符(例如电话或电子邮件),那么创建并添加到列表中的联系人总数将会少于预期。

请注意,如果您有相同的标识符,则您的联系人将会被创建为一个,其他标识符将被添加到其中。例如,如果您有2个联系人,电子邮件不同但电话号码相同,您将只获得一个创建的联系人,其中包含2个电子邮件和1个电话号码。

为什么我的列表中的联系人数量少于导入的数量

导入视图显示了CSV文件中所有处理过的行数,但是如果您的文件中有重复的标识符(例如电话或电子邮件),那么创建并添加到列表中的联系人总数将会少于预期。

请注意,如果您有相同的标识符,则您的联系人将会被创建为一个,其他标识符将被添加到其中。例如,如果您有2个联系人,电子邮件不同但电话号码相同,您将只获得一个创建的联系人,其中包含2个电子邮件和1个电话号码。

为什么我的列表中的联系人数量少于导入的数量

导入视图显示了CSV文件中所有处理过的行数,但是如果您的文件中有重复的标识符(例如电话或电子邮件),那么创建并添加到列表中的联系人总数将会少于预期。

请注意,如果您有相同的标识符,则您的联系人将会被创建为一个,其他标识符将被添加到其中。例如,如果您有2个联系人,电子邮件不同但电话号码相同,您将只获得一个创建的联系人,其中包含2个电子邮件和1个电话号码。

一个人在办公桌前站着,一边在笔记本电脑上打字。

这个完整的AI原生平台可以随着您的业务进行扩展。

Product

解决方案

资源

Company

隐私设置

社交

Newsletter

通过每周更新到您的收件箱,随时了解 Bird 的最新动态。

Signup

© 2025 Bird

一个人在办公桌前站着,一边在笔记本电脑上打字。

这个完整的AI原生平台可以随着您的业务进行扩展。

Product

解决方案

资源

Company

隐私设置

社交

Newsletter

通过每周更新到您的收件箱,随时了解 Bird 的最新动态。

Signup

© 2025 Bird