Syndication Implementation Guide

Syndication works by using a unique identifier to match products in the source and destination accounts. Content is then synchronized once every 24 hours from the source account/product to the target account/product.

How it works

Your Yotpo Customer Success Manager will be able to configure your accounts for syndication according to your specifications, however, you must first provide your CSM with the product and account information outlined in this guide. Once your product identifiers have been assigned and matched accordingly, contact Yotpo Support and let us know which parameter you wish to use for Syndication.

Setting up syndication

It is important to verify that products are correctly assigned a unique identifier and that the identifiers are identical (including matching case) in the source and destination products. 

You may use more than one type of identifier to match products.

Yotpo currently supports the following standard product identifiers:

• UPC (Universal Product Code)
• MPN (Manufacturer Part Number) + Brand
• ISBN (International Standard Book Number)
• SKU (Stock-keeping unit)
• Product ID (The ID associated with every order per eCommerce platform) 

Setting up product identifiers

You may choose between one of the methods listed below to assign product identifiers which will ensure that they are read correctly by Yotpo and syndicated successfully. 

Set up for Shopify store owners

Shopify users benefit from an automated process that does not require you to update product identifiers. It is, however, recommended to review relevant product identifiers in Product > Inventory to ensure that all unique identifiers (SKU, ISBN, UPC, etc.) are the same across all of your stores for the products you wish to syndicate. 

Set up by product catalog

You may use the Product Catalog to update product identifiers. This method allows you to add new products and their identifiers or update existing products with their identifiers. 

• If you are importing a new product (you haven't sent it to Yotpo via the API), refer to the instructions here. 
• If you are updating the product specs for an existing product (already sent to Yotpo or reviewed in the past), refer to the instructions here.

Set up by API endpoint

The API is a direct and useful way to update product specs. 

For customers who already use the API calls, this is the recommended way to update specs.

Assigning product specifications

Use the [specs] parameter in the Create product API call.

Editing product specifications

Submit the product specifications again in the same order, replacing the product specifications you wish to change using the Update product API call.

Deleting product specifications

Submit the product specifications again in the same order, replacing the product specifications you wish to delete with "".

Set up by widget

You may use the widget to update product identifiers, however, please consider the following limitations of this method:

1. Product specifications cannot be changed or deleted using the widget. 
2. Product specifications will be applied within the Yotpo system only after the first review is generated for that product. 

Assigning product specifications using the widget

1. Open the main widget on your product page.
2. Add the data-product-spec field to the div.

<div class="yotpo yotpo-main-widget"
 data-product-id="{PRODUCT_SKU}"
 data-name="{PRODUCT_NAME}"
 data-url="{PRODUCT_URL}"
 data-image-url="{IMAGE_URL}"
 data-description="{PRODUCT_DESCRIPTION}"
 ...
 data-product-spec-upc="{Tag}"
 data-product-spec-mpn="{Tag}"
 data-product-spec-brand="{Tag}"
 data-product-spec-isbn="{Tag}"
 data-product-spec-sku="{Tag}"
 data-product-spec-external=sku="{Tag}"
 >
</div>

Example

To add the ISBN product specification “paper” to PROD1234:

<div class="yotpo yotpo-main-widget" data-product-id="PROD1234"
 data-name="75 GSM US Letter White Printer Paper"
 data-url="http://www.gkstore.com/paper/75GSMUSLWPP.html"
 data-image-url=" http://www.gkstore.com/paper/75GSMUSLWPP.JPG"
 data-description="Plain white paper for laser printers. 75 GSM, 8.5” x 11”
 data-product-spec-isbn="paper">
</div>

Final steps

Once your product identifiers have been assigned and matched accordingly, contact Yotpo Support and let us know which parameter you wish to use for Syndication. Syndication will only be enabled once a Yotpo representative sets it up.