AgileLINK VOD Integration
AgileLINK VOD is an exciting new feature of the Agile Ticketing Solutions software. Customers are now able to view streamed films, livestreams, and virtual discussions by using the same process as buying a ticket to an in-person event at one of your organization’s venues. AgileLINK VOD allows your organization to control how long a customer has access to a virtual film link, connect VOD to members’/passholders’ benefits, and let your customers watch on any device that has access to an internet connection and a web browser.
Creating Virtual Events in Agile Ticketing
First, you will need to decide where you will want to set up your virtual events. You can build your templates and your events in existing folders, or you can create a new blue sales folder just for virtual events.
Building a Digital Screening Room Template.
Because Virtual Events may require a different Sales Line Type than in-person events, you will need to create a specific Digital Screening Room Template.
- In the sales folder, select Template.
- Right-click in the Template area and select New.
- Select the ellipsis button. In the field, type Streaming and click Add New.
- Click the ellipsis button next to the Venue. Create a venue called Digital Screening Room or Virtual Theater.
- Add a Template Name in the field provided.
- Select the Delivery Tab.
- Check the box next to the Streaming Delivery Method. Then, click Apply and OK.
- Next, right-click in the Tier/Inventory area and select New Tier.
- For the Sales Line Type drop-down list, select Streaming Event.
- Select the Tier Name.
- Add the Initial Default Inventory for the number of views you will be selling for the streaming.
- Click Apply and OK to save the information.
- Next, you will build the prices that you will be using in this event. This should include any promotions or member benefit prices. To learn more about building prices, see Creating a Price. To learn how to create a new streaming benefit so that members and passholders can access discounted streaming prices, see the Member Benefits section of Creating Member Benefit Groups and Adding Member Benefits.
You are now ready to build your shows for streaming. A streamed event is mostly built just like any other event (see Building an Individual Show for further instructions if necessary), but there are a few key additional steps you must take to make sure the streamed event displays online correctly:
Setting Your Event's Streaming Custom Properties
The Streaming Custom Properties play a large part in defining how a streamed event functions. In the Custom Properties tab of the streamed event, scroll to the Streaming section.
- StreamingEnabled: This is the property which a Streaming Entry Point / Web Page will check to determine whether this Show should appear on the Entry Point. Set this value to TRUE for all shows which you want to appear on a web page of a list of streaming events.
- StreamingID: If you are using Vimeo, this is where you will type the content's Video ID. If you are using CineSend/BitCine, this is where you will type the video's integrator code. If you are using Zoom, this is where you will type the Meeting ID.
- StreamingPrompt: The text inputted into this property will appear on the button customers click to stream this Show. If no text is inputted, StreamingPrompt will default to "Click to Stream."
- StreamingPurchasePrompt: The text inputted into this property will appear on the button customers click to purchase a ticket to the stream. If no text is inputted, StreamingPurchasePrompt will default to "Buy Tickets."
- StreamingSiteURL: This property specifies a full URL (e.g. https://agiletix.com) to be used for the following StreamTypes: ExternalURL, PurchaseURL, and FrameSRC. Note: If you are using Vimeo, CineSend/BitCine, or Zoom without the use of a registration link, you must leave StreamingSiteURL blank. Otherwise, your video platform will not embed correctly onto Agile web pages.
- StreamingType: This is the property where you will specify which video platform will stream the Show:
- BitCine - A standard CineSend/BitCine video stream.
- ExternalURL - After a customer has purchased a ticket and the system has made sure that the window is valid, the customer will be redirected to "StreamingSiteURL."
- FrameSRC - After a customer had purchased a ticket, "StreamingSiteURL" will be used as the source of an embedded iFrame element, i.e., "StreamingSiteURL" will be embedded onto an Agile streaming page.
- PurchaseURL - After a customer clicks the "Click to Stream" button, the customer will be redirected to "StreamingSiteURL."
- Vimeo - A standard Vimeo video stream.
- VimeoLive - A Vimeo Live livestream.
- VimeoShowcase - A Vimeo Showcase (an embeddable Vimeo playlist).
- ZoomMeeting - A Zoom Meeting which participants do not have to sign into or use a registration link to access.
Two Streaming Custom properties, StreamingWindowType and StreamingHours, require a little more explanation. StreamingWindowType and StreamingHours work together to determine how long customers will be able to access your streamed event. Their basic relationship is this: StreamingWindowType determines at what point in time customers may begin streaming this Show. Once that point in time begins, StreamingHours determines how many hours customers have before their streaming link is no longer valid.
Any amount of hours (0, 2, 24, 72, etc.) can be inputted into StreamingHours. If no value is inputted, StreamingHours will default to 48 hours.
The values for StreamingWindowType are as follows:
- FirstWatch: Once a customer has clicked the Play button on the Streaming Welcome Page for the first time, they may watch the stream until the time defined by "StreamingHours" has passed. For example, if StreamingHours were set to 24, then the customer would have 24 hours after they clicked the Play button to watch the stream. If no value is chosen for StreamingWindowType, it will default to FirstWatch.
- PurchaseDate: Once a customer has purchased a ticket to the stream, they may watch the stream until the number of "StreamingHours" have passed after the time of purchase. For example, if StreamingHours were set to 72, then the customer would have 72 hours after they bought access to the stream to watch it.
- OpenToAll: The customer must sign in to their account with your organization to access the streaming, but they are not required to purchase a ticket. They may watch the stream at any time until the number of "StreamingHours" after the End Date defined for each of the Show's Sales Channels at the Showing level. For example, if StreamingHours is were to 2 and the End Date of the Sales Channel were set to May 15 at 5:00 PM, then the customer would be able to watch the stream until May 15 at 7:00 PM. If StreamingHours is 0, the Sales Channel End Date would be the hard stop for streaming on this Show.
- OpenToMembers: A customer must sign in with an active membership to view the stream. They may watch the stream at any time after their purchase until "StreamingHours" after the End Date defined for the Show's Sales Channels at the Showing level. If StreamingHours is 0, the Sales Channel End Date would be the hard stop for streaming on this Show.
Setting the Showing's Start and End Dates in the General and Sales Channel Tabs
With streamed events, you will generally only need to make one showing that spans the length of the entire streaming period.
Once you have created a Showing for a Streamed events, there are two things to keep in mind:
I. The Showing's Duration
In the General Tab of the Showing's Properties, you will see that you can adjust a Showing's Duration. With a regular in-person event, you would set a Showing's Duration to be the run-time of the event. With a streamed event, however, the Duration determines the period of time when customers may access and view the event. Therefore, the Duration must be set to the entire length of time when customers are able to access the stream. If a streamed event should be accessible for 15 days and 20 minutes, then its duration should be 360 hours and 20 minutes.
It may also be helpful to check the box next to Show End Date. This will allow customers to see the length of the total streaming period online. You may also choose to check the box next to "Show time with date" to make the exact time display, as well.
Note: If a streamed event does not display online even when you have set its duration to its full run-time, the next step would be to look at the Properties of the entry point that should house that event. We have found that if a streamed event's Duration exceeds its End Date Offset, the event will not display correctly. For example, if the event's Duration is 9999 hours but the entry point only displays events up to 12 (only about 8765 hours) months in the future, the event will not appear on the entry point.
II. The Showing's Sales Channel Dates
Just like with any other Show, you may set a streamed event's on- and off-sale dates in the Sales Channels tab of the Showing's Properties. However, the StreamingWindowType Custom Properties may make it so that a customer may continue to watch a streamed event after that event's End Date has passed.
It all depends on the StreamingWindowType and StreamingHours set for the Streamed Event in the Custom Properties at the Show level. For example, say that a streamed film's StreamingWindowType is set to FirstWatch, its StreamingHours is set to 48 hours, and its off-sale date is May 1 at 5:00 PM. If a customer only clicks the "play" button for the film on May 1 at 3:00 PM and does not refresh the window in their browser where the film is playing, they may be able to watch the stream until May 3 at 3:00 PM.
Due to certain distributors requiring strict windows of access to their content, the above example may not be ideal for all organizations. In that case, we suggest that you subtract the number of "StreamingHours" and the actual run-time of the film from your End Date of your streamed content. If the organization streaming content in the above example wanted May 1 at 5:00 PM to be a hard cut-off date for a 2-hour streamed film, then they would set the End Date to be April 29 at 3:00 PM, 50 hours before.
In this case, it would be important to communicate to warn customers that April 29 at 3:00 PM through May 1 at 5:00 PM would be a "grace period" for them to finish watching the film. It would also be important to communicate to customers that if they refresh their browser during that grace period, they will lose access to the film.
Video Platform Details
There are several video platforms which work well in the AgileLINK setup: Vimeo, CineSend/BitCine, Zoom, CloudWatch, and others. You will need an account with one of these platforms in order to use AgileLINK correctly.
We are in the process of creating articles that outline how to adjust the account settings for each platform to keep videos secure. As those articles are finished, they will be added below.
Note: Your organization does not necessarily need to have its own account on a video platform--for instance, you may be able to obtain Video IDs from a distributor's Vimeo account. In that case, you will need to share these instructions with the account holder in order to make sure that the videos are embeddable on the necessary web pages.
CineSend/BitCine: In Progress
Zoom: In Progress
CloudWatch: In Progress