PatronManager Help

Troubleshooting/FAQs for Virtual Events Users

Updated on

Use this link to share with your colleagues:

Troubleshooting / FAQs for Virtual Events: https://help.pm.leapevent.tech/a/1287949

Now that Virtual Events have been enabled in your account, you probably have more specific questions! That's what this article is for - to get you over the most common speedbumps our clients encounter when setting up and using the feature.

We'll cover a number of frequently asked questions, best practice recommendations, and troubleshooting tips:

Here we go!

Virtual Events general questions

Setting up a Virtual Event

How do I set up a Virtual Event Instance in PatronManager?

It depends on what content format (RTMP/External/Video on Demand) you're using! We've got articles to walk you through How to Set Up a Livestream Event Instance and How to Set Up a Video On Demand Event Instance, so check that out after you decide what format you're using.

Can I restrict my Virtual Event viewers to a specific geographic area?

Yes! You can set up geofencing for Video on Demand and RTMP Livestreams.

Why can't I use the Video On Demand or RTMP features?

Your ability to use these features depends on your contract. If you want to be able to use Video On Demand or RTMP, and cannot currently, reach out to us on a case via the Community and let us know - we can chat about modifying your contract.

Why can't I set a $0 price level?

Your ability to set $0 price levels depends on your contract. Running Virtual Events incurs hard costs for PatronManager, so the way you pay for the service (and thus, your contract) dictates your ability to set $0 price levels.

If you want to be able to set $0 price levels and cannot currently, reach out to us on a case via the Community and let us know - we can chat about modifying your contract.

What's the "Standard" content format?

Good question -- this is what you'll use for regular, in-person Event Instances.

Can I create Virtual Event Instances with a mass upload?

Virtual Event Instances cannot be created using a mass upload.

When a Virtual Event Instance is created normally through the system, a corresponding "event" on the streaming service is also created. This is required to validate your patrons' tickets and to upload or stream your content. Uploading Event Instances does not trigger this step, and therefore those Instances will not be usable.

You may also receive the error message "Stream does not exist (user.general.does_not_exist)" if you create a Virtual Event Instance using a mass upload tool.

For more on how to create Virtual Event Instances, see How to Set Up a Livestream Event Instance and How to Set Up a Video On Demand Event Instance.

Selling Virtual Events

Should I sell one ticket per person or one ticket per household?

You may wish to consider a model where one ticket is good for one viewing device. If two patrons live together, they'll likely watch your virtual event on the same screen (or virtual "seat").

Patrons can of course buy multiple tickets in the same Order, but keep in mind that they'll receive an email with all their access links, and it could be tricky to ensure that the right person clicks on the right link when they forward that email to their other viewers.

How do we sell tickets ahead of time? I want to set up our Virtual Events season, but I'm not ready with the platform and/or our VOD content yet.

Great question. The answer depends on the type of content:

  • For VOD content: When you set up your Event Instance, you should:
    1. Set global availability to the date you plan to load in the video
    2. Make sure to set the Allocation view limit to start from "first-viewed date" (rather than  from "purchase date")
    3. Be sure to upload the video file at least a day before the availability window opens
  • For Livestreamed content: You will need to pick your format between the two modes, but once you do, you'll be able to start selling tickets:
    • For RTMP mode: you'll stream straight to us when it comes time to go live
    • For External mode: insert a placeholder link (e.g. to your YouTube channel), and be sure to update it before the Event Instance Date
How should I offer discounted tickets for my members/VIPs?

The process here is the same as for any other kind of Event. We recommend using Discount Codes tied to Benefit Levels if you use Portal, or Passcodes (with or without Portal) to give your members discounted access while still selling full-priced tickets to non-members.

What about pre- or post-show events? Can I easily funnel specific audience members from one stream to another?

This is a wonderful idea - but not one we've implemented yet. If this is something your organization needs to do, please submit a Product Idea and let us know how you'd use such a feature. We'd love to have your input!

In the meantime, you could set up the different options as separate Event Instances; patrons can purchase them together and will receive a link for each one in their confirmation email.

Communicating with Virtual Event patrons

Can I use automatic post-show emails with virtual events?

You can send automatic post-show emails for livestreamed events! And because PatronManager automatically tracks attendance for virtual events, you can use the option to only send post-show emails to attendees if you wish.

Automatic post-show emails are not currently compatible with Video on Demand Event Instances. If you choose to send outreach to these patrons manually, the date the patron first viewed the content is available for reporting in the "Entry Date" field on the Ticket Order Item.

How do I customize the language in the confirmation email for virtual events?

Confirmation emails include conditional text if the Order contains one or more virtual events. The default text reads as follows:

"Your order contains tickets to one or more virtual events. To view your virtual event(s), click the button(s) below a few minutes before the listed time."

Below the text, patrons will see the button(s) to click to use their virtual tickets:

To customize the text above the Virtual Ticket link, follow the instructions in this article.

The patron experience

If a patron trying to view a livestream or VOD is having technical problems, who do they contact for help?

They'll click the "Support" link on the player page, which will direct them to you. We recommend including a phone number or email there of someone like a House Manager at an in-person performance.

The majority of issues that would lead a patron to clicking said "Support" link are:

  • Their internet is insufficient for a quality streaming experience
  • Wanting to donate to your organization
  • Questions about the content of the show

And these are all questions your House Manager should be prepared to answer.

If you're having problems steaming your content, make sure you're familiar with this article about your emergency backup plan (you should have set this up when enabling the feature).

I just updated Enhanced Domains and my patrons are having trouble attending my Virtual Event!

Updating Enhanced Domains changes all of your domains, including those used for Virtual Events, and can cause interruptions for you and your patrons. For this reason, we recommend updating Enhanced domains during a low volume time for your Virtual Events (i.e. not the day of a Livestream or the release date of a VOD).

If you've updated Enhanced Domains and use Virtual Events, make sure to go click the Update Domain button in the Virtual Event Settings section of PatronTicket Settings to update your domain.

Update Domain in PatronTicket Settings

Updating your domain for Virtual Events will take a few minutes, but you are able to navigate away from this page while the update happens.

Chat

Does PatronManager's Virtual Events feature have chat functionality?

It sure does! You can turn on chat functionality for your patrons in the Control Panel by clicking the "Setup Chat and Reactions" button in the Chat box.

From the Chat Settings, you can:

  1. Allow Chat: Check this box if you'd like to allow chat functionality
  2. Allow Reactions: Check this box if you'd like to allow patrons to interact with emoji reactions. These are only visible in real time
  3. You are a moderator. Enter your name.: Enter the name you'd like to be known as in the chat
  4. Enable Chat / Save Settings: Click to save the settings and enable chat
Can I toggle chat on and off during the stream?

You can! For example, if you want patrons to be able to chat during intermission, but not during the actual performance, you can opt to allow or not allow chat during the stream as you so choose.

Can patrons hide chat if they don't want to see it?

Patrons will have the option to hide chat from their view if they'd rather not participate, or if they have a smaller screen.

How do I moderate the chat?

You can participate and moderate the chat from the Control Panel for the event. Specifically, you'll have the option to:

  1. Ban This User: This option mutes the user in chat and they will not be able to send further messages
    • This will move the user to the "Banned Users" tab in chat, where you can unmute them if desired
  2. Ban This User From Event: This option removes the user from the livestream and invalidates their ticket so they cannot return
    • This cannot be undone
  3. Delete This Message: This deletes the message from the chat for everyone

There are also some built-in moderation tools for you:

  • A profanity filter to block messages that contain words from Google's banned words list
  • Rate-limiting to prevent participants from spamming the chat with a limitation of 7 messages per minute
  • A message character limit of 250 characters
Can I pin a message?

You can pin a message by either check the pinned box before sending your message

Or by opting to pin the message in the chat.

Can I download the chat after the livestream?

You can download the chat for up to 90 days by clicking the gear icon and opting to "Download Chat History."

Livestreaming questions

How do I...

Choose between RTMP and External platforms?

It depends what you're trying to do and what's important to you (such as: do you need interactivity with your audience? What about access control?). We've pulled together some questions and deciding factors for you over in this article.

Choose between broadcasting software options?

If you're using the PatronManager player to host your livestream, you'll use broadcasting software to send your content to the right place. There are many different kinds of broadcasting software: you'll find our top recommendations, and the pros and cons of each, in the second half of this article.

Send automatic pre-show emails for livestreams?

Just like any other performance! The Automated Communications feature is fully compatible with tickets sold to virtual livestreamed events, and pre-show reminder emails are highly recommended!

You can also add a merge field to include a button with the patron's link to view the livestream in their pre-show reminder email:

Because the VirtualEventAccessLink merge field generates a button, do not use this merge field on a button element.

Doing so can cause issues with your final email.

Note: Automatic pre-show emails are not compatible with Video On Demand Event Instances.

Sell tickets to an event that is both livestreamed and in-person?

Great question! You'd need to set up two separate Event Instances: one with the "Standard" content format for the in-person show, and a separate Event Instance for the livestream. Your Standard Event Instance might have reserved seating or attendance caps, while the livestream may have different pricing, details, and capacity.

Tip: you can use the Event Instance Detail on each Event Instance to link off to the other one (Standard vs Livestream), to help the patron choose their preferred option!

Launch a livestream?

The details depend on the content format you choose. Check out this article for more.

Run a livestreamed event?

We have some best practices for you; from a dress rehearsal to a stage manager, we've got you covered in this article.

Run a panel discussion or webinar via this platform?

If you've got multiple people participating and/or performing from multiple platforms, we highly recommend using StreamYard.

Do a free stream?

Use the "Livestream (External)" Content Format and set all your prices/fees to $0.

Set up a recurring event, like a series of class sessions on Zoom?

Let's say you're doing a set of art classes using Zoom and the "Livestream (External)" option. These classes will happen weekly on Wednesdays at 6pm for 8 weeks. How should you set this up?

It depends! Here are a few things to consider.

  1. Do you want to be able to keep selling tickets after the first session and/or sell classes individually?
    • If so, you should set up the classes as separate Event Instances, and consider building them into subscription packages (all 8 classes, 7 classes, etc).
  2. Do you want to automatically track attendance in PatronManager for each class separately?
    • If so, you'll need to set up a separate Event Instance for each class.
  3. Were the answers to questions 1 and 2 "no"? Will the external (i.e. Zoom) link be the same for every class?
    • You could set up a single Event Instance with the Instance Date as the first class start time and the Instance End Date as the last class end time.
    • Patrons will be able to use their ticket links to click through the player page to the external stream link as many times as they need to during that range.
Make sure my patrons have their ticket link before the event starts?

Your patrons will receive the link they need to access the your livestream in their Order Confirmation email immediately after they purchase a ticket. 

If you use PatronPortal, your Portal users will also have access to their ticket links from their Portal order history.

However, our recommended best practice is also send them an email just before the show with the same link - it's no fun to sift through your inbox for a link to a show you paid for.

You've got two options here, depending on your audience size:

Option A: if you sold less than ~2,000 tickets to your virtual Event Instance

Your best bet is to use Automated Communications - you can do everything inside PatronManager, and it's easy to use. However, there's an important drawback:

Warning!

These emails count towards your Salesforce Single Email Limit. Once you hit 5,000 total emails for the day, Automated Communications will no longer work. More importantly, ticket purchase and donation confirmation emails will no longer send, meaning you won't be able to process further transactions that day.

If you're concerned about hitting your Single Email Limit, you may want to use Option B.

  1. Set up automated communications if you haven't done so already
  2. Create a pre-show email template that contains the Ticket Order Item merge field "VirtualEventAccessLink" (again, if you haven't done so already)
  3. Set that template as the pre-show email, either:
    1. On your Automated Communications Settings, if you want to use that template for all your Ticketable Events
    2. On the specific Ticketable Event, if it's more specialized
  4. Make sure the email is set to go out an hour before the show (again, either in your Automated Communications Settings or on the Ticketable Event)

Here's what that email might look like:

Pro tip!

Last minute ticket buyers won't get this automated pre-show email, but they will receive their confirmation email with their ticket link. We recommend putting any crucial information for the ticket buyer in the confirmation email.

Option B: if you sold more than ~2,000 tickets to your virtual Event Instance

You'll want to send the email via your email marketing system; here's our step-by-step instructions on how to do that.

Get a patron back into the stream if they lost their connection?

Direct them back to their email and have them click their virtual ticket / access link again, just as they did to join the stream originally.

Access Control in PatronManager protects against simultaneous concurrent viewers, and does not count the total number of clicks.

Preview my livestream/see the number of active viewers/is there an admin interface for the player?

Head over to the "Livestream (RTMP)" Event Instance and click the "Control Panel" button:

Make my livestream available as a recording afterward?

You can do one or both of the following:

  1. If you want folks who bought tickets to the livestream to have automatic access to the recorded version afterward, you can convert the completed livestream to VOD
  2. If you want to sell more tickets to the recorded version after the livestream is over, we recommend uploading the recording of your livestream to a new "Video on Demand" Event Instance and selling access to it that way

Best practice recommendation: record your video on your side as it is being streamed (rather than relying on downloading the recording from the Stream Control Panel), then upload that recording to Video On Demand. Why?

  • Bandwidth: when you record your own video, you'll get a cleaner, clearer recording not affected by internet speeds.
  • Separate files: if your stream is interrupted, you'll receive several separate video files from the Control Panel; if you record from your side, you'll get one, full performance file.
Embed a stream from another platform (e.g. YouTube) within the PatronManager player?

You cannot embed a stream from another platform in the PM frame.

If you'd like to use the PatronManager player page, use "Livestream (RTMP)". If you'd like to host the stream on another platform (like YouTube), use "Livestream (External)".

To clarify, when you use our streaming platform (i.e. RTMP), you aren't capturing video, streaming it to YouTube, then sending it to our platform. Rather, you're capturing video and sending it straight to our platform.

Choose what video equipment to use?

Our Client Community has a whole group of organizations like yours who are turning to streamed content - we recommend asking them what they've tried and liked so far!

If you haven't joined the Virtual Events Community Group yet, it's the last step in enabling the feature for your organization.

Download stats/chat from the Control Panel to view after the stream?

You can't download stats from the Control Panel yet, but that's a great idea. Please submit a Product Idea in the Community so our Product Development Team knows that this is something you want - every vote counts!

You can download chat from the Control Panel up to 90 days after the stream.

See how long patrons spent watching the stream?

For RTMP livestreams, you can check the Virtual Events Dashboard in PatronTicket Settings to see how long your patrons spent viewing your event.

This Virtual Events Dashboard only shows the amount of minutes patrons spent viewing events within a date range that you set.

This dashboard does not count total viewers or unique viewers, which is available from the Control Panel on an individual virtual Event Instance.

The Virtual Events Dashboard will only show you information for RTMP livestreams and Video on Demand events, not external livestreams.

Troubleshooting

It's showtime and something is wrong!

Don't forget the emergency pull-switch you set up when configuring virtual events! You can use it to quickly send all ticket holders a backup link to view the stream -- either the same link they'd have landed on anyway for a "Livestream (External)" Event Instance, or a backup link you created for a "Livestream (RTMP)" Event Instance. Here are those setup steps again.

I got an error message when creating an Event Instance

Here are some error messages we've seen, and how to fix them.

  1. Unable to register your Event Instance with the livestream service: {"error":"Unable to create stream - Make sure all settings have been set"}
    • Are you creating a "Livestream (External)" Event Instance? Check to make sure your Stream URL is correct, that it matches the platform you selected in the dropdown, and that there are no spaces or line breaks in the URL.
  2. Unable to register your Event Instance with the livestream service: Attempt to de-reference a null object
    • Try the same troubleshooting steps as for #1.
I can't send an RTMP stream to your platform from my preferred software
Try a different Stream URL - here's a list:
  • rtmps://global-live.mux.com/app
    • This is the default URL, and will work with most providers
  • rtmps://global-live.mux.com:443/app
    • Some providers like Wirecast may require this more specific URL
  • rtmp://global-live.mux.com:5222/app
    • This URL is less secure, but works with many providers that can't use the fully secure URLs listed above (for example, Livestream.com)
I don't see the expected RTMP fields in my preferred broadcasting software

Here are some other terms we've seen used:

  • Stream Key 
    • Sometimes labeled as "Stream Name"
  • Stream URL
    • Sometimes labeled "Server URL" or "FMS URL"

If your broadcasting software only has one field labeled something like "Location" or URL", it may want a combination of the Stream URL and the Stream Key. Try something like this:

  • rtmp://global-live.mux.com:5222/app/YOUR_STREAM_KEY
I'm getting "Invalid access code" errors for valid tickets on my "Livestream (External)" event

Check your "Livestream (External)" Event Instance, specifically the URL you've provided. Make sure it's a valid URL, and make sure it contains the "https://" in the address.

In the image below, the URL is missing that prefix, and would throw this error until corrected:

My patrons are getting "Invalid access code" errors for my Livestream

If you've recently enabled Enhanced Domains, this may happen if your domain for Virtual Events hasn't been updated yet.

Go click the Update Domain button in the Virtual Event Settings section of PatronTicket Settings to update your domain.

Update Domain in PatronTicket Settings

Video On Demand questions

How do I...

Set up a specific screening time for my VOD?

Our best practice recommendation is to go with a Livestream Event Instance instead. It's the best way to make it "seem" like it's a live performance, or emulate something like a TV special. Further recommendations:

  1. Use the "RTMP" option
  2. Use OBS Studio (linking to a platform like Vimeo to stream will be more obvious to your patrons)

Consider this:

If you just need to restrict availability to a given timeframe, you can still use VOD. Set your global availability window to a certain date range, and no one will be able to access it before or after that period.

However, make absolutely sure you use the "from first viewed date" timing restriction when setting up your Allocations. If a patron buys a ticket to that VOD early and your timing restriction is set to "from purchase date", their tickets may expire before they're able to access the video.

Safeguard against people downloading the video content?

There's nothing inherent in the PatronManager platform that makes it possible to download VOD content. However, a determined bad actor could hack a workaround to record it, just like they could on NetFlix or other streaming platforms.

If this is a high concern, we recommend you consider watermarking your videos. Please also submit a Product Idea.

Upload a video? Do you have file size recommendations? How long does it take?

All video sizes we've tested have worked well so far (note that the max resolution is 1080p).

It does take a bit to upload your video, though, and the larger the file, the longer it takes. We recommend allowing a full day to complete the upload, to avoid last-minute stress. If you have a very large file or experience issues uploading directly from your computer, you can upload the file to your website or a hosting service like Dropbox, and have the system fetch the file from that URL instead.

For full instructions, see our "How to Set Up a Video On Demand Event Instance" article.

Add closed captions?

You can add closed caption subtitle tracks to your VOD from the Control Panel. Click here for full instructions.

See how long patrons spent watching my VOD?

For VOD events, you can check the Virtual Events Dashboard in PatronTicket Settings to see how long your patrons spent viewing your video.

This Virtual Events Dashboard only shows the amount of minutes patrons spent viewing events within a date range that you set, and will not necessarily show the all-time total minutes viewed for your video.

This dashboard does not count total viewers or unique viewers, which is available from the Control Panel on an individual virtual Event Instance.

Troubleshooting

My patron's Video On Demand (VOD) ticket is expired, but it shouldn't be

Reset the VOD ticket's validity depending on how the tickets are set up:

  • "First-Viewed Date" validity: go to the patron's Ticket Order in PMBO, open the "Print" tab, and clear the "Attendance" for that ticket
  • "Purchased Date" validity: exchange the ticket for a new one, and send the patron the automatic exchange confirmation email (this will contain their new ticket link)

In addition, if you've recently enabled Enhanced Domains, this may happen if your domain for Virtual Events hasn't been updated yet.

Go click the Update Domain button in the Virtual Event Settings section of PatronTicket Settings to update your domain.

Update Domain in PatronTicket Settings
My patrons are getting "Invalid access code" errors for my VOD

If you've recently enabled Enhanced Domains, this may happen if your domain for Virtual Events hasn't been updated yet.

Go click the Update Domain button in the Virtual Event Settings section of PatronTicket Settings to update your domain.

Update Domain in PatronTicket Settings
I'm having trouble uploading my video

Here are a few things to try:

  • Make sure that you're using a video file (not something like a .jpg or a .pdf)
  • Try using a different browser (e.g. Firefox vs Chrome)
  • Check your internet speed, including the upload speed, using something like speedtest -- if your connection is slow or unstable, uploads can take a long time
I'm having trouble uploading my subtitle/caption file

If you see an error like the one shown below, double-check your file for syntax errors.

Typical SRT syntax looks like this:

Syntax errors vary; here are some examples:

  • Two consecutive spaces where one space is expected (e.g. in the timestamp)
    • 00:00:00,000  --> 00:00:05,000 (there are two spaces before the arrow, but there should only be one)
  • Missing spaces in the timestamp
    • 00:00:00,000-->00:00:05,000 (there are no spaces before/after the arrow)
  • Incorrect characters (e.g. a colon or period in the place of a comma on a timestamp line)
    • 00:00:00,000-->00:00:05:000 (note the misplaced colon near the end)
  • Missing subtitle numbers, or subtitle numbers out of order
    • Each timestamp/subtitle combo is preceded by a number (1, 2, 3, etc). Placing a timestamp/subtitle combo without its preceding number, or placing a number out of sequence, can result in an error
  • An extra carriage return between the timestamp and the subtitle

If you're having trouble finding the problem area in the caption file, try splitting it in half into two separate files, and uploading each one separately.

Delete any successful test file from the VOD Event Instance, then take whichever half of the file failed to upload and repeat the process, splitting it in half again. This will help you narrow down the part of the file with a syntax error.

Previous Article Enable and Configure Virtual Events
Next Article Choose Content Format and Software for Your Virtual Events
Still Need Help? Continue to the Client Community