ASO Documentation

Superwall integration

Send Superwall paywall and subscription events to AppSprint ASO so Apple Ads keywords can show trials, revenue, and return on ad spend.

Requirements

  • An active AppSprint ASO Pro plan.
  • A published app selected in the Mac app.
  • Superwall admin access for the project.

Create the webhook in Superwall

In Superwall, open Integrations from the sidebar, then open Webhooks. Create a new webhook and paste the AppSprint URL shown in the Mac app into the webhook URL field. Keep all events selected, then click Create Webhook. To find that URL, select your app in AppSprint ASO, open Apple Ads, click the SDK & revenue tracking button in the top-right toolbar, then choose Superwall.

https://api.appsprint.app/v1/integrations/superwall/webhooks/app_xxx

Copy the signing secret

Once the webhook is created, click the newly created webhook in Superwall. In the top-right corner, click Copy Secret. The secret usually starts with whsec_.

whsec_xxx

Save the secret in AppSprint ASO

Back in the same SDK & revenue tracking flow in the Mac app, paste the signing secret into the Superwall step and save it.

Continue setup

After the signing secret is saved, you do not need to wait for a Superwall test event. Superwall does not send arbitrary test webhooks from the dashboard. Revenue, trials, and ROAS start populating once Superwall sends real subscription events for this app.

Continue to SDK setup

Return to the Mac app. Click Next in the SDK & revenue tracking flow and copy the SDK prompt for your app stack.