Resources for Partners
Here you'll find valuable information and data templates to use when setting up your partnership with Snooth.
- Snooth's XML Data Feed Template
- Snooth's CSV Template
- Reporting and Conversion Tracking Code and Instructions
This page contains three main sections:
Snooth's Data Feed XML Template
Watch a video demonstration on how to upload a data feed to Snooth
Below you'll find a sample XML template. This is the preferred method for keeping Snooth up to date with your wine's information. If you are a retailer, you must include the name, sku, price, and product url. Please provide as much information as possible.
A general rule-of-thumb is that if you can open and view your XML file using a browser such as Firefox, your file will be readable by Snooth. Also, be sure to correctly escape any html tags.
<?xml version="1.0" encoding="UTF-8" ?> <document> <wine> <sku> Your unique id for the wine</sku> <name> The name of the wine as displayed on your site</name> <vintage> The wine vintage</vintage> <product_url> The URL for the wine</product_url> <image_url> The URL for the wine image</image_url> <vineyard> The name of the vineyard of the wine</vineyard> <winery> The name of the producer of the wine</winery> <winemaker> The name of the winemaker</winemaker> <owner> The name of the owner if it is different than the name of the winery</owner> <brand> The brand name of the wine, if different from the winery or owner</brand> <designation> Any other name terms not captured in a separate field, such as Reserva</designation> <color> The wine color (red, white or rose only)</color> <type> The type of wine (table, sparkling,port, sherry, madeira, icewine etc)</type> <country> The country of origin</country> <appellation> The Appellation/District of origin (most specific level)</appellation> <varietal> The wine varietal, including blend composition (eg. Cabernet Sauvignon (50%); Merlot (50%))</varietal> <price> Retail price at which the wine sells on your site You may only use decimal numbers in this field.</price> <sale_price> Discounted price for current promotions</sale_price> <currency> 3-letter currency code (i.e. USD,GBP,EUR). Required for non-USD prices</currency> <in_stock> Binary flag indicating if the wine is in stock (1=yes, 0=no)</in_stock> <bottle_size> The bottle size (in ml eg. 750)</bottle_size> <percentage> The percentage alcohol by volume</percentage> <weight> The weight of the wine (in lbs, use decimals, not ounces. eg. 2.8)</weight> <reviews> <review> Text of first <br> review</review> <review> Text of second review</review> </reviews> <winery_notes> Notes provided by the winery</winery_notes> <upc> UPC number</upc> <drink_after> Recommended date to drink wine after</drink_after> <drink_before> Recommended date to drink wine before</drink_before> <kosher> Kosher wines (1=yes, 0=no)</kosher> <non_alcoholic> Non-Alcoholic wines (1=yes, 0=no)</non_alcoholic> <organic> Organic wines (1=yes, 0=no)</organic> <acidity> Acidity Level (pH ideally)</acidity> <sugar> Sugar Level (in g/l. eg. .50)</sugar> </wine> </document>
Snooth's CSV Template
If you are unable or prefer not to provide an XML-based feed of your wine data, you may also provide the data in CSV format. See below for an example, and download the CSV template
CSV files can be generated from within Excel by creating a document and saving it as a CSV file. Please be aware that quotes ("") are not compatible with CSV files so please do not use them.
Please try to fill out as many columns as possible. The product url, price, and id are required for retail providers. You must include the header row at the top of your file, so that we can match the names. You can include as many reviews as you want in the final columns, but they must have "Review <#Number>" as the header.
If you are using a spreadsheet program to manage your information, you must export or save it as a flat, comma-delimited CSV file before submitting it. Please note that if you are a retailer, you will need to submit a new data file (or mark your most recent data file as current) every 30 days using the Feed page on your Partnership Hub.
| Sku | Name | Vintage | Appellation | Winery | Vineyard | Varietal | Type | Color | Price | Currency | UPC | Organic | Kosher | Non-Alcoholic | Winery Notes | Bottle Size | Sugar | Product URL | Image URL | Drink After | Drink Before | Acidity | Review 1 | Review 2 | Review 3 | Review #etc. |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 00883 | White Horse Reserve Cabernet | 2005 | Napa Valley | White Horse | Cabernet Sauvignon | Table Wine | Red | 25.99 | GBP | 00181288 | 1 | "…It was a rainy summer…" | 750 | 3 | http://… | http://… | 10/2010 | 2014 | 4 | 5 out of 5 by the Chicago Monthly | "…rich bicycle-seat aromas…" | ... more reviews | ||||
| 00884 | ... etc. |
Reporting and Conversion Tracking
In order to track the sales we refer to your website, a small piece of hidden code must be integrated into your website. It's important to keep in mind that this code will not function if it's pasted as-is. Instead, you or your webmaster will need to modify some of the variables to match the variables used in your website.
Option 1
This code should be placed on the order confirmation page of your e-commerce website. This is the page that users see after they have successfully made a purchase. The code works by notifying Snooth every time a purchase is made from a user who we referred to your site so it can be logged.
<script type="text/javascript"> //Don't modify above this line ----------------------------------------------------------------- var snooth_merchant_id = 555; //set this to your merchant id - this value should always stay the same var snooth_order_id = '1000'; //set this to your order id - unique for every order var snooth_order_amount = 317.48; //set this to the full dollar amount of purchase - unique for every order var snooth_order_data = '100:125.99:2;101:65.50:1;'; // sku:price:quantity; for each item purchased. For example, //the order above means 2 orders of sku 100 (which cost $125.99 each), and 1 order of sku 101 (that costs $65.50 each). //Don't modify below this line ----------------------------------------------------------------- var snoothtrack = new Image(); snoothtrack.src='https://www.snooth.com/track/' + snooth_merchant_id + '/' + snooth_order_id + '/' + snooth_order_amount + '/' + snooth_order_data; </script>
Option 2
This code should be placed in the footer of your website so it appears on every page. If you don't have a dynamic website with a footer template you can modify, use Option 1. If your website uses a shopping cart that changes domains or uses a lot of redirecting urls (such as through Yahoo or PayPal), then you should use this option.
<script type="text/javascript"> //Don't modify above this line ----------------------------------------------------------------- __sn_m = 555; //set this to your merchant id - this value should always stay the same __sn_o = '1000'; //set this to your order id - unique for every order __sn_s = 317.48; //set this to the full dollar amount of purchase - unique for every order __sn_d = '100:125.99:2;101:65.50:1;'; // sku:price:quantity; for each item purchased. For example, //the order above means 2 orders of sku 100 (which cost $125.99 each), and 1 order of sku 101 (that costs $65.50 each). //Don't modify below this line ----------------------------------------------------------------- __sn_a = 0, __sn_r = 0; if(document.location.toString().indexOf('__sn_ref=1') >= 0) { __sn_a = 1; } if(document.cookie.toString().indexOf('__sn_stc=1') >= 0) { __sn_r = 1; } if(__sn_a || __sn_o) { document.write(unescape("%3Cscript src='" + document.location.protocol + "//media1.snooth.com/js-compressed/t.js' type='text/javascript'%3E%3C/script%3E")); } </script> <script type="text/javascript"> if(__sn_a) { __sn_ssc(); __sn_r = 1; } if(__sn_r && __sn_o) { __sn_stc(); } </script>
