Skip to main content

My videos are not automatically appearing on PDPs (SKU-based distribution)

SKU-based Distribution

This troubleshooting guide is specifically for SKU-based automatic distribution, where videos are matched to products by their SKU (Product Reference). There are three methods for automatic playlists on PDPs:

This guide covers requirements for methods 2.1 and 2.3. If you're using tag-based distribution (2.2), see the tag-based distribution guide instead.

Method 2.3: Explicit SKU Override

If you're using query="sku:abc123" in your <bam-playlist> element (method 2.3), the specified SKU will override the SKU that would normally be scraped from the page. In this case, Requirements 1 and 2 below do not apply, as the SKU is explicitly set in the code rather than being scraped or matched. See method 2.3 documentation for more details.

To ensure your videos automatically appear on your Product Detail Pages (PDPs) using SKU-based distribution, all the requirements outlined below must be met. Each step is critical for video distribution to function seamlessly.

Requirements​

  1. The Bambuser Product Scraper retrieves the Product Reference from your PDP (Product Detail Page).

  2. The Product Reference in Bambuser must match the one obtained through the Product Scraper.

  3. Your product must be linked to at least one video.

  4. Your playlist should not have query="none" attribute.

How to Open the DevTools​

  • Chrome/Edge: Right-click on the page, select Inspect, and navigate to the Console or Network tab.
  • Firefox: Right-click on the page, select Inspect Element, and open the Console or Network tab.
  • Safari: Enable Develop Mode in Preferences, then use Develop > Show Web Inspector.

Checklist for Troubleshooting​

1. Requirement 1: The Bambuser Product Scraper retrieves the Product Reference from your PDP.​

Steps to verify:

  1. Navigate to Product Scraper Testing Tool.
  2. Enter your PDP URL in the tool.
  3. Confirm that the Bambuser Scraper retrieves the Product Reference automatically.
  4. If it fails to scrape the Product Reference, read more on how to fix it here.

Example:
We take https://demo.bambuser.shop/product/1737/bambuser-hoodie/ as an example.

When entering the URL into the Product Scraper tool, we see that the Product Reference is correctly scraped as 1737.

req1

2. Requirement 2: Product Reference must match the one obtained through the Product Scraper.​

Steps to verify:

  1. Navigate to your BamHub.
  2. Go to the Pages section.
  3. Add your product (if not already added).
  4. Check the "Product Reference" field for your product.
  5. Ensure it matches the reference retrieved via the Product Scraper.

Note: The Product Reference can be modified manually if needed.

Example:
We take https://demo.bambuser.shop/product/1737/bambuser-hoodie/ as an example again.

The Product Reference in BamHub is 1737, matching the reference obtained via the Product Scraper (Requirement 1)

req2

3. Requirement 3: Product must be linked to at least one video.​

Steps to verify:

  1. Navigate to your BamHub.
  2. Go to the Videos section.
  3. Click on the video you want to associate with a product.
  4. Scroll down to the Products section.
  5. Link the product to the video.

Example:
For the product Bambuser Hoodie, associated with the URL https://demo.bambuser.shop/product/1737/bambuser-hoodie/, it is linked to the "Fashion Video."

req3

4. Requirement 4: Your playlist should not have query="none" attribute.​

Steps to verify:

  1. Navigate to your PDP where <bam-playlist> is integrated.
  2. Inspect the HTML source code or use browser DevTools to find the <bam-playlist> element.
  3. Ensure that the query attribute is either not present, or if present, it should not be set to "none".
  4. If query="none" is found, remove it or change it to allow automatic distribution.

Note: The query="none" attribute disables automatic playlist population based on product SKU. For SKU-based automatic distribution to work, this attribute must not be set to "none".

Note: If you're using query="sku:abc123" to explicitly specify a SKU, this overrides the scraped SKU and Requirements 1 and 2 do not apply. The playlist will use the SKU specified in the query attribute instead.

Example:

<!-- ❌ This will prevent automatic distribution -->
<bam-playlist org-id="your-org-id" query="none"></bam-playlist>

<!-- ✅ This allows automatic distribution (uses scraped SKU) -->
<bam-playlist org-id="your-org-id"></bam-playlist>

<!-- ✅ This allows automatic distribution (uses explicit SKU, overrides scraped SKU) -->
<bam-playlist org-id="your-org-id" query="sku:abc123"></bam-playlist>

If you're experiencing the opposite issue—unwanted videos appearing on your PDPs—see Unwanted videos appearing on our PDPs to learn how to disable automatic distribution.