Skip to main content

Automatically Log In Participants from an Event App

Learn how to use URL Query Parameters to allow your participants to instantly join your Crowdpurr Experience without going through the sign-in page.

Ross Newton avatar
Written by Ross Newton
Updated over 7 months ago

The following functionality requires an advanced understanding of web browsers, hyperlink or Uniform Resource Locators (URLs) syntax, and web programming of custom buttons or anchor links.

Please consult with someone with the appropriate skillset if you don't feel comfortable with the instructions below. Or feel free to reach out to us at help@crowdpurr.com.

A common use case with Crowdpurr is embedding a link or a button to the Participant View into event apps such as Cvent, Crowd Compass, or Socio to allow your event participants to instantly join your Crowdpurr Experience. Or you may want to send out an email or SMS text message with a hyperlink to allow participants to easily join an Experience.

In these use cases, our users often already have access to their participants' lead capture data in an external event app or CRM (Customer Relationship Management) tool so there's no need for participants to enter it again on Crowdpurr's Participant View lead capture form. However, you may want to see certain lead capture fields referenced next to a participant's response data in Crowdpurr to identify the participant's answers such as their email, phone number, or employee number, for example.

Or you may want new participants to still complete a lead capture form but not burden your existing participants with re-entering their information.

Automatic Lead Capture Completion

The Seminar Plan and above allow you to embed a query into the Participant View URL, which will automatically fill out any Lead Capture Data fields you already have from your participants and also log them in immediately without clicking any extra buttons! Once your event is finished, you can easily export your Crowd Lead Response Data for your records.

Which fields can be auto-completed? All of them! You can insert their nickname or first name, last name, email address, and phone number, along with every other Lead Capture field offered by Crowdpurr. For Team Trivia Games set under the Advanced Team Mode, you can also set their Team from the URL!

Using the URL Query Parameters

This feature uses a standard feature in web browser URLs: the query. Simply add a question mark (?) to the end of your URL, the key for the field you want to fill, and an equals sign (=). In this example, we'll use "f" for First Name. Finally, simply input their data.

The First Name field in the URL was inputted with the name, Kyle, and automatically reflected on the Participant View.

The First Name field in the URL was inputted with the name, Kyle, and automatically reflected on the Participant View.

To fill in more fields, separate them with an ampersand (&) and repeat.

The URL Query can fill in any field you enable in your experience. Here are the keys for each field:

Key

Field

f

First Name / Nickname

l

Last Name

e

Email Address

a1

Address

a2

Address (Line 2)

cit

City

s

State

z

Postal Code

cou

Country

p

Phone Number

a

Age

t

Advanced Team

cf1

Custom Field 1

cf2

Custom Field 2

cf3

Custom Field 3

cf4

Custom Field4

What if I'm using a checkbox/opt-in box for a Custom Field? Any Custom Field set as a checkbox needs any value passed to mark it as checked. To leave a Custom Field checkbox unchecked, do not pass a value. All other field types will be set correctly by passing their text value.


I'm running multiple Experiences at my event. Do I need the Experience Code? No, the Experience Code is not required for this feature. Automatically logging participants in can be done from the gateway, like so:

https://www.crowd.live/?f=Kyle&l=B.&e=hello@crowdpurr.com

Omitting the Experience Code from the URL will require participants to manually enter the code once they reach the gateway, however.


I'm using a Custom URL. Will this still work? Absolutely, the process is exactly the same. If you're using a single Linked Experience, simply add the query to the end of your Custom URL:

http://www.playtrivia.live/?f=Kyle&l=B.&e=hello@crowdpurr.com

If you're using Gateway Mode, you have the option of using the Experience Code as well.

http://www.playtrivia.live/12345?f=Kyle&l=B.&e=hello@crowdpurr.com

Automatic Log In & Required Fields

When filling out the form using the URL Query parameters, Crowdpurr will check which fields are required. If all required fields are received from the URL Query parameters, the participant will automatically join your Experience and they won't see the Lead Capture form at all. If you have any additional fields enabled, but not required, they will not get the chance to fill them out.

Because every required field was filled by the URL, the participant will see the current Participant View for your Experience.
Since the Email Address wasn't in the URL, the participant is prompted to enter it. Because it is required, they must enter one to join.

Because every required field was filled by the URL, the participant will see the current Participant View for your Experience.

Since the Email Address wasn't in the URL, the participant is prompted to enter it. Because it is required, they must enter one to join.

Phone Number and Country

Our Phone Number field supports phone numbers from around the globe. In order to automatically fill the phone number field, it will also require a value for the Country field.

The country field uses the standard 2 letter abbreviations found here:

If your event app stores the country code in a different format from this, you'll need to convert that value to this format. Otherwise, your participant will be prompted to select their country.

Don't forget the country code! You'll also need to include the country code in your participant's phone number. In the United States, it's 1, followed by the Area Code, and then their number. The link above also includes every country's code!

Programming A Button or Hyperlink To Crowdpurr In Your Event App

A common use case for implementing this functionality is creating a custom link or button in your event app for each of your participants. The URL for this hyperlink or button will contain all of their lead capture data according to the above syntax. This button can then be clicked by your participants to join the Experience, automatically complete the lead capture form, and automatically log them in if the form has all the required fields completed.

Your event app (e.g. Crowd Compass, Cvent, Socio) likely has the functionality to create dynamic buttons or hyperlinks where you can reference and embed lead capture fields into the URL of the hyperlink or button. For Cvent and Crowd Compass, please see this Community Article on Creating Dynamic Links.

Additionally, with some light programming knowledge, you could also create emails and SMS text messages that also load these lead capture fields into the URL of a hyperlink so your participants could automatically log in via an email or SMS text message containing a hyperlink to your Experience.

Did this answer your question?