Managing parameters in the redirect URL of onboarding allows for user attribution, understanding their choices, or segmenting and showing personalized content after onboarding. Here's a guide on how to add and manage these parameters:
How to Transfer Parameters from the Web2App Onboarding Link to the Redirect URL
If your Web2App onboarding link contains parameters (e.g., attributes of an advertising campaign), you can selectively transfer them to the redirect URL, which users will visit after completing onboarding.
For example, you generated a Web2App onboarding link: https://web.onboarding.online/welcome-to-books-app?utm_source=facebook&utm_medium=cpc&utm_campaign=audience_FB&utm_content=Books_App, and added a redirect URL: https://onboarding.online.
How to Transfer ALL Parameters to the Redirect URL
If you want to transfer all parameters from the link to the redirect URL, enable the option "Inject ALL parameters to redirect link".
Click Update for the parameter to apply.
The final redirect URL will contain all parameters from the original link, e.g., https://onboarding.online/?utm_source=facebook&utm_medium=cpc&utm_campaign=audience_FB&utm_content=Books_App.
How to Transfer Specific Parameters to the Redirect URL
If you want to transfer one or several parameters to the redirect URL, such as utm_source, follow these steps:
Step 1: Intercepting the Parameter
Click "+ADD" in the "Income parameters" section.
In 'Get Parameter Name', enter the exact name of the parameter from your initial link (e.g., utm_source). It must match exactly.
In the 'Income parameter key', enter the name of the parameter to be saved for transmission. You can rename the received parameter or leave it unchanged, e.g., utm_source or HELLO.
Specify the 'parameter type' - the data type in the parameter (string or number).
Save the parameter interception by clicking ADD.
Currently, the editing option is unavailable. To change, delete the parameter by clicking the trash can icon and re-add it with new data.
Currently, the editing option is unavailable. To change, delete the parameter by clicking the trash can icon and re-add it with new data.
Step 2: Adding the Parameter to the Redirect URL
In the "Redirect parameter" section, click "ADD".
Select the interception method - "Income parameter" from the dropdown list.
Enter ‘Value’, corresponding to 'Income parameter key' (e.g., HELLO or utm_source).
Set the parameter name in the URL by filling in the "Key" field. For example, if you write BUY, your redirect URL will include BUY with the value from utm_source.
Save the parameter addition to the redirect link by clicking ADD.
Currently, the editing option is unavailable. To change, delete the parameter by clicking the trash can icon and re-add it with a new data.
Currently, the editing option is unavailable. To change, delete the parameter by clicking the trash can icon and re-add it with a new data.
Click Update to apply the parameter.
Example: If you added 'utm_source' as 'HELLO' and entered 'BYE' as 'Key' in the redirect URL, the URL will be https://onboarding.online?BYE=facebook. You can also use the original parameter name in the setup, and the redirect URL will be: https://onboarding.online?utm_source=facebook.
How to Transfer Amplitude ID, IP, and UserAgent to the Redirect URL
Choose the required parameters in the Web2App link setup form. They will automatically appear in "Income parameters".
In the "Redirect parameters" section, click "ADD".
A screen will appear for adding a GET parameter to the redirect link. Fill in the fields:
Select the interception method - "Income parameter" from the dropdown list.
Enter ‘Value’, exactly matching the parameter name. Copy it from the Income parameters section:
In the "Key" field, enter the parameter name for the redirect URL. For example, if you want to transfer amplitudeDebiceId and name the parameter 'amplitudeId', enter amplitudeId -> the parameter named amplitudeId will be sent in the redirect URL.
Save the parameter addition to the redirect link by clicking ADD.
Сurrently, the editing option is unavailable. To edit, you can delete it by clicking on the trash can icon and add it again.
Сurrently, the editing option is unavailable. To edit, you can delete it by clicking on the trash can icon and add it again.
Click Update for the parameter to apply.
Example
Example
You generated a Web2App link: https://web.onboarding.online/welcome-to-books-app, set the redirect URL as https://onboarding.online/, added amplitudeDeviceId, and specified "Key" = amplitudeId. The redirect URL will contain the parameter: https://onboarding.online?amplitudeId=.....(ID from analytics).
Important: To send the amplitudeDeviceId, add this analytics system in the project settings on our service. To do this, go to the instruction by the link.
How to Transfer User-Entered Data to the Redirect URL
To transfer data from a specific screen (e.g., email address entered by the user, choices in tables, etc.), follow these steps:
Remember the ScreenID from which you want to transfer data.
Open the Web2App link editing form. In the "redirect parameter" section, click +ADD.
A screen will appear for adding a GET parameter to the redirect link. Fill in the fields:
Select the interception method - "User data" from the dropdown list.
In the "Value" field, enter the Screen ID noted earlier.
In the "Key" field, enter the parameter name for the redirect URL. For example, if you enter ‘email’, the redirect URL will send a parameter named = email containing the email entered by the user.
Click the ADD button to add the parameter.
Currently, the editing option is unavailable. To edit, you can delete it by clicking on the trash can icon and add it again.
Currently, the editing option is unavailable. To edit, you can delete it by clicking on the trash can icon and add it again.
Click Update for the parameter to apply.
Example
Example
If a user entered their email on Screen1, and you used 'email' as 'Key', the redirect URL will be https://[email protected].
How to Transfer Data from a Webhook to the Redirect URL
You can use data received from your server's responses and transfer them to the Redirect URL.
Step 1: Intercepting the Webhook Response
Set up a webhook type "WaitForResponse". In the "Response parameters" section, click "+ADD".
In the 'Key' field, enter the exact name of the parameter you expect from your server's response.
Choose the data type sent by your server for this parameter (string, int, or double).
Complete the setup by clicking ADD.
Step 2: Sending the Received Parameter to the Redirect URL
In the "redirect parameter" section, click "+ADD".
Select the interception type "Hook Response".
Enter 'Value', corresponding to the server response parameter.
Set 'Key' - the parameter name for the redirect URL. For example, if you enter ‘USER_ID’, the redirect URL will send a parameter named 'USER_ID’ with the value received in the response.
Click ADD to add the parameter to the redirect URL
Click Update to apply the parameter.
Example
Example
If the webhook returns 'createUserId', and you use 'USER_ID' as 'Key', the redirect URL will be https://onboarding.online?USER_ID=[value from server].