Connect your Meta Ads account
Once connected, the dashboard pulls live campaign data, parses it by product category, and calculates ROAS for each collection.
Build a campaign name
Names are auto-recognised and categorised in the dashboard
Naming structure
OF_
DR/TP/DN/AC_
CONV/RETARG…_
COLD/WARM…_
FB/IG/META_
v1/v2…
Generated names
How the dashboard recognises this campaign
When Meta syncs a campaign named , the dashboard reads the second segment () and automatically assigns it to .
Connect Meta Ads in Integrations to see your campaigns here.
Product collections
These categories are used across naming, campaign parsing, and the tracker
How codes work
Each product has a 2–3 letter code. Campaigns named OF_CODE_… are automatically categorised in the dashboard.
Changing a code here updates the naming generator and campaign filter instantly. Existing campaign data is re-categorised on the next sync.
GA4 connection
Cross-reference ad revenue with on-site e-commerce data
UTM parameters
Use these exact UTM values so GA4 correctly attributes paid traffic from named campaigns.
utm_source
facebook / instagram
utm_medium
paid_social
utm_campaign
OF_{{CATEGORY}}_{{OBJECTIVE}}_{{BUDGET}}_{{VERSION}}
utm_content (ad level)
OF_{{CATEGORY}}_{{OBJECTIVE}}_{{AUDIENCE}}_{{PLATFORM}}_{{FORMAT}}_{{VERSION}}
Data mapping
Purchase revenue
purchase event with item_category matching product codes for per-category revenue.Sessions
Filter by
source/medium = paid_social to reconcile with Meta spend by campaign name.ROAS comparison
Meta-reported vs GA4-reported ROAS side-by-side to spot attribution gaps.
Funnel events
view_item → add_to_cart → checkout → purchase tracked per product category.GA4 preview
Demo data| Product | Sessions | Txns | Revenue | Conv% |
|---|---|---|---|---|
| DR | 4,210 | 148 | LKR 740,000 | 3.5% |
| TP | 2,890 | 97 | LKR 485,000 | 3.4% |
| DN | 3,540 | 131 | LKR 655,000 | 3.7% |
| AC | 1,760 | 58 | LKR 290,000 | 3.3% |
Meta Ads
Connect your Meta Business ad account to pull live campaign data
Not connected
Enter your Meta Ads API credentials. Found in Meta Business Manager under Business Settings → Users → System Users.
Security note: Your access token is encrypted and stored securely in Firebase database (not in browser storage). Each user can only access their own credentials. Use a System User token with
ads_read permissions only.
WordPress
Connect your WordPress store to fetch total revenue data
Not connected
Enter your WordPress site details and WooCommerce API credentials.
Security note: Your API credentials are encrypted and stored securely in Firebase database (not in browser storage). Each user can only access their own credentials. Generate API keys in WordPress under WooCommerce → Settings → Advanced → REST API.
Google Analytics 4
Pull e-commerce revenue and session data from GA4