How it works
This section explains how Progress Bars are configured at a high level, how players earn points from offers, and how missions progress and complete in the web store.Configure a Progress Bar
Design and create a Progress Bar in the Publisher Dashboard, or via the Progress Bar API. During configuration, define one or more missions, which players complete in sequence. For each mission, specify:- The number of points required to complete it.
- The reward granted upon completion.
Assign Progress Bar points to offers
Using the Publisher Dashboard or the Offers V2 API, choose which offers contribute points toward the Progress Bar and how many points each offer grants. In the web store, contributing offers display a Points Ribbon showing how many points players earn when collected or purchased. Popup and Checkout Link offers don’t contribute points toward the Progress Bar.
Progress Bar behavior in the web store
This section explains how progress is tracked, displayed, and completed in the web store.Mission progress and completion
The Progress Bar displays progress toward a single mission at a time. As players earn points, the Progress Bar fills to reflect their advancement. When the bar is filled and the required number of points is reached, the mission is completed, the player receives their reward, and a free order is created. If additional missions are available, the Progress Bar automatically transitions to the next mission. The bar visually clears and begins filling again to represent progress toward the new mission’s point requirement. This reset is visual only and does not remove any earned points. The next mission is revealed with an animation, while Points Ribbons remain visible on contributing offers. If there are no remaining missions, the Progress Bar and Points Ribbons are removed from the web store. If you’re using the Web Store Personalization API service, you can customize each mission’s reward by specifying the product and quantity players receive upon completion.
Rollover points
Any extra points earned beyond the requirement of the mission the player just completed roll over to the next mission. This ensures that no progress is lost and creates a smooth and continuous experience where completing one mission naturally leads into the next. If there are no more available missions, the Progress Bar is considered complete. If you later add a new mission, any remaining rollover points are automatically applied toward it.If a Progress Bar is deleted from the Publisher Dashboard, or if a scheduled Progress Bar ends, both the Points Ribbons and any accumulated rollover progress are permanently lost.
Progress Bar lifecycle and updates
This section covers changes you can make to a Progress Bar after it has been created, including how inactivity, scheduling, and mission updates affect player progress.Set a Progress Bar to inactive
If you set a Progress Bar to inactive, it is removed from the web store but player points are preserved. If the Progress Bar is later reactivated, players will see the Progress Bar along with their existing progress in the web store.Schedule a Progress Bar
You can schedule a Progress Bar to appear during specific time periods. When scheduled, a countdown timer is displayed, creating a sense of urgency for players. Once the scheduled time ends, the Progress Bar is removed from the web store. At that point, both the Points Ribbons and any accumulated rollover player progress are permanently lost.Update mission point requirements
Appcharge always tracks the total number of points a player has earned. When you change a mission’s required points, Appcharge recalculates the player’s progress using the same total points and applies those points to missions in order. Points are consumed as each mission requirement is met, and only the remaining points move on to the next mission. Rewards aren’t granted retroactively for missions the player didn’t complete under the original configuration. Recalculation stops when the player reaches a mission where their remaining points are less than the mission’s required points.This recalculation also occurs if the Progress Bar is inactive at the time of the update. In that case, players see the updated progress the next time the Progress Bar becomes active in the web store.
Mission 2 (20 points): Player has 15 out of 20 points and didn’t complete the mission.
Mission 3 (30 points): Player hasn’t yet reached this mission. If you update the mission sizes to 10, 10, and 10 points, Appcharge redistributes the same 25 points in order: Mission 1: Marked as complete with no additional reward.
Mission 2: Marked as complete due to recalculation only, no reward is granted. Remaining points after Missions 1 and 2: 25 − 10 − 10 = 5
Mission 3: Player has 5 out of 10 points. Final result: The player is now in Mission 3 with 5 out of 10 points of progress toward completion.
Key features
- Clear reward structure: Drives long-term engagement and reinforces a sense of achievement with visible progress and clearly defined rewards.
Monitor Progress Bars
You can track Progress Bars by:- Viewing all Progress Bars in the Progress Bar section of the Publisher Dashboard, where you can filter by external ID and status.
- Setting up webhook events for real-time updates on player activity, offer interactions, and orders.