Source Dataset Requirements for the Contacts Data Product

Suggest Edits

The Contacts data product includes a predefined, standardized schema for contact data. When you add data to your data product, you identify how columns in your source datasets correspond to the attributes in the unified schema.

To prepare, review the general Requirements for Source Datasets.

The table below describes these attributes and explains which are:

Required: You cannot refresh your data until you map source columns to these attributes. Mapping ONLY required attributes does not provide sufficient information for clustering or enrichment.
Suggested: For optimal enrichment and clustering results, map source columns to these attributes.
Optional: These attributes have minimal impact on your clustering and enrichment results. If your source data includes columns that match these attributes, map them to include that source data in your completed data product.

Attributes Other than Addresses, Phone Numbers, and Email

Note that the matching model requires either the combination of first and family name values or full name values, whichever is mapped from the source data.

Unified Attribute	Description	Type
Primary Key	The primary key used in the source dataset to uniquely identify each record. See About Primary Keys for more information.	Required
Name Prefix	The contact's prefix, such as Ms. or Mr.	Optional
First Name	The contact's first name.	You are required to map either the first and family name or the full name attributes.
Middle Name	The contact's middle name.	Optional
Family Name	The contact's last name.	You are required to map either the first and family name or the full name attributes.
Full Name	The contact's full name.	You are required to map either the first and family name or the full name attributes.
Name suffix	The contacts's suffix, such as Jr. or Senior.	Optional
Professional Title	The contact's professional title.	Suggested
Organization Name	The name of the contact's organization or business.	Suggested
Organization Alternative Names	The alternate name of the contact's organization or business.	Optional
Organization Website	The website or url of the contact's organization or business.	Optional

Address Attributes

You can configure multiple address types. Address attributes are organized into different groups, representing different types of addresses associated with the contactss.

The data product schema includes Primary address attributes by default. You can choose to include attributes for additional address types, including:

Office
Corporate
Previous
Mailing
Shipping
Registered
Billing
Other

Within an attribute group, the attribute name is prefixed with the address type. For example: Primary: Address, Billing: City, and Mailing: Country.

Each attribute group includes the following address attributes:

Unified Address Attribute	Description	Type
Address	Either line 1 of the address, or the complete address.	Suggested for primary address. Optional for other address types.
Address Line 2	Line 2 of the address.	Optional
Address Line 3	Line 3 of the address.	Optional
Address Line 4	Line 4 of the address.	Optional
City	City of the address.	Optional
State	The state or region of the address.	Optional
Postal Code	Postal (zip) code of the address.	Optional
Country	Country of the address.	Suggested for primary address. Optional for other address types.
Latitude	The latitude of the address.	Optional
Longitude	The longitude of the address.	Optional

Phone Attributes

You can configure multiple phone number types. Phone number attributes are organized into different groups, representing different types of phone numbers associated with a person.

The data product schema includes Mobile phone number attributes by default. You can choose to include attributes for additional phone number types, including:

Home
Work
Office
Other

Within an attribute group, the attribute name is prefixed with the phone number type (for example: Mobile: Phone).

Each phone number group includes the following attribute:

Unified Phone Attribute	Description	Type
Phone	Phone number	Suggested for mobile number. Optional for other phone numbers.

Email Attributes

You can configure multiple email address types. Email address attributes are organized into different groups, representing different types of email addresses associated with a person.

The data product schema includes Personal email address attributes by default. You can choose to include attributes for additional email address types, including:

Work
Office
Other

Within an attribute group, the attribute name is prefixed with the email address type (for example: Personal: Email).

Each email address group includes the following attribute:

Unified Email Attribute	Description	Type
Email	Email address.	Suggested for personal email. Optional for other email addresses.

Updated 5 days ago