Documentation Index
Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
Use this file to discover all available pages before exploring further.
The Short Version
For stores flagged under Meta’s Health & Wellness category, Upstack Data operates in server-side-only mode — meaning the Facebook browser pixel (the JavaScript snippet that normally runs on your website) is completely removed. All event data is sent directly from Upstack’s servers to Meta through the Conversions API (CAPI). This gives Upstack complete control over what data reaches Meta, which is the foundation of the entire Health & Wellness solution.Why the Browser Pixel Is a Problem for H&W Stores
The standard Meta pixel is a JavaScript snippet that runs in your customer’s browser. When someone visits your store, the pixel automatically reads information from the page and sends it to Meta. This includes:-
The page URL (e.g.,
yourstore.com/products/organic-ashwagandha-supplement) - The page title (e.g., “Organic Ashwagandha Supplement - 60 Capsules”)
- Product data embedded in the page (names, descriptions, categories)
- Referrer URLs that may contain health-related search terms
- Content IDs and other metadata tied to your product catalog
- Reinforce the flag, making it harder to resolve
- Trigger a re-flag if you’ve set up a new pixel
- Reduce Event Match Quality as Meta discards or downgrades events it considers non-compliant
How Server-Side-Only Mode Works
When Upstack activates the Health & Wellness container, the tracking flow changes completely:Standard Tracking (Browser + Server)
In a normal Upstack setup, events are sent two ways:- Browser pixel fires in the customer’s browser and sends data directly to Meta
- Server-side (CAPI) sends the same event from Upstack’s servers to Meta
event_id so Meta deduplicates them into a single event. This redundancy improves match rates and ensures events aren’t lost to ad blockers or browser restrictions.
Health & Wellness Mode (Server-Only)
In H&W mode, the Meta browser pixel is removed entirely:Customer actions are captured
Customer actions (page views, add to cart, purchases) are captured by Upstack’s Theme App Extension on your store.
Data is sanitized
Upstack processes and sanitizes the data (see the Data Sanitization article).
What Data Gets Sent to Meta
In server-side-only mode, Upstack sends only what Meta needs for attribution and optimization: Always sent:- Event type — the action that occurred (mapped to a custom H&W event name)
- Event time — when the action happened
-
User identifiers — hashed email, hashed phone number, Facebook click ID (
fbclid), and browser ID (fbp) for matching the event to a Meta user - Event source URL — the alias domain URL (not your real store URL)
- Value — the purchase amount or cart value
- Currency — e.g., USD
- Product names, descriptions, or categories
- Real page URLs from your flagged domain
- SKUs, product IDs, or catalog data
- Any content that could contain health/wellness keywords
Why CAPI-Only Still Works for Optimization
A common concern is that removing the browser pixel will hurt performance. In practice, for H&W flagged stores, the opposite is true. The browser pixel was already compromised. Once a store is flagged, Meta restricts what it does with browser pixel data from that domain. In many cases, browser events are partially or fully ignored for optimization. Removing a data source that Meta is already discounting doesn’t hurt you — it removes a liability. CAPI events are treated as higher quality. Server-side events carry hashed first-party data (email, phone) that provides stronger identity matching than cookies alone. Meta’s own documentation recommends CAPI as the primary data source, with the browser pixel as a supplement. Event Match Quality stays strong. EMQ depends on the quality of user identifiers (email, phone, click ID), not on the transmission method. Upstack captures these identifiers at key moments (checkout, account creation) and sends them via CAPI. Most Upstack H&W customers see EMQ scores comparable to or better than their pre-flag performance. The flag was the real performance killer. The biggest optimization hit comes from the flag itself — restricted audiences, blocked events, degraded delivery. By going server-side only with clean data from an unflagged domain, you’re restoring what the flag took away.How This Differs from Standard CAPI Setups
Not all server-side tracking is the same. Here’s how Upstack’s H&W implementation differs from a standard CAPI setup:Feature | Standard CAPI | Upstack H&W (Server-Only) |
Browser pixel active | Yes (redundant tracking) | No (completely removed) |
Data sanitization | No | Yes (keywords, URLs, product data stripped) |
Event source URL | Your real domain | Clean alias domain |
Event names | Standard Meta events | Custom H&W event mappings |
Product data sent | Yes (content_ids, content_name) | No (stripped before sending) |
What You Need to Do
Nothing — Upstack handles this automatically when the Health & Wellness container is activated during your onboarding call. The browser pixel removal, CAPI-only routing, and data processing all happen on Upstack’s side.Watch for other tracking tools. Any active browser pixel — from Shopify’s native integration, Triple Whale Sonar, Elevar, or hardcoded JavaScript — will send unsanitized data to Meta and undermine the server-side-only approach. Make sure all other Meta pixel sources are disabled.