Precisely Target the Right Audience

Precisely Target the Right Audience

CUSTOM DIMENSIONS - Product Guide

www. upsight.com

With Upsight Segmentation, you can create custom user segments from any combination of the 11 dimensions where Upsight automatically collects data. These segments provide powerful, precise targeting for in- and out-of-app messages that can meaningfully impact user behavior and app performance.

Now, you have the opportunity to create Custom Dimensions, either upload directly into Upsight or collect automatically, and then use them in your marketing activities. By defining and fine tuning your user dimensions, you can precisely reach specific usres with the exact right message.

We’ve put together some interesting ways that you can use Custom Dimensions, but don’t feel restricted by these suggestions. There are many use cases for custom dimensions, so get creative, and feel free to reach out with any questions or unique examples of how you’re using it with your campaigns.

Attribution Source

If you keep track of acquisition sources, you might want to target users by channel. For example, you can improve the value of users acquired from a new ad network by tracking source with a Custom Dimension and then using that information to target them with a special welcome campaign.

Targeting Churn-Prone Users

Have you identified churn prone users with Data Mine? You can export this group of users from Data Mine and upload them into a Custom Dimension. From there you can send this segment of users Push Messages, Rewards and Virtual Good Promotions that encourage them to remain active with your app.

Cross Promotions

Make sure all of the users in your network know about the apps you’ve created. Custom Dimensions can be used for super-efficient, targeted Cross Promotions. For example, if you have two apps A and B, you can target users of app A who don't have app B installed with app B cross promotions.

Use Cases

Creating Custom Dimensions is simple and can be done in 3 ways: 1) Dashboard CSV Upload, 2) API, and 3) Upsight SDK.

CUSTOM DIMENSIONS - Product Guide

1. Click “Add Dimension.”

2. Add “Dimension Variable Name” which will be comprised of letters and digits. Spaces should be noted as “_”. This will likely be noted as a name like “user_level” or “ad_network_source.”

Next, add a new dimension

Let’s walk through the process of creating a Custom Dimension entirely in your Upsight Dashboard:

1. Log in to https://login.upsight.com. 2. Go to the Marketing tab.

3. Select the app for which you would like to create a custom dimension.

4. Click “Game Settings” in the upper right corner of the page.

CUSTOM DIMENSIONS - Product Guide

4. Select “Dimension Type” which will be one of the following:

Number: Useful for storing a user level or other numeric data. Numeric dimensions support matching operations of equals (user_level = 10) or a range (user_level is between 5 and 20).

String: Useful for storing text data. This data can be matched by is or is not (acquisition_channel is facebook). Boolean: Useful for storing true or false data. This data can be matched by is true or is false (churn_prone is true).

www. upsight.com

Now that you have created a custom dimension, you can send data via the API, SDK, or CSV uploader in the dash-board.

Format of Values

Both the API and CSV uploader in the dashboard use the same CSV file format, which has the format of: device_id,-type_id,dimension_name

- device_id is the IDFV, IFA, Upsight SID or Android ID of the device you’d like to store the dimension for. - type_id is one of ida, idfv, sid or device. IDA, IDFV or SID are for iOS and Device and SID are for Android. - dimension_name is the name of your custom dimension.

Uploading the CSV Uploader

String - a string of text, up to n characters

Number - a number for comparison, can be an integer or a decimal. Boolean - True or 1 will be set to true; everything else will be set to false.

Deleting Values

To delete a custom dimension, simply include it in an upload with a missing value. For example, this will result in a user_level of 2.5 being set for IDFA 28033E33-DFB6-42D1-BCA9-E7E693669F4D and user_level will be deleted for 3BD7A17-A3B3-427A-91CF-8E27B41A6B8C:

device_id,type_id,user_level

28033E33-DFB6-42D1-BCA9-E7E693669F4D,ifa,2.5 73BD7A17-A3B3-427A-91CF-8E27B41A6B8C,ifa,

Sending us your Custom Dimension via the CSV upload is simple. Simply click on “Upload Values” next the new dimension you just created. There you will find instructions.

Using the API and SDK

Search the Marketing Help Center for detailed documentation on how to use each feature.

Creating user segments from Custom Dimensions

Now that you have created a Custom Dimension and added data via the API or via the CSV upload in the dash-board, you can now create a user segment to target users who match these Custom Dimension values.

1. Log in to https://login.upsight.com. Go to the Marketing tab. 2. Select the game you'd like to create a User Segment for 3. Click "Game Settings"

4. Click "User Segments" 5. Click "Add Segment"

6. Name your segment and give it a description

In the definition section, you can create a combination of Custom and standard dimensions.

As an example, let's say you have created a Custom Dimension called acquisition_channel, which represents what channel users were acquired from. You'd like to create a User Segment that identifies users who was acquired from Facebook and have purchased over $5 from you.

In the definition section, select all from the drop-down next to "of the following rules are met", and from the rule box select "amount spent", "is greater than", "1" USD. Next click the "+" below it and add a second rule of "custom - acquisition_channel", "is", and "facebook". This will match users who have the Custom Dimension acquisi-tion_channel value of "facebook" and have spent over $5.

CUSTOM DIMENSIONS - Product Guide

Notes and Tips

Limits: Custom Dimensions are allocated to Pro and Enterprise customers. To add Custom Dimensions to your

account, please contact your CSM or [email protected].

Important: Once you have added a custom dimension, you cannot edit the definition. So please be careful! Once

you have added data to your custom dimension, you cannot make changes to it.

Tip: Custom Dimensions can be used in conjunction with standard Upsight Segmentation dimensions such as

amount spent, last session date, language, or country to create laser-targeted slices of your user-base.

Tip 2: If you plan on using a newly created Custom Dimensions to send a Push Notification, it will take 20 minutes