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.

mapping_example.png

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:
Make sure that the video is published.

 
1.

On the video page, click Share and then select SundaySky Landing Page.

  share_LP.png

2. Follow the steps as displayed on the screen.

 
a. Copy and paste the landing page URL into your distribution platform.
▶ Note that the parameter keys that you defined are concatenated to the URL, as in the example below.

  step_1_new.png

b. In the video link sent to your viewers, replace each <** **> occurrence with the corresponding video data to create a key-value pair, as in the example above.

  step_2_new.png

Using URL Parameters with a Non-SundaySky Landing Page

Before Starting:
Make sure that the video is published.

 
1.

On the Video Page, click Share and then select Embed Video.
▶ If you have not yet created the code snippet, the option name is Create Embed Video.

2. (Optional) If you have not yet created the code snippet, follow steps 3-4 in Generating the Embed Code.
3. Follow the steps as displayed on the screen.

 
a. Copy and paste the embed code into your website editor.
▶ Skip this step if the code is already embedded.

  non_Ssky_step_1.png

b. Replace each <** **> occurrence with the corresponding video data to create a key-value pair, as in the example above.
  non_Ssky_step_2.png
4. Use either of the following methods:

 
Pass the URL parameters through the landing page URL Pass the URL parameters directly to the SundaySky player
When using this option, the URL parameters are visible to the viewer.

1. Embed the SundaySky player code in your page (see step 3.a. above).

2. Distribute the URL string with the concatenated parameters.
Was this article helpful?
0 out of 0 found this helpful

Still Have Questions?

SundaySky Support is here for you

contact support