---
title: analytics.trackEvent
url: https://docs.kaltura.com/docs/rich-media-cms-apis/analytics/analytics-events-track-event
---

## analytics.trackEvent

Application-level event tracking for page loads, button clicks, and custom interactions. Uses a separate analytics server endpoint.

**Required Parameters**

| Parameter | Type | Required | Description |
|---|---|---|---|
| `eventType` | int | Yes | Event type ID: `10002` (ButtonClicked) or `10003` (PageLoad) |
| `partnerId` | int | Yes | Your Kaltura partner ID |
| `entryId` | string | No | Kaltura entry ID to associate the event with (recommended for content-scoped tracking) |
| `kalturaApplication` | string | No | Application identifier for per-app segmentation (e.g., `"events-portal"`, `"mobile-app"`) |

```bash
curl -X POST "$KALTURA_ANALYTICS_URL/api_v3/index.php?service=analytics&action=trackEvent" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "eventType=10003" \
  -d "partnerId=$KALTURA_PARTNER_ID" \
  -d "entryId=$KALTURA_ENTRY_ID" \
  -d "kalturaApplication=my-portal"
```

### Event Types

| Type ID | Name | Description |
|---------|------|-------------|
| 10002 | ButtonClicked | User clicked a UI element |
| 10003 | PageLoad | Page or view was loaded |

### Additional Fields

| Field | Description | Example |
|-------|-------------|---------|
| `kalturaApplication` | Application identifier for segmentation | `"events-portal"`, `"mobile-app"` |
| `pageType` | Page category | `"lobby"`, `"session"`, `"sponsor-booth"` |
| `pageName` | Specific page name | `"keynote-2025"` |
| `buttonType` | Button category | `"cta"`, `"download"`, `"share"` |
| `buttonName` | Specific button name | `"register-now"`, `"download-slides"` |

### Tracking Page Loads and CTA Clicks

```bash
# Track portal page load
curl -X POST "$KALTURA_ANALYTICS_URL/api_v3/index.php?service=analytics&action=trackEvent" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "eventType=10003" \
  -d "partnerId=$KALTURA_PARTNER_ID" \
  -d "entryId=$KALTURA_ENTRY_ID" \
  -d "kalturaApplication=events-portal" \
  -d "pageType=lobby" \
  -d "pageName=main-lobby"

# Track CTA button click
curl -X POST "$KALTURA_ANALYTICS_URL/api_v3/index.php?service=analytics&action=trackEvent" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "eventType=10002" \
  -d "partnerId=$KALTURA_PARTNER_ID" \
  -d "entryId=$KALTURA_ENTRY_ID" \
  -d "kalturaApplication=events-portal" \
  -d "buttonType=cta" \
  -d "buttonName=register-now"
```