Siebel Loyalty Administration Guide > Setting Up Siebel Loyalty Promotions > Transient Variables >

Examples of Using Transient Variables


This topic provides the following examples of how to use transient variables in the context of a promotion design:

Example of Using Transient Variables with Actions of Type Track and Assign Points

This topic gives one example of how actions of type Track and Assign Points might be used with transient variables. You might use Siebel Loyalty differently, depending on your business model.

An airline rewards program awards its Gold members 25% bonus points on the distance travelled. To encourage members to book tickets online, it awards an additional 10% bonus on the total rewards earned if the channel of booking is Web.

The administrator creates a promotion design that will take all of these promotions into account as accrual promotions, where the value assigned to the given point type is stored in the transient variable and then carried forward to the next promotion for evaluation.

From left to right, she includes the following promotion design objects: Start, Base Promotion, P0: Admin Promotion, P1: 25% Bonus for Gold Members, P2: 10% Bonus on total points earned if Channel of Booking is 'Web', End. This promotion design is shown in Figure 2.

Figure 2. Promotion Design for Scenario 1.

These promotions use the Track and Assign Points action with Transient as its object, so the value accumulates in the transient variable. Each promotion adds the new bonus that it calculates to the bonus that is already stored in the transient variable. The final promotion uses the Assign Points action, so it assigns the customer the entire bonus that accumulated value in the transient variable.

Using the P0: Admin Promotion as the base promotion, the administrator can calculate the distance travelled. In this admin promotion she uses a Track and Assign points action. This action internally updates the transient variable associated with the point type. While defining P0: Admin Promotion, she creates an action and assigns values to the fields as defined in Table 18.

Table 18. P0: Admin Promotion Action
Field
Value

Sequence Number (#)

1

Name

Track and Assign points

Type

Track and Assign Points

Expression

[Transaction.Filed.Points]

Point Type

Regular

Object

Transaction

Attribute

Transaction Point

In the promotion P1: 25% Bonus for Gold Members, a criterion is defined to verify the member tier. The action updates the transient variable to reward members 25% bonus points on miles travelled. Because the subsequent promotion requires the total points earned, use the Track and Assign points action for this promotion. The action for this promotion has the field values shown in Table 19.

Table 19. P1: 25% Bonus for Gold Members Action
Field
Value

Sequence Number (#)

1

Name

Track and Assign

Type

Track and Assign Points

Point Type

Regular

Object

Transient

Attribute

Regular Point TV

Operator

Multiply

Value

.25

In the promotion P2: 10% Bonus on total points earned if channel of booking is Web, a criterion is defined to check the ticket class. The action assigns points to reward members 10% bonus points on the total points earned so far in the promotion design. If the channel of booking is Web, then the promotion executes the action with the field values shown in Table 20.

Table 20. P2: 10% Bonus on total points earned if channel of booking is 'Web' Action
Field
Value

Sequence Number (#)

1

Name

Assign Points

Type

Assign Points

Point Type

Regular

Object

Transient

Attribute

Regular Point TV

Operator

Multiply

Value

.1

Table 21 explains how points are assigned in this scenario based on 2000 base points.

Table 21. Points Awarded with Actions of Type Track and Assign Points
Promotion
Action
Rewards
Value of Transient Variable
Explanation

Base Promotion

Calculate Base Price

Not applicable

Not applicable

  • Base points earned is 2000
  • Point Type is Regular

P0: Admin Promotion

Track & Assign Points

2000

2000

The Track & Assign points action assigns a value to the transient variable defined by the point type used in the Base and Admin promotions. In this case it is defined as type Regular.

For more details about the action refer to Table 18.

P1: 25% Bonus for Gold Members

Track & Assign Points

Transient variable is multiplied by 0.25

2000 times 0.25 equals 500

 

2000 plus 500 equals 2500

In this promotion the transient variable is multiplied by 0.25. The action then updates the transient variable with the resulting value 2500.

For more details about the action, refer to Table 19.

P2: 10% Bonus on total points earned if Channel of booking is Web

Track & Assign Points

Transient variable is multiplied by 0.1

2500 times 0.1 equals 250

 

2500 plus 250 equals 2750

In this promotion the transient variable is multiplied by 0.1. The Assign Points action can be used here, because there are no subsequent promotions in the promotion design. This action assigns all the points that have accumulated in the transient variable to the customer.

For more details about the action, refer to Table 20.

Example of Using Transient Variables with Action of Type Assign Points

This topic gives one example of how actions of type Assign Points might be used with transient variables. You might use Siebel Loyalty differently, depending on your business model.

An airline rewards program awards its gold members 25% bonus points on distance travelled and 10% bonus points on distance travelled if the channel of booking is Web.

The administrator sets up a promotion design that takes all of these promotions into account using accrual promotions with actions of type Assign Points. This type of action is used because the value of the reward is not required by subsequent promotions in the promotion design. In this case, the administrator is explicitly required to select Transient Variable as the object for the action.

From left to right, the administrator includes the following promotion design objects: Start, Base Promotion, P0: Admin Promotion, P1: 25% Bonus for Gold Members, P2: 10% Bonus if Channel of Booking is 'Web', End. The promotion design is shown in Figure 3.

Figure 3. Promotion Design for Scenario 2.

These promotions are similar to the promotions used in the previous scenario, except that they use the Assign Points action so the points assigned by each promotion are based only on the original value of the transaction points, not on the subsequent bonus added by each promotion.

Using the Base Promotion, the administrator can calculate the distance travelled. In the P0: Admin Promotion she uses the Track and Assign points action. This action internally updates the transient variable associated with the point type. The P0: Admin Promotion includes an action with the field values shown in Table 22.

Table 22. P0: Admin Promotion Action
Field
Value

Sequence Number (#)

1

Name

Track and Assign points

Type

Track and Assign Points

Expression

[Transaction.Filed.Points]

Point Type

Regular

Object

Transaction

Attribute

Transaction Point

In the promotion P1: 25% Bonus for Gold Members, the administrator sets up the criteria to verify the member tier and creates an action of type Assign Points in order to reward members 25% bonus points on miles travelled.

NOTE:  Because the subsequent promotion requires the distance travelled the administrator uses an action of type Assign Points. Do not use an action of type Track and Assign Points with this promotion. Doing so would erroneously update the transient variable with total points earned.

Keeping these factors in mind, while defining P1: 25% Bonus for Gold Members promotion, she creates an action with the field values shown in Table 23.

Table 23. P1: 25% Bonus for Gold Members Action
Field
Value

Sequence Number (#)

1

Name

Assign points

Type

Assign Points

Point Type

Regular

Object

Transient

Attribute

Regular Point TV

Operator

Multiply

Value

.25

In the promotion P2: 10% Bonus if Channel of Booking is Web, the administrator sets up the criteria to verify the ticket class and uses an action of type Assign Points in order to reward member 10% bonus points on miles travelled. The action, which is applied only if the ticket is booked on the Web, has the field values shown in Table 24.

Table 24. P2: 10% Bonus if Channel of Booking is Web Action
Field
Value

Sequence Number (#)

1

Name

Assign Points

Type

Assign Points

Point Type

Regular

Object

Transient

Attribute

Regular Point TV

Operator

Multiply

Value

.1

Table 25 displays points how points are assigned in this example based on 2000 base points. Additional information about the tracking and assigning of points appears in the Explanation column.

Table 25. Points Awarded with an Actions of Type Assign Points
Promotion
Action
Rewards
Value of Transient Variable
Explanation

Base Promotion

Calculate Base Price

Not applicable

Not applicable

  • Base points earned is 2000
  • Point Type is Regular

P0: Admin Promotion

Track & Assign Points

2000

2000

The Track & Assign points action assigns a value to the transient variable defined by the point type used in Base and Admin promotions. In this case it is defined as type Regular.

For more details about the action refer to Table 22.

P1: 25% Bonus for Gold Members

Assign Points

Transient variable is multiplied by 0.25

2000 times 0.25 equals 500

2000

In this promotion the transient variable is multiplied by 0.25. The Assign Points action assigns 500 points to the member but does not update the variable.

For more details about the action, refer to Table 23.

P2: 10% Bonus if Channel of booking is 'Web'

Assign Points

Transient variable is multiplied by 0.1

2000 times 0.1 equals 200

2000

In this promotion the transient variable is multiplied by 0.1. The Assign Points action assigns 200 points to the member but does not update the variable.

For more details about the action, refer to Table 24.

Example of Using Transient Variables with Actions of Type Discount Points and Discount Points plus (+) Pay

This topic gives one example of how actions of type Discount Points and Discount Points plus (+) Pay might be used with transient variables. You might use Siebel Loyalty differently, depending on your business model.

An airline rewards program has a promotion offering its gold members a 15% discount on the redemption price for flights from SFO to BOS.

The administrator sets up a promotion design that redeems the appropriate number of points from the member. From left to right, she includes the following objects in the redemption promotion design: Start, Base Promotion, 15% Discount for Gold Members, End. The resulting promotion design appears in Figure 4.

Figure 4. Promotion Design for Scenario 3.

The Base Promotion, offers one of the following base redemption price options to members:

  • Redeem 1000 points
  • Redeem 700 points and pay $100

The output of the base redemption promotion is assigned to a transient variable associated with the appropriate point type, depending on the chosen option.

In the Base Promotion, the administrator creates two actions: the Redeem Points Action and the Redeem Points plus (+) Pay Action. Table 26 shows the field values used for the Redeem Points Action.

Table 26. Base Promotion: Redeem Points Action
Field
Value

Sequence Number (#)

1

Name

Redeem points

Type

Redeem Points

Expression

1000

Point Type

Regular

Value

1000

Table 27 shows the field values used for the Redeem Points plus (+) Pay Action.

Table 27. Base Promotion: Redeem Points plus (+) Pay Action
Field
Value

Sequence Number (#)

2

Name

Redeem points plus Pay USD

Type

Redeem Points plus (+) Pay

Expression

700

Point Type

Regular

Value

700

Amount

100

Currency

USD

The 15% Discount for Gold Members promotion in the promotion design uses actions of both the Discount Points and Discount Points plus (+) Pay type to award discounts to the members on redemption.

In the 15% Discount for Gold Members promotion, the administrator creates two actions: the Discount Points Action and the Discount Points plus (+) Pay Action. Table 28 shows the field values used for the Discount Points Action.

Table 28. 15% Discount for Gold Members Promotion: Discount Points Action
Field
Value

Sequence Number (#)

1

Name

Discount points

Type

Discount Points

Expression

[Transient.Field.Point 1 Value] * 0.15

Point Type

Regular

Object

Transient

Attribute

Regular

Operator

Multiply

Value

.15

Table 29 shows the field values used for the Discount Points plus (+) Pay Action.

Table 29. 15% Discount for Gold Members Promotion: Discount Points plus (+) Pay Action
Field
Value

Sequence Number (#)

2

Name

Discount points plus USD

Type

Discount Points plus (+) Pay

Expression

[Transient.Field.Point 1 Value] * 0.85

Point Type

Regular

Object

Transient

Attribute

Regular

Operator

Multiply

Value

.15

Currency

USD

Operator

Multiply

Value

.85

Table 30 displays how points are redeemed based on the promotion design with the actions in this example.

Table 30. Points Awarded with an Actions of Type Assign Points
Promotion
Action
Redemption Price
Value of Transient Variable
Explanation

Base Promotion

Redeem Points

1000 points

1000

The action assigns 1000 as the value of the transient variable.

For more details about the action, refer to Table 26.

Base Promotion

Redeem Points plus (+) Pay

700 points

$100 USD

700

The action assigns 700 as the value of the transient variable. The dollar value is tracked internally by the application.

For more details about the action, refer to Table 27.

15% Discount for Gold Members Promotion

Discount Points

1000 minus (1000 times 0.15) equals 850 points

850

This action awards a discount of 15% on the points redeemed, and assigns 850 as the value of the transient variable.

For more details about the action, refer to Table 28.

15% Discount for Gold Members Promotion

Discount Points plus (+) Pay

700 minus (700 times 0.15) equals 595 points

100 times 0.85 equals $85 USD

595

This action awards a discount of 15% on the points redeemed and assigns 595 as the value of the transient variable. The dollar value is tracked internally by the application.

For more details about the action, refer to Table 29.

Siebel Loyalty Administration Guide Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices.