You can find information specific to major platforms in the below articles. If yours isn't listed, check the rest of this page. If your data source is not listed below, please contact us at Searchspring Help Desk.
General Options
These options apply for CSV, JSON, XML, RSS, Magento, and Aabaco feeds.
Data Feed Location
Your store's product data must be stored online somewhere in order for us to access it. Enter the URL address of your data feed here.
Data Feed Security (Optional)
Searchspring supports downloading data feeds from URLs that are password protected using Basic Access Authentication. To enable this feature, enter the appropriate username and password. We strongly recommend the use of a secure (HTTPS) data feed URL in conjunction with Basic Access Authentication. This helps to ensure that the password is transmitted securely and that prying eyes won't see the password. Ensure that your data feed can be accessed securely via HTTPS and use the appropriate URL starting with https:// in the Data Feed Location above. Contact your IT department, web host or E-Commerce service provider for implementation assistance.
Data Feed Format: Encoding
This option applies for Magento, CSV, XML, RSS, and Aabaco feeds.
The character encoding used within your data feed. Consistent and valid encoding is important to ensure the best display of special characters like trademark symbols or non-English letters. Searchspring will attempt to auto-detect encoding and convert text accordingly, however specifying the correct encoding is a good idea. If you're not sure what encoding your data feed employs, it's better not to guess. (This is one of the geeky, technical things that must be exactly right.)
CSV Options
CSV Feed Format Configuration
- Delimiter: The character separating each field in your data.
- Quote Character: The character used for indicating a quote in your data.
Example CSV Data
id sku name brand url addtocart_url image_url thumbnail_url description price msrp categories colors display_colors rating num_ratings sizes
123 "ABJ-252" "Nike Track Jacket" "Nike" "http://www.mystore.com/ABJ252.html" "http://www.mystore.com/addtocart?id=123" "http://www.mystore.com/images/ABJ252.jpg" "http://www.mystore.com/thumbnails/ABJ252.jpg" "This is a really great jacket. It's available in several colors and will keep you warm." 49.99 54.99 "Apparel|Apparel/Men's|Apparel/Men's/Jackets" "Red|Blue|Black" "#D80626|#2B98E5|#121212" 5 4 "Small|Medium|Large"
162 "ADI-42" "Adidas Soccer Shirt" "Adidas" "http://www.mystore.com/ADI42.html" "http://www.mystore.com/addtocart?id=162" "http://www.mystore.com/images/ADI42.jpg" "http://www.mystore.com/thumbnails/ADI42.jpg" "This is a white t-shirt with a soccer ball on it." 13.99 18.99 "Apparel|Apparel/Men's|Apparel/Men's/Shirts" "White" "#FFFFFF" 3.5 2 "Large|X-Large"
You can download a copy of this sample feed here.
XML Options
XML Feed Format Configuration
- Record Element: The name of the XML element that contains each record. In the example below, "Product" would be the record element.
- Unique Key: The name of the attribute or element that contains the unique key for each record (such as a unique SKU or Product ID). In the example below, "ID" would be the Unique Key.
Example XML Data:
<Products>
<Product ID="123984">
<SKU>10-500XY</SKU>
<Name>Widget X</Name>
</Product>
<Product ID="324534">
<SKU>30-100AA</SKU>
<Name>Just Another Item</Name>
</Product>
</Products>
JSON Options
The JSON option supports an externally-hosted JSON file that is pulled in from the supplied URL. JSON must be formatted with one product record per line, and must be in flat format. Nested structures and arrays are not supported.
Data Feed Format
If you're passing the data that is being mapped to "Unique ID" in your Core Field mappings, and you're keying that field as "_id", then you can check the "includes _id" key box.
If you're unsure, leave this unchecked.
While currently not optimized, in the future indexing will be faster / more reliable when the "_id" key is provided.
Example JSON Data
{"id": "0001", "sku": "1234-567", "brand": "Nike", "title": "Product Name Number One", "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit", "link": "http://www.mywebstore.com/product1.html", "image_link": "https://www.mywebstore.com/product-images/product1.jpg", "thumbnail_image_link": "https://www.mywebstore.com/product-images/product1_th.jpg", "price": "52.00", "msrp": "75.00", "sale_price": "44.99", "on_sale": "Yes", "publish_date": "3/18/2018", "in_stock": "Yes", "color": "Blue"}
{"id": "0002", "sku": "1234-568", "brand": "Nike", "title": "Product Name Number Two", "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit", "link": "http://www.mywebstore.com/product2.html", "image_link": "https://www.mywebstore.com/product-images/product2.jpg", "thumbnail_image_link": "https://www.mywebstore.com/product-images/product2_th.jpg", "price": "50.00", "msrp": "70.00", "sale_price": "39.99", "on_sale": "No", "publish_date": "3/20/2018", "in_stock": "Yes", "color": "Red"}
Comments
0 comments
Article is closed for comments.