Adding Feedless with Product Variants (PDPs)

[CommunityJedi22]

Note: Display 4.0 documentation is provided as a courtesy for clients on this older version of PowerReviews. We recommend contacting your Account Manager to discuss upgrading to our newer Display 4.1 version as soon as possible.

This article discusses how to implement Feedless Product Data code on your product detail pages (PDPs) with product variants being present. 

To learn more about implementing Feedless without product variants, click here. To learn how to troubleshoot your Feedless Product Data code, click here. To learn more about Feedless and its features and considerations, click here.

Installations Steps

1. Ensure you have already installed the PowerReviews UI.js library and render function on your pages with the components you will be using.
2. Paste the code sample directly underneath the review_wrapper_url variable with a focus on the product: { } object, as you should have already installed the other code.

The sample code below includes only three variants and is meant to illustrate how you should structure your variant data. You are not limited to three variants only, and can add more if needed.

<script src="https://ui.powerreviews.com/stable/4.0/ui.js" async></script>
         
 <script>
POWERREVIEWS.display.render({
   api_key: 'API_KEY',
   locale: 'LOCALE',
   merchant_group_id: 'MERCHANT_GROUP_ID',
   merchant_id: 'MERCHANT_ID',
   page_id: 'PAGE_ID',
   review_wrapper_url: 'WRAPPER_URL',
   //*** Start Feedless Product Code ***
   product:{
            name:'YOUR_PRODUCT_NAME',
            url:'YOUR_PAGE_URL',
            image_url: 'YOUR_PRODUCT_IMAGE_URL',
            description: 'YOUR_PRODUCT_DESCRIPTION',
            category_name: 'YOUR_PRODUCT_CATEGORY_NAME',
            brand_name: 'YOUR_PRODUCT_BRAND_NAME',
            price: 'YOUR_PRODUCT_PRICE',
            in_stock: 'PRODUCT_IN_STOCK_STATUS',
   variants: [{
            name: 'YOUR_VARIANT_NAME_1',
            image_url: 'YOUR_VARIANT_IMAGE_URL_1',
            upc: 'YOUR_VARIANT_UPC_1',
            page_id_variant: 'PAGE_ID_VARIANT_1',
      },
      {
            name: 'YOUR_VARIANT_NAME_2',
            image_url: 'YOUR_VARIANT_IMAGE_URL_2',
            upc: 'YOUR_VARIANT_UPC_2',
            page_id_variant: 'PAGE_ID_VARIANT_2',
      },
      {

            name: 'YOUR_VARIANT_NAME_3',
            image_url: 'YOUR_VARIANT_IMAGE_URL_3',
            upc: 'YOUR_VARIANT_UPC_3',
            page_id_variant: 'PAGE_ID_VARIANT_3',            
      }]
      },
   //*** End Feedless Product Code ***
   components: {
      ReviewSnippet: 'pr-reviewsnippet',
      ReviewDisplay: 'pr-reviewdisplay'
   }
});
</script>

3. In the product object you created, update all of the fields with the appropriate data below.

Required Fields at the Parent Level

Match the exact spelling and formatting to ensure your code is accurate.

Field	Description	Requirements	Example	Additional Notes
name	The name of your product.	Use only UTF-8 encoded characters.	Rivno® Jacket	The name will be visible to your customers on the write-a-review page and Follow-Up Email. Internally, the name will be visible in moderation and reporting.
url	The absolute URL of the PDP.	The URL shouldn’t contain spaces and should always begin with https.	https://www.prdemostore.com/ collections/apparel/products/ womens-fleet-jacket	The URL will be used to hyperlink the product name on the write-a-review page and for the "continue shopping" link (visible after submitting a review). Internally, you will see this URL in moderation and reporting.
image_url	The absolute URL where your product image is publicly hosted.	The URL shouldn’t contain spaces and should always begin with https.	https://cdn.shopify.com/s/files/ 1/1595/6395/products/ CUR7_HBM_hero_large.jpg?v=1478881740	The image will be visible to your customers on the write-a-review page and Follow-Up Email. Internally, the image will be visible in moderation.
description	A description of your product.	Avoid using line breaks or HTML tags and entities in the description, and use only UTF-8 encoded characters.	Go for a walk in the forest and stay dry during the rainy season with this slick jacket fully equipped with top-of-the-line water-resistant technology.	The description is used for moderation purposes and is not visible to your customers.
category_name	The category hierarchy of the product.	The maximum length for this variable is 300 characters.	Apparel > Jackets > Rain Jackets	This field will be available in reporting, allowing you to filter reviews by category.
brand_name	The product brand.		The North Face	This field is required for Syndication. It will also be available in reporting, allowing you to filter reviews by brand.

Optional Fields at the Parent Level

If you elect to use any of these fields, match the exact spelling and formatting to ensure your code is accurate.

Field	Description	Requirements	Example
price	The price of the product.	This field can include a decimal point. Currency symbols should not be included.	230.00
in_stock	The stock value of the product.	'1' if the product is in stock or '0' if it is out of stock.	1
add_to_cart_url	The hyperlink to add the product to the customer's cart.		https://www.example.com/store/cart-AddProduct?pid=1234&Quantity=1
asin	Amazon Standard Identification Numbers (ASINs) are unique blocks of 10 letters and/or numbers that identify items - used for the Share to Amazon feature.	Must be 10 characters	B00005N5PF

Required Fields at the Variant Level

Match the exact spelling and formatting to ensure your code is accurate.

Field	Description	Requirements	Example	Additional Notes
page_id_variant	The unique product identifier at the child level; this can be the UPC if you do not have a system-defined value. The page_id_variant is determined by you.	This field can include up to 50 alphanumeric characters. page_id_variant values are case sensitive. Hyphens ( - ) and underscores ( _ ) can be used.	AXS-345	While reviews always roll up to the page_id level, including a page_id_variant will allow you to identify the specific variation of the product being reviewed.
manufacturer_id	The manufacturer model or part number.		xlslmpprod-1790001-a	This field is required for Syndication.
upc	The 12-digit Universal Product Code, the 13-digit International Article Number/European Article Number, or the 14-digit Global Trade Item Number.	This field can only be a string of digits and cannot include letters, spaces, or special characters.	872760558488	This field is required for Syndication.

Optional Fields at the Variant Level

If you elect to use any of these fields, match the exact spelling and formatting to ensure your code is accurate.

If you do not include the fields below, the variant will inherit the data you included at the parent level.

Field	Description	Requirements	Example	Additional Notes
name	The name of your product variant.	Use only UTF-8 encoded characters.	Red Rivno® Jacket	The name will be visible to your customers on the write-a-review page and Follow-up Email. Internally, the name will be visible in moderation and reporting.
image_url	The absolute URL where your product variant’s image is publicly hosted.	The URL shouldn’t contain spaces and should always begin with https.	https://cdn.shopify.com/s/files/ 1/1595/6395/products/ CUR7_HBM_hero_large.jpg?v=1478881740
asin	Amazon Standard Identification Numbers (ASINs) are unique blocks of 10 letters and/or numbers that identify items - used for the Share to Amazon feature.	Must be 10 characters	B00005N5PF

Considerations for Variants

PowerReviews will only collect Product Data for up to 3 variants at a time, selected at random, to avoid overloading the page. If you include more than 3 variants on a given page, multiple page visits will need to occur for the code to fire enough pixels to get through all variants.