Skip to main content
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. First, complete the fields for your popup type:
    • Triggers
      • Action: From the drop-down menu, select Purchase Completed.
      • Frequency: Enter the number of matching purchases required before the popup is displayed. For example, 3 means the popup appears after 3 matching purchases.
      • Offer ID: Select one or more offer IDs if you want this popup to appear only when the selected offers are purchased.
    • Triggers
      • Action: From the drop-down menu, select Store Refresh.
      • Frequency: Enter the number of store refreshes required before the popup is displayed. For example, 3 means the popup appears after 3 eligible store refreshes.
      • Cooldown: Enter the number of minutes that must pass before the popup can appear again.
    • Scheduled Offer: Click one of the following tabs to set the offer schedule, and then complete its specific fields:
      • Permanent: The offer is always available.
        • Availability: Enter a number representing how many times a player can purchase this offer.
        • Show Availability: Select this option to show the offer’s availability in the web store. For example, if Availability is set to 5, the web store displays Available 5/5. When a player collects or purchases the offer, the displayed availability decreases, for example to Available 4/5.
      • Intervals: The offer is available at specific times.
        • Availability: Enter a number representing how many times a player can purchase this offer.
        • Show Availability: Select this option to show the offer’s availability in the web store. For example, if Availability is set to 5, the web store displays Available 5/5. When a player collects or purchases the offer, the displayed availability decreases, for example to Available 4/5. Deselect it to hide the availability text in the UI.
        • 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.
        • Show Availability: Select this option to show the offer’s availability in the web store. For example, if Availability is set to 5, the web store displays Available 5/5. When a player collects or purchases the offer, the displayed availability decreases, for example to Available 4/5.
        • 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.
    Then, complete the shared sections for both popup types:
    • 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.