Custom Attribute: Reference Tag Use

You can define a custom attribute for a shopper in CRMS, and then add a custom attribute reference tag to an email communication so that the custom attribute field value for a specific shopper is added to an email communication. For example, you could define "Shopper Birthday" as a custom attribute for your shopper, collect birthday data for shoppers, and then insert a custom attribute tag into the email that would add a shopper's birthday data into each email.

Because you define custom attributes in CRMS (using the Admin > Custom Attributes page), custom attribute fields are not listed in the standard drop-down menus. To add a custom attribute tag, you must know the tag name (the name of the Custom Attribute Definition Reference Tag field that your organization defined and uses) to refer to the custom attribute. Usually this is something simple, like "shopperbirthday".

Note: To see the reference tag name assigned to a custom attribute, open the Admin > Custom Attributes page, look in the Manage Custom Attributes table, and find the custom attribute you want to use. The table lists the reference tag name for custom attribute.

Custom attribute tags for shoppers are named according to the following convention:

@(shopper:customattrib:<reference_tag_name>)

where: the reference_tag_name maps to the CustomAttributeDefinition ReferenceTag field.

So, if a CRMS user creates a shopper custom attribute with ReferenceTag = “shopperbirthday”, the corresponding tag would be:

@(shopper:customattrib:shopperbirthday)

Note:
  • You can substitute "s" for shopper, so the following also works:
  • @(s:customattrib:shopperbirthday)
  • Make sure there are no spaces within the tag.
  • Custom attributes that are supposed to display dates also include specific time data (hours and minutes). Regardless of the data entered, the displayed "date" fields have the following format: MM/DD/YYYY:HH/MM
  • Custom attributes that are supposed to display integer numbers actually display numbers with two decimal digits, regardless of the data originally entered.