Spooky Analytics

API Key

App ID (for headers)

Integration Guide

Send analytics events from your app to Spooky Analytics. Choose your platform below.

1. Endpoint

Send a POST request to:

POST /v1/events

Base URL is provided in your project settings.

2. Request Body Format

{
  "request_id": "UUID — unique per batch for idempotency",
  "app_id": "your.app.bundle.id",
  "user_id": "user_or_device_id",
  "session_id": "s_UUID",
  "platform": "ios | android | web",
  "app_version": "1.2.3",
  "country": "US",
  "language": "en",
  "events": [
    {
      "event_name": "level_complete",
      "event_time": 1706000120,
      "params": { "level": 5, "score": 980 }
    }
  ]
}

3. Send Events — Code Snippets

4. Session Management

Sessions are defined by user activity with an inactivity timeout (default: 2 minutes). No explicit session_end event is required.

For each event:

Check if current_time - last_event_time > SESSION_TIMEOUT
If yes → generate a new session_id (UUID prefixed with s_)
If no → reuse the current session_id
Update last_event_time

5. Batching & Offline Queue

Setting	Recommended
Batch size	50 events
Batch interval	30 seconds
Offline queue max	10,000 events / 5 MB
Offline max age	7 days
Retry attempts	3 (exponential backoff: 5s, 15s, 60s)

6. Predictions API

Request ML-powered purchase predictions for a user. Recommended: once daily on app open, cache for 24h.

GET /v1/predictions/{user_id}

Header:  X-App-Id: your.app.bundle.id

Response:

{
  "user_id": "user_123",
  "segment": "HOT | WARM | COLD | null",
  "purchase_probability_7d": 0.85,
  "probability_percentile": 0.95
}

Segment	Meaning	Suggested Action
HOT	Top 5% — high purchase probability	Show special offer
WARM	Top 20% — medium probability	Show promo on exit
COLD	Rest — low probability	Standard UX

7. Response Codes

Code	Meaning	Action
200	Success	Remove events from queue
400	Invalid request	Don't retry — fix data
401	Unauthorized	Check API key
429	Rate limit	Retry after `Retry-After`
500	Server error	Retry with backoff

Analytics so accurate,
it's spooky

PM as a Service

Event Evaluation

Predictive Analytics

Startup-Friendly

Ready to see what your players are really doing?

Your Apps

New App

Integration Guide

1. Endpoint

2. Request Body Format

3. Send Events — Code Snippets

4. Session Management

5. Batching & Offline Queue

6. Predictions API

7. Response Codes

PM as a Service

Event Evaluation

Predictive Analytics

Startup-Friendly

Ready to see what your players are really doing?

Your Apps

New App

Integration Guide

1. Endpoint

2. Request Body Format

3. Send Events — Code Snippets

4. Session Management

5. Batching & Offline Queue

6. Predictions API

7. Response Codes

Sign In