Create deep links for your app

​Upgrade your free account to the Olé plan to use this feature.
A deep link is a type of link that will send the user to a specific page of a mobile app. Usually, deep links are used in QR codes or in websites. When these links are opened on a phone (browser, QR code or other method), the user will be redirected to the part of the app we specified.
On iOS, the deep link will open the app screen as a modal. 
On Android, it will open the app and navigate to that screen.
🖇 Creating a deep link for your Bravo app
Once you have imported a design file into Bravo and created an app project, you can generate a deep link targeting any of the app pages. To do that, go to Integrations > Deep Links.
To generate a deep link, you'll need to specify the following values:
Deep Link Name: the name for the deep link you'll generate. You can use any name you prefer. Later on, the latest generated deep links will appear in the panel, identified with the name you set here.
URL copied from Bravo Vision: here, you'll specify the app page you want to target with the deep link. To get this URL, you need to open the app in Bravo Vision, go to the desired page, long press, and select Copy page URL, as indicated here.
URL to open from desktop: in case the deep link is opened from a desktop device instead of a mobile phone, the URL specified here will be opened. You can set it to whatever webpage you wish. Remember to provide the complete webpage URL (including https://).
You'll see the Create live app link button disabled, as you'll need to set up a Firebase project and provide some assets to be able to generate this link. This will be covered later in this guide.
📲 Creating a deep link for a Bravo Vision app
With the information you've already provided, you'll be able to create a deep link targeting an app in Bravo Vision. To create the link, click on Create Bravo Vision link inside the Deep Links section, in the app settings.
Once the link is created, it will appear under Generated deep links (last 10).
Now, you'll be able to get the QR code for that deep link, by clicking on the eye icon. Alternatively, you can copy the link in text format, by clicking on the icon in the left.
To test it, make sure the app is opened on Bravo Vision, in the mobile device where you're going to test the deep link. Otherwise, the link won't work. 
To open the link in your mobile device, simply send it in text format via your preferred method (email, messaging, notes...) or scan the QR code.
🌏 Creating a deep link for a published app
In case you're about to publish your app to the stores, or test it with Testflight / debug APK, you can generate a deep link targeting it. You'll need to follow these steps before generating the app bundle. In case you've already generated it, you'll need to request a new one after finishing these configuration steps.
First, you need to set up a Firebase Dynamic Links project. Go to Firebase, and create a new project inside your account (You need a Google account first). Inside the project, go to Engage > Dynamic Links.
Inside this page, you'll be asked to add a URL prefix. Input a name of your choice for that. Once you finish typing, you'll see the option to choose the Google provided domain, which is the recommended way to set the URL prefix.
Click on it, and choose Continue for all the other steps.
Once you've created your URL prefix, it will appear inside the Dynamic Links section in Firebase. Now, you need to complete the following steps to obtain some assets that we'll provide later inside the Bravo Studio settings:
In your Firebase project, go to Build > Authentication. Here, add a sign-in method. You can use, for instance, email / password. Although we don't need to set up any authentication in our app to use deep links, this configuration will generate a web API key that will appear inside the Firebase project settings, and we'll need to copy into the Bravo settings.
Go to the Firebase project settings, and create an app for both iOS and Android. Here, we'll need to provide for the iOS project the Bundle ID, Team ID and App Store ID and for Android the Package name. These bundle id and package name need to be the same ones specified when generating the app bundle for publication. 
For the Android app, you'll also need to add the SHA code corresponding to your app bundle. You can copy this code from the build history inside the Bravo platform, and include it in the Firebase project as shown below.
After completing those steps, go back to the Deep Links settings inside Bravo. Go to Firebase settings, and provide the following information:
Web API key: copy this from your Firebase project settings. If you see the message "No web API key for this project", indicate an Authentication method as described before.
URL prefix: this is the URL prefix indicated in Firebase before. In case it's a Google domain, it will end in .page.link. Copy it from Firebase and paste it here.
Android Package Name: the package name for the Android app, specified in Firebase.
iOS GoogleService plist file: the iOS configuration file you can download from a Firebase iOS App in Firebase console.
iOS Package Name: the bundle ID for the iOS app, specified in Firebase.
iOS App Store ID: in case you have published the app for iOS, copy this value from the App Store Connect portal, under App Information. The app doesn't need to be published, only created in App Store Connect.
Once you've set these values, click Save. Finally, go to the Generate links section, fill in the Deep Link Name and URLs, and click on Create live app link. You'll obtain a deep link that you can test on a mobile device with the target app installed. You can test it via QR code, or copying the link URL in the Notes app, and opening it from the mobile device, won't work using the browser address bar.
In case the Create live app link button is disabled, go through the Firebase configuration steps and make sure you provided the right values inside the Firebase settings section.
Once you've indicated these settings, you can go ahead and request your app bundle.
If you already have a published app bundle, and you change these settings afterwards, you'll need to generate a new bundle and publish an update to the stores.
Troubleshooting
You can get extra information on issues adding &d=1 on the deep link.

Double check that you have filled all the fields in the Bravo Deep links settings, and uploaded all the files.

iOS troubleshooting
Be sure to fill the Team ID in Firebase project settings, without it the deep links won't work at all.

You can double check that the configuration file that Firebase generates exists opening in the browser the URL:
https://<your-firebase-deeplink-domain>.page.link/.well-known/apple-app-site-association, a file should be there and should have the correct bundle id.

For testing iOS deep links we recommend using the Notes app, pasting the link there and tapping on it, should trigger the deep link and open the app instead of the browser.

If still doesn't work, on the browser check if scrolling a banner appears on top, asking to choose to open the app instead, iOS remembers the last preference and if the first time due to an error the link was opened in the browser, it will open the browser.

Hopefully should work now! 


​

Data binding - Previous

Conditional Visibility

Next - Integrations

Push Notifications with OneSignal

Last modified 30d ago

Copy link

On this page

🖇 Creating a deep link for your Bravo app

📲 Creating a deep link for a Bravo Vision app

🌏 Creating a deep link for a published app