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 a URL that your app can handle, typically an app's content/payload, which can initiate app-specific logic (such as crediting the user with a coupon or displaying a welcome screen). This link must be a well-formatted URL, be properly URL-encoded, use the HTTP or HTTPS, and not another Dynamic Link. scheme. When users open a Dynamic Link on a desktop web browser, they will load this URL (unless param dfl is specified). If you don't have a web equivalent to the linked content, the URL doesn't need to point to a valid web resource. In this situation, you should set up a redirect from this URL to, for example, your home page.

Payload parameter

link

The link your app will open. You can specify a URL that your app can handle, typically an app's content/payload, which can initiate app-specific logic (such as crediting the user with a coupon or displaying a welcome screen). This link must be a well-formatted URL, be properly URL-encoded, use the HTTP or HTTPS, and not another Dynamic Link. 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

Desktop parameters
dfl	The link to open on desktop, overriding param link. This is useful to specify a different behavior on desktop, like displaying mobile-web version of the app content/payload (as specified by param link) and suggesting users to install the app, which can be another dynamic link.

Navigation parameters
efr	Skip the app preview page when the Dynamic Link is opened on iOS, and instead redirect to the app or App Store. The app preview page (enabled by default) can more reliably send users to the most appropriate destination when they open Dynamic Links in apps; however, if you expect a Dynamic Link to be opened only in apps that can open Dynamic Links reliably without this page, you can disable it with this parameter.

Navigation parameters

efr

Skip the app preview page when the Dynamic Link is opened on iOS, and instead redirect to the app or App Store. The app preview page (enabled by default) can more reliably send users to the most appropriate destination when they open Dynamic Links in apps; however, if you expect a Dynamic Link to be opened only in apps that can open Dynamic Links reliably without this page, you can disable it with this parameter.

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.

Note: You can combine parameters for Android and iOS to create a Dynamic Link that can be used on both platforms. For example:

https://example.app.goo.gl/?link=https://www.example.com/someresource&apn=com.example.android&amv=3&ibi=com.example.ios&isi=1234567&ius=exampleapp

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.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated May 22, 2017.