​
User Activity Reports

User activity reports provide detailed analytics on user engagement patterns, helping administrators track user behavior, identify inactive users, and make informed decisions about user management and retention strategies.
This feature requires Admin API Access Token and provides comprehensive user activity data including read/write actions, timestamps, and engagement metrics.

​
Overview

Last Activity Report

Track user login times, content interactions, and engagement patterns

Engagement Analytics

Analyze user behavior trends and activity patterns

Inactive Users

Identify and manage users who haven’t been active recently

Data Export

Export reports in CSV or JSON format for analysis

​
Report Types

​
Last Activity Report

Comprehensive user activity tracking including:
  • Login Activity: Last login timestamps and frequency
  • Content Interactions: Posts, comments, reactions, and shares
  • Social Actions: Follows, unfollows, and profile updates
  • Chat Activity: Message sending and channel participation
  • Media Engagement: Image/video views and uploads
{
  "userId": "user123",
  "lastActivity": "2024-01-15T10:30:00Z",
  "actions": {
    "login": "2024-01-15T09:00:00Z",
    "lastPost": "2024-01-14T16:45:00Z",
    "lastComment": "2024-01-15T10:15:00Z",
    "lastReaction": "2024-01-15T10:30:00Z"
  },
  "engagementScore": 85,
  "status": "active"
}

​
Generating Reports

1

Authenticate

Obtain an Admin API Access Token from the social.plus Console
2

Configure Report

Specify date ranges, user filters, and report format
3

Request Report

Submit the report generation request via API
4

Download Results

Retrieve the generated report in your preferred format

​
API Implementation

# Generate user activity report
curl -X POST "https://api.amity.co/api/v1/reports/user-activity" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "dateRange": {
      "start": "2024-01-01T00:00:00Z",
      "end": "2024-01-31T23:59:59Z"
    },
    "format": "json",
    "includeInactive": true,
    "groupBy": "daily"
  }'

# Get report status
curl -X GET "https://api.amity.co/api/v1/reports/user-activity/{reportId}" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN"

# Download report
curl -X GET "https://api.amity.co/api/v1/reports/user-activity/{reportId}/download" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -o "user_activity_report.csv"

​
Report Configuration Options

​
Analytics Insights

Engagement Patterns

Identify trends in:
  • Peak activity hours
  • Day-of-week patterns
  • Seasonal variations
  • Feature usage trends

User Segmentation

Segment users by:
  • Activity levels (high, medium, low)
  • Engagement types (creators, consumers, socializers)
  • Retention cohorts
  • Geographic regions

Churn Analysis

Analyze user churn:
  • Inactivity patterns
  • Drop-off points
  • Risk indicators
  • Reactivation opportunities

Growth Metrics

Track growth:
  • New user acquisition
  • User lifecycle stages
  • Feature adoption rates
  • Community health scores

​
Inactive User Management

​
Identifying Inactive Users

1

Define Inactivity

Set criteria for what constitutes “inactive” (e.g., no activity for 30 days)
2

Generate Report

Run user activity report with inactive user filters
3

Analyze Patterns

Look for common characteristics among inactive users
4

Prioritize Actions

Determine which inactive users to target first

​
Data Export and Analysis

​
Best Practices

Data Privacy

  • Compliance: Follow GDPR, CCPA, and other privacy regulations
  • Anonymization: Remove personally identifiable information when possible
  • Access Control: Limit report access to authorized personnel only
  • Retention: Implement data retention policies for reports

Performance

  • Batch Processing: Generate large reports during off-peak hours
  • Caching: Cache frequently requested reports
  • Pagination: Use pagination for large datasets
  • Compression: Compress large exports to reduce bandwidth

​
Troubleshooting

For assistance with report generation or data analysis, contact our support team at [email protected].