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:
- Product specifications cannot be changed or deleted using the widget.
- 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
- Open the main widget on your product page.
- Add the data-product-spec field to the div.
- The data-product-spec tag must be in lowercase.
- Trailing spaces are automatically stripped in the product specification.
- Any combination of leading zeros (“0”), leading spaces, and leading dashes (“-“) are automatically stripped in the product specification.
- The product specification value is case-sensitive.
- The product specification value “N/A” is invalid in any case, and is ignored.
- The data-product-id attribute only supports alphanumeric (a...z, A...Z, 0...9) and "_" and "-" symbols.
<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.