Participation Policies - Gamification

Participation Policies

Participation policies control user visibility across all game objects (leaderboards, badges, certificates, lead scoring).

Policy	Description
display	User participates; progress visible to other users
do_not_display	User participates; progress visible only to admins
do_not_save	User does not participate; no data collected

5.1 Matching Criteria

Criteria	Description
byGroup	Match by user group ID
byEmailDomain	Match by email domain

Policies evaluate in array order. First match wins. If no policy matches, userDefaultPolicy applies.

curl -X POST "$KALTURA_SCM_URL/leaderboard/create" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{
    "objectType": "Leaderboard",
    "name": "External Only",
    "status": "scheduled",
    "startDate": "2025-06-01T00:00:00Z",
    "endDate": "2025-06-02T00:00:00Z",
    "participationPolicy": {
      "userDefaultPolicy": "display",
      "policies": [
        {"policy": "do_not_save", "matchCriteria": "byEmailDomain", "values": ["internal-company.com"]},
        {"policy": "do_not_display", "matchCriteria": "byGroup", "values": ["speakers"]}
      ]
    },
    "virtualEventIds": ["$VIRTUAL_EVENT_ID"]
  }'

In this example, internal employees are excluded entirely (do_not_save), speakers participate but are hidden from rankings (do_not_display), and all other users are visible (display).