Crafting Engaging Challenges

Learn how to design, configure, and manage engaging challenges that drive user participation and community engagement.

Quick Start: Ready to create your first challenge? Jump to Creating Your First Challenge

Overview

Challenges are interactive quests that guide users through engaging activities. They are the heart of the Nudj platform, combining multiple actions into cohesive experiences that drive participation and reward engagement.

Challenge Types

Understanding different challenge types helps you choose the right approach for your goals:

Single Action Challenge

Best for: Quick interactions, polls, simple tasksExamples:

Daily poll questions
Quick photo uploads
Simple quizzes

Setup time: 5-10 minutes

Multi-Action Challenge

Best for: Complex journeys, learning paths, campaignsExamples:

Product tutorials with multiple steps
Contest entries with multiple requirements
Educational courses

Setup time: 30-60 minutes

Recurring Challenge

Best for: Habit building, ongoing engagementExamples:

Daily check-ins
Weekly fitness goals
Monthly surveys

Frequency: Daily, weekly, monthly, yearly

Limited Time Challenge

Best for: Events, promotions, special campaignsExamples:

Flash contests
Holiday-themed activities
Product launch campaigns

Duration: Hours to weeks

Creating Your First Challenge

Access Challenge Creation

Navigate to Engagement > Challenges in your admin dashboard and click Create Challenge.

Set Basic Information

Configure your challenge fundamentals:

Title: Make it engaging and clear
Description: Explain what users will do and why
Community: Select the target community
Featured: Toggle to highlight on homepage

Configure Challenge Settings

Set up key parameters:

Status: Draft, Live, Scheduled, or Archived
Scheduling: Set start and end dates (optional)
Progress Type: Linear (sequential) or non-linear (any order)
Skippable: Allow users to skip actions

Add Visual Elements

Upload images for light and dark themes:

Primary Image: Main challenge visual (recommended: 800x400px)
Secondary Image: Supporting visual or icon (recommended: 400x400px)

Create Actions

Add the individual tasks users will complete (covered in detail below).

Set Rewards Configuration

Configure points, XP, and any special rewards for completion.

Challenge Configuration Options

Status Management

Draft
Live
Scheduled
Archived

When to use: During challenge creation and testing

Not visible to users
Can be freely edited
Perfect for building complex challenges

Progress Configuration

Linear Challenges (isLinear: true)

Users must complete actions in order
Previous action completion unlocks the next
Best for tutorials and guided experiences

Non-Linear Challenges (isLinear: false)

Users can complete actions in any order
All actions available immediately
Better for exploration-based challenges

Recurrence Settings

{
  "progressPeriod": "daily",
  "maxCompletionsPerPeriod": 1
}

Action Types and Configuration

Actions are the individual tasks within challenges. Choose the right action type for your engagement goals:

Question Actions

Multiple Choice Question

Best for: Knowledge testing, quizzes, assessmentsConfiguration:

Question text (required)
2-10 answer options
Correct answers (single or multiple)
Number of required selections

API Key: question-multiple-choiceExample Use Cases:

Product knowledge tests
Brand awareness quizzes
Educational assessments

Open-Ended Question

Best for: Feedback collection, creative responses, testimonialsConfiguration:

Question text (required)
Optional character limits
Moderation settings

API Key: question-open-endedExample Use Cases:

Customer feedback
User-generated content prompts
Survey responses

Rating Scale

Best for: Experience ratings, satisfaction surveysConfiguration:

Question text (required)
Rating style (stars, numbers, emoji, thumbs)
Scale range (1-5, 1-10, etc.)

API Key: question-rate-your-experienceExample Use Cases:

Product reviews
Service satisfaction
Content ratings

Select from List

Best for: Preferences, multiple selections, categorizationConfiguration:

Question text (required)
List of options
Minimum/maximum selections

API Key: question-select-from-listExample Use Cases:

Interest selection
Feature preferences
Category tagging

Date Selection

Best for: Event planning, scheduling, commitmentsConfiguration:

Question text (required)
Date validation (past/future/all)
Allow current date toggle

API Key: question-select-dateExample Use Cases:

Event RSVPs
Appointment booking
Goal setting dates

Secret Access Code

Best for: Event check-ins, exclusive access, location validationConfiguration:

Question text (required)
Secret code (case sensitive)
Hint text (optional)

API Key: question-secret-access-codeExample Use Cases:

Event attendance verification
Store visit confirmation
Exclusive content access

Interaction Actions

Image Upload

Best for: User-generated content, photo contests, visual proofConfiguration:

Upload prompt (required)
AI validation (optional)
File size/format limits
Moderation settings

API Key: interaction-image-uploadExample Use Cases:

Photo contests
Product usage photos
Location check-ins

External Link

Best for: Driving traffic, social actions, resource sharingConfiguration:

Link description (required)
Target URL (required)
Open in new tab setting
Event validation toggle

API Key: interaction-external-linkExample Use Cases:

Social media follows
Website visits
Resource downloads

Engage with Content

Best for: Information sharing, tutorials, rich mediaConfiguration:

Content title (required)
Rich content editor
Engagement tracking

API Key: interaction-engage-with-contentExample Use Cases:

Educational content
Video presentations
Interactive guides

Social Media Actions

Challenge Groups and Organization

Understanding Challenge Groups

Challenge Groups help organize related challenges and create structured user experiences:

Campaign Groups
Learning Paths
Themed Collections

Purpose: Organize challenges around marketing campaignsExample: “Summer Festival 2024”

Week 1: Registration Challenge
Week 2: Social Sharing Challenge
Week 3: Photo Contest Challenge
Week 4: Finale Event Challenge

Creating Challenge Groups

POST /api/v2/admin/challenge-groups
{
  "communityId": "609c1a5b4f1b2c001f647392",
  "details": {
    "title": "Summer Campaign 2024",
    "description": "Complete summer-themed challenges",
    "light": {
      "primaryImageUrl": "https://...",
      "secondaryImageUrl": "https://..."
    },
    "dark": {
      "primaryImageUrl": "https://...",
      "secondaryImageUrl": "https://..."
    }
  }
}

Action Groups and Display Options

Action Groups control how actions are presented to users within challenges:

Action Group Types

Single Actions
Action Groups
Child Actions

Type: singleWhen to use: Standalone actions that don’t need groupingDisplay: Individual action cards

Display Type Examples

{
  "type": "group",
  "displayType": "list",
  "details": {
    "title": "Survey Questions",
    "description": "Answer all questions below"
  }
}

Challenge Templates

Leverage templates to accelerate challenge creation:

Using Existing Templates

Browse Templates

Navigate to Templates > Challenges in your admin dashboard

Preview Template

Click on any template to see its structure, actions, and configuration

Create from Template

Click Use Template and customize for your needs

Modify as Needed

Edit actions, rewards, branding, and settings

Creating Templates

Make your successful challenges reusable:

POST /api/v2/admin/challenges
{
  "communityId": "609c1a5b4f1b2c001f647392",
  "isGlobalTemplate": true,
  "availableAsTemplateForOrganisations": [
    "609c1a5b4f1b2c001f647391"
  ],
  "details": {
    "title": "Product Launch Template",
    "description": "Ready-to-use product launch challenge"
  }
}

Popular Template Categories

Marketing Campaign

Social media promotion
Brand awareness activities
User-generated content
Referral challenges

Educational Path

Product tutorials
Skill development
Certification tracks
Knowledge assessments

Event Activation

Pre-event engagement
Live event activities
Post-event follow-up
Networking challenges

Community Building

Welcome sequences
Member introductions
Discussion prompts
Collaboration tasks

Rewards and XP Configuration

Setting Up Challenge Rewards

Configure rewards to motivate completion:

Points Rewards
XP Rewards
Unlock Requirements

Spendable Currency

Base points for challenge completion
Bonus points for speed/quality
Can be used to redeem rewards

Configuration:

{
  "basePoints": 100,
  "bonusPoints": 50,
  "conditions": ["speed", "accuracy"]
}

Reward Strategy Best Practices

Reward Scaling: Higher rewards for more complex or time-intensive challenges encourage participation in premium content.

Simple Actions: 10-25 points, 25-50 XP
Medium Challenges: 50-100 points, 100-250 XP
Complex Challenges: 150-300 points, 300-500 XP
Premium/Exclusive: 300+ points, 500+ XP

Challenge Scheduling and Availability

Time-Based Configuration

{
  "startsAt": "2024-07-01T00:00:00Z",
  "expiresAt": "2024-07-31T23:59:59Z",
  "status": "scheduled"
}

Scheduling Strategies

Campaign Coordination

Scenario: Product launch with multiple phasesStrategy:

Pre-launch: Teaser challenge (1 week before)
Launch day: Main challenge (24-48 hours)
Post-launch: Follow-up challenge (1 week after)

Event Integration

Scenario: Conference or workshop supportStrategy:

Pre-event: Registration and prep challenges
During event: Live engagement challenges
Post-event: Feedback and connection challenges

Seasonal Campaigns

Scenario: Holiday or seasonal promotionsStrategy:

Plan seasonal themes months ahead
Create templates for recurring holidays
Build excitement with countdown challenges

Best Practices for Engaging Challenges

Design Principles

Clear Value Proposition

What users should know:

What they’ll get from completing it
How long it will take
What’s required of them
Why it matters

Progressive Difficulty

Structure challenges:

Start with easy actions to build momentum
Gradually increase complexity
Celebrate milestones along the way
End with satisfying conclusions

Visual Appeal

Make it attractive:

Use high-quality, relevant images
Maintain consistent branding
Consider light/dark theme variants
Test on mobile devices

Social Elements

Encourage sharing:

Include social actions where appropriate
Create opportunities for user-generated content
Build in community interaction
Recognize top participants

Content Guidelines

Avoid These Common Mistakes:

Overly complex instructions
Too many actions in a single challenge
Rewards that don’t match effort required
Missing or unclear visual elements
No mobile testing before launch

Writing Effective Challenge Content:

Titles: Action-oriented, benefit-focused (e.g., “Master Our New Features” not “New Features Challenge”)
Descriptions: Explain the “why” and set expectations clearly
Action Instructions: Use simple, direct language with specific steps
Visual Elements: Choose images that represent the experience, not just decoration

Testing and Optimization

Pre-Launch Testing

Test all actions in draft mode
Verify reward calculations
Check mobile responsiveness
Get feedback from team members

Soft Launch

Release to a small user group first
Monitor completion rates and feedback
Fix any issues before full rollout

Monitor Performance

Track key metrics: start rate, completion rate, time to complete
Watch for drop-off points in multi-action challenges
Gather user feedback proactively

Iterate and Improve

Adjust based on performance data
Create variations to test what works best
Document successful patterns for future challenges

Advanced Configuration

Multi-Community Challenges

Deploy challenges across multiple communities:

{
  "communityId": "primary-community-id",
  "additionalCommunityIds": [
    "secondary-community-id",
    "tertiary-community-id"
  ]
}

Custom Video Integration

For challenges with video content:

{
  "videoMetadata": {
    "platform": "youtube",
    "videoId": "dQw4w9WgXcQ", 
    "duration": 213,
    "thumbnailUrl": "https://...",
    "title": "Product Demo Video"
  }
}

Conditional Logic

Create dynamic experiences with conditional actions:

{
  "prerequisites": {
    "completedActions": ["action-id-1", "action-id-2"],
    "userAttributes": {
      "level": ">=5",
      "points": ">=1000"
    }
  }
}

Troubleshooting Common Issues

Challenge Not Appearing to Users

Checklist:

Status is set to “live”
Start date is in the past (if set)
End date is in the future (if set)
User has access to the community
Challenge has at least one action
Unlock requirements are met

Solution: Verify each item above and test with a different user account.

Actions Not Working Properly

Common causes:

Missing required configuration fields
Invalid external URLs or social media links
Incorrect image upload settings
Network connectivity issues

Solution: Test each action individually in draft mode before making live.

Rewards Not Being Distributed

Checklist:

Reward configuration is properly set
All required actions are completed
User meets any unlock requirements
Points/XP calculations are correct

Solution: Check the challenge completion logs and verify reward settings.

Poor Completion Rates

Analysis questions:

Is the challenge too long or complex?
Are the instructions clear?
Are the rewards proportional to effort?
Is the content engaging and relevant?

Solution: Review challenge analytics and gather user feedback to optimize.

Getting Help

Community Support

Get help from our team and community

Admin FAQs

Quick answers to common challenge questions

Next Steps: Once you’ve created your challenge, learn how to manage rewards and track performance to optimize engagement.

Getting Started

Dashboard & People

Core Engagement Features

Gamification System

Organization Settings

Advanced Features & Workflows

​Crafting Engaging Challenges

​Overview

​Challenge Types

Single Action Challenge

Multi-Action Challenge

Recurring Challenge

Limited Time Challenge

​Creating Your First Challenge

​Challenge Configuration Options

​Status Management

​Progress Configuration

​Recurrence Settings

​Action Types and Configuration

​Question Actions

​Interaction Actions

​Social Actions

​Challenge Groups and Organization

​Understanding Challenge Groups

​Creating Challenge Groups

​Action Groups and Display Options

​Action Group Types

​Display Type Examples

​Challenge Templates

​Using Existing Templates

​Creating Templates

​Popular Template Categories

Marketing Campaign

Educational Path

Event Activation

Community Building

​Rewards and XP Configuration

​Setting Up Challenge Rewards

​Reward Strategy Best Practices

​Challenge Scheduling and Availability

​Time-Based Configuration

​Scheduling Strategies

​Best Practices for Engaging Challenges

​Design Principles

Clear Value Proposition

Progressive Difficulty

Visual Appeal

Social Elements

​Content Guidelines

​Testing and Optimization

​Advanced Configuration

​Multi-Community Challenges

​Custom Video Integration

​Conditional Logic

​Troubleshooting Common Issues

​Getting Help

Community Support

Admin FAQs

Crafting Engaging Challenges

Overview

Challenge Types

Creating Your First Challenge

Challenge Configuration Options

Status Management

Progress Configuration

Recurrence Settings

Action Types and Configuration

Question Actions

Interaction Actions

Social Actions

Challenge Groups and Organization

Understanding Challenge Groups

Creating Challenge Groups

Action Groups and Display Options

Action Group Types

Display Type Examples

Challenge Templates

Using Existing Templates

Creating Templates

Popular Template Categories

Rewards and XP Configuration

Setting Up Challenge Rewards

Reward Strategy Best Practices

Challenge Scheduling and Availability

Time-Based Configuration

Scheduling Strategies

Best Practices for Engaging Challenges

Design Principles

Content Guidelines

Testing and Optimization

Advanced Configuration

Multi-Community Challenges

Custom Video Integration

Conditional Logic

Troubleshooting Common Issues

Getting Help