Introduction
Using URL parameters is an easy way to activate personalized data in the videos your viewers watch.
Parameters are passed to SundaySky as key-value pairs in the page URL. Among the many ways that URL parameters can be used is within an email to landing page distribution flow. For example: you can use the URL parameters data connector to pass data directly from your email service platform to SundaySky.
When you send the video link to a viewer, all the URL parameters are concatenated to the landing page URL, as in the syntax example below:
https://myvideo.sundaysky.com/?programId=e60330cf-fbe9-4be2-b3cd-18ace9b3ba1b&First-Name=Douglas&Plan-Name=Essentials |
The parameter keys added to the URL are based on the data fields that were created for personalizing the video. In the example below, two data fields and their respective parameter keys are displayed in the mapping window of the data library. All the parameter keys are automatically concatenated to the URL that is distributed when the video is shared. The maximum supported length of the URL is 2,000 characters.
In this article you will find instructions for formatting URL parameters, whether you are using the SundaySky landing page or a non-SundaySky page.
Using URL Parameters with a SundaySky Landing Page
Before Starting: |
1. |
On the video page, click Share and then select SundaySky Landing Page. |
||||||||
|
|||||||||
2. | Follow the steps as displayed on the screen. |
||||||||
|
Using URL Parameters with a Non-SundaySky Landing Page
Before Starting: |
1. |
On the video page, click Share and then select Embed Video. |
||||||||
|
|||||||||
2. | Follow the steps as displayed on the screen. |
||||||||
|
|||||||||
3. | Use either of the following methods: |
||||||||
When using this option, the URL parameters are visible to the viewer.
1. Embed the SundaySky player code in your page (see step 2.a. above). 2. Distribute the URL string with the concatenated parameters. When using this option, the URL parameters are not visible to the viewer.
1. Embed the SundaySky player code in your page (see step 2.a. above). 2. Inject the parameters directly into the SundaySky player attribute "endpoint-URL" as in the example below:
|