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, you need to concatenate all of the URL parameters to the landing page URL, as in the syntax example below:

In this syntax example, only two values are included in the URL. You can, of course, include all the values that are needed for personalization.
The maximum supported length of the URL is 2,000 characters.
The source field names in the URL above are taken from the source field names that are defined in the data library.

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.   b. In the video link sent to your viewers, concatenate all of the URL parameters to the landing page URL. For more details, see the URL syntax example at the beginning of the article.

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.   Use either of the following options:   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. Concatenate the parameters to the URL string. 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 to 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&attribute1= value1&attribute2=value2');