Skip to main content
With the Superwall integration, you can:
  1. Use Superwall in-app events to run enhanced app campaigns.
  2. Unlock attribution-based paywall optimization.
To successfully connect Superwall, you must:
  1. Have Owner/Admin access to an Appstack organization.
  2. Have access to the correct Superwall account.

​
Connect to Superwall

Follow the steps to ensure the Superwall integration works:
1

SDK configuration

To successfully receive the Appstack ID, use the following line after the calls to Superwall and Appstack configure methods:
// Use Superwall SDK version >= 4.12.11

await Superwall.shared.setIntegrationAttribute(
  IntegrationAttribute.appstackId,
  AppstackAttributionSdk.shared.getAppstackId(),
);
And to show paywalls based on where your users came from (paid ads), you only need to add a single line of code before your first Superwall.register call to pass Appstack’s parameters as user attributes. That’s it, there’s no need to repeat it for every placement:
Learn more about how to use ad campaign data to show personalized paywalls and increase subscription revenue by reading this article.
Task {
	Superwall.shared.setUserAttributes(
		AppstackAttributionSdk.shared.getAttributionParams() ?? [:]
	)
}

// Now, your placements will attach those user attributes, making
// them available for use in campaign filters.
Superwall.shared.register(placement: "onboarding_paywall")
2

Copy the credentials

  1. In Appstack, from the side menu, select Integrations > Superwall.
  2. Copy the access token.
  3. Copy the app ID.
3

Paste the credentials

  1. In Superwall, from the side menu, select Integrations > Appstack.
  2. Paste the access token.
  3. Paste the app ID.
Information
  1. After the integration is active on Superwall’s platform, it can take 30-60 minutes to appear as active on Appstack’s side.
  2. It’s recommended not to edit or modify the integration on Superwall’s platform to avoid attribution issues.

​
Events received

In-app event nameValueDefinition
Start trialsw_trial_startedUser begins a free trial for a subscription
Trial convertedsw_trial_convertedWhen a free trial becomes a paid subscription
Purchasesw_initial_purchaseFirst-time subscription or purchase
Subscribesw_subscription_startedFirst-time subscription or trial converted
Renewalsw_subscription_renewedSubscription renewal
Cancellationsw_cancellationSubscription cancelled
Expirationsw_expirationSubscription expired
Billing issuesw_billing_issuePayment processing failed
Product changesw_product_changeUser changed subscription tier