App Install
Circuul powers Thspian app-install (and web-visit) campaigns. Creators share a unique link; when someone installs and opens your app, Circuul attributes the conversion and pays a flat CPA from the campaign budget.
How it works
- Brand turns on App Install on a UGC campaign and copies the public app token.
- Creators get a referral link when they’re approved.
- Someone taps the link → Thspian records the click → they go to the store or web app.
- Your app uses a Circuul SDK to match that first open to the creator.
- The install is attributed and CPA is credited to the creator.
Packages (for your engineering team)
| Package | Use when |
|---|---|
| `@thspian/circuul-core` | Shared helpers (any JS runtime) |
| `@thspian/circuul-react` | Web apps (React) |
| `@thspian/circuul-react-native` | iOS / Android (React Native) |
What you need from Thspian
- App token — shown on the campaign detail page (App Install Token). Paste it into your app’s Circuul setup.
- API base URL — your Thspian API origin (for example
https://dashboard.thspian.com/api/v1). - Store links / Android package name — set on the campaign so referral links open the right place.
Next steps
- Brand setup — token, budget, and creator links
- React SDK
- React Native SDK
- Core package
- Attribution & matching