Embedded Listings
- Last updated on May 9, 2025 at 9:46 PM
- Features
- Get Tickets Button
- Ticket List
- Series Calendar
- Series Calendar w/ Inventory Filter
- Reserved Seating
- Feature Setup
- Cart Mode
- UTM, Tags & Google Cross Domain
- Marketing Support
Embedded listings enable you to integrate the checkout process into your website seamlessly. This grants you greater control over the branding and overall look and feel of the ticket purchase experience.
Note: You will need to have access to the HTML of your website or blog to use this feature.
Embed does not support redirect payment gateways (for example PayPal and Afterpay).
Features
Embedded Listings fall under the category of Event Listings. Unlike standard Event Listings that generate standalone pages, Embedded Listings offer an embeddable object for integration into your website, initiating a seamless checkout flow.
There are three types of Embedded Listings. While all three launch the checkout in the same way, they provide different starting points:
- Get Ticket button
- Ticket List
- Series Calendar
The implementation process for each type is identical. Simply configure the embedded listing as desired and save the changes. This action will generate a JavaScript snippet that a web developer can then place in their preferred location on your host website.
Note: Adding multiple JavaScript snippets of the 'same' event to a single webpage is not recommended. While it is possible to include multiple JavaScript snippets of different events on the same page, it's important to note that this won't enable a cart mode. Only one event is eligible for checkout at a time.
For all types, the checkout behavior mirrors that of standard Event Listings. Think of it as a simple cut-and-paste action, moving the 'Get Tickets' button from the standard Event Listing to your website.
Get Tickets Button
The 'Get Tickets' button is exactly what it sounds like—a button that says 'Get Tickets'! When added to a website, clicking this button will launch the checkout in an overlay, similar to standalone listings.
Like standard listings, you can customize both the 'Get Tickets' text and the button color.
This feature is available for both Single Events and Event Series.
Ticket List
The Ticket List or Ticket 'picker' embeds the ticket/product selection step of the checkout process. Like standard listings, you have the flexibility to customize the Price Levels and Products displayed specifically for the embedded picker. After customers make their selections and click 'Proceed to Checkout,' the remaining steps unfold in an overlay.
Available for Single events only.
Series Calendar
For Event Series, you have the option to embed the Series Calendar. Clicking on a date will initiate the time slot selection and the remaining checkout process in an overlay.
This feature is exclusive to Event Series.
Series Calendar w/ Inventory Filter
The Inventory Filter is a supported option when embedding a Series Calendar. Clicking on a date will initiate the time slot selection and the remaining checkout process in an overlay.
This feature is exclusive to Event Series.
Reserved Seating
Reserved seating is also supported through Embed. You can choose the initial iFrame load to start at:
- Button: Find Seats
- Ticket List: Select Seats, Find Best Available, Have a reserved seat code?
Feature Setup
Embedded Listings are setup just like standard Event Listings.
On the Event Overview, click the + icon to add a new Embedded Listing. This action will launch the Listings CMS and provide configuration options.
The Embed Listing CMS will largely have the same options as standalone listings, with a few different key differences.
Page settings, Header, and Event Details settings are removed since these are not relevant to embedded listings.
Embed settings are included to chose:
- Which of the three types of embedded listings that you want to create.
- The Cart dismissal behavior
- This sets whether the cart should minimize and pin to the top or bottom of the page. Or if dismissing the cart should just cancel/close out the reservation
Beyond that the features supported within Embedded Listings are the same as standalone listings. This includes:
- Upsells
- Series Calendar customizations
- Custom calendar colors
- Inventory filter
- List view etc.
Cart Mode
Cart Mode is not supported. For instance, if you add multiple embedded listings on the same webpage, each will be treated as a separate reservation.
It's recommended to configure the Cart Dismissal behavior for multiple embeds on the same page as 'Close Reservation.'
UTM, Tags & Google Cross Domain
Embed Ability to Read UTMs in the URL
Embed now recognizes UTMs in the parent page’s URL. For marketing integrations that are supported through ShowClix, these UTMs are relayed through the Embed object, attached to relevant marketing events, and sent to third-party analytics tools.
This feature is available for both the Marketing Helper and Advanced Marketing Helper Embed options. Simply add UTMs to your parent page URL and Embed will do the rest!
UTM support works with both existing and new embed codes. There is no need to replace your existing embed code on your parent page to take advantage of this feature.
Feature Support Breakdown
Basic Embed
- Not supported: The Basic Embed does not include marketing or pixel tracking capabilities.
- Possible exception: If Google Analytics 4 is set up in the ShowClix Marketing Admin, a 'page_view' event may still send with the UTMs, though this is not guaranteed.
Embed with Marketing Helper
- Supported: UTMs are fully supported with this option.
- Note: In Google Analytics, reporting may show 'reservation' instead of 'purchase.' This issue seems specific to Google, as Meta correctly tracks the purchase terminology.
Embed with Advanced Marketing Helper
Supported: UTMs are fully supported with the Advanced Marketing Helper option.
Embed with Marketing Snippet
- Web developer awareness: The web developer responsible for the parent page should already manage UTMs on their site and attach them to relevant actions in their website’s library.
- Google Analytics exception: If Google Analytics 4 is set up in the Marketing Admin, a 'page_view' event may send with UTMs in this setup.
Embed Ability to Read Leap Tags in the URL
Embed now supports recognizing Pro/Leap Tags in the parent page’s URL. These tags are relayed to the Embed object to trigger actions based on Marketing Tracking Tags or Coupon Tags.
Feature Support Breakdown
Basic Embed
Supported: ShowClix/Leap Tags are fully supported with the Basic Embed option.
Embed with Marketing Helper
Supported: ShowClix/Leap Tags are fully supported with the Marketing Helper option.
Embed with Advanced Marketing Helper
Supported: ShowClix/Leap Tags are fully supported with the Advanced Marketing Helper option.
Embed with Marketing Snippet
Supported: ShowClix/Leap Tags are fully supported with the Marketing Snippet option.
How to list your Leap Tag in the URL
The Embed will recognize the tag only if the URL is following the standard protocol of ?leap_tag=
The Embed feature looks for ?leap_tag= and will then apply the desired action.
- An example would be: ?leap_tag=discount5
- A full URL website example would be: https://www.yourwebsite.com?leap_tag=discount5
If you are using both UTMs and Leap Tags, the UTMs should come first in the URL.
If you list the Leap Tag first, the UTMs may not find their way to third-party analytics.
To combine UTMs and Leap Tags, use the '&' symbol after your UTM and before your Leap Tag.
An example of full URL with the & in red font bold to show its location:
Updating Your Embed Code for Leap Tag Recognition
To enable your embed to read Leap Tags in the parent URL, you’ll need to update the embed code on your parent page to the new version that includes the "leap-embed-script."
If you continue using the old embed code, it will still function, but it won’t read any tags from the parent page URL.
How to Identify the Old vs. New Embed Code
The new embed code includes the text "leap-embed-script" in the script section.
Example: Old vs. New Embed Code
Old Embed Code (Without Leap Tag Support):
New Embed Code (With Leap Tag Support) in Green:
How to Update to the New Embed Code
If you want your embed to recognize tags on existing events, you should copy and paste the new embed code from the Event Admin.
The embed code currently visible in the Event Admin and Embed Management Page now includes the "leap-embed-script" version by default.
Any new embed codes created will automatically have the "leap-embed-script" version.
Embed Ability to Read Google Cross Domain ?gl= Tag in the URL
Embed URLs now support Google Analytics 4 (GA4) Cross Domain setup. The ?gl= information will appear in the "page location" metadata of Google Analytics.
Example Scenario:
- You have a promotional website (Page A) that includes a link to redirect visitors to another page (Page B) on a different domain.
- Page B, also your site, contains the Embed object used to purchase tickets.
- The Embed object will now monitor the parent Page B URL for the ?gl= tag.
- If the ?gl= tag is passed from Page A to Page B, this GA4 cross-domain information will be captured by the Embed and sent to Google Analytics.
- Both Page A and Page B must be set up for GA4 cross-domain tracking, with the Google tag script and other necessary Google configurations. For more details, refer to: https://support.google.com/analytics/answer/10071811
Marketing Support
Refer to Embedded Listings Marketing Support.