Lead Scoring - Gamification

Lead Scoring

Lead scoring tracks user engagement during events and segments users by likelihood to convert. Two parallel segmentation systems run simultaneously.

9.1 Percentage Groups (Relative Ranking)

Group	Range	Description
Hot Leads	80-100%	Top 20% of participants
Warm Leads	50-79%	Middle 30%
Cold Leads	0-49%	Bottom 50%

9.2 Score Groups (Absolute Thresholds)

Group	Range
Top Score Leads	1000+
Mid Score Leads	500-999
Low Score Leads	0-499

9.3 Lead Scoring CRUD

# Create lead scoring profile (scoreGroups or percentageGroups required)
curl -X POST "$KALTURA_SCM_URL/leadScoring/create" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Event Lead Scoring",
    "description": "Score attendees by engagement",
    "status": "scheduled",
    "startDate": "2025-06-01T00:00:00Z",
    "endDate": "2025-06-03T23:59:59Z",
    "participationPolicy": {
      "userDefaultPolicy": "display",
      "policies": [
        {"policy": "do_not_save", "matchCriteria": "byEmailDomain", "values": ["internal-company.com"]}
      ]
    },
    "scoreGroups": [
      {"name": "Top Score Leads", "range": [1000, 99999]},
      {"name": "Mid Score Leads", "range": [500, 999]},
      {"name": "Low Score Leads", "range": [0, 499]}
    ],
    "virtualEventIds": ["$VIRTUAL_EVENT_ID"]
  }'

# Create rules for lead scoring
curl -X POST "$KALTURA_SCM_URL/rule/create" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{
    "gameObjectType": "leadScoring",
    "gameObjectId": "'$LEAD_SCORING_ID'",
    "name": "Session viewership",
    "conditions": [{"fact": "eventType", "operator": "equal", "value": "viewPeriod"}],
    "type": "sum",
    "mode": "distribute_points",
    "metric": "playTime",
    "groupBy": "kuserId,entryId",
    "goal": "60",
    "points": "10",
    "maxPoints": "unlimited",
    "reportFormat": "default"
  }'

9.4 User Lead Scoring Data

curl -X POST "$KALTURA_SCM_URL/userLeadScoring/list" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{"gameObjectId": "'$LEAD_SCORING_ID'", "pager": {"pageSize": 100, "pageIndex": 1}}'

9.5 Lead Scoring Reports

Summary report: Percentage Group Name, Range, Number of Users, Average Score, Average Engagement Score, Average User Profile Score.

Detailed report: Absolute Rank, Total Lead Score, User Name, Email, S-Group (absolute), Rank within S-Group, P-Group (percentage), Rank within P-Group, per-rule-group scores.

Reports are exportable to CRM systems as custom objects.