RevenueCat to Meta Conversions API.
Send RevenueCat subscriptions and purchases to Meta so app ads optimize on paying users. Each one reaches your Meta Pixel or app with the install attached.
What gets sent.
| DATALYR event | When it fires | Sent to Meta as | What it carries |
|---|---|---|---|
| trial_started | A trial begins | StartTrial | The trial, with no value |
| subscription_started | The first paid subscription purchase | Subscribe or Purchase | Gross value in USD, before tax and store commission, and the install's device context |
| trial_converted | A trial turns into a paid subscription | Purchase | Gross value in USD, before tax and store commission |
| subscription_renewed | A subscription renews. Optional rule | Purchase | Gross value in USD, before tax and store commission |
How it's matched.
DATALYR checks these in order and stops at the first one that finds the ad click.
- The datalyr_id subscriber attribute set by the app
- The $email subscriber attribute
- Each alias on the RevenueCat event
- The install you bound to the RevenueCat user ID
Meta gets the click ID (fbc, built from the _fbc cookie or fbclid) and browser ID (fbp), plus email, phone and name hashed with SHA-256 when known. DATALYR sends the same event ID the browser pixel uses, so Meta merges the pair into one conversion.
How it works.
- 01
Connect RevenueCat.
Open Sources, select connect on RevenueCat, enter your project ID, store app IDs and a webhook secret, then paste the webhook URL and secret into RevenueCat. Set the datalyr_id subscriber attribute before you show a paywall.
- 02
Connect Meta.
Open Sources, select connect on Meta Ads and sign in with Facebook Login for Business. Set the primary ad account. In Conversions, select manage rules, then new rule: trigger event subscription_started, target platform Meta, your pixel, platform event Subscribe or Purchase. Set value to dynamic. RevenueCat sends USD, so build the rule on the USD value.
- 03
Check one conversion.
Complete one real App Store purchase from a Meta ad install. Find subscription_started in Events, then open the newest row in Conversions and read the reply from Meta.
Check it worked.
- In Events, the visitor_id does not start with revenuecat_. That prefix means the identity link did not land: set datalyr_id before the paywall, or bind the RevenueCat user ID after both SDKs start.
- Set a Test Events code on the rule, then select send test event. The event shows in Events Manager under Test events with the name, value and currency you mapped. Without a code, a test is a real conversion.
- Open the newest row in Conversions. Its status reads sent, and the response body carries Meta's own acceptance field.
Questions, answered.
Contact usA mobile-only rule needs the install's device context. app_context_not_configured means the subscriber has no datalyr_id, so set it before the paywall. app_identity_unavailable means the source has no store app IDs: add your bundle ID or package name and its RevenueCat app ID in Sources.
USD. RevenueCat converts before it sends, so the event currency is always USD. The value is gross, before tax and store commission. The net figure is stored on the event as net_revenue if you want to build a rule on it.
iOS 2.1.16 or later and React Native 1.7.21 or later. Earlier releases send the wrong ID. From iOS 2.1.19 and React Native 1.7.24, syncRevenueCatAttributes registers the attributes once and keeps them current.

See what really drives revenue.
Real-time attribution, analytics and conversions for every channel, campaign and ad, ready for your team and your agents.