1"use strict";(globalThis.webpackChunkbambuser_docs||=[]).push([[134],{29794(e,n,t){t.r(n),t.d(n,{assets:()=>l,contentTitle:()=>a,default:()=>h,frontMatter:()=>r,metadata:()=>i,toc:()=>c});const i=JSON.parse('{"id":"troubleshooting/wrong-shoppable-videos-appearing","title":"Wrong Shoppable Videos Appearing","description":"Wrong videos appearing: placement matched by Page URL + Component ID (component-id or playlist-auto-id-N); use BamHub Placements to find the winning one.","source":"@site/shoppable-video/troubleshooting/wrong-shoppable-videos-appearing.md","sourceDirName":"troubleshooting","slug":"/troubleshooting/wrong-shoppable-videos-appearing","permalink":"/docs/shoppable-video/troubleshooting/wrong-shoppable-videos-appearing","draft":false,"unlisted":false,"tags":[{"inline":true,"label":"shoppable videos","permalink":"/docs/shoppable-video/tags/shoppable-videos"}],"version":"current","frontMatter":{"title":"Wrong Shoppable Videos Appearing","description":"Wrong videos appearing: placement matched by Page URL + Component ID (component-id or playlist-auto-id-N); use BamHub Placements to find the winning one.","slug":"wrong-shoppable-videos-appearing","tags":["shoppable videos"],"hide_table_of_contents":false}}');var o=t(74848),s=t(28453);const r={title:"Wrong Shoppable Videos Appearing",description:"Wrong videos appearing: placement matched by Page URL + Component ID (component-id or playlist-auto-id-N); use BamHub Placements to find the winning one.",slug:"wrong-shoppable-videos-appearing",tags:["shoppable videos"],hide_table_of_contents:!1},a=void 0,l={},c=[{value:"Understanding Placements and Component IDs",id:"understanding-placements-and-component-ids",level:2},{value:"How the "Best Match" is Decided (Specificity)",id:"how-the-best-match-is-decided-specificity",level:2},{value:"How to Identify the Active Placement",id:"how-to-identify-the-active-placement",level:2},{value:"Technical Verification: Finding your component ID",id:"technical-verification-finding-your-component-id",level:2}];function d(e){const n={admonition:"admonition",code:"code",h2:"h2",hr:"hr",li:"li",ol:"ol",p:"p",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,s.R)(),...e.components};return(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(n.p,{children:"If your Shoppable Videos are missing or displaying the wrong content, the most common cause is a placement misconfiguration."}),"\n",(0,o.jsx)(n.hr,{}),"\n",(0,o.jsx)(n.h2,{id:"understanding-placements-and-component-ids",children:"Understanding Placements and Component IDs"}),"\n",(0,o.jsxs)(n.p,{children:["A ",(0,o.jsx)(n.strong,{children:"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:"]}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.strong,{children:"Page URL"}),": The web address where the video lives."]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.strong,{children:"Component ID (component-id)"}),": The unique identifier for the ",(0,o.jsx)(n.code,{children:"<bam-playlist>"})," element in your code."]}),"\n"]}),"\n",(0,o.jsx)(n.admonition,{title:"Pro Tip",type:"tip",children:(0,o.jsxs)(n.p,{children:["While we automatically assign IDs (e.g., ",(0,o.jsx)(n.code,{children:"playlist-auto-id-0"}),"), we strongly recommend manually assigning unique IDs to your ",(0,o.jsx)(n.code,{children:"<bam-playlist>"})," elements. This makes targeting much more reliable and easier to manage."]})}),"\n",(0,o.jsx)(n.hr,{}),"\n",(0,o.jsx)(n.h2,{id:"how-the-best-match-is-decided-specificity",children:'How the "Best Match" is Decided (Specificity)'}),"\n",(0,o.jsxs)(n.p,{children:["A single ",(0,o.jsx)(n.code,{children:"<bam-playlist>"}),' can only have one active placement. If multiple placements overlap, our system uses a "specificity" hierarchy to choose the winner:']}),"\n",(0,o.jsxs)(n.table,{children:[(0,o.jsx)(n.thead,{children:(0,o.jsxs)(n.tr,{children:[(0,o.jsx)(n.th,{children:"Priority"}),(0,o.jsx)(n.th,{children:"Match Type"}),(0,o.jsx)(n.th,{children:"Description"})]})}),(0,o.jsxs)(n.tbody,{children:[(0,o.jsxs)(n.tr,{children:[(0,o.jsx)(n.td,{children:(0,o.jsx)(n.strong,{children:"1. Highest"})}),(0,o.jsx)(n.td,{children:"Exact URL"}),(0,o.jsx)(n.td,{children:"Placements with a manually added, exact URL match."})]}),(0,o.jsxs)(n.tr,{children:[(0,o.jsx)(n.td,{children:(0,o.jsx)(n.strong,{children:"2. High"})}),(0,o.jsx)(n.td,{children:"Multiple Matching Criteria"}),(0,o.jsx)(n.td,{children:"Placements that match both a URL pattern and a Component ID."})]}),(0,o.jsxs)(n.tr,{children:[(0,o.jsx)(n.td,{children:(0,o.jsx)(n.strong,{children:"3. Tie-breaker"})}),(0,o.jsx)(n.td,{children:"Age"}),(0,o.jsx)(n.td,{children:"If two (or more) placements have equal specificity, the oldest one wins."})]})]})]}),"\n",(0,o.jsx)(n.hr,{}),"\n",(0,o.jsx)(n.h2,{id:"how-to-identify-the-active-placement",children:"How to Identify the Active Placement"}),"\n",(0,o.jsx)(n.p,{children:'If you aren\'t sure which placement is currently "winning" on a specific page, use the "Your Pages" workflow in BamHub:'}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.strong,{children:"Navigate to Placements"}),": Log in to your dashboard and go to the ",(0,o.jsx)(n.strong,{children:"Placements"})," section."]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.strong,{children:'Open "Your Pages"'}),": Click the ",(0,o.jsx)(n.strong,{children:"YOUR PAGES"})," button on top right, to see all indexed URLs where Bambuser scripts are active."]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.strong,{children:"Select or Search"}),": Select or enter the URL of the page you are troubleshooting and click the result."]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.strong,{children:"Identify the Component"}),": If the page has multiple components on it, select the ",(0,o.jsx)(n.strong,{children:"Component ID"})," for the component in question."]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.strong,{children:"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."]}),"\n"]}),"\n",(0,o.jsx)(n.hr,{}),"\n",(0,o.jsx)(n.h2,{id:"technical-verification-finding-your-component-id",children:"Technical Verification: Finding your component ID"}),"\n",(0,o.jsx)(n.p,{children:"If you aren't sure which ID to look for, you can find it in your website's source code:"}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.strong,{children:"Manual IDs"}),": Look for the ",(0,o.jsx)(n.code,{children:"component-id"})," attribute within the ",(0,o.jsx)(n.code,{children:"<bam-playlist>"})," tag."]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.strong,{children:"Auto-assigned IDs"}),": If no ID is specified, they are assigned by their order on the page. The first is ",(0,o.jsx)(n.code,{children:"playlist-auto-id-0"}),", the second is ",(0,o.jsx)(n.code,{children:"playlist-auto-id-1"}),", and so on."]}),"\n"]})]})}function h(e={}){const{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,o.jsx)(n,{...e,children:(0,o.jsx)(d,{...e})}):d(e)}},28453(e,n,t){t.d(n,{R:()=>r,x:()=>a});var i=t(96540);const o={},s=i.createContext(o);function r(e){const n=i.useContext(s);return i.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function a(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:r(e.components),i.createElement(s.Provider,{value:n},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.