Beyond Likes. Into Sales.
Winfluencer Creator Analytics · April 2026
Winfluencer Creator Analytics
App Support Guide
Your complete guide to every feature, tracking methodology, compliance detail, and setup flow within Winfluencer Creator Analytics.
01
App Overview
Winfluencer Creator Analytics is a Shopify embedded app that tracks influencer-driven traffic through the full e-commerce funnel — from the first click on a tracking link through product views, add-to-cart, checkout, and completed purchase. Each influencer receives a unique tracking link. Revenue and conversion metrics are attributed to individual creators using first-party data only — no cookies, no consent banners required.
| Field | Detail |
|---|---|
| App Name | Winfluencer Creator Analytics |
| App URL | https://app.winfluencer.online |
| Category | Store Management › Operations › Analytics |
| Secondary | Marketing and Conversion › Marketing › Marketing - Other |
| Privacy Policy | https://winfluencer.online/privacy-policy/ |
| API Version | 2026-04 |
| Scopes | read_customer_events, write_pixels, write_themes |
| Embedded | Yes — renders inside Shopify Admin iframe |
| Hosting | Vercel serverless (app.winfluencer.online) |
| Database | NeonDB PostgreSQL (US-East-1) |
Key Value Propositions
Full-Funnel Visibility
Visitors → Product Views → Cart → Checkout → Purchase per influencer
Multi-Touch Attribution
Tracks all influencer touches in a visitor's journey before purchase
Product Intelligence
Shows which products each influencer's audience buys vs. just carts
Journey Role Analysis
Classifies each influencer as Introducer, Mid-touch, or Closer
First-Party Only
Uses Shopify cart attributes and Web Pixels API — zero third-party cookies
02
Install & Onboarding Flow
The following steps describe the exact experience a merchant goes through from App Store installation to first tracking link — which reviewers should replicate during testing.
Step-by-Step Install Flow
1
Merchant clicks Install on the App Store listing
2
Shopify redirects to the OAuth consent screen — scopes requested:
read_customer_events, write_pixels, write_themes3
Merchant approves — Shopify redirects to
https://app.winfluencer.online/api/auth4
App creates a Store record in the database with a unique
pixelId5
App automatically registers the Custom Web Pixel extension on the merchant's store
6
Merchant is redirected to the Winfluencer dashboard inside Shopify Admin
7
Dashboard shows a 'Get started' prompt with instructions to enable the App Embed Block in the theme
Theme App Embed Block Activation
8
In Shopify Admin: Online Store → Themes → Customize
9
App Embeds section → Enable 'Winfluencer Tracker'
10
Save the theme. This activates the Liquid snippet that writes the
wf_influencer_id cart attribute when a visitor arrives via a tracking link. One-time setup.
No Code Required. The entire install and setup process requires zero code changes from the merchant. The Web Pixel registers automatically on install. The embed block requires only a toggle in the theme editor.
03
UI Features — Complete Walkthrough
All UI is rendered inside the Shopify Admin embedded iframe using Shopify Polaris components. No external windows or pop-ups are used.
3.1 Main Dashboard (/app)
The main dashboard provides a store-wide overview of all influencer-driven performance. It is the first page shown after install.
Total Revenue
Sum of all influencer-attributed purchase revenue from item_purchased events
Total Visitors
Count of unique sessions from influencer tracking links
Conversion Rate
Percentage of influencer visitors who completed a purchase
Top Product
Product generating the most revenue from influencer traffic
Conversion Funnel — visual progress-bar funnel showing drop-off at each stage:
Visitors100%
›
Product Views~70%
›
Add to Cart~35%
›
Checkout~20%
›
Purchased~8%
Sankey Journey Flow Diagram — a Recharts Sankey diagram showing aggregate multi-touch journey flows between influencers. Node size = influencer; flow width = visitor journey count. Only appears when multi-touch Touchpoint data exists.
Top Influencers Table — top 5 influencers by revenue: Name, Platform, Visitors, Add-to-Cart, Purchases, Revenue, Conversion Rate. Each row links to the influencer profile page.
3.2 Campaigns List (/app/campaigns)
Responsive 3-column card grid. Each card shows: campaign name, status badge (Active / Ended / Upcoming), date range, influencer count, and 4 metrics — Revenue, Conversion Rate, Visitors, Purchases. Clicking a card navigates to the Campaign Detail page.
3.3 New Campaign Form (/app/campaigns/new)
| Field | Detail |
|---|---|
| Campaign Name | Required text field |
| Start Date | Optional date picker |
| End Date | Optional date picker |
| Store URL | Base URL for tracking links (defaults to merchant's store homepage) |
| Influencers | Repeatable rows: Influencer Name, @Handle, Platform (TikTok / Instagram / YouTube / Other). One row minimum required. |
Tracking Link Generation
wfId: crypto.randomUUID().replace(/-/g,'').slice(0,12) // 12-char hex trackingUrl: storeUrl + '?wf_id=' + wfId // Example: // https://my-store.myshopify.com/products/tee?wf_id=a3f9c12b8e4d
3.4 Campaign Detail Page (/app/campaigns/:id)
5 metric cards (Revenue, Visitors, Add-to-Cart, Purchases, Conversion Rate) filtered to campaign influencers. Includes:
| Feature | Description |
|---|---|
| Influencer Breakdown Table | Per-influencer stats — Name, Platform, wfId, Tracking URL (Copy button), all funnel metrics, AOV. Each row links to influencer profile. |
| Add Influencer (Inline) | Expands inline form for adding influencers to existing campaigns. Generates new wfId on submission. |
| Campaign Sankey | Journey flow diagram filtered to this campaign's influencers only. |
| Product Intelligence Table | Products, Variant, Price, Carted, Purchased, Cart-to-Buy Rate, Revenue, Signal (High convert / Price friction / Strong intent / Normal). |
3.5 Influencer Profile Page (/app/campaigns/:campaignId/influencers/:influencerId)
The most detailed view in the app. 6 stat cards: Revenue, Purchases, Conversion Rate, AOV, Visitors, Unique Visitors. Includes tracking link copy button.
| Journey Role | Definition |
|---|---|
| Introducer | First touch in the journey — brought the visitor to the brand |
| Influencer | Middle touch — continued engagement during consideration |
| Closer | Last touch before purchase — converted the visitor |
Also shows: Recent Visitor Journeys (last 10, with sequence + outcome badge), 5-stage conversion funnel, Revenue Breakdown sidebar (AOV, Revenue per Visitor, Top Product, Price Friction warning), and full Product Intelligence table.
04
Tracking System — Technical Deep Dive
4.1 The wf_id Tracking Parameter
Every influencer receives a unique 12-character hex identifier embedded into their tracking link as a URL parameter:
Example Tracking Link
https://my-store.myshopify.com/products/summer-tee?wf_id=a3f9c12b8e4d
4.2 Two-Layer wf_id Persistence
| Layer | Mechanism | How It Works | Survives Checkout? |
|---|---|---|---|
| 1 | Cart Attributes | Embed Block writes wf_influencer_id to Shopify cart.attributes on page load | Yes |
| 2 | Pixel localStorage | Web Pixel reads wf_id from URL on every page view, persists via browser.localStorage (Shopify async API) | Yes |
4.3 Session Management
| Property | Value |
|---|---|
| Session ID source | Shopify cart token › checkout token › crypto-generated fallback |
| Session TTL | 30 minutes of inactivity — reset on every pixel event |
| Persistence | browser.localStorage (wf_session_id) + Shopify cart attributes |
| wf_id TTL | 90 days from first touch — attribution window expires after |
| Journey cap | Maximum 20 influencer touches stored per visitor |
4.4 Events Tracked by the Web Pixel
| Event Type | Data Captured | Funnel Stage |
|---|---|---|
| page_viewed | Page URL | Top of funnel — traffic |
| product_viewed | Product/variant ID, title, price | Product discovery |
| product_added_to_cart | Product/variant, price, quantity | Purchase intent |
| cart_viewed | Cart total, item count | Cart engagement |
| checkout_started | Line items, subtotal (ex. shipping/tax) | Checkout intent |
| checkout_completed | Line items, order ID, subtotal | Confirmed purchase |
| item_purchased | Single line item: price × quantity | Per-product revenue |
Note on item_purchased events. This is not a standard Shopify pixel event. It is generated server-side by the
/api/events handler when a checkout_completed event arrives. One item_purchased record is created per line item — enabling per-product revenue breakdowns without requiring the read_orders scope.
4.5 Multi-Touch Journey Tracking
The pixel maintains a journey array in localStorage containing every influencer touch for a visitor:
localStorage: wf_journey
[
{ "wfId": "a3f9c12b8e4d", "ts": 1712000000000 },
{ "wfId": "d7e2b45f9c1a", "ts": 1712010000000 }
]
This array is sent with every pixel event. The /api/events handler creates Touchpoint records for each entry with touchIndex and touchTotal. This powers the Sankey diagram and Introducer/Influencer/Closer role analysis.
05
Shopify App Store Compliance
5.1 API Scopes — Justification
| Scope | Justification | Status |
|---|---|---|
| read_customer_events | Required to receive Shopify Analytics pixel events via the Web Pixels API | Pass |
| write_pixels | Required to register and deploy the Custom Web Pixel extension | Pass |
| write_themes | Required to install the App Embed Block into the merchant's active theme | Pass |
| read_orders (NOT requested) | Not needed — revenue computed from pixel events, not Shopify orders | N/A |
| read_customers (NOT requested) | Not needed — no customer PII stored | N/A |
5.2 GDPR Mandatory Webhooks
All three mandatory GDPR webhooks are implemented and registered declaratively in shopify.app.toml:
| Webhook | Implementation | Status |
|---|---|---|
| customers/data_request | Logs request, returns 200. No PII stored so nothing to export. | Pass |
| customers/redact | Deletes Order records matching customer's Shopify order IDs. Returns 200. | Pass |
| shop/redact | Immediately deletes Events, Touchpoints, Orders, TeamMembers. Soft-deletes Store (sets deletedAt). Campaign/Influencer data retained 30 days then purged. | Pass |
5.3 Privacy & Data Handling
| Requirement | Implementation | Status |
|---|---|---|
| No PII collected | No customer names, emails, phone numbers, or addresses stored | Pass |
| Anonymous identifiers only | wf_id (brand-created), session ID (cart token or crypto-generated) | Pass |
| Cart attributes classification | wf_influencer_id and wf_session_id are functional data — no consent banner required | Pass |
| No cookie consent required | All tracking uses first-party functional data and Shopify's own analytics infrastructure | Pass |
| No data selling | Privacy policy explicitly states data is not sold, rented, or shared | Pass |
| Data residency disclosed | NeonDB (AWS US-East-1) — stated in privacy policy | Pass |
| 30-day data retention on delete | Soft-delete on uninstall, hard-delete after 30 days | Pass |
5.4 Web Pixel Compliance Settings
| Setting | Value |
|---|---|
| runtime_context | strict — most restrictive sandbox mode |
| analytics | true — required for storefront event subscriptions |
| marketing | true — required for attribution pixel use case |
| sale_of_data | not_enabled — Winfluencer does not sell visitor data |
5.5 App URLs — No Prohibited Words
| Route | URL | Status |
|---|---|---|
| Application URL | https://app.winfluencer.online | Pass |
| Auth Redirect URL | https://app.winfluencer.online/api/auth | Pass |
| App Proxy URL | https://app.winfluencer.online/api | Pass |
| Event Ingestion URL | https://app.winfluencer.online/api/events | Pass |
| No 'shopify' in domain | Custom domain app.winfluencer.online used | Pass |
06
Test Credentials & Setup Guide
Before You Begin. After installation, the App Embed Block must be enabled in your active theme (Online Store → Themes → Customize → App Embeds → Enable 'Winfluencer Tracker'). This is a one-time step that takes approximately 30 seconds.
6.1 Test Store Access
| Field | Detail |
|---|---|
| Shopify Dev Store URL | Provided in the app submission form |
| Admin login email | Provided in the app submission form |
| Admin login password | Provided in the app submission form |
| App install URL | https://app.winfluencer.online |
6.2 Testing the Full Tracking Flow
1
Install the app and enable the embed block in the theme
2
Open the Winfluencer dashboard inside Shopify Admin
3
Create a new campaign: name it 'Review Test', add one influencer (any name/handle/platform)
4
Copy the generated tracking link from the influencer row
5
Open the tracking link in an incognito browser window — simulates an influencer's follower clicking their link
6
Browse a product page, add to cart, proceed to checkout, complete a purchase using Shopify's Bogus Gateway for test payments
7
Return to the dashboard — event data should appear within 10–30 seconds
8
Click into the campaign → click the influencer name → verify funnel, revenue, and journey data
6.3 Verification Checklist
| Requirement | Implementation | Status |
|---|---|---|
| Authenticates immediately after install | OAuth flow completes and redirects to /app dashboard | Pass |
| Redirects to app UI immediately | After auth, merchant lands on dashboard with no extra steps | Pass |
| Mandatory compliance webhooks | customers/data_request, customers/redact, shop/redact all registered | Pass |
| HMAC webhook verification | All handlers use authenticate.webhook from Shopify SDK | Pass |
| Valid TLS certificate | app.winfluencer.online has valid SSL via Vercel | Pass |
| Embedded app checks | Renders inside Shopify Admin iframe using App Bridge | Pass |
07
Technical Architecture Summary
FrontendReact Router v7 (SSR, file-based routing)
UI LibraryShopify Polaris — native embedded app design system
BackendNode.js serverless functions (Vercel)
ORMPrisma 6 (type-safe PostgreSQL queries)
DatabaseNeonDB PostgreSQL serverless (US-East-1)
HostingVercel — atomic deploys, global CDN, auto-scaling
Shopify SDKshopify-app-react-router (OAuth, sessions, webhooks, App Bridge)
Pixel Ext.Custom Web Pixel (web_pixel_extension, strict runtime)
Theme Ext.App Embed Block (wf-tracker.liquid)
ChartsRecharts (Sankey diagram, ProgressBar)
Source CtrlGitHub (auto-deploys to Vercel on push to main)
App Proxy/apps/winfluencer/* → /api/* on Vercel
7.1 Webhook Routes
| Route | Purpose |
|---|---|
| /webhooks/app/uninstalled | Deletes merchant session on app uninstall |
| /webhooks/app/scopes_update | Updates stored session scopes when app scopes change |
| /webhooks/customers/data_request | GDPR: logs request, returns 200 (no PII stored) |
| /webhooks/customers/redact | GDPR: deletes Order records for the customer |
| /webhooks/shop/redact | GDPR: full data deletion on shop removal (30-day soft delete) |
7.2 API Routes
| Route | Purpose |
|---|---|
| /api/auth | Shopify OAuth entry point |
| /api/auth/callback | Shopify OAuth callback — creates/updates Store record |
| /api/events | Public event ingestion endpoint (POST) — receives pixel events |
| /api/* | App Proxy target — routes storefront API calls |
7.3 Data Flow Summary
1
Visitor clicks influencer tracking link (
?wf_id=abc123)2
Embed Block (Liquid) writes
wf_id to Shopify cart attributes3
Web Pixel initializes: reads
wf_id, creates session ID, loads journey array from localStorage4
Pixel fires events (
page_viewed, product_viewed, checkout_completed…) to /api/events5
API handler resolves influencer from
wf_id, creates Event + Touchpoint records in NeonDB6
Merchant dashboard queries Event/Touchpoint tables in real-time for all analytics
No Shopify Orders API Required. Revenue is computed entirely from
item_purchased events (expanded from checkout_completed line items). This means no read_orders scope is needed — a deliberate privacy-by-design decision that also avoids Protected Customer Data approval requirements.
— Winfluencer Creator Analytics · App Support Guide · April 2026