In this article, you'll learn about Attributes in Talon.One. You can manage, test and create new Custom Attributes in the Developers section of your account.
Before you start using Custom Attributes in your rules, make sure you're set up correctly and your integration is sending the right data to Talon.One.
Before You Start
- You will need an active Talon.One integration and at least one Application in your Account
- Your Developers should be familiar with our Attributes Documentation
*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 a range of ready-to-use attributes in your Talon.One account like billing address, customer name, birth date, etc. that are associated with customer profiles, promotions and events.
For example, attributes can be used in the Rule Builder like this:
You can also create your own Custom Attributes when you need to narrow the scope of your campaign and 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" simply means you create the Attribute and define its parameters yourself.
Creating New Attributes
You can assign any data you send Talon.One to a Custom Attribute and unlock many possibilities when building rules. Custom Attributes use your unique business data and so should only be created by someone from your tech team to ensure they are correctly connected to your integration.
Navigate to the Attributes page and click + Create Attribute.
You need to fill in the required information for the following fields:
- Entity: Customer Profile, Application, Campaign, Coupon, Referral, Customer Session, Cart Item, Event*
- Event Type: Select the event type from the drop-down (*Only visible when Event is the entity)
- Attribute Type: String, Number, Boolean, Time, Location, List of Strings, List of Numbers, List of Dates, List of Locations
- API Name: This is how your attribute will look in the backend code (no spaces, only underscores)
- Title: The name of your attribute to search for in the Rule Builder Palette
- Description: Important details to identify your attribute
- Suggestions: Add suggestions for commonly used inputs (for Strings only)
- Available In Applications: If this attribute should be exclusive to one or more applications, select those applications here. Default is 'All applications'.
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 understand the purpose of this attribute.
Next click Create Attribute and now you can search for and use the Attribute in the Rule Builder.
Using Custom Attributes
Custom Attributes can be used in many different ways to create your specific use cases. Read more about Using Conditions and Using Effects to understand how Attributes can be used when building Campaign Rules.
Using Attribute 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.
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 easily identify campaigns, organize campaigns and track attribution. Some examples of Campaign Attributes include: Country Name, Category, Offer, Internal ID, Mobile, etc.
In the Settings page of your 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.
If an attribute is not available on this page, check that attribute's application availability- it might be excluding the current application.
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.
Simply hit the + Add Custom Attributes button and select your attributes.
This will help you easily manage, search and identify coupons.
After creating a referral campaign, you can add referral attributes to a Referral Code. To add the referral attribute to a code simply click on the + Add Custom Attributes when editing a Referral Code.
Referral attributes are an excellent way to help you manage and identify the codes.
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.
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 any questions about managing your Attributes get in touch.