Fierce Mobile Game API - Admin Panel User Guide

Complete guide for managing your game's backend administration

Table of Contents

Getting Started

Accessing the Admin Panel

  1. Open your web browser
  2. Navigate to: http://localhost/fierce-mobile-api/admin/
  3. Default login credentials:
    • Username: admin
    • Password: admin123

System Requirements

  • XAMPP/Apache server running
  • PHP 7.4+ with PDO extension
  • MySQL database connection
  • Web browser (Chrome, Firefox, Safari, Edge)

Initial Configuration

Before using the admin panel:

  1. Ensure database is properly connected
  2. Import the database schema (database/schema.sql)
  3. Configure system settings (see System Settings section)
  4. Set up AdMob credentials for revenue tracking

Dashboard Overview

The Dashboard is your central hub for monitoring the game's performance and status.

Key Metrics Cards

Total Users

Number of registered players

Pending Withdrawals

Withdrawal requests awaiting approval

Total Payouts

Total amount paid to users

Total Balance

Combined user wallet balances

Quick Charts

  • Daily Activity: User engagement over time
  • Revenue Trends: Financial performance tracking

Navigation Menu

  • Dashboard: Main overview page
  • Withdrawal Requests: Manage user payout requests
  • Users: View and manage player accounts
  • Analytics: Detailed reports and insights
  • Settings: System configuration

Withdrawal Management

This section handles all user withdrawal requests and payouts.

Viewing Withdrawal Requests

Request Information Displayed

  • User Details: Username and email
  • Amount: Requested withdrawal amount
  • Payment Method: PayPal, bank transfer, etc.
  • Payment Address: User's payment details
  • Status: Pending, Approved, Rejected, Completed
  • Date: When the request was submitted

Status Types

Pending: New requests awaiting review
Approved: Approved but payment not yet sent
Completed: Payment processed successfully
Rejected: Request denied

Processing Withdrawals

Step-by-Step Process

1. Review Request
  • Verify user has sufficient balance
  • Check payment details are valid
  • Ensure compliance with minimum/maximum limits
2. Approve Request
  • Click "Approve" button next to the request
  • System automatically deducts amount from user balance
  • Status changes to "Approved"
3. Process Payment
  • Send payment via external payment processor
  • Update status to "Completed" once payment is sent
  • Add transaction reference if available
4. Reject Request (if necessary)
  • Click "Reject" button
  • Provide reason for rejection
  • User balance remains unchanged

Withdrawal Settings

Configure withdrawal parameters in Settings:

  • Minimum Amount: Lowest allowed withdrawal
  • Maximum Amount: Highest allowed withdrawal
  • Processing Fee: Percentage fee charged
  • Enable/Disable: Turn withdrawal system on/off

User Management

Monitor and manage all registered players.

User Information View

Each user profile shows:

Basic Info: Username, email, registration date
Financial Data: Current balance, total earned, total withdrawn
Activity Stats: Playtime, last login, session count
AdMob Earnings: Revenue from ad interactions

User Actions

View Details
Suspend Account
Ban User
Adjust Balance
Reset Password
Filter Users

User Filtering

  • Filter by account status
  • Search by username or email
  • Sort by balance, earnings, or activity

Analytics & Reports

Comprehensive reporting and analytics dashboard.

Key Performance Indicators (KPIs)

Daily Active Users

Players active each day

New User Registrations

Growth tracking

Average Session Duration

Engagement metric

User Retention Rate

Player return percentage

Revenue per User

Monetization efficiency

Game Completion Rate

Success metric

Charts and Graphs

1. Daily Activity Chart

  • • User engagement over last 7 days
  • • Peak usage times identification

2. Revenue Distribution

  • • AdMob earnings vs. gameplay earnings
  • • Revenue source breakdown

3. Playtime Distribution

  • • Session length analysis
  • • User engagement patterns

4. User Growth Trends

  • • Registration patterns
  • • Retention analysis

Data Export

  • Export analytics data to CSV
  • Generate custom date range reports
  • Schedule automated reports (if configured)

System Settings

Configure all system parameters and game economics.

Financial Settings

Earning Rate

Money earned per minute of gameplay

Minimum Withdrawal

Lowest payout amount allowed

Maximum Withdrawal

Highest payout amount allowed

Withdrawal Fee

Percentage charged on withdrawals

Daily Earning Limit

Maximum earnings per user per day

Race Completion Bonus

Extra earnings for finishing races

AdMob Configuration

App IDs (Required for AdMob initialization)

  • • Android App ID: Your AdMob Android app identifier
  • • iOS App ID: Your AdMob iOS app identifier

Ad Unit IDs

Android
Banner Ad Unit ID
Interstitial Ad Unit ID
Rewarded Ad Unit ID
iOS
Banner Ad Unit ID
Interstitial Ad Unit ID
Rewarded Ad Unit ID

Revenue Settings

  • AdMob User Share: Percentage of ad revenue given to users
  • Revenue Tracking: Enable/disable automatic revenue recording

System Controls

Withdrawals Enabled

Turn withdrawal system on/off

New User Registration

Allow/block new signups

Maintenance Mode

Disable API access temporarily

Saving Settings

  1. Modify desired settings values
  2. Click "Save Settings" button
  3. Changes apply immediately
  4. Restart game clients if needed for certain changes

Common Tasks

Daily Admin Routine

Morning Checklist

  1. Check Dashboard - Review overnight activity
  2. Process Withdrawals - Handle pending requests
  3. Review New Users - Check for suspicious accounts
  4. Monitor Analytics - Identify any unusual patterns

Weekly Tasks

  1. Analyze Performance - Review weekly analytics
  2. Adjust Settings - Optimize earning rates if needed
  3. User Account Review - Check for inactive accounts
  4. System Backup - Backup database and settings

Managing High-Volume Periods

  • Monitor server performance during peak times
  • Adjust earning limits if necessary
  • Process withdrawals more frequently
  • Watch for unusual activity patterns

Handling User Issues

1. Balance Disputes

  • Check user session history
  • Verify calculation accuracy
  • Make manual adjustments if warranted

2. Withdrawal Problems

  • Verify payment information
  • Check processing limits
  • Provide clear rejection reasons

3. Technical Support

  • Check system logs for errors
  • Verify database connectivity
  • Monitor API response times

Troubleshooting

Common Issues and Solutions

Dashboard Not Loading Data

Symptoms: Empty stats cards, no chart data

Solutions:

  1. Check database connection in config/database.php
  2. Verify PHP PDO extension is enabled
  3. Check file permissions on API files
  4. Review browser console for JavaScript errors

Withdrawal Processing Errors

Symptoms: Cannot approve/reject withdrawals

Solutions:

  1. Verify database write permissions
  2. Check user balance calculations
  3. Ensure withdrawal limits are properly set
  4. Review PHP error logs

Settings Not Saving

Symptoms: Changes revert after saving

Solutions:

  1. Check database write permissions
  2. Verify POST request is being sent
  3. Check for PHP execution errors
  4. Ensure form validation is passing

Users Section Empty

Symptoms: No users displayed

Solutions:

  1. Verify users exist in database
  2. Check API endpoint /admin/api/admin_users.php
  3. Review database query permissions
  4. Check for PHP syntax errors

Analytics Charts Not Displaying

Symptoms: Empty chart areas

Solutions:

  1. Ensure Chart.js library is loading
  2. Check data format from analytics API
  3. Verify JavaScript console for errors
  4. Check network requests for API failures

Issue Categories

Database Issues

  • • Connection Failed
  • • Table Missing
  • • Permission Denied
  • • Data Corruption

Performance Issues

  • • Slow Loading
  • • High Memory Usage
  • • Timeout Errors
  • • API Delays

Security Concerns

  • • Unauthorized Access
  • • Suspicious Activity
  • • API Abuse
  • • Data Integrity

Best Practices

Security

  • • Change default admin credentials
  • • Use strong passwords
  • • Regular database backups
  • • Monitor for unusual activity
  • • Keep software updated

Operations

  • • Process withdrawals promptly
  • • Monitor user feedback
  • • Adjust settings based on usage
  • • Regular performance reviews
  • • Document custom changes

Data Management

  • • Regular database backups
  • • Monitor storage usage
  • • Archive old data periodically
  • • Maintain data integrity checks