Leaderboard Scoring Rules and Procedures

HealthKit Data Tasks

  • HealthKit data is automatically pulled into each task based on the task selected schedule (monthly, weekly, daily, one time) and displayed for the user in real time.

  • HealthKit data is automatically recorded as completing the target task when a user meets the target value. The user should not have to manually mark HealthKit data tasks as complete

  • HealthKit task completions are automatically posted to the goal chat, and all goal participants are notified about other participant’s task completions.

  • HealthKit data tasks should include a target value (i.e. 5000 steps per day).

  • Participants will be awarded points for the leaderboard based on the following parameters.

    • 1 point for completing the target value on the assigned day.

    • If the target is not reached by the end of the day, the total value recorded for the day is divided by the target value to generate a point value less than 1.

    • 1 bonus point for every unit of value completed above the target value per day (i.e. if the user completes 6000 steps on day where the target is 5000 steps, they will receive an additional 1000 points for that day). Bonus points will be awarded at the end of each day.

    • Ties should be broken based on the timestamps of when the participant reaches the target value for that day. If the participant does not meet or exceed the target value, the timestamp is recorded as 23:59:59.

Standard Tasks (not HealthKit)

  • Participants are required to mark each task complete and include any required form of validation (i.e. image, video, etc.).

  • Task completions are automatically posted to the goal chat, and all goal participants are notified about other participant’s task completions. The validation is also included in the chat post (i.e. the image or video link showing proof of task completion is posted in the chat for all participants to view).

  • The goal administrator can change “completed” tasks by other users to “not complete”. This is necessary to keep scoring fair in the case of a participant not correctly completing a task. The administrator may changes completed tasks to not complete if the validation method does not adequately show the task was completed as required. If a participant’s task is changed to “not complete” by the administrator, the task will be available for the participant to complete again with a new form of validation.

  • Participants will be awarded points for the leaderboard based on the following parameters

    • 1 point for recording the task complete on the assigned day.

    • .75 points for recording the task complete on the day after the assigned day.

    • Tasks marked complete two or more days after the task assigned date will be scored as 1 divided by the number of days past the assigned day. For example, if a participant marks a task complete 5 days after the assigned day, the point value would be 1/5, or .2.

    • Points will be removed for tasks marked “not complete” by goal admin, and points will be added for tasks completed again by the participant as noted above.

    • Ties should be broken based on the time stamp of when the participants record tasks as complete.

    • If a participant does not mark tasks complete prior the goal ending, the incomplete tasks will be scored as 0 and timestamped 23:59:59 on the goal end date.

Tie Breaking Rules/Process

  • Participants can have simultaneously assigned HealthKit and Standard tasks. This means a participant’s score is the sum of all points from any completed task. Points are calculated in real time as HealthKit targets are met, as other tasks are marked complete, and when HealthKit bonus points are awarded at the end of each day.

  • When a points tie exists between two or more users and until the points tie is no longer in effect, the following tie breaking process is used to calculate real time leaderboard standings. When point ties no longer exist from the calculation methods listed above, the tie breaking procedures are ignored.

  • Tie breaking points are calculated separately from points earned from HealthKit and Standard tasks.

  • Tie breaking points are awarded based on the number of participants in a goal and the HH:MM:SS time stamps recorded when a task is marked complete as described above.

  • Tie breaking points

    • The first participant to complete a task based on the time stamp from their time zone is awarded points equal to the number of participants times a random multiplier (a unique random multiplier will be generated for each task on each day to prevent additional ties from tie breaking points). The second participant to complete a task using the same time stamp method is awarded points equal to the number of participants minus 1 times the random multiplier. The third participant to complete a task is awarded points equal to the number of participants minus 2 times the random multiplier, and so forth.

    • Time stamps are not compared by relative time zone equivalences; rather, time stamps for all users are compared based on the individual user’s perspective of time. For example, 7:00 PM PST is considered earlier than 8:00 PM EST because 7:00 PM is earlier than 8:00 PM.

    • Leaderboard standings are determined by the total number of tie breaking points accumulated during the duration of the goal when two or more users are otherwise tied. Only those users who are tied in normal points are assigned leaderboard standing by tie breaking points. For example, if user A has 100 points, user B has 80 points, user C has 60 points, and user D has 80 points, user A is in first place and user C is in fourth place. Users B and D’s standing for second and third place will be determined by tie breaking points. When users B and D are no longer tied in normal points, their tie breaking points will be ignored.