In this article you will learn about Attributes in Talon.One. You can manage, test and create new Custom Attributes in the Developers section of your account. Before you can start using Custom Attributes in rules, be sure they are setup correctly and your integration is sending the right data to Talon.One. 

Before You Start

Note: Please ensure you have the right technical knowledge to successfully manage Attributes, we recommend that someone from IT, Product or Development manage or support this process directly.

Attributes In Talon.One 

There are several pre-defined attributes available in your Talon.One account like billing address, customer name, birth date, etc. that are associated with various entities like customer profiles, coupons and cart items. Use attributes and custom attributes when you build rules for your campaigns and can be added to rules when you open the Rule Builder Palette.

For example, attributes can be used in the Rule Builder like this: 

You can also create your own Custom Attributes when other data is needed to build more customized campaign rules. To extend your integration beyond the standard attributes, you could add Custom Attributes such as Brand, Product Is On Sale, Subscription Active, etc. depending on your business requirements. "Custom" means you will add the Attribute and define the parameters yourself.

Creating New Attributes

You can map any data points you send Talon.One to a Custom Attribute and unlock many possibilities when building rules. Custom Attributes are very powerful and so should only be created by someone from your tech team to ensure they are correctly mapped to your integration. 

Navigate to the Attributes page and click +New Attribute. You will fill in the required information for the following fields: 

  • Entity: Customer Profile, Application, Campaign, Coupon, Customer Session, Cart Item, Event*
  • Event Type: write the event type in the field (*visible when Event is selected)
  • Attribute Type: String, Number, Boolean, Time, Location, List of Strings, List of Numbers, List of Dates, List of Locations
  • Name: Internal (no spaces) and Visible Title (appears in Rule Builder)
  • Description: write identifying text here
  • Suggestions: Add suggestions for commonly used inputs (for Strings only)
  • Tags: add tags for organization

Please ensure new attributes are configured correctly with your integration before using in campaign Rules. 

For example, you can create a Customer Session Attribute to check if a customer has an active subscription. Name it "Subscription Active" of type "boolean". Be sure to add a clear description so other users can understand the purpose of this attribute. 

Next click Create Attribute and now you can search for the Attribute in the Rule Builder. 

Using Custom Attributes

Custom Attributes can be used in many different ways to achieve your use case. Read more about Using Conditions and Using Effects to understand how Attributes can be used when building Campaign Rules.

Using Attributes Suggestions

When you create an Attribute of type String, you can add suggestions for commonly used inputs. These suggestions will appear in a drop-down list in the Rule Builder when you build a Condition or Cart Filter using this Attribute. This will help your team build rules faster and avoid making mistakes when building rules.

Read how more about using Attribute Suggestions here

Campaign Attributes

In the Settings page of a campaign, you can add values to the Campaign Custom Attributes you have defined (e.g., Attributes associated with the Campaign entity).

For example, marketers can more easily identify campaigns, organise campaigns and track attribution. Some examples of Campaign Attributes include: Country Name, Category, Offer, Internal ID, Mobile, etc.

Application Attributes

In the Settings page of an application, you can add values to the Application Custom Attributes you have defined (e.g., Attributes associated with the Application entity).

This way you can make use of attributes across all campaigns in that application.
This is useful for attributes holding values like lists of physical locations or local public holidays.

Coupon Attributes

Depending on how your integration is configured, you can add Attributes to Coupons. Like Campaign or Application Attributes, you can add values associated with the Coupon entity. This will help you can easily manage, search and identify coupons. 

Testing Attributes

Your developers can use the API Tester in the Developers section to check if the Custom Attributes are configured correctly. Please visit our Developers Center and read more about Attributes.

Attribute Library

View the full Talon.One Attribute Library. With Custom Attributes, it's easy to map most of the data you need onto the appropriate Talon.One entities.


Now you know about Attributes in Talon.One and how to create new Custom Attributes. 

Once your integration is sending the data to Talon.One, these Custom Attributes can be used in campaign rulesets to create even more customized campaigns. If you have questions about managing Attributes get in touch