Every organization is unique, and which data is needed to drive a powerful marketing operation therefor vary from organization to organization. At the center of most marketing activities is the Contact model, holding personal information and contact details for your contacts. Many of your marketing activities will also involve the order history of your contacts, which is where the Order model come in. Out-of-the-box the Contact and Order models provide a range of general attributes - name, contact information, order value, order items etc. that covers a lot of ground. However, to make the most of your marketing efforts, your organization may want to import additional attributes, not covered by the general attributes - this is where custom attributes come in handy.

Custom attributes are additional attributes that your organization want to save on a Contact or an Order, to make segmentation and filtering even more customized to your needs - it may be a membership renewal date, a loyalty program level, or any other data point that is important to you.

You can extend your data model with additional custom attributes at any time and they will be immediately available for filtering in the MarketHype application. To make it possible for us to provide you with appropriate filter options and to validate and properly index your data, all custom attributes need to be defined in advance, before you can import any data using those attributes.

Extend Contact model

The Contact model holds personal data and contact information for a single contact in your database. When extending the Contact model with custom attributes, try to focus on attributes that somehow describe that person:

Extend Order model

The Order model holds data about a specific order placed by a Contact. By default the order can hold information about when the order was placed, what was purchased, order amount etc. When extending the Order model with custom attributes, try to focus on attributes that additionally describe the specific order:

Define a custom attribute

Before you can import data including your custom attribute, you need to define the attribute. By defining the attribute in advance, we can validate your data on import, index it for filtering and provide relevant filtering options in the application depending on what type of data your attribute holds.

Custom attributes can be defined on either the Contact or Order model. To define an attribute you need to define key label and type.

Key

The key is a unique identifier for your custom attribute. The key is used to map your imported data to the right attribute.

<aside> <img src="/icons/warning_yellow.svg" alt="/icons/warning_yellow.svg" width="40px" />

WARNING

The same key cannot be used twice on your model and cannot be changed in the future.

</aside>

Label