How to Send RevenueCat Purchase Events to Meta and TikTok

Running paid acquisition for a consumer subscription app gets expensive fast when your ad networks optimize for raw app installs instead of actual subscribers. With the Airbridge Core Plan, starting with a 30-day free trial and then $40+/mo, you can connect your subscription billing setup, tie subscription activity back to your campaigns, and configure postback settings so ad algorithms optimize for paying users.

Connect Your Account

The Core Plan includes up to two third-party integrations, and the Core Plan page lists RevenueCat among the tools those integrations cover. You can link the two dashboards in a few steps using the integration setup guide:

1. Head over to your billing dashboard, open Integrations in the left sidebar, and select Airbridge under the Attribution section.
2. Paste the Airbridge Subdomain and Airbridge Token, copied from Integrations > Third-party Integration > RevenueCat in the Airbridge dashboard, into the corresponding fields.
3. Scroll to the Event names section and select Use default event names so the pre-mapped event names auto-fill.
4. Click Add integration to finish the dashboard connection.

Pass Device and User IDs

Your app code needs to pass identifiers between the two SDKs.

First, configure your billing SDK to send the device IDs collected by Airbridge. Next, make sure User IDs are logged identically in both the Airbridge SDK and your subscription platform. The App User ID from your subscription tool should be sent to the Airbridge SDK alongside early lifecycle events like sign-up and sign-in, which usually happen before a user ever subscribes.

If Airbridge cannot find a matching User ID from your subscription events, it generates a random User ID instead. Because those unmatched events get assigned to newly generated IDs, your Airbridge reports may end up displaying a higher number of users for subscription-related events than you actually have.

Subscription Events Available

Once the integration and SDK identifiers are in place, trials, payments, and renewals land on the same campaigns inside Airbridge, and those conversions go back to your ad channels.

When you use the default event name setup, subscription lifecycle events map into Airbridge in two ways depending on whether they match standard events or custom events. The table below shows part of the mapping; the integration guide also lists custom events such as SUBSCRIPTION_EXTENDED, REFUND_REVERSED, and REFUND:

For the events that follow the default custom-event mapping, the Airbridge dashboard displays them using their original event names, and their event data is included inside custom attributes. Custom events are listed as a Growth Plan feature on the pricing page, so check which of these events your plan collects.

Configure Channel Postbacks

Keep in mind that only events that have already been collected by Airbridge will show up for selection in the postback configuration screen.

Follow these steps to configure your ad-channel postbacks:

1. In the Airbridge dashboard, navigate to Integration, select the ad channel you want to configure, and switch on the Send postbacks toggle in its Postback tab.
2. Click Postback event setup to open the event selection view.
3. Select the collected events and data you want to send, and set a delivery rule for them.
4. Edit the event details for your ad-channel postbacks to configure the channel event names.
5. If you ever need to adjust an event setup that is already complete, return to this view to edit the event data or update the delivery rules.