Help Center

Capture customer data in Profile Properties

At the core of BlueConic are the profile properties that store customer or visitor data in BlueConic customer profiles. Profile properties receive data from various parts of BlueConic, for example from listeners that collect data, from customer input to dialogue forms, from connections that integrate with other systems, and so on. 

Watch the video: BlueConic Profile Properties Overview

To view or manage profile properties, you select Properties or Profile properties from the BlueConic navigation bar.

What are CDP customer profile properties? How to create, manage, and activate real-time customer data in behavioral customer profiles with BlueConic

Organize and manage profile properties

All existing profile properties are shown in a navigation list on the Profile properties tab. You can manage the listed profile properties by searching and filtering. You can even modify the columns displayed. See "Object Navigation" for an in-depth discussion of the navigation list and its options.

How do I create profile properties in BlueConic to store first-party real-time customer data in a customer profiles? Profile property creation

Note: A select group of properties on this page are system-generated and read-only, meaning you cannot alter their settings or data type. These are grayed out in the table but still clickable.


Create a profile property

Profile properties can be created manually in BlueConic. To create a new profile property, click the Add profile property button on the Profile properties tab. Or, you can create profile properties as you are building connections, dialogues, or listeners. 

Define the following settings for a profile property:

Setting Description
Name and Metadata
Name This is the human readable text that appears for the profile property wherever it appears in the BlueConic user interface. See Best practices for names and labels for tips on naming your profile properties.
Labels Assign any number of text labels to the profile property for grouping or easy retrieval.
Description A short description of the profile property.
ID The internal identifier for the profile property. The identifier must be unique for each profile property. A valid ID may consist of letters, numbers, hyphens (-), and underscores (_) and must be at least one character long. Once saved, the ID cannot be modified.
Type Specifies the data type of the profile property. The options are:
  • Text — The value stored in the profile property is in text format. Valid entries include any type of text. Examples: ブルークルー, Blue Crew
  • Email address — The value contains a valid email address. Example:
  • Number — The value stored in the profile property is in numerical format: 0 to 9 and -. If you select this format, you also select units for the number. The maximum number that can be held by BlueConic is 2,147,483,647. Examples: 1234 and -9876
    Note: You can store numbers higher than 2,147,483,647 that you don't use for mathematical operations in a property of type Text.
  • Decimal — The value contains numbers from 0 to 9, - and . with a maximum of 4 decimal places. Examples: 12.3456 and -98
  • Currency — The value contains numbers from 0 to 9, - and .. If you select this format, you can select from over 150 currencies, with the corresponding units. Examples: 12.34 and -98.76.
  • Date time — The value stored in the profile property is in UNIX millisecond timestamp format: the number of milliseconds since 1-1-1970 UTC. Example: 1538073598692 represents September 27th, 2018 6:39:58 PM UTC
  • Group ID — The value serves as the unique ID of a BlueConic group. If you identify this property as a Group ID, you need to provide the Group type as well. Learn more about BlueConic Groups.

Note: If you set these data types, BlueConic will enforce them. Once there is at least one profile with a value for the profile property, you can no longer change the data type (except for "Text" profile properties, which can be changed to the type "Email address" at all times). Learn more about validating and enforcing data types in profile properties.

Segmentation Use the 'Available for segmentation' option to specify whether or not the profile property should be available in the Segments tab to be used as a filter for segmentation. If you do not show the profile property in the Segments tab, you cannot use it do define BlueConic customer segments.
Default values Enter default values for the profile property. These values will be available for building segments — even when no values have been added by listeners to visitor profiles yet.
  • Click Save to permanently save the profile property.

Selecting unit types for numerical profile properties

When you set a profile property's type to number, you can specify a unit for the numbers. The unit serves as a visual aid to help BlueConic users to understand the context for this profile property value. It does not affect the numerical values stored in the profile property. The default value is 'No unit'.

For example, if the profile property value represents page views, you can specify the unit when you create the profile property.

How to store numerical customer data in BlueConic real-time customer profiles / profile property creation

Expert Settings

Use the profile property expert settings to control the privacy level of the property, its data sensitivity (PII vs non-PII), and what happens to the value of a profile property during profile merging. You can also assign a unique identifier to a profile property that aids in the retrieving of property values using the BlueConic REST API.
If you aren't sure about how to configure these settings, it's best to leave them at the default value or ask your BlueConic customer success manager.

Setting Description
Unique identifier A unique identifier that can be used to retrieve profiles with a specific value for a property, for example, an email address. The unique identifier is also used for profile properties that can be used to create a "When to Merge" rule. See Profile merging for complete information.
Select "Create new profile when identifier changes" for improved privacy and security (to prevent profile hijacking). If checked, the visitor will switch to a new profile when a new value for this property is set.
See Unique identifiers in BlueConic.
Data sensitivity Select whether this profile property will contain personally identifiable information (PII) or non-PII. PII settings can be changed to non-PII only if no profiles contain values for this property. Properties with PII are visible only to BlueConic users whose user role includes data visibility for PII. See data sensitivity and visibility settings for more information.
Permission level Specifies what visitor permission level is minimally needed to use the profile property. There are two options:
  • Level 1 — The profile property can only store anonymous data.
  • Level 2 — The profile property can store personal data such as an email address or telephone number.
Merge strategy Specifies what to do with the value of the profile property if the visitor's profile is merged with another profile. See Profile merging for complete information on profile merging. You have the following options:
  • Value of current profile — The value of the property in the current visitor profile is kept. The current profile is the one the visitor was actively using at the time of the merge.
  • Keep both — The values from both profile properties are kept.
  • Most recently updated value — Keeps the value that was last set.
  • Sum — (number, decimal, and currency only) The values from the two matching profile properties are added together.
  • Highest — (number, decimal, and currency only) Keep the highest number from the visitor profiles as the value.
  • Lowest — (number, decimal, and currency only) Keep the lowest number from the visitor profiles as the value.
  • Most recent date — (date time only) Compare both date values and keep the most recent one.
  • Oldest date — (date time only) Compare both date values and keep the most recent one.
  • First stored value — If both profiles have a value, the oldest value (with the oldest timestamp) is used for merging.
Visitor access

Determines what access the visitor or browser has from the browser client to read or write to this profile property (including BlueConic client connections, dialogues, and listeners). Enable the "Read" option to allow the visitor's browser to retrieve the value for this profile property. Enable "Write" to allow the visitor's browser client to write a new value into this property.

When you create new profile properties via the Profile properties tab, Visitor access is turned off by default, to improve security of these values, so the values are not open to changes from the browser. You can choose to enable Read or Write access if you require that the visitor's browser be able to read or write the profile property value. 

Visitor access determines a profile property's read and write access from a website (as well as BlueConic client connections, dialogues, and listeners). It does not apply to batch and server-side, real-time connections, server-side listeners, or the BlueConic REST API. The BlueConic connections to Mailchimp, via Webhooks, and for Facebook Custom Audiences are all examples of batch or server-side real-time connections, so these do not need readable or writable profile properties.

Contact your BlueConic Customer Success Manager for more information.

Hide from UI Enable the "Don’t show on Segments tab" option if you do not want this profile property to show up on the user interface of the Segments tab. This is useful if you only want to be able to hand off the profile property in a connection.


Validate and enforce data types

When you set a data type for a profile property, BlueConic enforces data validation for the number, date time, decimal, and currency data types.

You can see the data type and validation status when you view profile properties in a navigation list.

How to use the BlueConic customer data platform to create a single customer view of first-party real-time customer profiles

See validating and enforcing data types to learn more.

Modify a profile property

You can change any setting for a profile property except the ID of the profile property. When you change any of the settings of a profile property, the Save button is enabled. By clicking the Save button, the profile property settings are permanently modified.

Note: Profile properties that are defined in plugins by a developer are read only and cannot be modified. This is indicated in the user interface by the grayed-out settings and the disabled Save button.


Delete a profile property

To delete a profile property, select the Save button and choose delete from the dropdown menu. Note: Profile properties that are defined in plugins by a developer are read-only and cannot be deleted. This is indicated in the user interface by the grayed-out settings and the disabled Delete option.


Copy a profile property

A shortcut for profile property creation is to copy an existing profile property. Press the Save button and choose Save as... from the dropdown menu.
A new profile property is created with the same settings as the original profile property, but with an adapted ID. You can set a new ID or change any other setting. By clicking the Save button, you finalize the creation of the copied profile property.



In the right-hand sidebar, the "statistics" widget shows the number of profiles in your profile database that contain a value for the profile property that you are managing.
It also shows that last date and time a value was set in any of the profiles for this particular profile property.

How does BlueConic work?

Related items

In the right-hand sidebar, the "related items" widget shows the other objects in BlueConic that are directly related to the profile property that you are managing.
Profile properties can have the following types of related items:

    • Dashboards that display statistics for this profile property.
    • Segments that use this profile property as a filter. 
    • Listeners that are configured to set a value for this profile property. 
    • Dialogues that are configured to set a value for this profile property or interactions that use this profile property as a filter on the "Who" tab. 
    • Connections that map data to or from this profile property. 


Was this article helpful?
0 out of 0 found this helpful