Creating and Using Events

Events are the primary driver of in-game content.  Say you want to create a weekly event where you need to slay three dragons and receive gold, gems, and boosters as a reward.  Then the next week you want to run the same weekly event, but change it to slay ten goblins and receive a different set of rewards. This is where Events come in.

The basic flow of Events:

1. Create any required Event Frameworks. This is a one time step.
2. Optional: Create an Event Template.
3. Create a Campaign to house the Event
4. Add the Event to the Campaign via the Content Builder. 
5. Re-use the Event as many times as you need in custom configurations to many different segments and keep things fresh and interesting for your players!

Create an Event Framework

An Event Framework allows your LiveOps team to reuse an expected JSON-defined structure inside the SDK for multiple events. This is especially helpful for recurring events and event formats. This setup is one-time and will need to be done on the app level.  You can edit your App's Event Frameworks by navigating to the Settings > Event Frameworks dashboard page. 

Be sure the proper app is selected in the top left corner!

In order to create an Event Framework, you should have some knowledge of how JSON works and what the SDK will expect to receive on initialization.  

You will create a JSON-based template to define the fields which are needed. Visit the JSON Templating article to learn more about how you and your team should structure your custom JSON-defined templates.

Optional: Create an Event Template

An Event Template takes your Event Framework and creates a template that can be re-used for multiple Events. This is a handy way to save your Event's structure if you have multiple reward tiers that you have built out that you do not want to re-create every time you use the Event Framework. You can edit your App's Event Templates by navigating to Templates > Events.

*Tip: You can create an Event within a Campaign using an Event Framework without using a Template and when you have it completed, can use the Save Changes dropdown to "Save as New Template."

Add the Event to a Campaign

Enter the Campaign you wish to use your Event in.  In the Content Builder of the Campaign, click "+ Add Content" and choose Event, and select "Start from Template".  Select the template you've just created above and fill out the details.  Click Save and your Event is ready to go in your Campaign as soon as you set your Campaign live!