Singular Links Prerequisites

Learn how to enable the new Singular Links for your iOS and Android apps, including deep linking. After you've set up these prerequisites, you will be able to implement deep linking in your Singular SDK integration.

For more information, see the Singular Links FAQ and the Deep Linking FAQ.

Note: Singular Links are being rolled out gradually to our customers, starting August 2019.

 

iOS Prerequisites

Singular uses iOS Universal Links for deep linking on iOS. To enable your app to use Universal Links with Singular Links, follow these steps:

  1. Configure at least one sub-domain for your links in the Link Management page in Singular. For more information, see the Singular Links FAQ.
  2. To set up Universal Links (deep linking in iOS):
    • Log into the Apple Developer Portal.
    • Go to Identifiers and select the app that you want to add Universal Links support to.

      identifiers.png

    • In the Capabilities menu, check the Associated Domains checkbox, and click Save.

      associateddomains.png

  3. To add the "Associated Domains" entitlement to your app:
    • In XCode, go to Project settings > Capabilities > Associated Domains.

    • Add your Singular Links domains.

      associateddomains2.png

  4. Copy your "App Prefix" (AKA "Team ID") from the Apple Developer Portal.
  5. In Singular, go to Apps Configuration, find your app, expand the iOS app site settings, and paste the value in the Team ID field.

    teamid.png

  6. Now you can implement deep linking in your app according to the appropriate SDK integration guide:

Android Prerequisites

  1. Configure at least one sub-domain for your links in the Link Management page in Singular. For more information, see the Singular Links FAQ.
  2. To configure your Android app to handle URI Scheme deep links, add an appropriate intent filter to your AndroidManifest.xml.

    For example:

    <intent-filter>
    <data android:scheme="singular-example" />
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    </intent-filter>

    This configuration will allow your app to open links such as:

    singular-example://your-sub-domain1.sng.link/Aabcd/1234

     

  3. In Singular, go to Settings > Apps, find your app, expand the Android app site settings, and enter the Android scheme name in the Android App Scheme field (in the example above, the scheme name is “singular-example”).

    androidscheme.png

  4. Now you can implement deep linking in your app according to the appropriate SDK integration guide:
Was this article helpful?
0 out of 0 found this helpful