Operational+34% avg ROAS visibility

LoyalFans to Meta Pixel + 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 (fbclid)
   -> loyalfansapi.com tracking link (stores fbclid, IP, UA)
   -> LoyalFans checkout (subscription, store, tip, call)
   -> LoyalFans API webhook engine (net = gross * 0.80, event_id)
   -> Meta Pixel + Conversions API

Parameter capture matrix

Parameter	Source	Required
fbclid	Landing URL query	Yes
_fbc	Cookie built from fbclid	Yes
_fbp	Meta Pixel browser cookie	Recommended
client_ip_address	Tracking link request	Yes
client_user_agent	Tracking link request	Yes

Event mapping

LoyalFans event	Meta event
New subscription	Subscribe
Video Store / Audio Store purchase	Purchase
Go Live tip / One on One 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/meta/events \
  -H "Authorization: Bearer sk_live_..." \
  -d '{
    "event_name": "Purchase",
    "order_id": "ord_9912",
    "gross": 50.00,
    "fbc": "fb.1.1712.IwAR...",
    "fbp": "fb.1.1712.98123"
  }'

Testing checklist

Use a test_event_code from Meta Events Manager, then confirm the event appears under Test Events with Deduplicated status when the browser Pixel fires the same event_id.

Troubleshooting

Issue	Fix
Event shows Not deduplicated	Send the same event_id from Pixel and CAPI. Use hash(order_id + event_name).
Low Event Match Quality	Include _fbc, _fbp, client IP and user agent captured by the tracking link.
Value looks too high	Confirm net mode is enabled so the value equals gross multiplied by 0.80.

Ship your first LoyalFans integration today.

Free trial, sandbox keys in minutes, no credit card. Questions? hello@loyalfansapi.com

Start for free