Singular Links Prerequisites

Learn how to set up your iOS and Android apps in order to fully implement the new Singular Links - including deeplinking. For more information, see the Singular Links FAQ.

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

 

iOS Prerequisites

Singular uses iOS Universal Links for deeplinking 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. Integrate the Singular iOS SDK by following the iOS section in the Singular SDK Guide. Make sure to implement the Singular handler to route deeplinks properly.
      3. To set up Universal Links (deeplinking 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

      4. 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

      5. Copy your "App Prefix" (AKA "Team ID") from the Apple Developer Portal.
      6. 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

Android Prerequisites

    1. Singular uses URI schemes and Android intents for deeplinking on Android. To enable your Android app for deeplinking with Singular Links, follow these steps:

    2. To configure your Android app to handle URI Scheme deeplinks, 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 Apps Configuration, 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

Was this article helpful?
0 out of 0 found this helpful