Welcome to Bambuser Knowledge Base. Whether you're seeking information, looking for solutions, or simply exploring, we're here to assist you every step of the way.

Live
Video Consultation
Shoppable Video
Chat

Troubleshooting: Shoppable Videos Not Appearing on My Website

If your Shoppable Videos aren't appearing as expected, don't worry - most issues can be resolved with a few quick checks. For developers or those comfortable with code, you can head straight to our Technical Documentation (link below this paragraph) for deep-dive solutions and step-by-step implementation guides.

 

https://bambuser.com/docs/shoppable-video/troubleshooting/shoppable-videos-not-appearing/

 

However, if you prefer a non-technical approach, you can troubleshoot directly within the Bambuser BamHub. Often, if videos are missing or displaying the wrong content, the culprit is a placement misconfiguration. Use the guide below to get things back on track.

If your Shoppable Videos are missing or displaying the wrong content, the most common cause is a placement misconfiguration.

Understanding Placements and Component IDs

A Placement configuration is a rule that tells our system which videos to show on a specific part of your site. It looks for a match based on two factors:

  1. Page URL: The web address where the video lives.
  2. Component ID (component-id): The unique identifier for the bam-playlist element in your code.

Pro Tip: While we automatically assign IDs (e.g., playlist-auto-id-0), we strongly recommend manually assigning unique IDs to your bam-playlist elements. This makes targeting much more reliable and easier to manage.

 

How the "Best Match" is Decided (Specificity)

A single bam-playlist can only have one active placement. If multiple placements overlap, our system uses a "specificity" hierarchy to choose the winner:

Priority

Match Type

Description

1. Highest

Exact URL

Placements with a manually added, exact URL match.

2. High

Multiple Matching Criteria

Placements that match both a URL pattern and a Component ID.

3. Tie-breaker

Age

If two(or more) placements have equal specificity, the oldest one wins.

How to Identify the Active Placement

If you aren't sure which placement is currently "winning" on a specific page, use the "Your Pages" workflow in BamHub:

 

  1. Navigate to Placements: Log in to your dashboard and go to the Placements section.
  2. Open "Your Pages": Click the YOUR PAGES button to see all indexed URLs where Bambuser scripts are active.
  3. Select or Search: Select or enter the URL of the page you are troubleshooting and click the result.
  4. Identify the Component: If the page has multiple components on it, select the Component ID for the component in question.
  5. Analyze & Resolve: The dashboard will highlight exactly which placement is currently utilizing that ID. You can then click through to modify the settings or update relevant placements to resolve your issue.

 

Technical Verification: Finding your ID

If you aren't sure which ID to look for, you can find it in your website's source code:

  • Manual IDs: Look for the component-id attribute within the <bam-playlist> tag.
  • Auto-assigned IDs: If no ID is specified, they are assigned by their order on the page. The first is playlist-auto-id-0, the second is playlist-auto-id-1, and so on.
Related Questions