Skip to main content

Wrong Shoppable Videos Appearing

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:

  • Page URL: The web address where the video lives.
  • 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:

PriorityMatch TypeDescription
1. HighestExact URLPlacements with a manually added, exact URL match.
2. HighMultiple Matching CriteriaPlacements that match both a URL pattern and a Component ID.
3. Tie-breakerAgeIf 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 on top right, 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 Component ID. You can then click through to modify the settings or update relevant placements to resolve your issue.

Technical Verification: Finding your component 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.