App Settings

Reward Items


Rewards are items you define that are given to your users using the Upsight infrastructure. Any content unit can contain a reward for your user.

Create items in your app's code, define the Reward Item on the Upsight Dashboard, and then use In-App Purchase tracking to fully utilize Reward Items with the Upsight SDK.

For more information about using Rewards, see Rewards Content Unit

Note Granting Rewards require additional instrumentation to function properly, please see your platform's respective integration guide (iOS, Android) for more information on the steps required to implement rewards in your application.

  1. Log into your Upsight Marketing Dashboard.

  2. From the list of apps at the bottom of the screen, click your app.

  3. On the top right of the screen, click the app settings button.

  4. From the list of menu of settings on the right, click the Reward Items link.

  5. On the top right of the screen, click the add reward item button.

  6. In the Item Tag textbox, enter the name you would like to use for your Reward Item.

    Note This should be a unique string that represents unlockable content in your app and must be recognized within your app code.

  7. In the Description box, enter a meaningful description for your Reward Item.

  8. From the Supported App Versions dropboxes, indicate your supported app versions.

  9. Click the save button to save the button without publishing it.

  10. Click the publish button to begin sending your Content Unit to users.

IAP Products


In-App Purchase (IAP) Products let you sell a variety of items directly within your app, including app currency, virtual goods, or other in-app content. Create items in your app's code, define the Reward Item on the Upsight Dashboard, and then use In-App Purchase tracking to fully utilize Reward Items with the Upsight SDK.

IAP Products are configured in iTunes Connect or Google Play, for their respective platforms, and added to the Marketing Dashboard. IAP Products are selected when creating a Virtual Good Promotion.

Note IAP Products require additional instrumentation to function properly, please see your platform's respective integration guide (iOS, Android) for more information on the steps required to implement Virtual Goods Promotions.

To add an IAP, follow these steps:

  1. Log into your Upsight Marketing Dashboard.

  2. From the list of apps at the bottom of the screen, click your app.

    List of apps

  3. On the top right of the screen, click the App Settings button.

    App Settings Button

  4. From the list of menu of settings on the right, click the IAP Products link

    List of Menu Settings

  5. On the top right of the screen, click the Add IAP Product button.

    Add IAP Product Button

  6. In the Product ID box, enter your Product ID from iTunes Connect or Google Play.

    Product ID Box

    Note The Product ID can be for a single item or a bundle created in iTunes Connect.

  7. In the Description box, enter a meaningful description for your IAP Product.

    Description Box

  8. From the Type radio boxes, select whether your IAP is consumable or non-consumable.

    Type Radio Boxes

    Note This must match what you have defined in iTunes Connect or Google Play.

    • Consumable IAP Products such as virtual currency, can be purchased an infinite number of times by a particular player.
    • Non-consumable IAP Products will be awarded to end users only if they do not already own it. Non-consumable items such as a sword, can only be purchased once.
  9. In the Price textbox, enter your IAP price tier.

    Price Textbox

    Note The selected Price Tier for this IAP Product must match what's defined in iTunes Connect or Google Play. The user will always be charged the iTunes Connect or Google Play price tier regardless of what is selected in the Upsight Marketing Dashboard.

  10. From the Cleared for Sale radio boxes, indicate if the item is cleared for sale or not.

    Cleared for Sale Radio Boxes

    IAP Products that are not cleared for sale cannot be advertised via Upsight Marketing Virtual Good Promotions.

    Note This must match what's defined in iTunes Connect or Google Play.

  11. From the Supported App Versions dropboxes, indic!ate your supported app versions.

    Supported App Versions Dropboxes

    Use this section if your IAP Product is only available in specific versions of your app.

    Note App versions can be added and managed in App Settings.

  12. Click the Save button.

    Save and cancel button

App Versions


What are app versions?

App versions are specific releases of your application. By adding app versions to the Upsight Marketing dashboard, you will be able to target users on those versions when delivering content to them.

How do I add app versions?

  1. Log into your Upsight Marketing Dashboard.

  2. From the list of apps at the bottom of the screen, click your app.

    App List

  3. On the top right of the screen, click the App Settings button.

    App Settings Button

  4. From the list of menu settings on the right, click the App Versions link.

    App Versions Link

  5. On the top right of the screen click the add app version button.

    Add App Version Button

  6. In the Version Number textbox, enter the version number.

    Version Number Textbox

    Note This version number must match your app's Property List file (.plist). Version numbers are formatted as "major.minor" or "major.minor.subminor". (e.g. 1.5.3).

  7. In the Description textbox, enter a meaningful description

    Description Textbox

  8. Click the Save button.

    Save Button

User Segments


What are User Segments?

The User Segments feature allows you to target specific users for your app based on dimensions you define and target. Saving different user segments and apply the defined segments to content, without having to redefine targeting parameters within each content. When you apply dimensions to a user segment, for example United States for Location or WiFi for Connection, users will have to match either all or any dimensions defined.

Note Currently, each dimension can only be used once per User Segment.

Note Test Devices do not adhere to targeting rules.

Create complex targeting rules using one or many dimensions. Each User Segment can be defined with Boolean Operators (AND/OR/NOT) and nested rules. Here's an example of a complex rule that targets users in North America that are not on an iPod Touch and have either used the app for at least 3 hours or 100 sessions.

Screenshot of rules in place

How do I create User Segments?

Note If a User Segment is edited, the modifications will be applied to any content unit that it is assigned to. Additionally, if a User Segment is deleted, targeting rules will no longer be applied to content units that use it.

  1. Log into your Upsight Marketing Dashboard.

  2. From the list of apps at the bottom of the screen, click your app.

    App List

  3. On the top right of the screen, click the App Settings button.

    App Settings Button

  4. From the list of menu settings on the right, click the User Segments link.

    User Segments Link

  5. On the top right of the screen, click the add segment button.

    Add Segment Button

  6. In the Segment Name textbox, enter your Segment Name.

    Segment Name Textbox

  7. In the Description textbox, enter a meaningful description for your segment.

    Description Textbox

  8. From the first Definition dropdown box choose:

    • All if a user must meet all the rules you define to be targeted by the User Segment.

    • Any if a user must meet at least one of the rules you define to be targeted by the User Segment.

    First Definition Textbox

  9. From the next Definition dropdown box choose the dimension you wish the rule to target.

    Second Definition Textbox

  10. Each dimension will then have a series of form inputs you can complete to define the rule.

    Form Inputs for Amount Spent Dimension

  11. Below the rules that you have defined, click the Plus Button (+) to add a new rule.

    Plus Button

  12. Below the rules that you have defined, click the Ellipses Button (...) to add a new rule with extra added nesting logic.

    Ellipses Button

  13. To the right of each rule, click the x button to remove a rule.

    X Button

  14. At the bottom of the screen, click the save button to save your rule.

    Save Button

How do I migrate from old targeting rules?

Publishers that have saved or published content units with the old targeting rules (before Boolean/nesting UI and saved user segments was available), must go through a migration flow when editing old content units. The original targeting rules appear on the page and the user is given the following two options if they wish to make any changes:

  1. Save as a User Segment: Save existing rules as a User Segment after giving it a name and description. They may optionally edit the rules before saving.

  2. Replace with Saved User Segment: Select an saved User Segment to replace existing rules.