Ads tracking
Operational+34% avg ROAS visibility
LoyalFans to Snapchat Conversions API
Server-side conversion tracking for every LoyalFans subscription, Video Store clip, Audio Store track, Go Live tip and One on One call.
Architecture
Browser click (scclid) -> loyalfansapi.com tracking link (stores scclid, IP, UA) -> LoyalFans checkout (subscription, store, tip, call) -> LoyalFans API webhook engine (net = gross * 0.80, event_id) -> Snapchat Conversions API
Parameter capture matrix
| Parameter | Source | Required |
|---|---|---|
| scclid | Landing URL query | Yes |
| _scid | Snap Pixel cookie | Recommended |
| client_ip_address | Tracking link request | Yes |
| client_user_agent | Tracking link request | Yes |
Event mapping
| LoyalFans event | Snapchat event |
|---|---|
| New subscription | SUBSCRIBE |
| Store purchase, tip or call | PURCHASE |
Net value calculation
Conversion Value = Gross Amount * 0.80
Reflects the LoyalFans 80/20 creator payout so ROAS matches what the creator actually earns. A $50 purchase reports $40.
Deduplication strategy
event_id = hash(order_id + event_name)
Deterministic IDs (UUIDv5) mean retries and browser + server double-fires are counted once.
Code examples
curl -X POST https://api.loyalfansapi.com/v1/ads/snapchat/events \
-H "Authorization: Bearer sk_live_..." \
-d '{"event_type":"PURCHASE","order_id":"ord_9912","gross":50.00,"scclid":"8f1c..."}'Testing checklist
Use Snapchat Events Manager Test Events with your Pixel ID, then trigger a sandbox purchase from the LoyalFans API dashboard.
Troubleshooting
| Issue | Fix |
|---|---|
| 401 from Snapchat | Regenerate the Conversions API token in Snapchat Business Manager and update it in LoyalFans API. |
| Events not attributed | Confirm the tracking link stores scclid before redirecting to LoyalFans. |
Ship your first LoyalFans integration today.
Free trial, sandbox keys in minutes, no credit card. Questions? hello@loyalfansapi.com
Start for free