With the launch of RadQuest, developers have a range of new tools they can use to help onboard new users into Radix and into their dApp. To enable this, RadQuest includes the possibility of dApps linking users to RadQuest, and have those users directed back to your dApp when they have the Radix Wallet. RadQuest will help them understand the basics of using Radix and the Wallet, and they can then use your dApp with confidence.

The mechanism to do this is a dapp_referrer parameter that can be passed to RadQuest, specifying the dApp Definition of your dApp.  This parameter has also been enabled on the official Radix Wallet download page at wallet.radixdlt.com, if you would prefer to onboard more experienced users to the Radix Wallet more directly rather than through RadQuest.

This guide explains the essentials of using this parameter and offers some best practices for integrating it into your dApp.

Usage Instructions

Both RadQuest and Radix Wallet download pages accept the dapp_referrer URL parameter. Its function is to ensure users are directed back to your referring dApp immediately after they get the Radix Wallet, making user onboarding more smooth. Here is how it works:

1. From your dApp’s website, link to RadQuest or the Radix Wallet download page wherever you feel appropriate for onboarding your users into the Radix Wallet. When creating the link, add the dapp_referrer parameter to the URL. The value of this parameter is  your dApp’s dApp Definition account address. (See example below.)
2. When a user clicks on the link, they will be sent to RadQuest or the Radix Wallet download page as normal, but those websites will keep track of the referring dApp when linking the user to the App Store or Play Store to get the Radix Wallet..
3. After downloading and installing the Radix Wallet, a banner will appear in the wallet, informing the user that they are set up and ready to return to the referring dApp, showing your dApp’s icon defined in the dApp Definition metadata.

Benefits

• Seamless Onboarding: Even users of your dApp that are new to Radix can be smoothly onboarded, with confidence that they will return to your dApp once they’re ready. 
• Brand Consistency: The visibility of the dApp’s icon in the wallet after installation reinforces brand identity and trust.

Example URLs

Using the Gumball Club dApp definition address:

•  For a user referred from your dApp to the Radix Wallet, the URL might look something like this:

https://wallet.radixdlt.com/?dapp_referrer=account_rdx12xuhw6v30chdkhcu7qznz9vu926vxefr4h4tdvc0mdckg9rq4afx9t   

• Similarly, for RadQuest:

https://radquest.io/?dapp_referrer=account_rdx12xuhw6v30chdkhcu7qznz9vu926vxefr4h4tdvc0mdckg9rq4afx9t  

Conclusion

Integrating the dapp_referrer parameter is a straightforward way to enhance user experience and retention for dApps within the Radix Ecosystem. 

→ To dive deeper into the RadQuest platform and its features, learn more about RadQuest here.

→ Download the Radix Wallet and join the web3 revolution!

→ Have questions or want to discuss further? Chat with us on Discord and Telegram channels Radix DLT Official and Radix Developer Discussion.