A Contest in ZIQNI is a single promotion. Contests can be created within a competition or they can be added in after a competition has been made. 



From the dashboard page, scroll to Competitions and click.


This will load the search/ create page. From here the following actions can be performed.



  • If there is data that can be searched for, the screen above will appear. Search for a competition that has been created and saved previously. Competitions can be searched by using keywords and phrases. 
  • Competitions can be searched using the pre-assigned filters;  All, Deleted, Ready, Active, Finished, Cancelled. These are available via the drop-down menu.
  • The default filter is Active. 
  • Select the competition the contest is to be added to. This can be done by checking the box and clicking on the competition ID.


The page below will load. 

  • This will display information that has been entered for the competition. The information can be edited/ deleted using the Action button.
  • Edits can only be made in fields with a white background.



  • Click on Contest, this will load all the contests linked to the specific competition.
  • From here, click on Create and the Create Contest page will load.


 Settings

The first step to creating a contest in the ZIQNI system is to generate the settings. This is where the user inputs the basic information required for the contest.



  • Name the contest. This is a mandatory field and is limited to 500 characters. 
  • Group the content using tags. Tags can be selected from options that have been created or you can type and add tags directly in the box. Multiple tags can be selected.
  • Select the round type: Time-Bound means the round has a time limit added to it. Target Based means there is goal to meet, for example, the first member to earn 100 points
  • Choose the minimum and maximum number of entrants.
  • Write a short description of the contest. This is for reference only and is an optional field. This is limited to 500 characters.
  • Include the terms and conditions. These set out the instructions for the contest.
  • Add metadata to describe and extend the competition, using a pair of values and keys.
  • Once all information has been entered, click next.


Scoring Strategies



  • Choose the number of rounds for the contest. 
  • Select the start and end times for the contest, including UTC. 
  • If required, select Entrants, these are members who have won a previous contest.  Leave the field empty if all entrants can participate.
  • Decide the scoring strategy. 
  1. Cumulative Strategy-  The most basic strategy where all points are added up and totals are displayed on the leaderboard.
  2. Highest Only - This requires a value to indicate how many of the highest points/ scores will be calculated and added to the leaderboard.
  3. Sum over Count - This requires a value to indicate how many events will be summed up and displayed on the leaderboard.
  4. Sum over Count - including a goal in time marker - This requires a value to indicate how many points need to be achieved to meet the goal, for example, the first person to reach 100. The value will be capped as the selected scoring strategy.
  •  Choose Ranking, the default will be on. If the toggle is turned off, the user can choose ranking strategies. 


Rewards

Creating a reward in Competitions/ Contests is optional. In Competitions, a reward will be triggered based on the rule structure. Multiple rewards can be created for Competitions/ Contests.



  • Select the reward icon.
  • Give the Reward a name for example - Congratulations Badge
  • Group the Reward using tags.  Tags can be selected from options that have been created or you can type and add tags directly in the box. Multiple tags can be selected.
  • Determine numerical the value of the reward. This number is the quantity of the reward. For example: How many badges?
  • Decide the reward type from the drop-down menu. This would have been pre-created in Settings - Reward Type.
  • Choose the ranking of players who will receive the reward. This can be players ranked 1- 10 or 1, 5, 6 or 1, 10 - 15.
  • Use the toggle to decide if set the point in time is on/ off. When on this allows the user to set a date for the reward to expire for all members. When set to off the user can decide on the period of time a member has to claim their reward, for example, 5 days.
  • Create a time delay in minutes which will provide a number of minutes between the achievement being triggered and the reward being issued
  • Select the period of time the member has to claim their reward until it is no longer valid, for example - must be claimed in 5 days.
  • Write a short description of the achievement.  This is for reference only and is an optional field. This is limited to 500 characters.
  • Decide whether Acknowledgement is required for the reward- Does the member have to manually claim the reward or is it issued automatically?
  • Set an issue limit - this is how many times the reward can be claimed. There is a direct relationship between the issue limit and the number of achievements. The reward issue limit cannot be more than the total number of achievements set. 
  • Add metadata to describe and extend, using a pair of values and keys.


Previously created rewards can also be added to a competition/ contest from a template. 



  • Move to Reward Tab click on Add From Template Button and a list of pre created rewards will be populated. 
  • Search for Rewards using the Search Field.
  • Check the reward to be added, click on Add  button in right hand corner. This will load the reward, from here any edits can be made.
  • Click Create to add the reward to the contest.


Rules

Using Ziqni's rule engine the user can create as many different rule combinations as required from simple to extremely complex. In contests the rules are the criteria that are set for how the member will access the contest. 


Please refer to the ZIQNI's Rule Engine articles for a more in-depth explanation and examples of how this can be used. 



  • Choose how the rules will be structured - rules can be created using any are true statements or all are true.
  • Click on the + sign to add further criteria to the rules.
  • Complete the then statement to state what will happen when each rule structure is met.Rules need to be created for all parts of a competition; 
    • Start - Create the rule structure that will set the criteria for the Competition/ Contest to start.
    • Finish- Create the rule structure that will set the criteria for the competition/ contest to finish
    • Finalise- Create the rule structure that will set the criteria for the competition/contest to finialise all data.
    • Cancel- Create the rule structure that will set the criteria for the competition/ contest to be cancelled. 
    • Entrant- Create the rule structure that will set the criteria for the entrants to participate in the competition/contest.



The action buttons in the top right-hand corner of the Rules page allow the user to access a number of features. 

  • <> Displays the JSON string along the right-hand side of the screen.
  • Clear allows the user to delete the rules and begin to create new ones.
  • Save as template - a string of rules can be saved as a template for future use.
  • Load as Template - load previously saved rule creations.
  • Arrow Icon - Expands the page to allow easy creation of more complex rule structures. 


Translations

The languages are pre-set and must already be added in the language settings. If these have not been added, translation will not function.

If additional languages are required, go to Settings → Languages and add a new language.



  • Select the language the fields are to be translated into.
  • The text that can be translated is automatically pre-populated. The user must write the translation into the translation box. 
  • Once all fields have been translated the language name will have a green check to show it has been successfully translated. Another language can then be chosen if required.
  • If the translation has not been successful (something has been left out) the language will have a pink exclamation mark to let the user know there is an error.
  • Click next once all translations have been completed.


Summary

This allows the user to review and edit all information that has been entered.



  • Use the arrow icon to open each section to preview the summary.
  • If any edits are required, this can be done by moving between the tabs. All information can be edited at this stage. Once the reward is created, specific information will be locked and will no longer be able to be edited.
  • When all information is correct, click on Finish and the Competition/ Contest has been created.
  • A preview page will now load, from this page, information can be edited or deleted using the Action button.
  • Once the edit page opens, only information with a white background will be editable.
  • Click on Entrants to view all entrants entered into this contest.