CSV Record Matching And Data Mapping

Record Matching

CSV data is matched against records in Demandbase using the following rules:

Accounts are matched against data from your CRM or Demandbase using the following prioritization:

  • External account ID (if provided)
  • Account domain + account name

Opportunities are matched against accounts using

  • account domain
  • account name
  • or external account ID.

People are matched against accounts using

  • external account ID
  • account domain
  • or account name.

Important: Importing people records only makes the data available for advertising campaigns.

To see individual activity at the person level, an integration with a CRM or Marketing Automation System is required.

Activities are matched against accounts or people using the external person ID.

Important: If the external person ID is related to an account, then the activity is matched against both the account and the person. If the external person ID is not related to an account, then the activity is matched against the person only.

CSV Headers

  • Account

    Field NameRequired
    Account NameYes
    Account DomainYes
    Owner (email or name)No
    Phone NumberNo
    EmployeesNo
    Annual RevenueNo
    IndustryNo
    External Account IDNo
    Custom FieldsNo

  • People

    Header NameRequired
    First NameYes
    Last NameYes
    EmailYes
    Account NameNo
    Account DomainNo
    External Account IdNo
    External Person IdYes
    Person TypeNo
    Postal CodeNo
    RoleNo
    TitleNo
    StateNo
    Custom FieldsNo

    Matching Logic

    People records are matched using:

    1. external_account_id
    2. account_domain
    3. account_name

    Important:

    • Importing People records only supports advertising audiences unless CRM/MAS integrations exist.
    • Email is strongly recommended for deduplication and enrichment.
  • Opportunity CSV Headers

    Opportunity Field NameRequired
    External Opportunity IDYes
    Opportunity NameYes
    Account NameYes
    Account DomainYes
    Close DateNo
    External Account IDNo
    Opportunity StageNo
    Opportunity TypeNo
    RevenueNo
    Custom fieldsNo
  • Activity

    You can import task, call, meeting, email, and custom activity types.

    Task

    Field NameRequired
    TimeStampYes
    Activity DateYes
    OwnerYes
    External Person IDYes
    External Activity IDYes
    TitleNo
    Account NameNo
    DescriptionNo
    Account DomainNo
    PriorityNo
    StatusNo
    TypeNo

    Call

    Field NameRequired
    Activity DateYes
    CallerYes
    TimeStampYes
    TitleYes
    External Person IDYes
    External Activity IDYes
    DurationNo
    Account NameNo
    DescriptionNo
    Account DomainNo
    Recording URLNo
    CalleeNo
    DirectionNo

    Meeting

    Field NameRequired
    Start TimeYes
    TitleYes
    Activity DateYes
    Owner IdYes
    End TimeYes
    External Person IDYes
    External Activity IDYes
    LocationNo
    Account NameNo
    Account DomainNo
    BodyNo
    External URLNo
    OutcomeNo

    Email

    Field NameRequired
    TimeStampYes
    SubjectYes
    Activity DateYes
    From EmailYes
    External Person IDYes
    To EmailYes
    External Activity IDYes
    Open Sales EmailNo
    Open Sales EmailNo
    Account NameNo
    Attachment IDsNo
    Account DomainNo
    Sender First NameNo
    Click Sales EmailNo
    Recipient Last NameNo
    Marketing Email OpenNo
    StatusNo
    Click EmailNo
    Sender Last NameNo
    BodyNo
    Recipient First NameNo

    Custom Activity

    Field NameRequired
    Activity DateYes
    External Person IDYes
    External Activity IDYes
    Any custom activity field that is a string typeNo

For more information, please refer to this document: What to know when importing data from a CSV file