Offer chain
Offer chains let you create a sequence of steps, each offering an item that can be either claimed for free or purchased. Users move through the chain step by step, unlocking the next offer only after completing the current one.
Use offer chains to drive repeat engagement and retention. They encourage users to return to the game and complete the chain before it expires.
Glossary
Offer
Offer chain
Partly available
How it works
Offer chain visibility and behavior
- Unauthenticated users can see all offer chains available in the store.
- Once logged in, users only see offer chains available to them based on display conditions.
- If the user has already claimed or purchased items within a chain, their current progress is displayed — including completed steps and the next available action.
- If the chain is configured to reset (weekly/monthly), the user’s progress is reset on schedule. After that, the user starts again from the first step.
- If the user completes all steps, the chain is shown as completed.
Step logic and pricing
Each step in the offer chain is associated with a specific SKU. The price of the step is automatically inherited from the assigned item:
- If the item is free, the step is also considered free.
- If the item has a price, the step is paid, and the item must be purchased to move forward in the offer chain.
SKU visibility and behavior
- If a SKU is only available through the offer chain, set its status to Partly available in the item settings in Publisher Account to hide it from the general catalog.
- If a SKU is available for direct purchase, users can buy it separately. However, direct purchases do not affect their progress in the offer chain.
Ignored SKU properties
The offer chain does not consider the following item’s configurations:
- personalization rules
- purchase limits
- scheduled availability (start/end date)
- promotions and discounts
Offer chain limitations
- A maximum of 30 steps per offer chain is allowed.
- Each step must contain only one item.
Refunds
If a purchased item is refunded, the user’s progress in the offer chain is reduced. The associated step is marked as incomplete, and the user cannot proceed further until they claim the item again by purchasing it once more.
Example:
The user completed steps 1, 2, and 3, then requested a refund for the item on step 2. Steps 1 and 3 remain completed, but step 4 is locked until the user completes step 2 again.
User flow
- The user goes to the store.
- The user sees the available offer chain and the rewards for each step.
- The user logs in.
- Their current progress in the offer chain is displayed.
- The user completes the current step:
- If the step is free: the user clicks Claim reward.
- If the step is paid: the user completes a purchase and receives the item.
- The user advances to the next step in the offer chain.
How to get it
To set up the offer chain feature in your project, you will need the following details:
Description | Example | Limitations |
---|---|---|
Name | Welcome Offer Chain | Character limit — 35 |
Explanatory text | Unlock new exclusive offers with every step you complete. | Character limit — 175 |
Period | 01.07.2023 — 15.07.2023 | Optional |
Description | Example | Limitations |
---|---|---|
Step content (SKU) | sword_1 | Must match item SKUs in your catalog. |
- steps and their status
- offer chain duration
- user progress
- unlocked offers with action buttons
Set up via Publisher Account
Create offer chain
- In your project in Publisher Account, go to the LiveOps > Offer chains section.
- Click Create offer chain.
- Specify the following parameters:
- Offer chain name.
- Description (optional).
- Click Next.
- To configure offer chain steps, click Add step.
- Specify the SKU the user can get at this step:
- Select the existing SKU from the drop-down list.
- Create a new item: virtual currency, virtual items, game keys, bundles.
- If the user can get this item for free, set the Offer free reward toggle to On.
- Click Save.
- Click Add step and repeat 5-8 to add more steps.
- Click Next when finished.
- Specify the following parameters in Time zone settings:
- Time zone
- Start date
- Start time
- End date (optional)
- End time (optional)
- If you want to make the offer chain recurring, set the Make offer chain renewable toggle to On and specify the following parameters:
- Renewal period
- Renewal day
- Renewal time (optional)
- Click Create. The offer chain is created with status Inactive.
- To activate it, click ⋯ next to the offer chain.
- Click Publish action, offer chain status will change to Active.
Edit offer chain
To edit the offer chain chain:- In your project in Publisher Account, go to the LiveOps > Offer chains section.
- Click ⋯ next to the chain.
- Click Edit and make the changes you need.
- Click Next.
- To add steps in the offer chain, click Add step.
- Specify the SKU the user can get at this step:
- Select the existing SKU from the drop-down list.
- Create a new item: virtual currency, virtual items, game keys, bundles.
- Specify the SKU the user can get at this step:
- If the user can get this item for free, set the Offer free reward toggle to On.
- Click Save.
- To edit an existing step, click the pencil icon and make the changes you need.
- To delete a step, click Delete.
- Click Next when finished.
- Make changes in Time zone settings if needed.
- Check the Make offer chain renewable toggle and the following parameters.
- Click Save.
Delete offer chain
To delete the offer chain:- In your project in Publisher Account, go to the LiveOps > Offer chains section.
- Choose the desired offer chain from the list and click ⋯ next to it.
- Click Delete.
Set up via API calls
You can use methods from the Admin subsection of the Offer chains method group to manage the offer chains.
- Create an offer chain using the Create offer chain API calls.
- Get a specific offer chain using the Get offer chain API calls.
- Get list of offer chains using the Get list of offer chains API calls.
You can use methods from the Client subsection of the Offer chains method group to manage the offer chains.
- List available offer chains via the Get current user’s offer chains API calls.
- Check user progress using the Get current user’s offer chain by ID API calls.
- Claim a free reward using the Claim offer chain step API calls.
- Purchase a paid reward with the Create order for paid offer chain step API calls.
You can also modify, disable, or delete the offer chains.
Found a typo or other text error? Select the text and press Ctrl+Enter.