Create and Manage a Rolling Offer

This article explains how to design, create, and manage a Rolling Offer for your web store in the Publisher Dashboard. Alternatively, you can create and update a Rolling Offer using the Rolling Offer API. To create or update a Rolling Offer design, use the Rolling Offer Design API.

When adding images, 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.

​

Design a Rolling Offer

Before creating a Rolling Offer, you need to design it:

1. In the Studio section go to > Offer Designs and click Add New Design.

2. In the Type field, select Rolling Offer from the drop-down menu. The form will update to display all fields relevant to a Rolling Offer.

3. Complete the following sections:

   • Offer Settings
     • Name: Enter a descriptive name for the offer.
     • External ID: Enter an ID for the offer.
     • Free Offer Text: Enter the text displayed on free sub offers. The default is FREE.
   • Main Offer Design
     • Enable Scroll: Select this checkbox to enable scrolling through sub offers. Scroll arrows appear only in the horizontal Rolling Offer layout on desktop. In the vertical layout on mobile, players scroll or swipe without arrows. When you unselect it, scrolling is off and Scroll Arrow Image is disabled.
     • Background Color: Select Solid for a single color, or Linear for a two-color gradient and a direction (to bottom, to top, to right, to left, to bottom right, to top left, to bottom left, or to top right). Set colors with the picker, eyedropper, or HEX, RGB, or HSL values.
     • Background Opacity: Enter a transparency level for the background color.
     • Border Color: Select a color for the border around sub offer tiles.
     • Offer Border Width: Enter the width of the border.
     • Default Arrows Color: Choose the color used for the arrows between sub offers when a custom arrow image isn’t provided.
     • Offer Header Image: Upload a header image in PNG or JPEG format, up to 2 MB. Files that exceed 2 MB or use an unsupported format are rejected with Image must be PNG or JPEG and under 2MB.
     • Arrows Image: Upload a custom image to replace the default arrow between sub offers. We recommend a 1:1 ratio image that’s 24px by 24px. If you don’t upload an image, Appcharge uses the Default Arrows Color.
     • Scroll Arrow Image: Desktop only. Upload a custom square image with a right-pointing arrow for the desktop scroll controls. Appcharge mirrors the image for the opposite direction. If you don’t upload an image, Appcharge uses default scroll arrow icons. Mobile scrolling does not use scroll arrows. Only applies when Enable Scroll is selected.
     • Offer Background Image (Vertical): Upload or select a background image for the vertical Rolling Offer layout as displayed in mobile view. Use PNG or JPEG, up to 2 MB. Files that exceed 2 MB or use an unsupported format are rejected with Image must be PNG or JPEG and under 2MB.
     • Offer Background Image (Horizontal): Upload or select a background image for the horizontal Rolling Offer layout as displayed in desktop view. Use PNG or JPEG, up to 2 MB. Files that exceed 2 MB or use an unsupported format are rejected with Image must be PNG or JPEG and under 2MB.
   • Sub Offer Design
     • Offers Background Color: Select a background color.
     • Offers Background Image: Upload a background image.
     • Lock Image: Upload an image shown on locked sub offers.

4. Click Save to apply changes.

​

Create a Rolling Offer

After designing a Rolling Offer, you can now create the offer:

1. Go to the Rolling section and click Add New Rolling Offer.

2. In the Settings tab, provide the required details, including the Rolling Offer priority with lower numbers indicating higher priority.

   • If you have multiple Rolling Offers, only the one with the highest priority will be shown in the web store. Rolling offers with the same priority number will be sorted by created date in ascending order, meaning the earliest created offer will appear first.
   • Once a player completes a Rolling Offer by purchasing all sub offers, the next Rolling Offer from the sorted list is displayed.

3. In the Configuration tab, you can add up to 50 sub offers to your rolling offer. You must have a minimum of 2. To add more sub offers, click Add Offer. You can also duplicate or delete a sub offer by clicking the ellipsis in the offer’s modal, and then Duplicate.

4. Set the price for each sub offer. The default is free ($0). To set a price, uncheck the Set as Free box and enter a price.

5. • Bar ID: ID of the Progress Bar this offer to contributes to.
   • Bar Points: Number of points awarded toward the Progress Bar.

6. You can apply the following discounts:

   • Main Product Sale: If a sub offer contains only 1 product, you can offer more quantity at the same price.
   • Price Discount: Apply a discount on the total price of the sub offer.

7. Add 1-3 products per sub offer.

8. After creating your sub offers, go to the Schedule tab to set the start and end times of the Rolling Offer, and then click Add Appearance. You must have at least 1 appearance. Click the ellipsis next to an appearance to edit or delete.

9. Click Save to complete the Rolling Offer creation process.

​

Edit a Rolling Offer

To edit an existing Rolling Offer:

1. Go to the Rolling section. You’ll see a list of all your existing Rolling Offers.
2. Click the ellipsis of the offer you want to edit, and then click Edit.
3. Modify the Rolling Offer as desired.
4. Click Save to apply changes.

​

Duplicate a Rolling Offer

To duplicate a Rolling Offer:

1. Go to the Rolling section. You’ll see a list of all your existing Rolling Offers.
2. Click the ellipsis of the offer you want to duplicate, and then click Duplicate.
3. Modify the Rolling Offer as desired.
4. Click Save to apply changes.

​

Delete a Rolling Offer

To delete a Rolling Offer:

1. Go to the Rolling section. You’ll see a list of all your existing Rolling Offers.
2. Click the ellipsis of the offer you want to delete, and then click Delete.