# Administrator Guide

Welcome to Onisokien Links.

## Link Types

1. **Short Link**: A simple redirect from a short code to a long destination URL.
2. **Smart Link**: A dynamic link that redirects users to different destinations based on their device:
   - **iOS/App Store URL**: For users on iPhones and iPads.
   - **Android/Google Play URL**: For users on Android devices.
   - **Web Fallback URL**: For desktop users, bots, and unknown devices.

## Creating and Editing Links

- Go to the **Dashboard** and click **Create Link**.
- Choose your **Link Type**.
- Enter an **Internal Name** to identify the link later.
- For **Custom Alias**, you can leave it blank to automatically generate a unique 5-character code (e.g., `a7k3q`), or you can specify your own (e.g., `summer-sale`).
- To change destinations later, click **Edit** on a link. The public short link stays the same, but visitors will instantly route to the new destinations.

## Link Statuses

- **Active**: Link works normally.
- **Inactive**: Link is manually disabled and shows a 404 Not Found page.
- **Scheduled**: Link has a future start date. Shows 404 until then.
- **Expired**: Link has passed its expiry date. Shows a 410 Gone page.
- **Archived**: Link is permanently removed from active rotation. Shows a 410 Gone page. The alias remains blocked from reuse.

## Analytics

- **Human Clicks**: Total clicks excluding known bots (crawlers, social previewers, uptime checkers).
- **Total Requests**: Includes both humans and bots.
- **Referrers**: The website the user clicked from.
- **Campaigns/Sources**: Extracted from standard UTM parameters.

### Privacy and Retention
We do not store raw IP addresses. IP addresses are instantly hashed using a one-way secure function solely to prevent click fraud/spam. Click data is automatically purged after the retention period (default 365 days).