Skip to content

Commit

Permalink
feat(docs): update iOS deep linking setup
Browse files Browse the repository at this point in the history
  • Loading branch information
Sporiff committed Oct 25, 2023
1 parent b351082 commit 9bef748
Showing 1 changed file with 20 additions and 20 deletions.
40 changes: 20 additions & 20 deletions src/content/docs/en/sdk/ios/configuration/deep-links/deep-link.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,38 +10,38 @@ You need to configure your app in the Adjust dashboard to enable deep linking. T
- [ ] Added your app in the Adjust dashboard.
- [ ] Retrieved all the required deep linking data.

Since iOS 9, Apple has changed the way you should handle deep linking in your apps. Depending on which iOS versions you are targeting, you need to set deep links to handle one or both of these methods.

- iOS 9 and later - Universal links
- iOS 8 and earlier - Deep links with a custom URL scheme

## Set up universal links in your app

To enable deep linking support for iOS 9 and later you need to set up universal links in the Adjust dashboard.
To enable deep linking support for iOS 9 and later you need to set up universal links in Adjust.

<Callout type="note">

You can enter only one Bundle ID per app. If you are testing an app with a Debug Bundle ID, you need to create a separate app.

</Callout>

Once you have gathered your setup data, you can add this to your app in the Adjust dashboard. Adding the information to your app enables you to add deep links to your campaigns. To set up universal links, follow these steps:

1. Log in to the Adjust dashboard.
2. Navigate to your app and select your app options caret (<Icon name="ChevronUp" />).
3. Select <MenuSelection>All Settings --> Platforms</MenuSelection>.
4. Select <GuiLabel>iOS</GuiLabel>.
1. If you haven't entered your Bundle ID, enter it in the <GuiLabel>IOS BUNDLE ID</GuiLabel> field. Make sure you enter the Release Bundle ID for your live app and the Debug Bundle ID for a debug app.
5. Select <GuiLabel>Universal Linking</GuiLabel>.
6. Enter your App Prefix.
7. Enter your App Scheme. If required, add your Release Custom URL Scheme or Debug Custom URL Scheme in the <GuiLabel>App Scheme</GuiLabel> field.
8. A raw universal link appears. You need this value to configure Associated Domains in Xcode. Example: `abcd.adj.st`
9. Select <GuiLabel>Save</GuiLabel>.
10. Select <GuiLabel>Save</GuiLabel> on the platform overview to save all settings.
Once you have gathered your setup data, you can add this to your app in Adjust. Adding the information to your app enables you to add deep links to your campaigns. To set up universal links, follow these steps:

1. Go to <GuiLabel>AppView</GuiLabel>.
2. On the <GuiLabel>Platforms</GuiLabel> tab, select <MenuSelection>Add platform --> iOS: Apple App Store</MenuSelection>.
3. Enter your App ID.
* If you haven't submitted your app to the App Store yet, select <GuiLabel>I don't have an app ID yet</GuiLabel>.
4. Select <GuiLabel>Request Verification</GuiLabel> only if you have entered the app ID. You need to verify the app ID to use Adjust's SKAdNetwork solution for your app.
5. Enter the <GuiLabel>iOS bundle ID</GuiLabel> of your app.
6. Under <GuiLabel>Device type</GuiLabel>, choose your app's default device:
* Universal - iPhone and iPad
* iPhone
* iPad
7. (Optional) Under <GuiLabel>Universal linking</GuiLabel>, turn on Enable universal linking to enable universal links for your app.
* Enter the <GuiLabel>App ID prefix</GuiLabel>.
* Enter the <GuiLabel>App scheme</GuiLabel>.
8. (Optional) Turn on <GuiLabel>Redirect all clicks to a custom URL</GuiLabel> and enter a <GuiLabel>Custom URL</GuiLabel>, if you want your users to go to a custom website instead of the App Store. This is recommended if your app doesn't have an App ID.
9. (Optional) Turn on <GuiLabel>Send data to App Store Connect</GuiLabel> and enter the <GuiLabel>Apple provider ID</GuiLabel> to send data to App Store Connect App Analytics.
10. Select <GuiLabel>Save</GuiLabel>.

## Set up deep links with a custom URL scheme

In this case, you need to pick a custom URL scheme name which your app will be responsible for opening. You can then use this scheme name in the Adjust tracker URL as part of the deeplink parameter.
In this case, you need to pick a custom URL scheme name which your app will be responsible for opening. You can then use this scheme name in the Adjust tracker URL as part of the deep link parameter.

To create a deep link with a custom URL scheme, follow these steps:

Expand Down

0 comments on commit 9bef748

Please sign in to comment.