RevenueCat

TrueOrigin reads your purchases from a RevenueCat webhook. Two parts: the webhook, and one line in your app that ties RevenueCat’s customer to the install.

1. Connect the webhook

In the dashboard, Settings → RevenueCat → Connect RevenueCat. You get a Webhook URL and an Authorization header. The header is shown once.
In RevenueCat, Integrations → Webhooks, add a webhook with that URL, and paste the whole header value, including Bearer , as the Authorization header.
Send all events.

No RevenueCat API key is needed. App Store events count; Android and web purchases arriving on the same webhook are acknowledged and dropped. If you lose the header, Issue new credentials in Settings and update it in RevenueCat. The old header stops working at once.

2. Set the attributes in your app

After configuring both SDKs, and before any paywall:

Purchases.shared.attribution.setAttributes(TrueOrigin.revenueCatAttributes())

// optional: campaign attributes for RevenueCat targeting, once attribution resolves
TrueOrigin.onAttribution { attribution in
    Purchases.shared.attribution.setAttributes(attribution.revenueCatAttributes)
}

import Purchases from 'react-native-purchases'

Purchases.configure({ apiKey: 'appl_…' })
await Purchases.setAttributes(TrueOrigin.revenueCatAttributes())

TrueOrigin.onAttribution(() => {
  Purchases.setAttributes(TrueOrigin.revenueCatAttributes())
})

Repeat the first call on every app start and after each successful RevenueCat logIn or logOut. It returns right away, makes no network request, and always includes trueorigin_install_id, even while the attribution is pending. It does not change the RevenueCat App User ID; keep your own. Once the install is matched, the attributes also carry the campaign:

Attribute
`trueorigin_install_id`	Always. Ties RevenueCat’s customer to the install.
`trueorigin_match_status`	`matched`, `unmatched`, …
`trueorigin_media_source`	The ad network.
`trueorigin_campaign`, `trueorigin_adset`, `trueorigin_ad`	From the ad’s URL parameters.

You can use them in RevenueCat for targeting and experiments.

What gets counted

RevenueCat event	TrueOrigin
Initial purchase with a free trial	Trial started
First renewal after a trial	Trial converted
Initial purchase without a trial, including intro offers	Subscription started
Other renewals	Renewal
Non-renewing purchase	One-time purchase

Refunds are recorded too. The same events can go to Meta and TikTok as postbacks.

Get started

SDK

Campaigns

Help

1. Connect the webhook

2. Set the attributes in your app

What gets counted

​1. Connect the webhook

​2. Set the attributes in your app

​What gets counted

1. Connect the webhook

2. Set the attributes in your app

What gets counted