Create offer chain

How it works

Overview

An offer chain is a sequence of steps, each containing an item. Users receive this item for free or purchase it as part of an active offer, progressing through the chain step by step. The next step unlocks only after completing all the previous ones.

An offer chain can include exclusive items available only within the chain, as well as items at discounted prices compared to store prices. This encourages users to return to the game and complete the chain before it expires. Use this marketing tool to retain users and increase engagement.

The following items can be offered at chain steps:

• virtual currency packages
• virtual items
• bundles

Limitations:

• The following item settings are ignored in offer chains:
  • personalization rules
  • purchase limits
  • scheduled availability (start/end date)
  • promotions and discounts
• A maximum number of steps in one offer chain — 30.
• One step can contain only one item.
• Price of the paid offer chain step equals the price of the item on this step.

User flow

1. The user goes to the store.
2. The user sees an available offer chain and the offered items for each step.
3. The user logs in.
4. The user sees their current progress in the chain.
5. The user completes the current step:
   • If the step is free, the user claims the item.
   • If the step is paid, the user makes a payment. The item is granted to the user the same way as when purchasing it.
6. The user proceeds to the next step in the chain.

Offer chain visibility and behavior

The logic of the offer chain work is the following:

• The offer chain availability depends on the visibility and personalization settings configured for a particular chain.
• If the user has already claimed or purchased items within a chain, their current progress is displayed including completed steps and the next available one.
• If the user completes all steps, the chain is shown as completed.
• If the chain is renewable, the user’s progress is reset on schedule.

Refunded items

If a purchased item is refunded, the user’s progress in the offer chain changes. The step where the user received the refunded item is considered incomplete. To proceed further through the chain, the user has to purchase this item again. Free items claimed before the refund aren’t affected.

Example:

The user claimed and purchased items at steps 1, 2, and 3, then requested a refund for the item at step 2. Steps 1 and 3 remain completed, but step 4 is locked until the user completes step 2 again.

Set up offer chain

To create an offer chain:

1. Open your project in Publisher Account and go to the LiveOps > Canvas section.

2. Proceed to create an offer chain in one of the following ways:

   • In the toolbar, click the + icon and select Offer chain.
   • In the offer chains list area, click the + icon.
   • Open the context menu anywhere on the canvas and select Offer chain.

3. Specify:
   • Chain title.
   • Chain description (optional).
4. Click Next.
5. Add an offer for each step of the chain. To add an item for a single step:
   1. Click Add step.
   2. Select an item.
   3. If you specified a price when creating the item but want to offer it for free, turn on the Give this item for free at this step toggle. For items created as free, this toggle is automatically turned on.
   4. Click Add step.

6. To change the order of offers in the chain, drag the row to the desired position using the ☰ icon (optional).
7. After you have added offers for each step, click Next.
8. Specify the validity period of the offer chain: a time zone, start date, and end date. If you don’t want to indicate the end of the validity period, turn on the No end date toggle.
9. If you want the offer chain to renew at a specific time, turn on the Make offer chain renewable toggle and specify the update schedule.
10. If you want to personalize the offer chain:
    1. Turn on the Personalized offer chain toggle.
    2. Select one of the chain display options:
       • Display to eligible users — in this case, the chain is displayed only to authorized users who meet the specified conditions.
       • Display to ineligible users — for such a chain, you don’t need to specify the personalization conditions — it is applied by default. It means it is displayed to unauthorized users, as well as in cases when no matching personalized offer chain is found for the authorized user.
    3. If you select Display to eligible users option, specify the condition:
       1. Specify the user attribute type — string, number, or date.
       2. Select the user attribute from the drop-down list.
       3. Select the comparison operator.
       4. Specify the user attribute value.
    4. To add more conditions, click Add condition and fill in the displayed fields (optional).

11. Click Next.
12. Check the chain.
13. To activate the chain immediately (optional), turn on the Create in Active status toggle.
14. Click Create.
15. To add the created active offer chain to the site (optional):
    1. Open the site in the builder by clicking Open or Open in Site Builder on the banner in the editing form.
    2. Follow the instructions from the Display on website created with Xsolla section.

Note

Active chains can’t be edited. To change an offer chain’s settings, first deactivate it.

You can activate or deactivate the chain in the following ways:

• from the offer chain card
• from the offer chain list
• while editing the chain

Display offer chain in store

Display on website created with Xsolla

To display an offer chain on your site:

1. Go to the builder for the site where you want to add the offer chain in one of the following ways:

   • From the offer chain editing form in canvas — click Open or Open in Site Builder on the banner.

1. • From any page of Publisher Account:
     1. Go to the Storefronts > Websites section.
     2. Select your site and click Open Site Builder.

2. If your site includes multiple pages, select the one you need:
   1. Click the current page title at the top of the builder.
   2. Select the necessary page from the drop-down list.
3. In the main area of the builder, choose a place where you want to add a new block and click Add block.
4. Select the Offer chain block.

5. In the side menu, go to the block settings.
6. From the drop-down list, select an active offer chain.

7. Customize the block appearance (optional):

1. Configure the chain appearance.
2. Configure the steps' appearance.

8. To check the chain, click Preview in the upper-right corner of the builder.

9. To apply changes, publish the website:

   1. In the upper-right corner of the site builder, click Publish.
   2. Check the boxes next to the pages you want to publish.
   3. Click Publish.

Display in your own UI

1. In your application UI, implement the elements to display offer chain steps.
2. Implement the logic to work with chains using the following client-side API calls from the Offer chains group:

3. Ensure that items are correctly granted to the user.