Analytics

All analytics endpoints require JWT authentication and an app_id query parameter.

GET /api/v1/analytics/dashboard

Get KPIs and time-series data.

Authentication: JWT required


curl "https://api.attributehq.com/v1/analytics/dashboard?app_id=YOUR_APP_ID&start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Query Parameters:

Param	Required	Description
`app_id`	Yes	App UUID
`start_date`	Yes	ISO 8601 datetime
`end_date`	Yes	ISO 8601 datetime

Response:


{
  "success": true,
  "data": {
    "kpis": {
      "total_installs": 12500,
      "paid_installs": 8200,
      "organic_installs": 4300,
      "total_revenue": 5250000,
      "average_cpi": 150,
      "conversion_rate": 3.2
    },
    "timeSeries": [
      {
        "date": "2025-01-01",
        "installs": 420,
        "paid_installs": 280,
        "organic_installs": 140,
        "revenue": 175000
      }
    ]
  }
}

GET /api/v1/analytics/sources

Attribution breakdown by media source.


curl "https://api.attributehq.com/v1/analytics/sources?app_id=YOUR_APP_ID&start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response includes per-source: installs, revenue, CPI, conversion rate.

GET /api/v1/analytics/campaigns

Campaign performance metrics.


curl "https://api.attributehq.com/v1/analytics/campaigns?app_id=YOUR_APP_ID&start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response includes per-campaign: installs, cost (if imported), CPI, revenue, ROAS.

GET /api/v1/analytics/retention

Cohort retention analysis (D1, D7, D30).


curl "https://api.attributehq.com/v1/analytics/retention?app_id=YOUR_APP_ID&start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response includes: retention rates by cohort date and day (D1, D7, D30).

GET /api/v1/analytics/revenue

Revenue and LTV analytics.


curl "https://api.attributehq.com/v1/analytics/revenue?app_id=YOUR_APP_ID&start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response includes: total revenue, ARPU, LTV by media source.

GET /api/v1/analytics/attribution

Attribution details with multi-touch model support.


curl "https://api.attributehq.com/v1/analytics/attribution?app_id=YOUR_APP_ID&start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z&model=last-touch" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Additional Parameters:

Param	Required	Default	Description
`model`	No	`last-touch`	`last-touch`, `first-touch`, `linear`, `time-decay`

GET /api/v1/analytics/export

Export analytics data as CSV.


curl "https://api.attributehq.com/v1/analytics/export?app_id=YOUR_APP_ID&start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z&type=installs" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -o export.csv

Additional Parameters:

Param	Required	Description
`type`	Yes	`installs`, `events`, `revenue`

Response: CSV file download.