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

# Directory Analytics

> Analytics and reporting for business directory performance

Track directory engagement, company visibility, and lead generation metrics.

## Key Metrics

<CardGroup cols={4}>
  <Card title="Total Listings">Active companies</Card>
  <Card title="Profile Views">Total views</Card>
  <Card title="Leads Generated">Contact submissions</Card>
  <Card title="Search Queries">Directory searches</Card>
</CardGroup>

## Reports

### Engagement Report

* Views per listing
* Search appearances
* Click-through rates

#### Acceptance Criteria

##### Frontend

* [ ] Engagement Report workflow is implemented in the UI as described.

##### Backend / API

* [ ] Backend behavior supports Engagement Report as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

### Lead Report

* Leads by company
* Conversion rates
* Response times

#### Acceptance Criteria

##### Frontend

* [ ] Lead Report workflow is implemented in the UI as described.

##### Backend / API

* [ ] Backend behavior supports Lead Report as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

### Category Performance

* Popular categories
* Category growth
* Search trends

#### Acceptance Criteria

##### Frontend

* [ ] Category Performance workflow is implemented in the UI as described.

##### Backend / API

* [ ] Backend behavior supports Category Performance as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

## Features

### Directory Analytics

#### Acceptance Criteria

##### Frontend

* [ ] UI supports the workflows described in this feature.

##### Backend / API

* [ ] Backend behavior supports this feature as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

## Implementation Contracts

### Backend (API)

```
GET /api/directory/analytics/summary         # Summary metrics
GET /api/directory/analytics/engagement      # Engagement report
GET /api/directory/analytics/leads           # Lead report
GET /api/directory/analytics/categories      # Category performance
POST /api/directory/analytics/export         # Export report
```