Tagging through URL Parameters
Understanding URL Parameters and Their Role in Video Tagging
What Are URL Parameters?
URL parameters, also known as query strings, are key-value pairs appended to a URL after a ?. They allow websites to pass information dynamically, enabling tracking, customization, and automation. Each parameter is separated by an & symbol, and they can be used for various applications — such as identifying users, storing preferences, and triggering actions within a platform.
A basic URL with a parameter looks like this:
http://example.com/page?email=john@example.com
Here, email is the key and john@example.com is its assigned value.
Restrictions: Tagging is not available on the Free plan. To gain access, you will need to upgrade to any of our paid plans.
How the Email Parameter Works
For Vidalytics to identify a viewer and fire tags correctly, it needs to know who is watching. The way this works is by passing the viewer's email address through the URL of the page where your video is embedded.
This is done by appending a ?email= parameter to the URL, like this:
http://example.com/video-page?email=john@example.com
In practice, this means your workflow should look something like this:
- A viewer lands on your opt-in page and submits their email address
- After submitting, they are redirected to your video page — and your email platform or funnel builder appends their email to the URL automatically
- Vidalytics reads the
emailparameter from the URL and uses it to identify the viewer when tags fire during playback
Note: The email address must be collected first — through an opt-in form, a funnel step, or a CRM — before it can be passed through the URL. The ?email= parameter simply carries it from one page to the next.
Video Tagging and URL Parameters
Video tags can be triggered at specific moments during video playback. This powerful feature enables automation strategies such as:
- Sending an email to a user who watches a video all the way to the end
- Adding a user to a specific email campaign after they reach a certain point in the video
By default, every video tag passes the user_id and email fields. However, to properly utilize tagging, you must include these fields explicitly within the Field Name section of the tag.
How to Pass Parameters in a URL
To ensure proper data capture, URL parameters must be correctly formatted.
Passing an email address:
http://example.com/page?email=john@example.com
Passing a custom field value:
http://example.com/page?customField123=value
Passing both email and a custom field together:
http://example.com/page?email=john@example.com&customField123=value
Special Instructions for ClickFunnels Users
ClickFunnels does not pass form values through the URL by default. To enable this functionality, you will need to follow additional steps. You can find a detailed guide on setting this up in ClickFunnels here.
Alternatively, CF Pro Tools offers a feature called CF URL Email Replacer, which captures an email address from an opt-in form and appends it to the URL on the next page. You can access more information on CF Pro Tools here.
Learn how to set up and use the CF URL Email Replacer here.
CRM Integration — Ensuring Accurate Field Tagging
When passing data to your CRM, the field tag must match the exact naming convention used in your system. For example, if your CRM identifies contacts using contact_id, you must use that exact field name in the URL to ensure proper tagging.
Common field identifiers include:
- Email address — must be unique per user
- Contact ID — or variations like
contact_iddepending on your CRM's naming convention
For advanced tagging methods, refer to our Player Documentation.
Automating Tagging with Zapier
To integrate video tags with Zapier, follow our step-by-step guide: How to Set Up the Zapier Integration.
By leveraging URL parameters effectively, you can enhance your video tracking, automate workflows, and streamline viewer interactions for a more dynamic and personalized experience.
If you have any questions, feedback, or need assistance, reach out to our Customer Happiness Team at hi@vidalytics.com. 😊