Pixels App QA

Overview

The Pixel Manager app (/business/apps/pixels) lets users create and manage tracking pixels for 10 platforms (Facebook, Google Analytics, Google Tag Manager, TikTok, Snapchat, Pinterest, LinkedIn, Twitter, Quora, Custom), assign them to biolink pages and short links, and manage their status.

Supported pixel types:

Type Key	Display Label
facebook	Facebook Pixel
google_analytics	Google Analytics
google_tag_manager	Google Tag Manager
tiktok	TikTok Pixel
snapchat	Snapchat Pixel
pinterest	Pinterest Tag
linkedin	LinkedIn Insight
twitter	Twitter Pixel
quora	Quora Pixel
custom	Custom Script

Routes under test:

Route	Purpose
/business/apps/pixels	Dashboard with stats and pixel list
/business/apps/pixels/new	Create a new pixel
/business/apps/pixels/[id]	View pixel details and assignments
/business/apps/pixels/settings	Settings (placeholder)

---

Dashboard

ID	Description	Preconditions	Steps	Expected Result	Priority
PX-001	Dashboard loads stats	User has pixels	1. Navigate to /business/apps/pixels	Four stat cards: Total Pixels, Active, Inactive, Assignments	P0
PX-002	Inactive count calculation	User has both active and inactive pixels	1. Navigate to dashboard	Inactive count equals total_pixels - active_pixels	P1
PX-003	Pixel grid renders	User has pixels	1. Navigate to /business/apps/pixels	Grid of pixel cards showing name, status badge (green for active, gray for inactive), type label, and pixel ID (monospace)	P0
PX-004	Empty pixel list	User has no pixels	1. Navigate to /business/apps/pixels	Empty state with code icon and “No tracking pixels yet” message	P1
PX-005	Add Pixel button navigates	User is on dashboard	1. Click “Add Pixel”	Navigates to /business/apps/pixels/new	P1
PX-006	Settings button navigates	User is on dashboard	1. Click “Settings” button	Navigates to /business/apps/pixels/settings	P2
PX-007	Pixel card navigates to detail	Pixels exist	1. Click on a pixel card	Navigates to /business/apps/pixels/[id]	P0

---

Create Pixel

ID	Description	Preconditions	Steps	Expected Result	Priority
PX-010	Create Facebook Pixel	User is authenticated	1. Navigate to /business/apps/pixels/new 2. Enter name “My FB Pixel” 3. Select type “Facebook Pixel” 4. Enter pixel ID “123456789012345” 5. Click “Create Pixel”	Redirected to /business/apps/pixels; new pixel appears in grid	P0
PX-011	Create Google Analytics pixel	User is authenticated	1. Select type “Google Analytics” 2. Enter ID “G-XXXXXXXXXX” 3. Create	Pixel created with correct type and ID	P0
PX-012	Create Google Tag Manager pixel	User is authenticated	1. Select type “Google Tag Manager” 2. Enter ID “GTM-XXXXXXX” 3. Create	Pixel created	P1
PX-013	Create TikTok Pixel	User is authenticated	1. Select type “TikTok Pixel” 2. Enter tracking ID 3. Create	Pixel created	P1
PX-014	Create Snapchat Pixel	User is authenticated	1. Select type “Snapchat Pixel” 2. Enter tracking ID 3. Create	Pixel created	P2
PX-015	Create Pinterest Tag	User is authenticated	1. Select type “Pinterest Tag” 2. Enter tracking ID 3. Create	Pixel created	P2
PX-016	Create LinkedIn Insight	User is authenticated	1. Select type “LinkedIn Insight” 2. Enter tracking ID 3. Create	Pixel created	P2
PX-017	Create Twitter Pixel	User is authenticated	1. Select type “Twitter Pixel” 2. Enter tracking ID 3. Create	Pixel created	P2
PX-018	Create Quora Pixel	User is authenticated	1. Select type “Quora Pixel” 2. Enter tracking ID 3. Create	Pixel created	P2
PX-019	Create Custom Script pixel	User is authenticated	1. Select type “Custom Script” 2. Enter script ID or code 3. Create	Pixel created	P1
PX-020	Placeholder updates on type change	User is on create form	1. Select “Facebook Pixel” from type dropdown	Pixel ID placeholder changes to “e.g. 123456789012345” 2. Switch to “Google Analytics”	Placeholder changes to “e.g. G-XXXXXXXXXX”
PX-021	Validation — empty name	User is on create form	1. Leave name blank 2. Click “Create Pixel”	Validation error on name field	P0
PX-022	Validation — no type selected	User is on create form	1. Enter name but skip type 2. Click “Create Pixel”	Validation error on type field	P0
PX-023	Validation — empty pixel ID	User is on create form	1. Enter name and type but leave pixel ID blank 2. Click “Create Pixel”	Validation error on pixel_id field	P0
PX-024	Cancel returns to dashboard	User is on create form	1. Click “Cancel”	Navigates to /business/apps/pixels	P2

---

Pixel Detail

ID	Description	Preconditions	Steps	Expected Result	Priority
PX-030	Detail page loads	Pixel exists	1. Navigate to /business/apps/pixels/[id]	Header shows pixel name and type label with monospace pixel ID; Details card shows Status, Type, Tracking ID, Created date	P0
PX-031	Status badge color	Pixel exists	1. Navigate to pixel detail	Active pixels show green badge; inactive pixels show gray badge	P1
PX-032	Assignments section — empty	Pixel has no assignments	1. Navigate to pixel detail	”This pixel has not been assigned to any pages or links yet.” message displayed	P1
PX-033	Assignments section — with assignments	Pixel is assigned to a biolink or short link	1. Navigate to pixel detail	Assignments listed with target_app badge and target_id; “Remove” button visible for each	P0
PX-034	Assign to Page/Link button visible	Pixel detail is open	1. Observe the Assignments card header	”Assign to Page/Link” button is displayed	P1
PX-035	Edit button visible	Pixel detail is open	1. Observe the header buttons	”Edit” button is displayed	P1
PX-036	Delete button visible	Pixel detail is open	1. Observe the header buttons	Red “Delete” button with trash icon is displayed	P1
PX-037	Non-owner cannot access pixel	Pixel belongs to another user	1. Navigate to pixel detail as a different user	403 Forbidden error	P1

---

Settings

ID	Description	Preconditions	Steps	Expected Result	Priority
PX-040	Settings page loads	User is authenticated	1. Navigate to /business/apps/pixels/settings	Page shows “No configurable settings yet” message	P2
PX-041	Back button navigates	User is on settings page	1. Click back arrow	Navigates to /business/apps/pixels	P2