Skip to main content
This article explains how to design, create, and manage a Reward Calendar for your web store in the Publisher Dashboard. You can also create and update Reward Calendars using the Reward Calendars API service.

​
Design a Reward Calendar

Before creating a Reward Calendar, you need to design it:
  1. In the Studio section, go to Offers Design, and click Create New Offer Design.
  2. Select Reward Calendar.
  3. Complete the following sections:
    • Reward Calendar
      • Name: Enter a descriptive name for the design.
      • External ID: Enter an ID for the design.
    • Main Design
      • Header Image: Upload an optional image displayed at the top of the calendar.
      • Collectible Badge Image: Upload or select an image for the badge shown when a reward is available to collect.
      • Locked Badge Image: Upload or select an image for the badge shown when a reward is locked.
        If you provide an external image URL, Appcharge saves and uses the URL as-is. Appcharge doesn’t download, copy, upload, or host the image. If you use an external image URL, host the image on your own infrastructure and keep it available at the provided URL.We recommend uploading image files instead of using external URLs when possible. Appcharge hosts uploaded files on its CDN.
    • Sub Design
      • Background Color: Select a background color for the calendar days.
      • Day Font Color: Select a color for the day text.
      • Sub Reward Background Image: Upload an optional background image for sub rewards, which are displayed as regular calendar day tiles. If no image is uploaded, the Background Color is used.
      • Main Reward Background Image: Upload an optional background image for the main reward, which is displayed as a larger, wider featured tile. If no image is uploaded, the Background Color is used.
      • Collect Icon Image: Upload or select the icon shown on days where the rewards have been collected.
      • Locked Icon Image: Upload or select the icon shown on days where the rewards are locked.
        If you provide an external image URL, Appcharge saves and uses the URL as-is. Appcharge doesn’t download, copy, upload, or host the image. If you use an external image URL, host the image on your own infrastructure and keep it available at the provided URL.We recommend uploading image files instead of using external URLs when possible. Appcharge hosts uploaded files on its CDN.
  4. Click Save to apply changes.

​
Create a Reward Calendar

After designing a Reward Calendar, you can create the offer:
  1. In Offers, go to Reward Calendars and click Create New Reward Calendar.
  2. In the Settings tab, complete the following sections:
    • General
      • Name: Enter a name for the Reward Calendar.
      • External ID: Enter an ID for the Reward Calendar.
      • Priority: Enter a priority number. Lower numbers appear first when multiple Reward Calendars are available.
      • Offer Design: Select the design you want to use from the drop-down menu.
    • Segments -Segment Name: Enter segment names to display the offer to specific groups of players.
  3. Go to the Configuration tab. Week 1 is added by default. You must configure all days in Week 1 before adding another week. You can configure up to 10 weeks.
  4. Click Day 1 to open the modal and configure the first reward.
  5. From the drop-down list, select a product to add, and then enter the number of units included in the offer. To add another product for that day, click Add Product and repeat this step. When done, click Continue to the next day until you’ve added rewards for the first 6 days.
  6. On the 7th day, from the drop-down list, select a product to add. Then enter the number of units included in the offer, and click Add Product. To add another product for that day, repeat this step. When done, close the modal.
  7. Click + Week and repeat steps 4-6 to configure rewards for another week, or click Save to save your changes.
  8. In the Offer Behavior tab, configure the calendar rules:
    • Restart After Completion: Choose whether the calendar restarts from Week 1 after the player completes all configured weeks.
    • Missed Reward Reset: Choose what happens when a player misses a day:
      • Complete Reset: Player progress resets to Week 1, Day 1.
      • Weekly Reset: Player progress resets to Day 1 of the current week.
    • Pop-Up Trigger: Choose how the calendar popup opens:
      • Automatic: Open automatically when a reward becomes available.
      • On Click: Open only when the player clicks the Reward Calendar badge.
    • Reward Collection: Choose how players collect daily rewards:
      • Forced Collection: When the Reward Calendar popup is displayed, the player must click the Collect button to collect the daily reward. The popup closes automatically after collection.
      • Manual Collection: When the Reward Calendar popup is displayed, the player can collect the daily reward using the Collect button, or close the popup. The player can then click the corresponding Reward Calendar badge to collect the reward at another time that day.
  9. Click Save in the top-right corner to save your changes.

​
Edit a Reward Calendar

To edit an existing Reward Calendar:
  1. Go to the Reward Calendars section.
  2. Click the ellipsis next to the Reward Calendar you want to edit, and then click Edit.
  3. Modify the Reward Calendar as needed.
  4. Click Save to apply the changes.

​
Duplicate a Reward Calendar

To duplicate a Reward Calendar:
  1. Go to the Reward Calendars section.
  2. Click the ellipsis next to the Reward Calendar you want to duplicate, and then click Duplicate.
  3. Modify the duplicated Reward Calendar as needed.
  4. Click Save to create the new Reward Calendar.

​
Deactivate a Reward Calendar

To deactivate a Reward Calendar:
  1. Go to the Reward Calendars section to view your existing Reward Calendars.
  2. Click the ellipsis next to the Reward Calendar you want to deactivate, and then click Deactivate.
  3. The Reward Calendar is now marked as Inactive and hidden from the web store.

​
Activate a Reward Calendar

A new Reward Calendar is active by default. You can also activate a previously deactivated one:
  1. Go to the Reward Calendars section to view your existing Reward Calendars.
  2. Click the ellipsis next to the Reward Calendar you want to activate, and then click Activate.
  3. The Reward Calendar now appears in the web store.

​
Delete a Reward Calendar

To delete a Reward Calendar:
  1. Go to the Reward Calendars section.
  2. Click the ellipsis next to the Reward Calendar you want to delete, and then click Delete.
  3. The Reward Calendar is permanently removed from the web store.