Pixel Manager

The Pixel Manager app lets users create and manage tracking pixels from various advertising and analytics platforms. Pixels can be assigned to specific bio links or short links for conversion tracking and audience building.

Key Features

Multi-platform support — Facebook Pixel, Google Analytics, Google Tag Manager, TikTok, Snapchat, Pinterest, LinkedIn Insight, Twitter, Quora, and custom scripts
Pixel assignments — attach pixels to specific bio links or short links
Active/inactive status toggle for each pixel
Dashboard stats — total pixels, active count, inactive count, and total assignments
Settings page for global pixel configuration

Page Structure

Route	Purpose
`/business/apps/pixels`	Dashboard with stats and pixel grid
`/business/apps/pixels/new`	Create a new pixel
`/business/apps/pixels/[id]`	Pixel detail with assignments
`/business/apps/pixels/settings`	Global pixel settings

Data Model Overview

Pixel

Each pixel has a name, type (one of the supported platforms), pixel_id (the platform-specific tracking ID), status (active or inactive), and a metadata JSON field.

PixelAssignment

Links a pixel to a target: target_app (biolinks or shortlinks) and target_id (the specific link’s ID).

PixelWithAssignments

Composite type combining a pixel with its assignments array for detail views.

Supported Pixel Types

Type	Label	Example ID Format
`facebook`	Facebook Pixel	`123456789012345`
`google_analytics`	Google Analytics	`G-XXXXXXXXXX`
`google_tag_manager`	Google Tag Manager	`GTM-XXXXXXX`
`tiktok`	TikTok Pixel	`CXXXXXXXXXXXXXXXXX`
`snapchat`	Snapchat Pixel	`xxxxxxxx-xxxx-xxxx-xxxx`
`pinterest`	Pinterest Tag	`1234567890123`
`linkedin`	LinkedIn Insight	`1234567`
`twitter`	Twitter Pixel	`xxxxx`
`quora`	Quora Pixel	`xxxxxxxxxxxxxxxx`
`custom`	Custom Script	Tracking ID or script

These are defined in $lib/apps/pixels/constants.ts via the PIXEL_TYPE_CONFIG mapping.

Key Components

Stats grid — four cards: Total Pixels, Active, Inactive (computed as total minus active), and Assignments
Pixel grid — responsive card layout (1/2/3 columns) with each card showing pixel name, active/inactive badge (green/gray), human-readable type label from PIXEL_TYPE_CONFIG, and the raw pixel_id in monospace
Empty state — centered code icon with a prompt to add the first pixel
Settings link — prominent outline button in the header

Notable Integrations

Services: getStats and listPixels from $lib/apps/pixels/services
Constants: PIXEL_TYPE_CONFIG from $lib/apps/pixels/constants for mapping type keys to display labels and placeholder text
Target apps: Pixels are scoped to biolinks and shortlinks — the two apps that support pixel injection
Database: Stored in a separate ext_pixels schema