Siebel Loyalty Administration Guide > Setting Up Siebel Loyalty Promotions > Process of Creating Loyalty Promotions >

Creating Attributes for Loyalty Programs

Attributes represent properties of objects which are used by criteria. Criteria can compare an attribute to a value or compare an attribute to another attribute.

Attributes generally represent fields in records, such as the Transaction record or the Member record. For example, to create a promotion that only applies to Platinum members, you must create an attribute representing the Tier field of the Member record. Then, as one of the criteria for this promotion, you create a criterion saying that this attribute equals Platinum.

Before you create a promotion based on the attributes listed in Table 16, the attributes must be defined at the program level.

All the types of attributes are summarized in Table 16.

This task is a step in Process of Creating Loyalty Promotions.

Creating Member Attributes

Member attributes are dynamic values that you create to track actions over the life time of a member. The value of a member attribute can be based on any field in a transaction, and they are updated every time a transaction takes place.

This task is a step in Process of Creating Loyalty Promotions.

To create member attributes

1. Navigate to the Loyalty Program Administration screen.
2. Locate the program that the attribute applies to and click its Program Id hyperlink.
3. Clear the program form's Active check box.
4. Click the Program Level Attributes view tab.
5. In the link bar of the Program Level Attributes view, click Member Attributes.
6. Add a record to the Program Level Attributes list, and complete the necessary fields. Some fields are described in the following table.

   Field	Description
   Data Type	Based on what type of data is being tracked, select Date, Integer, Number, or String. If the values are free form text (such as Yes and No), then select String.
   Default Value	Displays the original value before the transaction was updated.
   Merge Action	Specify how the program handles this attribute when you do a member merge. For more information, see Merging Loyalty Program Members.
   Pick List	Select this check box if the attribute is a field whose values are entered using a picklist. Then, when you are defining criteria and actions, Siebel Loyalty displays the picklist with the values for this field.
   Pick Applet	Select this check box if the attribute is a field whose values are entered using a dialog box. Then, when you are defining criteria and actions, Siebel Loyalty displays the dialog box with the values for this field.
   Pick Field	The pick field is that field whose value the user sees in the UI after selecting from the pick applet.

7. When you are finished creating all attributes for the program, select the program form's Active check box.

   NOTE:  You also must create a promotion to update this attribute.

Creating Member Field, Member Tier, or Transaction Attributes

Member field attributes represent fields in the member record. Member tier attributes represent fields in the Tier record for the member's tier. Transaction attributes represent fields in the Transaction record.

To create member field, member tier, or transaction attributes

1. Navigate to the Loyalty Program Administration screen.
2. Locate the program that the attribute applies to and click its Program Id hyperlink.
3. Clear the program form's Active check box.
4. Click the Program Level Attributes view tab.
5. In the link bar of the Program Level Attributes view, click Member Field Attributes, Member Tier Attributes, or Transaction Attributes.
6. Add a record to the Program Level Attributes list, and complete the necessary fields. Some fields are described in the following table.

   Field	Description
   Pick Field	Select the field that the attribute represents. To make additional fields available in this field, see About Changing the Fields Used in Loyalty Attributes.
   Merge Action	Specify how the program handles valid attributes when you do a member merge. For more information, see Merging Loyalty Program Members. NOTE:  This field is optional and is not applicable to all fields.

   You can use the Transaction Attributes such as Day and Hour to set up promotions based on day of the week and the time of day. For example, you can set up a promotion to reward a member with bonus points for shopping on Wednesday between 2:00 P.M. and 5:00 P.M. in a given time zone. If you require additional attributes, then you can add them by extending the Transaction business component using Siebel Tools. For more information, see Using Siebel Tools.

7. When you are finished creating all attributes for the program, select the program form's Active check box.

Creating Point Totals Attributes

Point totals attributes represent the number of points that a member has accrued over a period of time.

For example, you would use this attribute to create a promotion saying that any member who earns one thousand points in two months gets one hundred bonus points.

To create point totals attributes

1. Navigate to the Loyalty Program Administration screen.
2. Locate the program that the attribute applies to and click its Program Id hyperlink.
3. Clear the program form's Active check box.
4. Click the Program Level Attributes view tab.
5. In the link bar, click Point Totals Attributes.
6. Add a record to the Program Level Attributes list, and complete the necessary fields. Some fields are described in the following table.

   Field	Description
   Point Type	Select the point type.
   Period UoM	Enter the number of months that the points are totaled over.

7. When you are finished creating all attributes for the program, select the program form's Active check box.

Creating Promotion Specific Attributes

Promotion specific attributes are used in only one promotion. They represent fields of the promotion bucket. The Promotion Bucket is an intersection of the Member and Promotion records, and it has additional fields that are used for attributes to store values specific to the promotion.

To create promotion specific attributes

1. Navigate to the Loyalty Promotions Administration screen.
2. In the Promotions list, find the promotion that the promotion specific attribute applies to and click the hyperlink in its Promotion Number (#) field.
3. If the promotion form's Active check box is selected, then click Modify.
4. Click the Promotion Specific Attributes view tab.
5. Add a new record to the Promotion Specific Attributes list, and complete the necessary fields. Some fields are described in the following table.

   Field	Description
   Field	Select the field that the attribute represents. For information about specifying which fields are available, see About Changing the Fields Used in Loyalty Attributes.
   Default	Enter a default value to be used when the attribute is created for a member for the first time.
   Data Type	Select the data type of the attribute. If you selected a field, then its data type is displayed automatically.
   Pick List	Select this check box if the attribute is a field whose values are entered using a picklist. Then, when you are defining criteria and actions, Siebel Loyalty displays the picklist with the values for this field.
   Pick Applet	Select this check box if the attribute is a field whose values are entered using a dialog box. Then, when you are defining criteria and actions, Siebel Loyalty displays the dialog box with the values for this field.
   Pick Field	The pick field is that field whose value the user sees in the UI after selecting from the pick applet.
   Active	Select this check box to make the attribute available for use in criteria and actions.

Displaying Promotion-Specific Attributes to Members

If you want to display a promotion's promotion-specific attributes to members on the member portal, then after creating the attribute, you must select it in the Displayed Attributes view.

The attributes appear for applicable enrolled promotions in the following view: Member Portal, My Profile (LHS top link), My Promotions, Drilldown on any enrolled promotion, list applet at bottom for promotion attributes.

If a Member has enrolled in the promotion and has at least one qualifying transaction for the promotion, then the attribute automatically appears in this view.

To display attributes to members on the member portal

1. Navigate to the Loyalty Promotions Administration screen.
2. In the Promotions list, find the promotion that the attribute applies to and click the hyperlink in its Promotion Number (#) field.
3. Click the Displayed Attributes view tab.
4. Add a new record to the Displayed Attributes list.

   The Pick Attribute dialog box appears.

5. In the dialog box, select one or more attributes that you want to display and click OK.

Creating Custom Attributes

You can create a custom attribute to be used in promotion criteria or actions.

You create the custom attribute in the Administration - Business Service screen, defining the method in Methods view and entering a script in Scripts view.

To create a custom attribute

1. Navigate to the Administration - Business Service screen, then the Methods view, and define the method.
2. Navigate to the scripts view and enter the script.

   For more information about the fields used to define the method and enter the script, see the topic about creating business services in a Siebel application in Integration Platform Technologies: Siebel Enterprise Application Integration.

Example of Custom Method for Custom Attributes

To create a custom attribute, you must create a custom method that the attribute calls. Here is an example of how you could use eScript to write a custom method named GetValuesCustomAttribute to be used by a custom attribute.

function GetValuesCustomAttribute(inputs, outputs)

{

try{

// All the field values would be in the format Object.Field.Field Name. All the
// values would be passed to custom attributes.
// Avoid Using transaction Id and querying transaction BC, as in simulation
// mode the attributes passed in transaction are passed to simulation. Always use
// the values from the Transaction.Field.Field Name.

var strOrgAirPort = inputs.GetProperty ("Transaction.Field.Origination Airport");

var strDestAirPort = inputs.GetProperty ("Transaction.Field.Destination Airport");

var customCoeff = inputs.GetProperty ("Transaction.Field.Custom Coeff Factor");

var points = 0;

if(strOrgAirPort == "SFO" &&strDestAirPort ="BOS")

points = 200 * customCoeff;

outputs.SetProperty("Field Value",points);

}

catch(e)

{

TheApplication().RaiseErrorText(e.toString());

}

finally

{

}

}