Data Connector: URL Parameters

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:

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

1.	On the video page, click Share and then select SundaySky Landing Page.
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.   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.

Using URL Parameters with a Non-SundaySky Landing Page

1.	On the video page, click Share and then select Embed Video.
2.	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.   b. Replace each <** **> occurrence with the corresponding video data to create a key-value pair, as in the example above.
3.	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 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: sskyplayer.setAttribute('endpoint-url', 'https://apis.sundaysky.com/get-video/player-session/'+sskyProgramID+window.location.search+'&id=123456&First-Name=Douglas&Plan-Name=Essentials');