Using a Reference Code in a link or embed
If you would like to identify where your Corsizio event registrations may have come from, you can inject a Reference Code to each public page URL and have that code be associated with registrations that were initiated from that source.
This can also be useful when you wish to place an event link or embed code in multiple websites or locations to know which source the final registration came from. For example, you may have other people or websites promoting your events, and you would like to identify which person or source the registrations came from.
This reference code can be helpful in cases such as referral or affiliate tracking, but it is not specific for those use cases only. It is very generic to provide a way to associate some code to each registration behind the scenes without having the registrant enter it into a custom form field.
What does it look like?
A reference code can be up to 32 characters in length and can only be made up of letters, numbers, periods, and hyphens. It is also case-sensitive, meaning that a code like "Partner17" is not equal to "PARTNER17". It is up to you how you want to format and include such reference codes into your public page URL to be associated with registrations.
Below are some examples of what a reference code format can look like:
WebsiteOne Example_A77 Example-93 EXAMPLE_SITE example-site.com
Where and how do I include it?
On Corsizio, every account gets an auto-generated portal site (that lists all of its current and upcoming events that are published), dedicated event pages, and dedicated registration forms for every event created. These pages can be linked to from anywhere on the web or social media networks or even embedded on some webpage as an HTML iframe.
Please refer to the help doc about Website embed and links to your events. It explains where and how to get links to such public pages for your events. During that same process, you will have the option to inject a reference code of your choosing into the link before you copy it and use it as you see fit.
If you want to include the reference code manually, you simply add a URL parameter named ref with the value as the desired code. Be sure you know what you are doing, as manipulating the URL manually could lead to mistakes and a broken or invalid link.
Below are examples of how a public page can have a ref parameter added to its web URL with a custom value as the reference code.
https://my-business.corsizio.com/?ref=PartnerA https://site.corsizio.com/portal/6798eba31f21bf41554afabc?ref=PartnerA https://biz-one.corsizio.com/event/9867eba31f21bf41554afcba?ref=PartnerA https://my-business.corsizio.com/portal/my-business?param1=value1&ref=PartnerA
Warning: Keep in mind that the end user can easily manipulate the reference code in the URL to whatever they like. This means that you can see reference codes that you didn't include in URLs and that may be associated with some of the registration records. If that occurs, you can simply ignore them within your internal process. Overall, think of these reference codes as referral tokens that may or may not mean something to you internally.
What happens when a user visits a link that has a reference code?
The reference code present in the URL of a public page will be stored in the user's web browser session and associated with any registrations submitted after that using the same device and web browser. One can see the reference code at the very bottom of any public registration form if there is a reference code that will be associated with their registration.
Note that the reference code will be set on the user's web browser session for some time (a few days or so) before it is cleared out of their browser session. So, if much time has passed, the user will need to follow the link again that has a reference code for their registration to be associated with that code.
Under normal behavior, the user navigates to the web URL that has the reference code and selects an event, and registers for it all in the same session. But if they leave for a while and then come back later to register, the previous code will still be set behind the scenes and will be used if they don't navigate again using a URL with a reference code in it.
The reference code is associated with a registration in the background once it is submitted successfully. You can view and edit the associated reference code on the attendee registration details panel within your Corsizio dashboard, and it can also be included when you export registration records to a CSV file from your account.
See the screenshots below.
A user visits a public page with a reference code included.
The reference code is displayed at the very bottom of the registration form when it is going to be associated with the registration behind the scenes.
You can view the associated reference code of any attendee registration from its details panel.