Get the app on iPhone
On iPhone, an install from a link usually loses the link: the person ends up on your app's home screen, and the install shows as Organic. Get the app carries the link through the App Store with the person's own say-so, so they land on the screen the link meant and the install goes to that link's partner or ad.
What the person sees
- They tap your Apex Link, or the Smart Banner on your site, on an iPhone without your app.
- A page shows the link's picture and title, a Get the app button, and the line "When (your app's name) opens, tap Allow Paste to land right here."
- That tap copies a short one-time code and opens the App Store.
- They install and open your app. iPhone asks whether your app may paste from Safari.
- Allow Paste: your app opens on the exact screen, and the install counts for that link, its partner and its ad.
- Don't Allow Paste: they land on your home screen. Nothing is guessed.
People who already have your app skip all of this: the link opens the app directly.
What it needs
- Apex app plugin 2.9.0 or later in the version of your app on the App Store. Your app doesn't need any new code: the code comes back through
getDeferredDeepLink, which your app already calls for deferred deep links. - The link goes to the App Store. Links that send people to your website don't show the page.
- iOS 14 or later on the person's phone.
The page starts showing once the App Store version of your app has opened with plugin 2.9.0 or later. A TestFlight or Xcode build doesn't turn it on, so shoppers never see the page before the app they download can read the code. Until then, links go straight to the App Store as before.
Turn it on or off
It's on by default. The switch is in Settings, then Mobile apps, under First launch ("Hand the tap to your iPhone app"). The same switch is on the Smart Banner card. One switch covers your Apex Links and the banner. Turned off, the link goes straight to the App Store.
To keep one app from reading the clipboard at all, pass clipboardHandoff: false when you start the plugin.
What to know
- The code lasts two hours and works once. Your app looks for it only on its first open, within two hours of the install.
- The prompt can appear for something else. iPhone shows the Allow Paste prompt when anything that looks like a web address is on the clipboard. If the person copied another address shortly before installing, they'll see the prompt once. Apple doesn't let an app check what's on the clipboard without asking.
- Partners get the install. When the link belongs to a partner, the install pays that partner like any other install they brought.
- Ads get the install too. When the link came from an ad, the install goes to that ad and is sent to the ad network the way every credited install is. After a tracking no, the network hears only that an install happened, as described in App Store privacy answers.
- Apple Ads comes first. If Apple says the install came from its own ad, it stays an Apple Ads install.