> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thetinybell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

> Events tracked by the TinyBell pixel.

## Event types

The pixel automatically tracks these events:

| Event        | When it fires                                                 |
| ------------ | ------------------------------------------------------------- |
| `impression` | A notification is displayed to the visitor                    |
| `click`      | The visitor clicks the CTA button                             |
| `close`      | The visitor closes/dismisses the notification                 |
| `conversion` | The visitor completes the desired action (e.g. submits email) |

## Event payload

Each event sends the following data:

```json theme={null}
{
  "type": "click",
  "notification_id": 42,
  "campaign_id": 7,
  "url": "https://www.myhotel.com/rooms",
  "referrer": "https://www.google.com/",
  "device_type": "desktop",
  "os_name": "Windows",
  "browser_name": "Chrome",
  "country_code": "ES",
  "visitor_id": "v_abc123def456"
}
```

## Visitor identification

TinyBell uses a first-party cookie (`altumcode_pixel_key`) to identify returning visitors. This cookie:

* Is set on the hotel's domain (first-party)
* Expires after 365 days
* Contains only a random visitor ID
* Does not store personal information

## Statistics

All events are aggregated in the **Statistics** section of your dashboard:

* **Impressions**: Total views per notification
* **Clicks**: Total CTA clicks
* **CTR**: Click-through rate
* **Conversions**: Form submissions (collector notifications)
* **Breakdown by**: day, device, browser, country, page URL

## Data retention

Event data is retained for 12 months. Aggregated statistics are kept indefinitely.