The Upsight Dashboard lets you add and delete apps, edit their basic information, and add any resources they need. Specifically, you can add milestones, rewards, in-app purchases, and specify the different versions of the app that have been released.
Once you are logged in, at the bottom left of the Upsight Dashboard are settings links. Click APPLICATIONS to see a list of your apps.
Click ADD AN APP to add your app to Upsight. You can specify if your app is already on the App Store or Google Play store.
If your iOS app is not released yet, just enter its title. If it is live on the App Store, select a region and find your app in the APPLICATION NAME drop-down menu.
If your Android app is not released yet, just enter its name and click CREATE APP. If it is on the Google Play store, enter its Google Play Bundle ID instead.
For either iOS or Android apps, the next screen will show the App Token and Public Key you’ll need for integrating our SDKs.
Once you’ve added your app, you will go back to the app list page. From there, you can click EDIT in the dropdown next to the app’s name to go to that app’s settings.
In GENERAL SETTINGS, you can edit your app’s nickname, and see information like the app’s ID, token, public key, and current status:
Gather valuable data to engage with your users outside of your app! Ever want to know the average age or gender of your user base? How about their email address or phone number? With Upsight's Opt-In Data Campaigns gathering this data is as easy as following a handful of steps from our web based dashboard. Easily download this data from a secure and private section of your Dashboard and manage your user base accordingly!
If they love your app, it's not spam!
Below are some examples of how to use Opt-In Data Collection.
Weekly Newsletters - Use your email list to keep your users informed of not only the app they are using, but expose them to the other awesome things happening at your company.
App Update Announcements - Email your user base to let them know about your newest update and get them back in the app!
New App Cross-Promotions - Get the word out about your newest title to your existing user base.
Surveys - Target your most loyal users and follow up with a survey. Ask them what they really think about your app or what they would like to see in it's sequel! (i.e. "You are one of our most loyal users and we want to know what you think!)
Promotional Contests/Drawings - Set up a contest for your user base and ask them to opt-in to a drawing (i.e. "Submit your email address for a chance to win 100,000 gold coins! Drawing ends this Friday!").
SMS Marketing - You can directly communicate via SMS outside the confines of Apple/Google push notification policies. Unique to SMS, users read these messages on the device giving publishers the ability to directly link to the App Store or app itself using URL handlers.
To create an Opt-in Data collection campaign, see our documentation on Campaign Builder.
To export your Opt-in Data collection navigate to APPLICATIONS > APP NAME > APP SETTINGS > OPT-IN DATA COLLECTION.
Select the Opt-in Data campaign you want to export data from.
Select the time duration of the campaign you want to export data from.
Click DOWNLOAD CSV to download data as a CSV.
All data submitted is sent through an encrypted transmission via SSL to protect user privacy. Upsight will not use your collected data. The data collected is your own and for you to use how you see fit.
Milestones are a new way to track user movement through your app and allow you to manage exactly when and where a user sees content. Milestones are triggered when your user reaches a point in your application that you want to track or take action on.
To create a Milestone navigate to APPLICATIONS > APP NAME > APP SETTINGS > MILESTONES > ADD MILESTONE.
In the SCOPE textbox, enter a description of the user location or action within the app. Ensure the scope matches what is used within your app. Scope is limited to lowercases and no spaces. Examples of Scope include “level_up”, “app_launch”, “share_article”.
In the DESCRIPTION text enter a more detailed description of your scope.
Note Milestones 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 milestones in your application.
Rewards are items you define that are given to your users using the Reward Campaigns. Any creative can contain a reward for your user.
In order to set up a reward, first add Reward items to your app settings in the dashboard before creating a Reward Campaign.
Important Please note that the Reward item that you define on the Upsight dashboard will be converted to lower case and can only contain alphanumeric characters and underscores.
Improve Retention with Daily or Weekly Login Rewards
Create Regional Specific Item Promotions
Reengage Inactive Users
Establish Better Relationships with Top Users
To add a Reward, navigate to APPLICATIONS > APP NAME > APP SETTINGS > REWARDS > ADD REWARD.
In the 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.
In the DESCRIPTION textbox, enter a more detailed description of your reward.
For SUPPORTED APP VERSIONS, select the min and max versions that the reward is supported for your app.
Then click SAVE to add the Reward to the dashboard.
Note Reward campaigns 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.
Campaigns in Upsight that grant users rewards can have the reward be granted either client-side, via the SDK, or server-side. Server-Side reward granting allows Upsight to directly contact your server with the information on which users have been granted which rewards.
To configure Server-Side reward granting, click on the Configure Server-to-Server Callback link from within the Rewards section of the Application's settings.
Within the configuration page, there will be two fields to complete:
The Callback URL is the address of your server that Upsight will make an HTTP request to to inform you that a user has received an award. There are various macros available that will be replaced with the values for the specific user and reward being granted. These are:
To construct your Callback URL, enter your hostname and path, followed by the parameters and macros you wish to receive, for example:
Note that the URL parameters may be named according to what your server expects and do not need to be exactly the same as the macro names.
The Private Key is a key of your choice which will be used to sign the request that Upsight makes to your server, so you can verify that the request was made legitimately by Upsight and not by any other party that may have discovered your reward URL.
For more information on the signing and verification process, see our documentation here.
Once you have entered the Callback URL and Private Key, you can test that the Callback is working. You may enter values for the macros, or have random values generated for the various ID fields.
The Preview button will show an example of the completed URL that will be called, as well as what the Authorization header will look like. You may use these in your verification without Upsight making a call to your server. Once you have completed your implementation, the Test button will make a live call with the entered information. You may wish to use a specific
unique_id in your testing so you may prevent rewards from being granted to real users.
The test is considered successful when we receive an HTTP 200 response.
Once the test is successful, you may save the Callback in an enabled state. If you are unable to complete a successful test, but which to save your progress, use the toggle at the top of the page to set the callback to a disabled state before saving.
Not all users are the same yet they often all receive the same experience. Is a user that's never spent money in an app likely to make a $99.99 transaction for their first purchase? Should a user in China encounter a 4th of July-themed promotion? Can a non-English speaking player read English? The answer's no.
Displaying the same content for all users leads to lost opportunity ("no way I'm paying $99.99 for this but I'd buy that for $1.99), worse user experience ("I can't read English!"), and may even turn off users ("They recognize the U.S.'s Independence Day but not the Chinese New Year!?"). Optimizing the content shown to users based on their context (e.g. location, hardware, language) and behavior (e.g. purchase history, time in-app, number of sessions) is critical to maximizing LTV.
These problems are solved by Segments which allow you to target specific users for your app based on predefined and custom attributes that you define. Segments allows for complex targeting rules using one or many attributes. Each Segment can be defined with Boolean Operators (AND/OR) and nested rules.
Note Test Devices do not adhere to targeting rules.
To create a segment, you can use:
Navigate to APPLICATIONS > APP NAME > APP SETTINGS > SEGMENTS > ADD SEGMENT.
In the NEW SEGMENT textbox, enter a description of your segment.
In the SEGMENT DESCRIPTION textbox, enter a more detailed description of your segment.
Add all Segmentation targeting rules using one or many attributes with boolean operators and nested rules.
Then click SAVE to add the Segment to the dashboard.
App versions are specific releases of your application. By adding app versions to your app settings in the dashboard, you will be able to target users on those versions when delivering content to them.
Navigate to APPLICATIONS > APP NAME > APP SETTINGS > APP VERSIONS > ADD APP VERSION.
In the VERSION textbox, enter the app version defined in your code.
In the DESCRIPTION textbox, enter a description describing the app version and changes from prior app versions.
Then click SAVE to add an app version to the dashboard.
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.
IAP Products are configured in iTunes Connect or Google Play, for their respective platforms, and added to the Dashboard. IAP Products are selected when creating a Virtual Good Promotion campaign.
Promote any in-app item at the right time to the right audience and:
Maximize your in-app revenue
Turn non-paying users into purchasers
Establish a better relationship with whales
Increase awareness of and engagement with your virtual goods
There's no need to guess at what pricing might work for your in-app purchases. Real-time testing of everything - from where to put a promotion in your app to pricing - gives you the flexibility to make the most informed decisions for maximizing user value.
If the Upsight servers are made aware that a given user has already purchased a non-consumable In-App Purchase item, it will not show Virtual Goods Promotion Content Units for that item to that user. This is to avoid showing the user a promotion for an item that they have already purchased.
Navigate to APPLICATIONS > APP NAME > APP SETTINGS > IAP > ADD IAP PRODUCT.
In the PRODUCT ID textbox, enter your Product ID from iTunes Connect or Google Play.
In the DESCRIPTION textbox, enter a meaningful description for your IAP Product.
From the TYPE radio boxes, select whether your IAP is consumable or non-consumable.
Note This must match what you have defined in iTunes Connect or Google Play.
In the PRICE TIER dropdown, select your IAP price tier.
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.
From the CLEARED FOR SALE radio boxes, indicate if the item is cleared for sale or not.
Note This must match what's defined in iTunes Connect or Google Play.
For SUPPORTED APP VERSIONS, select the min and max versions that the IAP product is supported for your app.
Then click SAVE to add the In-App product to the dashboard.
Note Virtual Good Promotion campaigns 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 good promotions in your application.
For Android, upload your Google Play Credentials in your application settings under SETTINGS > APPLICATIONS > EDIT APP > UPLOAD GOOGLE PLAY CREDENTIALS.
To obtain Google Play Credentials, you will need to sign into your Google Play Developer's Console.
Note Ensure you are the main administrator to this account.
Go to SETTINGS > API ACCESS to link a Google Developer project to this account.
The Upsight platform provides you the ability to interactively segment your users through User Explorer and create powerful marketing campaigns using these segments. By default you can target by a number of key attributes, but there are many times when you may wish to segment based on your own specific needs and criteria.
This is what Custom Attributes allows you to do. You can send data either through CSV upload or the Upsight SDK to attach any unique value to each user and all their events. A couple powerful use-cases of Custom Attributes include:
If you keep track of what acquisition source you might want to target users by channel. For example, if you want to test out a new ad network you could buy a test set of installs and then target them with special campaigns within Upsight.
Targeting Churn Prone Users
After identifying users who may be churn prone you can send them push messages with Rewards, Virtual Good Promotions, or Announcements encouraging them to re-engage with your app.
If you have a number of apps you may want to promote apps to users who don't have them installed. For example, if you have apps A, B, and C you may want to segment users in app A who don't have app B installed and promote app B, and for those who don't have app C installed promote app C.
There are many use cases for custom attributes so please use your creativity, and feel free to reach out with any questions or unique scenarios.
To create a custom attribute:
Log into your dashboard and navigate to SETTINGS > APPLICATIONS > "YOUR APP" > APP SETTINGS > CUSTOM ATTRIBUTES.
On the top of the screen, click the ADD CUSTOM ATTRIBUTE button.
Important Once you have added a custom attribute you cannot edit it, so please be careful!
In the ATTRIBUTE VARIABLE NAME textbox, enter the name you would like your Custom Attribute to have.
Note This is a key to your variable for use in the CSV uploader or SDK. This value can be comprised of letters, digits, or _, and cannot have spaces or other special characters. Examples include
In the ATTRIBUTE DESCRIPTION textbox, enter a meaningful description of your Custom Attribute.
From the ATTRIBUTE TYPE dropdown menu, select the variable type you would like your Custom Attribute to have.
The three available types are:
Number: Useful for storing a user level or any numeric data (numbers can be integers or decimals). Numeric dimensions support matching operations of equals (user_level = 10, for example) or a range (user_level is between 5 and 20, for example).
String: Useful for storing text data, this data can be matched by is or is not (example: acquisition_channel is Upsight).
Boolean: Useful for storing true or false data, can match is true or is false (example: is_churn_prone is true).
On the bottom of the screen, click the SAVE button to save your Custom Attribute.
If you want to upload files with your custom attribute data manually you can do so using the Upsight dashboard.
To upload a file:
Log into your dashboard and navigate to SETTINGS > APPLICATIONS > "YOUR APP" > APP SETTINGS > CUSTOM ATTRIBUTES.
Select the Custom Attribute you want to upload values for and click UPLOAD VALUES.
To use the CSV uploader in the dashboard to set custom attribute data, use the following format:
device_id is the IFA, IDFV, or Android ID of the device you'd like to store the attribute for.
type_id: One of
device. IFA, and IDFV are for iOS, and DEVICE are for Android.
attribute_name: The name of your custom attribute. For example, user_level or virtual_currency.
device_id,type_id,user_level 28033E33-DFB6-42D1-BCA9-E7E693669F4D,ifa,10 73BD7A17-A3B3-427A-91CF-8E27B41A6B8C,idfv,15
Truewill be set to true, everything else will be set to false.
To delete a value for a Custom Attribute, include it in an upload with a missing value. For example, this file will result in a
2.5 being set for IDFA
user_level will be deleted for
device_id,type_id,user_level 28033E33-DFB6-42D1-BCA9-E7E693669F4D,ifa,2.5 73BD7A17-A3B3-427A-91CF-8E27B41A6B8C,ifa,