Once you have created Promotion Upsells for a promotion by deciding when they should display to users and the products associated with them, you need to create a trigger action that signals Oracle ATG Web Commerce to check whether a Promotion Upsell is appropriate for a user.
There are two ways of doing this. Instruct a page developer to use the ClosenessQualiferDroplet servlet bean on a page to check to see if any of the Promotion Upsells are applicable to the active user and to display the media item on that page. For example, if this servlet bean were used in a checkout page, when applicable Promotion Upsells are detected, you can display a media item beside a list of products in the shopping cart and their totals. For instructions on using the ClosenessQualiferDroplet servlet bean, see Appendix A, Oracle ATG Web Commerce Servlet Beans.
Another way to detect when a user deserves Promotion Upsell is to use scenarios. You can create a scenario that determines when a user qualifies for a Promotion Upsell and then performs some other action, such as adding an item to a slot or sending an e-mail. You can also use a scenario to determine when a user no longer qualifies for a Promotion Upsell and react accordingly (for example, remove an item from a slot). Here are scenario elements that you should know about:
The Promotion Closeness Qualification event determines when a user obtains a Promotion Upsell. You can use this event to listen for any Promotion Upsell or for a Promotion Upsell with a certain
repositoryId. See Promotion Closeness Qualification for more information.The Promotion Closeness Disqualification event is activated when a user no longer qualifies for a Promotion Upsell. You can focus this event to monitor all Promotion Upsells or a Promotion Upsell with a certain
repositoryId. See Promotion Closeness Disqualification for more information.The Add Item to Slot action allows you to add Promotion Upsells using
PromotionUpsellTargeterto a slot. Only Promotion Upsells that are relevant for the specified event are added here.The Add Item to Slot action allows you to add products that are part of an Upsell Action to a product slot using
PromotionUpsellProductTargeter. Only Upsell Actions that are relevant for the specified event’s Promotion Upsells are added here.
The sections below describe sample scenarios that provide upsell incentives.
