Two of the most important concepts in Upstack Data are destinations and data sources (referred to in the dashboard as Sources). They sound similar but serve opposite functions — and understanding the difference is essential for setting up your account correctly and getting accurate attribution data.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 core distinction
Destinations
Platforms Upstack sends event data to. When a customer views a product, adds to cart, or purchases, Upstack captures the event, enriches it with identity data, and pushes it to your destinations via server-side APIs.
Data sources (Sources)
Platforms Upstack pulls data from for reporting and analytics. To show which campaigns are driving revenue and at what cost, Upstack pulls in your ad spend, impressions, and click data from each platform.
- Destinations = Upstack pushing data OUT (events going to ad platforms and marketing tools).
- Sources = Upstack pulling data IN (spend and performance data for your dashboard).
Why the distinction matters
You might wonder why these are separate. After all, Meta is both a destination (Upstack sends purchase events to it) and a source (Upstack pulls spend data from it). They’re configured separately because they serve different purposes and require different permissions:- Sending events (destination) requires write access to a platform’s conversion API — like Meta CAPI or Google Ads offline conversions. This is about feeding the ad platform real-time conversion data for optimization.
- Pulling spend data (source) requires read access to a platform’s reporting API. This is about bringing performance data into Upstack’s attribution dashboard so you can see the full picture in one place.
Available destinations
Destinations receive enriched event data from Upstack via server-side APIs. Each destination gets relevant ecommerce events along with identity parameters for user matching.| Destination | API used | Events sent | Identity data sent |
|---|---|---|---|
| Meta CAPI | Conversions API | Purchase, AddToCart, ViewContent, InitiateCheckout, custom events | Hashed email, phone, name, IP, user agent, fbclid, fbp |
| Google Ads | Offline / Enhanced Conversions | Purchase, conversion events | gclid, hashed email, phone |
| TikTok | Events API | Purchase, AddToCart, ViewContent, funnel events | Hashed email, phone, IP, user agent, ttclid |
| Conversions API | Purchase, AddToCart, ViewContent | Hashed email, click ID, IP, user agent | |
| Klaviyo | Klaviyo API | Browse, cart, purchase events for flow triggering | Email, customer properties, event metadata |
| Snapchat | Conversions API | Purchase, conversion events | Hashed email, phone, IP, click ID |
| Omnisend | Omnisend API | Browse, cart, purchase events | Email, customer properties, event metadata |
| Webhooks | Custom HTTP | Any configured event | Full enriched payload |
GA4 is no longer a supported destination for new connections and is being deprecated.
Available data sources
Data sources provide Upstack with the information it needs to build your attribution dashboard and calculate key metrics like ROAS.| Data source | Data pulled | Used for |
|---|---|---|
| Shopify | Orders, revenue, products, customer data, refunds | Revenue attribution, order-level reporting, customer classification (new vs returning) |
| Facebook Ads (Meta) | Campaign spend, impressions, clicks, campaign/ad set/ad structure | ROAS calculation, spend-to-revenue comparison, campaign-level attribution |
| Google Ads | Campaign spend, impressions, clicks, campaign structure | ROAS calculation, spend-to-revenue comparison, campaign-level attribution |
| TikTok | Campaign spend, impressions, clicks, campaign structure | ROAS calculation, spend-to-revenue comparison, campaign-level attribution |
How they work together
The real power of Upstack comes from destinations and sources working in tandem:Events go OUT via destinations
A customer makes a purchase. Upstack captures the event, enriches it with identity data, and sends it to Meta via CAPI, Google via offline conversions, and any other connected destinations.
Spend data comes IN via sources
Upstack pulls your daily ad spend, campaign structure, and performance metrics from Meta, Google, TikTok, and Shopify.
The attribution dashboard combines both
Upstack’s Analytics matches revenue from Shopify orders (attributed through its own model) against spend data from your ad platforms. This gives you a unified view: how much you spent on each channel, how much revenue each channel drove, and your true ROAS — without relying on each platform’s self-reported numbers.
Setup priority order
If you’re configuring Upstack for the first time, here’s the recommended order:Phase 1 — Critical (Day 1)
- Meta as a destination — get enriched events flowing to your highest-spend platform.
- Google Ads as a destination — second-highest priority for most brands.
- Shopify as a source — usually connected automatically during installation.
Phase 2 — Important (Day 1–2)
- Meta as a source — pull spend data so your dashboard can calculate ROAS.
- Google Ads as a source — same reason.
- Klaviyo as a destination — if you use Klaviyo for email/SMS marketing.
Common confusion
I connected Facebook — why don't I see spend data?
I connected Facebook — why don't I see spend data?
Connecting Facebook as a destination (Meta CAPI) only sets up event sending. You also need to connect Facebook Ads as a source to pull in spend and campaign data for your attribution dashboard.
My attribution dashboard shows revenue but no ROAS
My attribution dashboard shows revenue but no ROAS
ROAS requires both revenue data (from Shopify) and spend data (from ad platform sources). If you haven’t connected your ad platforms as sources, Upstack can’t calculate ROAS. See Attribution and reporting.
Do I need to connect Shopify as a destination?
Do I need to connect Shopify as a destination?
No. Shopify is a source — Upstack pulls order data from it. Shopify isn’t a destination because you don’t send tracking events to Shopify; events originate from Shopify.
Frequently asked questions
Can a platform be both a destination and a source?
Can a platform be both a destination and a source?
Yes. Meta, Google Ads, and TikTok are all both destinations (Upstack sends events to them) and sources (Upstack pulls spend data from them). They’re configured separately because they use different APIs and permissions.
What happens if I only connect destinations but not sources?
What happens if I only connect destinations but not sources?
Your ad platforms will receive enriched event data and optimize more effectively, but your Upstack attribution dashboard won’t be able to show spend or calculate ROAS. You’ll still see revenue attribution, but without the cost side of the equation.
What happens if I only connect sources but not destinations?
What happens if I only connect sources but not destinations?
Your Upstack dashboard will show spend data, but your ad platforms won’t receive enriched server-side events from Upstack. You’d miss out on improved match quality, better optimization signals, and the core value of server-side tracking.
Do sources update in real time?
Do sources update in real time?
Ad spend data is typically pulled on a regular schedule (daily or more frequently) rather than in real time. There may be a short delay between when spend occurs on the ad platform and when it appears in your Upstack dashboard.
Related
Destinations overview
Every supported destination and its configuration options.
Sources overview
Every supported data source and how each one is connected.
Connect a destination
Step-by-step setup for your first destination.
Attribution and reporting
How Upstack combines event data and spend data to attribute revenue.
What are destinations?
A focused deep-dive on destinations.
What are data sources?
A focused deep-dive on sources.