How to Deep Link

Deep links are pathways that connect users directly to a location deeper into a website, in this case the Unifyr One portal. This streamlines the user experience and exposes the right content quickly. 

Deep links allow users to move between different views and applications. Here are some examples:

• Website to Application
• Application to Application
• Social Media to Application
• Email to Application
• SMS to Application

If you have SSO and would like to link your partners, users, or stakeholders directly to campaigns or assets in the Unifyr One Portal without having to go through the User Sign In page, you can use these deep linking recommendations. If you do not have SSO, users are required to sign in to access the page. 

To create a Deep Link:

1. Use one of these parameters in the link, depending on what is supported by your Identity Provider (IdP):

   • RelayState parameter

     SAML RelayState is a parameter of the SAML protocol that is used to identify the specific resource the user will access after they are signed in and directed to the relying party server.

     Example - https://idp.example.com/samlsso?spEntityID=zift_production&RelayState=

   • TargetSource

     Example - https://idp.example.com/samlsso?spEntityID=zift_production&TargetSource=

   The examples in this article use RelayState.

2. Navigate to a URL decoder, for example https://www.urlencoder.org.

3. Generate an encoded URL for the Unifyr One page you want users to access, with destination character set UTF-8.

   For example, for the page https://interhelp.ziftone.com/#/marketplace/providers:

   https%3A%2F%2Finterhelp.ziftone.com%2F%23%2Fmarketplace%2Fproviders

4. Paste the encoded page URL after the resource identification parameter. The final URL will look like this:

   https://idp.example.com/samlsso?spEntityID=zift_production&RelayState=https%3A%2F%2Finterhelp.ziftone.com%2F%23%2Fmarketplace%2Fproviders