💰 Revenue Attribution
Understand exactly which social posts are driving real sales. OmniSocial AI connects the dots between social engagement and e-commerce revenue using UTM-based tracking and multi-touch attribution.
How Attribution Works​
- Link tagging — OmniSocial AI automatically appends UTM parameters to links in your posts
- Click tracking — When a user clicks through, the UTM data travels with them to your store
- Order matching — When a purchase happens, the CommerceOrder record captures UTM fields (
utmSource,utmMedium,utmCampaign,utmContent,utmTerm) along withreferrerUrlandlandingPage - Attribution calculation — The RevenueAttribution model matches orders to posts and assigns credit
The RevenueAttribution model handles the mapping between orders and posts:
| Field | Description |
|---|---|
attributionModel | The model used (first-touch, last-touch, multi-touch) |
attributionWeight | Weight assigned to this touchpoint (0–1, sums to 1 across touchpoints) |
revenue | Revenue credited to this touchpoint |
matchedField | Which UTM field matched (e.g., utmContent, utmCampaign) |
matchedValue | The actual value that was matched |
Revenue Dashboard​
View your complete revenue picture at Analytics > Revenue (GET /commerce/revenue/dashboard):
| Metric | Description |
|---|---|
| Total Social Revenue | Sum of all revenue attributed to social posts |
| Revenue by Platform | Breakdown by Instagram, Facebook, TikTok |
| Revenue by Post | Which individual posts drove the most sales |
| Top Revenue Content | Ranked list of highest-earning content |
| Conversion Funnel | Impression → Click → Purchase pipeline |
Per-Post Revenue​
Every post with attributed sales shows detailed revenue data from the PostRevenue model:
| Field | Description |
|---|---|
totalRevenue | Total revenue attributed to this post |
totalOrders | Number of orders from this post |
totalUnits | Total product units sold |
avgOrderValue | Average order value |
conversionRate | Click-to-purchase conversion rate |
roas | Return on ad spend (if the post was boosted) |
Access per-post revenue via GET /commerce/revenue/posts/:postId, or see it inline on the Post Analytics page.
Additional Revenue Endpoints​
| Endpoint | Method | Description |
|---|---|---|
/commerce/revenue/dashboard | GET | Full revenue dashboard data |
/commerce/revenue/posts/:postId | GET | Revenue for a specific post |
/commerce/orders | GET | Browse attributed orders |
/commerce/segments | GET | Revenue segmented by audience, campaign, or platform |
/commerce/coupons | GET | Track coupon code performance |
Customer Segments​
The segmentation endpoint (GET /commerce/segments) lets you analyze revenue by:
- Platform — Which social platform drives the highest-value customers?
- Campaign — Which campaign generated the most revenue?
- Content type — Do product posts or lifestyle posts convert better?
- Audience segment — Which customer cohorts are most valuable?
Coupon Tracking​
If you use coupon codes in your social posts, the coupons endpoint (GET /commerce/coupons) tracks:
- Redemption count per coupon code
- Revenue generated per coupon
- Which posts distributed each coupon
- Conversion rate by coupon
Use unique coupon codes per post or campaign for granular attribution. This provides a secondary attribution signal alongside UTM tracking, covering cases where users don't click through directly.
KPI Tracking & Alerts​
Set revenue KPIs and track progress against them. The AI monitors your trajectory and alerts you when:
- You're on track to exceed your revenue target
- You're falling behind and need to adjust strategy
- A specific post or campaign is significantly over- or under-performing
These insights also feed into the AI Advisor for strategic recommendations.
Revenue attribution requires an e-commerce store connection. Make sure your store integration is active and UTM parameters are flowing correctly through your checkout.
Related Pages​
- Connect Stores — Set up your e-commerce integration
- Product Posts — Generate revenue-driving content from your catalog
- Post Analytics — See revenue alongside engagement metrics
- Dashboard — Revenue overview in the main analytics view
- Auto-Boost & Ads — Maximize ROAS by boosting high-converting posts