Lumiere Video URL Anatomy
Before you integrate a Lumiere video into a third-party platform, it helps to understand the parts of a Lumiere video URL. Here's a quick breakdown:
VideoID
Every video in Lumiere gets a unique videoID, automatically generated when it's created. This is what points your viewers to the right video.
EID (External ID)
EID is the variable Lumiere uses to capture the unique ID of viewers coming from an external source. External sources typically include:
Online sample providers like Cint Marketplace, Appinio, and NewtonX
Survey hosting platforms like Qualtrics, Decipher, and FuelCycle
If your viewers are coming from one of these sources, we recommend piping each respondent's unique ID into the EID field. That's how Lumiere matches viewer data to the same respondent's data on your native platform.
Heads up: if you skip this step, there's no way to match viewer data collected in Lumiere with the corresponding data in your other platform.
Custom Data (cd_)
You can add custom data variables to your link too. Each one can have a unique value per viewer, letting you filter audience segments and demographics on your insights dashboard. For more, see our Custom Variables article.
3rd Party Integration
Most survey hosting platforms have a way to redirect respondents to a third-party site (like Lumiere) and then back to the original survey. In that section of your platform, you'll add:
Your Lumiere video URL
The respondent's unique ID (optional but recommended)
A redirect destination for when the Lumiere video experience ends
The full URL format looks like this:
https://lumiere.is/v/videoIDexample?eid=[viewerID_From_Your_Platform]&returnUrl=[ReturnLink]
You've got two main options depending on whether you want respondents to return to your survey afterward.
OPTION 1: Redirect to Lumiere only (no return trip)
If you don't need respondents to come back to your platform after watching, just point your redirect to the Lumiere video and pass through their unique ID:
https://lumiere.is/v/vmXBfZdkBgcS?eid=[UniqueID]
OPTION 2: Redirect to Lumiere and back to your survey
If you want respondents to return to your survey after the Lumiere experience, you'll also need to include a returnUrl.
So if the respondent's native survey URL is:
http://survey.example.com/s3/12345/example-survey?UniqueID=user112
Their full Lumiere redirect link would be:
https://lumiere.is/v/vmXBfZdkBgcS?eid=[user112]&returnUrl=[http%3A%2F%2Fsurvey.example.com%2Fs3%2F12345%2Fexample-survey%3FuniqueID%3Duser112]
Need a hand?
If you'd like help integrating Lumiere with your survey or sampling platform, reach out to our Support Team — we're happy to walk you through it.
And remember: you can also pass custom data through your video URL to filter your insights dashboard. Learn more here.