Setting Up Your First Campaign

Using your pre-planning notes, you have all your information gathered and are ready to set up your UserWise account and create your first event!

This walkthrough will lead you through setting up a new game, setting up a segment, and setting up an offer for that segment. 

In this example, we will be adding a game and creating a weekend offer for players who have a lot of gems saved up that we'll be offering up a bundle of in game items and currency for. 

Let's begin!

Create your game in UserWise

1. Sign into your UserWise account. Welcome to to your new LiveOps dashboard!
2. Add any team members to the account. You can find the Team link in the upper right corner by hovering over the profile image.
   
3. Create your first App by clicking "+ New App" and adding the App Name and an icon. *Note: The icon is for quick identification within UserWise only, it does not affect the game itself in any way.
   

Set up one time data flows and game information

1. Get data flowing into UserWise so that you can start segmenting users.
   1. Using your pre-determined attributes, begin sending in data to the UserWise system. 
   2. *Technical Note: If using a Server to Server implementation, don't forget to set up hashing.
   3. Documentation: Attributes - Events - Revenue Events
   4. To confirm the data is in the system, navigate to Segments, click Add Attribute and view your available attributes.
   5. Create a Segment for your first test. In our example, we have created a Segment for players who have more than 500 gems that we want to give an offer to.
2. Create any associated Products, Currencies, and Items by navigating to each section under Settings.
   
   1. Currencies and items can be thought of as lists with both the plaintext name of the currency or item and the game's hardcoded ID for each. The plaintext name is what the LiveOps team member will see in their configurations. 
   2. Products are your App Store products with defined price points and associated App Store IDs.
   3. You can manually add each of the above one at a time, or import a list for each. 

Create your first Campaign

1. You're ready to create your first Campaign. A Campaign is the highest level of event, and contains all the associated parts. 
   1. Make sure you are on the Campaign calendar by clicking Campaigns in the main menu bar. Click "+ Create Campaign"
      
   2. Choose Scheduled Campaign or Triggered Campaign depending on your specific need. 
      1. In this example, we would choose Scheduled Campaign as the campaign has a set start and end time, versus Triggered, which would occur whenever the set trigger occurs.
   3. Fill out your initial Campaign information and choose an initial Segment. Don't worry, you can further segment within the Campaign if you want to. 
      1. In our example, we have chosen our Segment we created earlier 'Gems over 500' and scheduled the Campaign starting on a Friday and ending on a Monday at 1AM. 
      2. Click Save. The system will return you to the Campaign calendar. 
2. Click on your new Campaign and open the Content Builder from the upper righthand corner
3. Begin adding any content you would like to your Campaign such as Messages, Event Configurations, Offers, JSON Uploads, and Surveys. In our example, we will be setting up an Offer. Since this is our first offer, we'll Start from Scratch. 
   
4. Add your information to the Offer Editor
   1. In our example we have given an internal name of 200 Gem Bundle, a user facing title of 800% Value, a user facing body of "Limited time only! 10,000 Gold, X items" We can optionally add images that will be passed to the game.
   2. Set when it will run - it's set to the whole campaign by default, you can further specify within the campaign here. 
   3. Add payment type, in this case it will be in-app currency rather than a Product purchase.
   4. Set up the what is included within the offer - items and currencies
   5. Click Save

Code UserWise into your game to receive Campaign data

1. Using the technical documentation, create the framework to receive and display the Campaign.

   1. Create a Player Session
   2. Check for Scheduled Campaigns and Offers
   3. Receive the Campaign data
   4. Deliver the Campaign content to the user in the manner of your choosing with the data received from UserWise.

QA your Campaign

1. Your Campaign is now ready to QA. We'll get into Environments later and how to implement your QA process with UserWise, but for now let's get your Campaign ready to test.
   1. From your Campaign's page, change the Campaign state from Draft to Ready for Testing and choose "Yes, change status."
      
2. Your Campaign is now ready to QA.
3. Change from the LiveOps / Dev Environment to the QA Environment by hovering over the profile pic and clicking "Switch Environments" from the menu and choosing QA / Testing and clicking Done.
   
4. In the QA / Testing Environment, right click your Campaign and choose Run Test and fill in the Profile IDs for your test accounts.
   
5. Using the Profile ID(s) you designated for your test, QA your Campaign. Confirm that the game is creating the Player Session, checking for and receiving the Campaign data, and delivering the content you set up in UserWise via the game method you've set up. 

Set to Live

1. When you've confirmed that the Campaign has passed your QA check, it's time to set the Campaign live for all players in the Segment (during the date parameters you have indicated)!
2. Return to the LiveOps / Dev Environment by choosing Switch Environment and choosing LiveOps / Dev
   
3. Click into your Campaign and change the state from Ready for Testing to Publish. 
   
4. Click Confirm to Publish to Live.

Congratulations, you've set up an Offer in UserWise! 

You're ready to start creating more Segments and creating Campaigns full of exciting content; creating A/B tests; integrating UserWise into your Campaign creation and testing ecosystem and fully utilizing the power of UserWise.