Manually constructing a Dynamic Link URL

You can create a Dynamic Link by manually constructing a URL with the following form:

https://app_code.app.goo.gl/?link=your_deep_link&apn=package_name[&amv=minimum_version][&al=android_link][&afl=fallback_link]

Dynamic Link parameters

Payload parameter
link

The link your app will open. You can specify any URL your app can handle, such as a link to your app's content, or a URL that initiates some app-specific logic such as crediting the user with a coupon, or displaying a specific welcome screen. This link must be a well-formatted URL, be properly URL-encoded, and use the HTTP or HTTPS scheme.

Android parameters
apn The package name of the Android app to use to open the link. The app must be connected to your project from the Overview page of the Firebase console. Required for the Dynamic Link to open an Android app.
afl The link to open when the app isn't installed. Specify this to do something other than install your app from the Play Store when the app isn't installed, such as open the mobile web version of the content, or display a promotional page for your app.
amv The versionCode of the minimum version of your app that can open the link. If the installed app is an older version, the user is taken to the Play Store to upgrade the app.
iOS parameters
ibi The bundle ID of the iOS app to use to open the link. The app must be connected to your project from the Overview page of the Firebase console. Required for the Dynamic Link to open an iOS app.
ifl The link to open when the app isn't installed. Specify this to do something other than install your app from the App Store when the app isn't installed, such as open the mobile web version of the content, or display a promotional page for your app.
ius Your app's custom URL scheme, if defined to be something other than your app's bundle ID
ipfl The link to open on iPads when the app isn't installed. Specify this to do something other than install your app from the App Store when the app isn't installed, such as open the web version of the content, or display a promotional page for your app.
ipbi The bundle ID of the iOS app to use on iPads to open the link. The app must be connected to your project from the Overview page of the Firebase console.
isi Your app's App Store ID, used to send users to the App Store when the app isn't installed
Social Meta Tag parameters
st The title to use when the Dynamic Link is shared in a social post.
sd The description to use when the Dynamic Link is shared in a social post.
si The URL to an image related to this link.
Analytics parameters
utm_source
utm_medium
utm_campaign
utm_term
utm_content
gclid
Google Play analytics parameters.
at
ct
mt
pt
iTunes Connect analytics parameters.

Debugging a URL

You can debug a Dynamic Link by taking a long or short URL and attaching a debug parameter.

https://abc123.app.goo.gl/?link=https://example.com&d=1
https://abc123.app.goo.gl/WXYZ?d=1
Debug parameter
d Instead of loading the Dynamic Link, generate a flowchart you can use to preview your Dynamic Links' behavior on different platforms and configurations.

Next steps

After you create a Dynamic Link, you need to set up your app to receive Dynamic Links and send users to the right place in your app after a user opens them.

To receive Dynamic Links in your app, see the documentation for iOS, Android, C++, and Unity.

Send feedback about...

Need help? Visit our support page.