Skip to main content

Use Cursor, Claude Code, or another AI to help you implement the Superwall integration with Appstack.

CursorOpen in Cursor
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

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(
		await 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.
The integration will show an error if less than 50% of events received over the last 24 hours include an appstackId. When this threshold is not met, these events cannot be used in ad network integration pages.

​
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

Use Cursor, Claude Code, or another AI to validate your existing Superwall + Appstack integration.

CursorOpen in Cursor