Customers
    • 7 Minutes to read

      Customers


        Article summary

        Manage and define new customer fields within the Customers tab of the Settings menu. The data stored in these listed fields can be used in your loyalty program mechanisms as filters and can also be synchronized with external systems.

        Fields

        When you navigate to the Customers tab, you’ll find the list of fields available within the customer object, displaying the following details:

        Label

        Label of the field

        Unique ID

        Unique ID of the field

        Field type

        Type of the customer data field

        Built-in

        • yes: factory fields provided by default

        • no: custom fields added on the Management UI

        Tags

        Tags associated with the field

        Add a new field

        • Click Create a new field

        • Define the unique ID
          This is the machine-readable ID of the field used for referencing in API calls and mathematical expressions. Once created, the ID cannot be modified.

        • Add the label
          This serves as the identifier for the field throughout the Management UI, used when creating segments, setting up workflows, or viewing customer profiles.

        • Add a description
          This description will be displayed under the customer field on the Personal information page of customer profiles, where field values can be edited.

        • Select the field type
          Select the type of data that is stored in the field. Ensure the data sent through the API matches the format required by the selected type to avoid API request failures.

          • String

          • Numeric

          • Boolean

          • Select (Define possible values)

          • Date  (format: YYYY-MM-DD)

          • URL

          • Datetime (format: YYYY-MM-DD hh:mm:ss)

          • Multiple choice (Define possible values)

          • List

          • Image

        • Default (only applicable for String, Numeric, Boolean, and URL type attributes)
          You can enter a default value for customer fields. After the new customer attribute is added, the default value will be automatically populated in the new attribute of all customers.

        • Format (only applicable for String and List types of fields)
          The format of values can be specified as Date, URL, Email, or Phone number formats, and the API will validate the values accordingly.

        • Tags
          Tags determine how attributes can be accessed and managed within the system:

          • API: The field is included in the response returned by the Customer API.

          • searchable: Any value of the field can be used as a search condition when requesting customer data via the Customer API.

          • importable: The value of the field can be updated through the Imports module.

          • groupable: Data values of the field can be grouped when configuring charts for display on the Dashboard.

          • filterable: The field can be used as a filter condition when requesting customer data via the Customer API.

          • unique: Each field value can only be registered once.

          • external_ID: The field will be available via the Customer API within the external_ids collection and can identify customers in various API calls.

        ⚠️

        Once the unique or external_ID tag is added and attribute settings are saved, it cannot be removed.

        • Access Level
          Select the access level applicable to the customer field. Read more about Access levels below.

        • Fieldset
          Choose or create a group under which the attribute will appear on the Personal information tab of the customer profile.

        Set data & privacy control rules

        • Required: If the attribute is marked as required, ensure you add a default value in the valid format. If this required item’s value is empty, you won’t be able to make further updates to the customer through the profile event unless a value is added in the correct format. However, you can still update customers via the Modify event workflow node, even if the required field isn’t populated.

        • Computed: Checking this box will hide the field from being displayed on the customer profile in the Management UI.

        • Sensitive: Values of sensitive fields aren’t displayed automatically on the customer profile. To view them, you’ll need to enter your Management UI login credentials.

        Make sure you click Save before leaving the page.

        Edit fields

        Edit configured fields anytime except for the Unique ID. Click the Edit button in the field list to edit a field. Use the search bar to locate specific fields if necessary.

        If you set or modify a default value while editing a customer field, this updated value will be applied to all customers. This applies when the attribute was initially empty or had a previously configured default value.

        Delete fields

        Customer fields cannot be deleted, but you can stop using them in your loyalty program. Before you do, make sure that the Required checkbox is not ticked in the editing interface.

        Access levels

        Access levels allow you to specify which group of Management UI users can view and edit particular customer attributes.

        Within the Access levels tab, you’ll find the list of added access levels with the following information:

        • Label

        • Creator: The user who defined the access level.

        • Creation date

        Add a new access level

        • Click Create a new access level

        • Define the unique ID
          The machine-readable ID is assigned to the access level upon creation. Once generated, this ID cannot be modified.

        • Add the label
          This label is used to identify the access level throughout the Management UI when assigning it to roles and customer fields.

        • Click Save

        Edit access levels

        You can modify the label of the access level at any time by clicking the Edit button next to the field in the list. Use the search bar if necessary.

        Delete access levels

        Access levels cannot be deleted, but you can stop using them.

        Add access levels to roles

        To activate access levels, ensure they are assigned to roles configured under the Roles tab of General settings. By default, all the access levels are included in the Administrator role. To assign access levels to additional roles, edit the respective roles and activate the options in the Permission mask section. All access levels, along with their labels, are listed in the Permission mask.

        Settings

        📓

        This menu item is accessible only if the Customers module is enabled. If you don’t see the Settings tab and wish to use any of the features mentioned below, please contact the Antavo Service Desk.

        Under the Settings tab, you can define basic settings that affect all customers.

        Minimum age

        This feature is useful if you’d like to prevent the registration of minors in the loyalty program.

        • Activate the age limit by turning on the corresponding radio button
          When activated, the Birth date field becomes a mandatory attribute for the Optin event.

        • Set the age limit in years
          The minimum age limit must be 13 years. If the Birth date value of the Optin event is below this minimum age, the event will be rejected automatically.

        Make inactive customer data available through API

        If this option is enabled, the endpoints of the Customer API will return the data for both active and inactive customers. Inactive customers are those who haven’t been registered in the loyalty program via an Optin event. Learn more about customer statuses in the Customer insights user manual.

        Before leaving the page, please click Save to make sure your changes are effective.