The first step to integrating your online store with your Photoslurp account is to sync your store's product feed with Photoslurp. Here you have two options:
Google Shopping Feed
If your store already provides a feed (or feeds in case it has multiple languages) that follows the Google Product Feed specification, there is not much else that you need to do here. Make sure that the file is available at a publicly accessible URL, and then prepend the feed/s URL/s with the following:
XX = Letter language code (eg: en or en_us)
YYY = 3 letter currency code (eg: usd or eur)
ZZ = the URL of the Google Product feed in XML or CSV/TSV format (eg: http://brand.com/google.xml)
Important: Ensure that the language and currency code you use here are the ones used by your eCommerce platform.
Once you have crafted the URL head to STEP 2 - Creating a Product Catalog in the Photoslurp dashboard to sync your feed with Photoslurp.
CSV
You can also use a standard CSV file that contains the product information. Ensure this file is hosted on your server and that you have the URL for it as you will need this URL in the next step of the setup process. The CSV file should conform to the following:
- The delimiter must be the pipe symbol '|'
- The file must be UTF-8 encoded
- A header row must be included containing the following values:
sku|group_id|title_<langcode>|description_<langcode>|url_<langcode>|image_url|in_stock_<langcode>|product_types
Note: <langcode> values will need to be adapted to your configuration as described below. - Apart from sku, title, url and image_url fields, all other fields are optional. Nevertheless, we recommend providing as many fields as possible because extra fields enable advanced features that can help you build a better experience for your visitors.
- The group ID can be used to group variants together under one ID.
- The <langcode> suffixes appended to "title", "description", "url" and "in_stock" fields can be in any existing language code format (i.e. en, en-us, en_US) and they only need to be included in the header row of the file.
These language codes are the mechanism by which our platform knows about the localized versions of the products that the widgets on your site/s will request. You can create multiple columns for the title, description, URL, and stock fields for every language that you want to include.
Note: Make sure that the language code suffixes provided in the header row match the language codes used in your eCommerce platform. - The values for the in_stock column are either 'in stock' or 'out of stock'. This column is only necessary if you plan on using the ‘stock sync’ feature in Photoslurp.
- Product types should include category information for the product should you wish to use our widget category filtering options. Category names can be comma separated (e.g. "Summer sales, Men > Swimwear", "BrandXYZ"). The angular bracket is used to depict hierarchy. (e.g. Men > Shoes > Running shoes)
You can download and examine this product feed example which will help you understand the product feed specifications.
Note: Please ensure that your eCommerce platform exports the product feed file on a regular basis so that it contains the most up to date product information. Our platform will download the product feed every 24 hours.
Multilanguage sites
Multilanguage sites are indeed supported in our platform. You can find more information on how to configure Photoslurp to work with multilanguage sites in this article.