Quickstart

From sign-up to your first matched install in about fifteen minutes.

1. Create your app

   Sign in at app.trueorigin.dev and create an app. Find it in the App Store search and the details fill in; an app that is not live yet can be entered by hand.

   The Link name becomes the first part of every tracking link, appdownload.link/{link name}/…. It cannot change later.

   When the app is created, the dashboard shows your SDK key (to_…) once. Copy it. If you lose it, rotate it in Settings → SDK key.

2. Add the SDK

   Swift

   In Xcode: File → Add Package Dependencies…, paste https://github.com/trueorigin-dev/trueorigin-ios and add the package. Then configure it at launch:

   import TrueOrigin
   
   TrueOrigin.configure(apiKey: "to_…")
   

   React Native

   npx expo install @trueorigin/react-native
   npx expo prebuild
   

   Then configure it at the top of your root layout:

   import TrueOrigin from '@trueorigin/react-native'
   
   TrueOrigin.configure('to_…')
   

   This needs a new native build; Expo Go does not include the module.

   Details: iOS SDK, React Native.

3. Create a tracking link

   In Tracking links → New link, choose a path (for example summer) and enter your App Store URL. The link is live within about 15 seconds: https://appdownload.link/{link name}/summer.

4. Test it on an iPhone

   Tap the tracking link on an iPhone, then install your build on that same iPhone and open it. The match shows in Live activity within seconds.

5. Put the link in your ads

   Use the link as the ad’s website URL and add the network’s URL parameters, so every install carries its campaign, ad set and ad. See Tracking links.

Then

RevenueCat

Trials and revenue per campaign.

Postbacks

Send installs and purchases back to Meta and TikTok.

Ad spend

CPI and ROAS from a Meta or TikTok CSV.