Attributes enable extending the core entities of the Talon.One data model. For example,
an online fashion retailer may wish to add a
Brand attribute to cart items. A
hotel-booking platform might add
CheckOutTime attributes to orders.
An ecommerce shop might want to add a
Segment attribute to customer profiles.
There are 2 types of attributes:
- Built-in attributes: They are provided by Talon.One.
- Custom attributes: They are created by you. For more information on attribute creation, see the end user documentation.
The core data model defines a small set of common attributes for various entities, such
as names for customer profiles and prices for cart items. In addition to these
built-ins, the Attribute Library contains a number of pre-defined
attributes organized into presets. For example, the Travel preset contains attributes
DepartureCountry. You can add library attributes to
your account in the Developer Settings section of the Campaign Manager.
In addition to pre-defined attributes in the Attribute Library, you may also define
custom attributes. As an example, consider a SaaS service with an in-house
community forum. They want to offer special promotions to active forum users, so they
can define a
ForumPosts attribute on customer profiles. These custom attributes can
be defined in the Developer Settings section of the Campaign Manager.
Talon.One will return a 400 error whenever an unknown attribute is transferred in a session. An unknown attribute doesn't appear in the Attribute Library.
You include attributes in update requests for various entities.
For example, consider the
ForumPosts attribute from above. To keep the count of forum posts in sync, the forum should perform an updateCustomerProfile operation every time the user makes a post.
For example, using the Ruby SDK:
The attribute value must match the attributes type, which is defined on a per-attribute basis. Currently the following 6 types are supported:
string- Any valid JSON string.
number- Any valid JSON number, internally these are treated as big decimal numbers.
time- An RFC3999 timestamp.
list of strings- Comma separated list of strings.
list of numbers- Comma separated list of numbers.
You can also remove any attribute value by setting it to
The attribute library lists all the attribute available in Talon.One, built-in and custom.
To open the attribute library:
- Click Account > Dev tools > Attributes.
- Click Attributes Library at the top of the screen.
IntegrationId: the identifier of the entity. It has the same value as the
profileIdof the customer session entity.
IntegrationId: the identifier of the session
ProfileId: the identifier of the customer owning the session. It has the same value as the
IntegrationIdof the customer profile entity.