Skip to main content

​
Gifting System Management

The Gift Rewards feature (formerly known as AirDrop) allows administrators to efficiently distribute rewards to multiple users at once. This powerful tool enables you to send XP, points, and reward assets/entries to selected users in your community, making it perfect for campaigns, special events, appreciation gestures, and community engagement initiatives.
Key Benefits: Streamline reward distribution, save time on individual gifting, and create exciting community-wide events with bulk reward drops.

​
Overview

Gift Rewards provides a streamlined two-step process for distributing rewards:
  1. Select Users: Choose recipients manually or through search functionality
  2. Configure Rewards: Specify the XP, points, and/or reward assets to distribute
The feature supports multiple distribution types simultaneously, allowing you to create comprehensive reward packages that combine different value types in a single operation.

​
Accessing Gift Rewards

Navigate to the Gift Rewards feature through your admin dashboard:
1

Go to Rewards Section

Navigate to https://[your-subdomain].nudj.cx/admin/engagement/rewards
2

Click Gift Rewards

Find the “Gift Rewards” button in the page header (next to “Create Reward”)
3

Start the Process

You’ll be taken to /admin/engagement/rewards/drop to begin the gifting process
Community Selection Required: You must have a community selected in your admin context before accessing Gift Rewards. The feature is community-scoped.

​
Step-by-Step Guide

​
Step 1: Select Users

The user selection step provides multiple ways to identify and add recipients to your gift drop: User Selection Interface

​
Manual User Selection

Search Functionality:
  • Search by user name or email address
  • Real-time search results with debounced input
  • Paginated results for large user bases
  • Press Enter to execute search
Adding Users:
  • Browse available users in the left panel
  • Click the ”+” button next to any user to add them
  • Users are immediately moved to the “Drop List” on the right
  • Success notification confirms each addition
Managing Selected Users:
  • View all selected users in the right panel
  • Remove users by clicking the ”×” button
  • User count badge shows total selected recipients
  • Pagination available for large selection lists
User Information Displayed:
  • User profile picture
  • Display name (or email if no name available)
  • User identification details

​
CSV Upload (Future Feature)

Coming Soon: Bulk user import via CSV upload is currently in development. The upload functionality is temporarily hidden but will allow importing user lists by email address.
Planned CSV Format: 
email
user1@example.com
user2@example.com
user3@example.com

​
Validation Requirements

Before proceeding to step 2:
  • At least one user must be selected
  • All selected users must be valid community members
  • Form validation prevents advancement with empty selection

​
Step 2: Configure Rewards

The reward configuration step allows you to specify exactly what to distribute to your selected users: Reward Configuration Interface

​
Available Reward Types

  • Experience Points (XP)
  • Points Currency
  • Reward Assets & Entries
Purpose: Boost user progression and statusConfiguration:
  • Enter any positive integer amount
  • XP is distributed equally to each user
  • Contributes to user level progression
  • Affects leaderboard standings
Best Practices:
  • Consider your XP economy balance
  • Typical ranges: 50-500 XP for special events
  • Higher amounts for major milestones
Example Use Cases:
  • Welcome bonuses for new community members
  • Appreciation rewards for active contributors
  • Event participation bonuses

​
Combination Rewards

Multi-Type Distribution: You can combine XP, points, and reward assets in a single gift drop for comprehensive reward packages.
Example Combination:
  • 100 XP (progression boost)
  • 250 Points (spending power)
  • “Community Champion” badge (recognition)
  • 3 entries for monthly contest (additional chances)

​
Final Confirmation

Before executing the distribution:
  1. Review Summary: The confirmation dialog shows exactly what will be distributed to how many users
  2. Double-Check Recipients: Verify the user count matches your expectations
  3. Confirm Distribution: Click “Confirm Gift” to execute the distribution
Irreversible Action: Gift distributions cannot be undone once confirmed. Ensure all details are correct before proceeding.

​
Distribution Mechanisms

The Gift Rewards feature supports different distribution strategies for reward assets:
Behavior: Every selected user receives every configured rewardUse Cases:
  • Community-wide appreciation events
  • Welcome packages for new members
  • Milestone celebration rewards
  • Fair distribution scenarios
Configuration:
mechanism: "all",
amountToDistribute: 1  // Each user gets 1 of each reward
Behavior: Randomly distribute rewards among selected usersUse Cases:
  • Limited supply promotional items
  • Contest-style distributions
  • Creating excitement through scarcity
  • Budget-controlled giveaways
Configuration:
mechanism: "random",
amountToDistribute: 10  // 10 random users receive rewards
Behavior: Distribute based on user priority criteriaUse Cases:
  • VIP member recognition
  • Performance-based rewards
  • Tier-based distribution
  • Merit-based selection
Configuration:
mechanism: "priority",
amountToDistribute: 5  // Top 5 priority users receive rewards

​
Best Practices

​
Planning Your Gift Drop

Audience Selection

Strategic Targeting:
  • Define clear recipient criteria
  • Consider user engagement levels
  • Account for community segments
  • Plan for future similar drops

Reward Balance

Economic Considerations:
  • Maintain point economy balance
  • Consider XP progression impact
  • Monitor reward value inflation
  • Track distribution frequency

Timing Strategy

Optimal Distribution:
  • Coordinate with community events
  • Consider time zone implications
  • Align with engagement peaks
  • Plan follow-up communications

Communication

User Notification:
  • Announce distribution events
  • Explain the gift purpose
  • Thank recipients publicly
  • Share impact metrics

​
Common Use Cases

Scenario: Onboarding new community membersTypical Configuration:
  • 100 XP (progression boost)
  • 500 Points (initial spending power)
  • “New Member” badge (recognition)
Targeting: Recently joined users (last 7 days)Benefits: Accelerated engagement, reduced churn, positive first impression
Scenario: Thanking participants after community eventsTypical Configuration:
  • 200 XP (event participation credit)
  • Event-specific badge or digital collectible
  • Bonus entries for upcoming contests
Targeting: Active event participantsBenefits: Reinforced participation value, increased loyalty, future event motivation
Scenario: Celebrating community achievementsTypical Configuration:
  • 300 XP (celebration boost)
  • 750 Points (special reward budget)
  • Exclusive “Milestone Member” badge
Targeting: All active community membersBenefits: Shared achievement feeling, community unity, continued engagement
Scenario: Addressing service issues or technical problemsTypical Configuration:
  • 150 XP (goodwill gesture)
  • 400 Points (compensation value)
  • Optional service credit or bonus
Targeting: Affected users or entire communityBenefits: Maintained trust, demonstrated care, customer retention

​
Analytics and Tracking

​
Post-Distribution Monitoring

After executing a gift drop, monitor its impact through your admin analytics: Key Metrics to Track:
  • Distribution Success Rate: Percentage of successful deliveries
  • User Engagement Impact: Activity changes post-distribution
  • Point Economy Effect: Overall point circulation changes
  • Redemption Patterns: How recipients use gifted rewards

​
Success Indicators

Short-term Metrics (24-48 hours):
  • User login rate increase
  • Community activity spike
  • Reward store engagement
  • Social sharing and mentions
Weekly Metrics (7-14 days):
  • Sustained engagement levels
  • Repeat visit frequency
  • Community participation rates
  • User retention improvements
Monthly Metrics (30+ days):
  • Overall community health
  • User lifetime value impact
  • Referral rate changes
  • Brand sentiment improvements

​
Troubleshooting

​
Common Issues and Solutions

Symptoms:
  • Some users didn’t receive rewards
  • Partial distribution completion
  • Error messages during processing
Potential Causes:
  • Invalid user IDs in selection
  • Insufficient reward inventory
  • User account restrictions
  • System processing limits
Solutions:
  • Review failed user IDs in response
  • Check reward supply levels
  • Verify user account status
  • Retry with smaller user batches
Symptoms:
  • Users not appearing in search
  • Cannot add specific users
  • Search results empty or limited
Potential Causes:
  • Users not in selected community
  • Search term formatting issues
  • User privacy settings
  • Account status restrictions
Solutions:
  • Verify community membership
  • Try alternative search terms
  • Check user account status
  • Use email-based search
Symptoms:
  • Cannot select certain rewards
  • Allocation options missing
  • Invalid configuration warnings
Potential Causes:
  • Rewards not active or published
  • Insufficient reward supply
  • Community targeting mismatch
  • Reward type restrictions
Solutions:
  • Verify reward status and supply
  • Check community assignments
  • Review reward configuration
  • Contact support for complex cases

​
Error Messages

Common Error Scenarios: 
// No users selected
"At least one user must be selected"

// No rewards configured
"Please select at least one reward type to distribute"

// Invalid reward amounts
"Amount must be positive"

// Community context missing
"No community selected"

// Distribution processing failed
"Failed to gift rewards: [specific error]"

​
Security and Compliance

​
Access Control

Admin-Only Feature: Gift Rewards is restricted to users with administrative privileges. Ensure proper role-based access control.
Security Measures:
  • Admin authentication required
  • Community-scoped access control
  • Audit logging of all distributions
  • Rate limiting on distribution frequency
  • Input validation and sanitization

​
Data Protection

Privacy Considerations:
  • User data handled according to privacy policies
  • Search functionality respects user visibility settings
  • Distribution logs maintained for compliance
  • Personal information scrubbing in error reports

​
API Integration

For automated or programmatic gift distributions, the Gift Rewards functionality is available through the Admin API: 
POST https://{your-subdomain}.nudj.cx/api/v2/admin/rewards/manual-distribution
Content-Type: application/json
x-api-token: YOUR_API_TOKEN

{
  "userIds": ["user1", "user2", "user3"],
  "communityId": "your-community-id",
  "xpToDistribute": 100,
  "pointsToDistribute": 250,
  "distributionMechanism": "all",
  "amountToDistribute": 1,
  "rewards": [
    {
      "rewardId": "reward-id-1",
      "allocationType": "assets",
      "quantity": 1
    }
  ]
}

​
Automation Examples

Scheduled Welcome Gifts: 
// Automated welcome package for new users
const welcomeNewUsers = async () => {
  const newUsers = await getRecentlyJoinedUsers(7); // Last 7 days

  if (newUsers.length > 0) {
    await adminApi.manualRewardDistribution({
      userIds: newUsers.map(u => u.id),
      communityId: community.id,
      xpToDistribute: 100,
      pointsToDistribute: 500,
      rewards: [{
        rewardId: 'welcome-badge-id',
        allocationType: 'assets',
        quantity: 1
      }]
    });
  }
};
Event Appreciation Automation: 
// Reward event participants automatically
const rewardEventParticipants = async (eventId: string) => {
  const participants = await getEventParticipants(eventId);

  await adminApi.manualRewardDistribution({
    userIds: participants,
    communityId: community.id,
    xpToDistribute: 200,
    rewards: [{
      rewardId: 'event-participation-badge',
      allocationType: 'assets',
      quantity: 1
    }]
  });
};

​
Support and Resources

For additional assistance with Gift Rewards setup or troubleshooting complex distribution scenarios, our support team is available to help.
Support Channels: Additional Resources:
The Gift Rewards feature streamlines community management by enabling efficient, targeted reward distributions that enhance engagement, show appreciation, and build stronger community connections. Use it strategically to maximize its impact on your community’s growth and satisfaction.
⌘I