Analytics & Reporting

Comprehensive performance metrics and insights

System Overview Analytics

GET /api/v1/affiliate/analytics/overview/

Query Parameters

Parameter Type Description
date_from date Start date
date_to date End date
granularity string day, week, month

Example Response

{
  "success": true,
  "data": {
    "period": {
      "start_date": "2024-01-01",
      "end_date": "2024-01-31",
      "duration_days": 31
    },
    "overview": {
      "total_affiliates": 450,
      "active_affiliates": 320,
      "total_clicks": 125000,
      "total_conversions": 8500,
      "conversion_rate": 6.8,
      "total_revenue": 1750000.00,
      "total_commissions": 175000.00,
      "average_order_value": 205.88
    },
    "top_performers": [
      {
        "affiliate_id": 123,
        "affiliate_name": "John Smith",
        "sales": 25000.00,
        "commissions": 3750.00,
        "conversions": 145
      }
    ],
    "trends": {
      "daily_revenue": [],
      "daily_clicks": [],
      "conversion_rates": []
    }
  }
}

Custom Report Generation

POST /api/v1/affiliate/analytics/custom/

Request Body

{
  "report_type": "affiliate_performance",
  "date_range": {
    "start_date": "2024-01-01",
    "end_date": "2024-01-31"
  },
  "filters": {
    "affiliate_tiers": [2, 3, 4],
    "min_sales": 1000.00,
    "product_categories": ["courses", "ebooks"]
  },
  "metrics": ["sales", "commissions", "clicks", "conversions"],
  "format": "json"
}