# Event Tracking

Use `allegro.track()` to record events. The SDK handles session creation, device identification, and page metadata collection automatically.

## Basic Usage[​](#basic-usage "Direct link to Basic Usage")

```js
window.allegro.push(function (allegro) {
    allegro.track('page_view');
});

```

## `allegro.track(eventName, data?)`[​](#allegrotrackeventname-data "Direct link to allegrotrackeventname-data")

Track an event. Returns a promise that resolves with `{ event_id: string }`.

The SDK automatically:

* Creates a session if one doesn't exist
* Includes device ID, session ID, and CSRF token
* Collects page metadata from the DOM (title, content type, publisher, etc.)
* Attaches the logged-in customer ID if available

### With event data[​](#with-event-data "Direct link to With event data")

```js
allegro.track('article_read', {
    content_id: 'article-456',
    content_type: 'premium',
    publisher: 'Daily News',
});

```

### With custom data[​](#with-custom-data "Direct link to With custom data")

```js
allegro.track('purchase', {
    data: {
        product_id: 'sku-789',
        price: 9.99,
        currency: 'USD',
    },
});

```

### Available fields[​](#available-fields "Direct link to Available fields")

| Field              | Type                      | Description                          |
| ------------------ | ------------------------- | ------------------------------------ |
| `url`              | `string`                  | Page URL (auto-collected by default) |
| `referer`          | `string`                  | Referring URL                        |
| `page_title`       | `string`                  | Page title                           |
| `content_type`     | `string`                  | Content type (e.g. article, video)   |
| `content_id`       | `string`                  | Content identifier                   |
| `publisher`        | `string`                  | Publisher name                       |
| `object_type`      | `string`                  | Object type                          |
| `object_id`        | `string`                  | Object identifier                    |
| `context`          | `string`                  | Context or category                  |
| `conversion_pv_id` | `string`                  | Conversion page view ID              |
| `url_in_click`     | `string`                  | Clicked URL                          |
| `data`             | `Record<string, unknown>` | Arbitrary custom data                |

For more information, see [Page Metadata](/developer/guides/page-metadata.md).

## Session & Device Management[​](#session--device-management "Direct link to Session & Device Management")

The SDK manages two cookies:

| Cookie               | Lifetime   | Purpose                                  |
| -------------------- | ---------- | ---------------------------------------- |
| `allegro_device_id`  | 10 years   | Persistent device identifier (UUID v4)   |
| `allegro_session_id` | 30 minutes | Session identifier, extended on activity |

Sessions are created automatically on the first `track()` or `member.login()` call. Each `track()` call extends the session timeout.