Deep links

Appetizes deep linking feature can be used to simplify user workflows and reduce friction by allowing users to jump directly to relevant content or actions.

Supported Links

• Android AppLinks / iOS Universal Links

• Custom Schema Deeplinks

• Web Links

Appetize allows configuration of deep links at app launch with launchUrl or during runtime with openUrl, depending on when and how the link needs to be triggered.

launchUrl

To launch a URL (deep link or regular) when the device starts.

Verifies AppLink or Universal Link associations (if applicable), which may delay the device launch until the validation is complete

Query Parameter

Set the deep-link URL by adding the URL encoded launchUrl query parameter to your app or embed URL.

&launchUrl=https%3A%2F%2Fwww.appetize.io

See Query Params Reference for more information.

JavaScript SDK

Set the deep-link URL of the device via our JavaScript SDK

await client.setConfig({
    launchUrl: "https://www.appetize.io",
    ...
})

See Configuration for more information.

openUrl

To launch a URL (deep link or regular) while the device (or application) is already running.

This can be called multiple times after launch of the device, with the assumption that all AppLink and Universal Link associations are already established.

await session.openUrl("https://appetize.io")

See the API Reference for more information.

Troubleshooting

Please note that the use of AppLinks and Universal Links may be affected if our network traffic monitor feature is enabled.

Verifying Associated Domains Entitlement included in your iOS App

1. Open the Terminal on your macOS machine.

2. Navigate to the directory where your app's .app bundle is located. For example, if your app is named YourAppName, and it's in the /Applications folder, you can use the following command to change to that directory:

cd /Applications/YourAppName.app

1. Run the codesign command with the --entitlements flag to extract the entitlements XML from your app bundle:

codesign -d --entitlements - YourAppName.app/

This command will print the entitlements XML to the Terminal.

1. Verify that the entitlements XML contains the com.apple.developer.associated-domains key and that it specifies the expected URL for your associated domain. The output should look like the following:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "https://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>com.apple.developer.associated-domains</key>
    <array>
      <string>applinks:yourexpected.domain.com</string>
    </array>
  </dict>
</plist>

Ensure that the <string> value within <array> corresponds to the domain you expect for your app's associated domains.