DATALYR

Superwall to Meta Conversions API.

Send Superwall 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.

What DATALYR sends from Superwall to Meta Conversions API
DATALYR eventWhen it firesSent to Meta asWhat it carries
trial_startedA trial beginsStartTrialThe trial, with no value
subscription_startedThe first paid subscription purchaseSubscribe or PurchaseGross value in USD, before tax and store commission, and the install's device context
trial_convertedA trial turns into a paid subscriptionPurchaseGross value in USD, before tax and store commission
subscription_renewedA subscription renews. Optional rulePurchaseGross 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.

  1. The datalyr_id user attribute set by the app
  2. The email user attribute
  3. The original app user ID, unless it is a Superwall alias
  4. The install you bound to the Superwall 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.

  1. 01

    Connect Superwall.

    Open Sources, select connect on Superwall, enter your bundle ID and whsec_ webhook secret, then paste the webhook URL into Superwall. Set the datalyr_id user attribute before you present a paywall.

  2. 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. Superwall sends USD, so build the rule on the USD value.

  3. 03

    Check one conversion.

    Complete one production purchase through a Superwall paywall 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 superwall_. That prefix means the app never set datalyr_id or bound the Superwall user ID.
  • 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.

View docsSuperwallMeta AdsConversion delivery

Questions, answered.

Contact us
  • No. Sandbox purchases never appear in DATALYR, so test with one production purchase through a Superwall paywall. Set a Test Events code on the Meta rule so the test is not a billable conversion.

  • USD. Superwall 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.

  • DATALYR counts revenue once. If both are connected, one is your revenue source and the other is recorded at $0. RevenueCat is the default, and you can change it in Settings, General, Mobile revenue authority.

See what really drives revenue.

Real-time attribution, analytics and conversions for every channel, campaign and ad, ready for your team and your agents.

Get started