Operational+34% avg ROAS visibility

LoyalFans to Google Ads Enhanced Conversions

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 (gclid)
   -> loyalfansapi.com tracking link (stores gclid, IP, UA)
   -> LoyalFans checkout (subscription, store, tip, call)
   -> LoyalFans API webhook engine (net = gross * 0.80, event_id)
   -> Google Ads Enhanced Conversions

Parameter capture matrix

Parameter	Source	Required
gclid	Landing URL query	Yes (web)
wbraid / gbraid	Landing URL query (iOS)	When present
hashed email	Enhanced conversions user data	Recommended

Event mapping

LoyalFans event	Google Ads event
New subscription	Subscribe conversion action
Store purchase, tip or call	Purchase conversion action
Refund / chargeback	Conversion adjustment (RETRACTION)

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/google/conversions \
  -H "Authorization: Bearer sk_live_..." \
  -d '{"conversion_action":"purchase","order_id":"ord_9912","gross":50.00,"gclid":"Cj0KCQ..."}'

Testing checklist

Check the upload diagnostics under Goals > Conversions in Google Ads. Uploads appear within a few hours; use Tag Assistant to confirm the gclid is captured.

Troubleshooting

Issue	Fix
Conversion not found for gclid	The click must be under 90 days old and from the same Google Ads account.
Duplicate uploads	Google deduplicates on order_id; always send the LoyalFans transaction ID.

Ship your first LoyalFans integration today.

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

Start for free