Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.appcharge.com/llms.txt

Use this file to discover all available pages before exploring further.

This article explains how to design, create, and manage a Triggered Popup offer in the Publisher Dashboard. Alternatively, you can create and update a Triggered Popup using the Triggered Popups API service.

​
Design a Triggered Popup

Before creating a Triggered Popup, you need to design it:
  1. In the Studio section go to Offers Design, and click Create New Offer Design.
  2. Select Triggered Popup.
  3. Complete the following sections:
    • Triggered Popup
      • Name: Enter a name for the offer design so you can easily identify it when creating an offer.
      • External ID: Enter an ID for the design.
    • Triggered Popup Design
      • Background Color: Select a solid color or choose Linear to apply a gradient.
      • Background Image: Upload or select a background image.
      • Badge Cover Image: Add an image for the badge.
      This field is relevant only for Store Refresh Popups. Configure this if you want to display a badge that players can click to view the current available Store Refresh Popup offer.
    • Title
      • Title Name: Enter a title for the offer.
      • Color: Select a color for the text.
      • Size: Enter a number for the text size.
      • Weight: Select a weight for the text.
  4. Click Save to finalize the design.

​
Create a Triggered Popup

After designing the Triggered Popup, you can create the offer itself:
  1. In the Offers section go to Triggered Popups and click Create New Triggered Popup.
  2. In the Settings tab, complete the following sections:
    • General
      • Name: Enter a name for the Triggered Popup offer. This name appears in the checkout unless you provide an alternative in the Display Name field.
      • Display Name: Enter a name for the Triggered Popup offer to display in the checkout. This value overrides the one in the Name field.
      If left blank, the value from the Name field is displayed in the checkout.
      • Description: Provide a description for the Triggered Popup.
      • External ID: Enter an ID for the Triggered Popup.
      • Offer Design: Select the design you want to use from the drop-down menu.
      • Price: Enter a price for the Triggered Popup.
      • Priority: Enter a priority number. Lower numbers appear first when multiple Triggered Popups of the same type and configuration are available.
      • Set As Free: Check if you want the Triggered Popup to be free.
  3. Go to the Configuration tab, and complete the following sections:
    • Triggers
      • Action: From the drop-down menu, select the action that triggers your popup:
        • Purchase Completed: Select this to create a Post Purchase Popup.
        • Store Refresh: Select this to create a Store Refresh Popup.
      The form updates to display all fields relevant to the selected action.
      • Frequency: Enter a number representing how many times the trigger action must occur before the popup is displayed. For Post Purchase Popups, this is the number of matching purchases required. For example, 3 means the popup appears after 3 matching purchases. For Store Refresh Popups, this is the number of store refreshes required. For example, 3 means the popup appears after 3 eligible store refreshes.
      • Offer ID: Select one or more offer IDs.
      This field is relevant only for Post Purchase Popups. Configure this if you want this offer to apply only when the selected offers are purchased.
      • Cooldown: Enter a number representing the number of minutes that must pass before the popup can appear again.
      This field is relevant only for Store Refresh Popups.
    • Scheduled Offer: Click one of the following tabs to set the offer schedule, and then complete their specific fields:
      • Permanent: The offer is always available.
        • Availability: Enter a number representing how many times a player can purchase this offer.
      • Intervals: The offer is available at specific times.
        • Availability: Enter a number representing how many times a player can purchase this offer.
        • Repeat: Use the drop-down menu to select how often this offer is displayed.
      • Schedule: The offer is available during a specific date and time.
        • Availability: Enter a number representing how many times a player can purchase this offer.
        • Pick A Date: Select the date and time period when the offer is available.
        • Note: Add any notes.
        • Add Appearance: Once you’re finished, click Add Appearance. You must have at least 1 appearance. Click the ellipsis next to an appearance to edit or delete.
    This field is relevant only for Store Refresh Popups.
    • Segments
      • Segment Name: Enter segment names to display the offer to specific groups of players.
    • Badges
      • Badge: Select a Badge from the drop-down menu to help highlight the offer.
    • Sale & Discounts
      • Min Product Sale: Enter a discount value for the product. Setting this field adds a Sale Badge to your offer.
      • Type: Click the drop-down menu to select the discount type, Percentage, Multiplier, or Fixed Amount.
      • Price Discount: Enter a discount value, and the full price will appear crossed out next to the sale price. This field is relevant only for paid offers.
    • Progress Bar
      This section is only relevant if you have a Progress Bar offer configured.
       Define how many points the Triggered Popup adds to a Progress Bar when it is collected or purchased.
      • Bar ID: ID of the Progress Bar this offer to contributes to.
      • Bar Points: Number of points awarded toward the Progress Bar.
    • Products: To add products to the Triggered Popup, configure the fields below, and then click Add Product. You’ll see the products displayed in a table at the bottom of the page.
      • Product Name: Select a product to add from the drop-down list.
      • Product Types: Choose how the product is displayed within the Triggered Popup:
        • Main: A primary product displayed prominently in the Triggered Popup.
        • Sub: A secondary product displayed in a smaller layout. Sub products can appear on their own or under a Main product.
        • Web Only: Select Web Only to promote items that are available exclusively in the Web Store.
          To get access to this feature, contact your account manager.
      • Quantity: Enter the number of units of this product included in the offer.
  4. Click Save to create the Triggered Popup.

​
Edit a Triggered Popup

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

​
Duplicate a Triggered Popup

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

​
Delete a Triggered Popup

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