Workspace, Brand Rooms & Scoping
Navigate organizations, single-parent Brand Rooms, Meta Ad Account selectors, and faceted scope filters.
AdHelix utilizes a hierarchical, tenant-isolated architecture. Every page, metric, heatmap, and queue is dynamically scoped to your active Organization, Brand Room, and Ad Account.
1. The 3-Tier Scoping Hierarchy
graph TD
Org["🏢 Level 1: Organization<br/>(Master Billing, Stripe Wallet, Team Admin)"]
Brand1["🏷️ Level 2: Brand Room A<br/>(DTC Beauty Brand)"]
Brand2["🏷️ Level 2: Brand Room B<br/>(Apparel Sub-Brand)"]
AdAcc1["📈 Level 3: Meta Ad Account 1<br/>(US Prospecting)"]
AdAcc2["📈 Level 3: Meta Ad Account 2<br/>(EU Scale)"]
Org --> Brand1
Org --> Brand2
Brand1 --> AdAcc1
Brand1 --> AdAcc2- Level 1: Organization (L1)
- Top-level corporate umbrella (e.g. your company or agency).
- Manages billing subscriptions, token wallets, and team member access.
- Level 2: Brand Room (L2)
- Dedicated workspace for an individual brand, client, or e-commerce store.
- Enforces single-parent ownership and isolated brand profiles (taxonomy, logo gallery, target KPIs).
- Level 3: Meta Ad Account (L3)
- Specific Meta Ads Manager account (
act_...). - Drives all campaign data, retention decay curves, and creative libraries.
- Specific Meta Ads Manager account (
2. Global Navigation & Core Modules
The left navigation sidebar is divided into four functional sections:
| Section | Routes | What You Do Here |
|---|---|---|
| 1. Overview | / Dashboard, /brand-dna | Monitor high-level KPI cards, recent analyses, and overall brand visual signature |
| 2. Ingestion | /campaigns, /creatives, /assets, /analysis | Browse Meta campaigns, manage synced media assets, and track queue processing |
| 3. Insights | /impact-heatmap, /timeline-dna, /element-performance, /playbook, /sequencer | Run causal TreeSHAP heatmaps, millisecond retention diagnostics, and recipe sequencing |
| 4. Settings | /settings/account, /settings/brand-rooms, /settings/team, /settings/billing | Manage subscriptions, token budgets, member roles, and Meta integrations |
3. Faceted Scope Filter Bar
When analyzing large ad accounts with hundreds of campaigns, use the Faceted Scope Filter Bar at the top of performance views to isolate specific segments:
- Objective: Filter by
OUTCOME_SALES,OUTCOME_LEADS,OUTCOME_TRAFFIC, orOUTCOME_AWARENESS. - Audience: Isolate Broad Targeting, Lookalike Audiences, or Retargeting Custom Audiences.
- Geography: Segment by Country code (e.g.
US,GB,DE,CH). - Demographics: Filter by Gender and Age cohorts.
- Placement: Segment by Feed, Stories, Reels, or Audience Network.