Marketplacer's MConnect enables retailers to sync product data from an XML feed to their seller account. This process pulls product information from the feed daily and synchronizes it with the Marketplacer platform. To begin, go to the seller's MConnect and select 'XML' as the integration platform.
Feed Format
The data feed for integrating with the Marketplace should be in XML format.
If you can generate a feed from your system, this should be sufficient to successfully import products. However, the Marketplacer feed also supports <quantity> (for setting stock levels), <specifications>, and <sku>. A full overview of supported fields is provided below.
Products with multiple variants should be represented as separate items, with a unique identifier provided as <item_group_id> to group the variants' items (use a parent SKU where possible). A data field with no value should be left empty in the feed.
Each item should be contained in an <item> tag, which should be within a <channel> and <rss> tag.
<rss> <channel> <item> <id>1234567890</id> <title>Product title</title> etc...
| Group | Attribute name | Type | Description |
| Basic product data |
id |
string |
Required Product's unique identifier |
|
title |
string |
Required Product name |
|
|
description |
string |
Required Product description |
|
|
spec |
string |
Optional Product specifications |
|
|
image_link |
string |
Required URL of the product's main image |
|
|
additional_image_link |
String/Array |
Optional URL of an additional image If there is only one additional image link included, the field should be a String. If two or more image links are included, the links should be stored in an Array by separating each of them with a \newline character. The maximum number of images that can be stored on a single product advert is 4, including image_link. |
|
|
Price & availability |
availability |
string |
Required This is the product's availability Supported values are 'in_stock' and 'out_of_stock'. |
|
quantity |
String |
Required This is the amount of stock of you have your product Please make sure the value is not empty. If there is no stock amount fed through, leave the field as 0. A product listed with 0 stock will not go live on our site. If you are not providing your stock levels please set quantity to 999. |
|
|
price |
string |
Required This is the product's price Please list only as a float or integer. Do not include any currency codes. |
|
|
sale_price |
string |
Optional Your product's sale price Please list only as a float or integer. Do not include any currency codes. |
|
|
Product category |
google_product_category |
>string |
Required Google-defined product category for your product Example: |
|
product_type |
string |
Optional Product category that you define for your product Example: |
|
|
Product identifiers |
brand |
string |
Required The product's brand name |
|
gtin |
string |
Optional The product's Global Trade Item Number (GTIN) |
|
|
sku |
string |
Required Your product's SKU number Please use unique SKU value in this field if possible |
|
|
condition |
string |
Required Your product's condition Supported values are 'new' (brand new/original/unopened packaging) and 'used' (previously used/original packaging opened, missing, or refurbished). |
|
|
Detailed product description |
|||
|
option_values |
string |
Optional You can nest product option values within <option_values>. For example, colour and size would be presented as: <option_values>
<color>Yellow</color>
<size>XXL</size>
</option_values>
|
|
|
item_group_id |
string |
Required ID for a group of products that come in different variants
|
Option Values
Your products may have characteristics that define different product variants, such as size, colour, material, etc. You can elect to send these data properties to the Marketplace, where they will be mapped to option values automatically if possible, or available to be mapped manually using the Mapping tool.
If your feed contains attributes for color and size, we'll send them by default as option values. However, you can also elect to send other attributes using the form:
<option_values>
<color>Yellow</color>
<size>XXL</size>
</option_values>
Attribute Names
If your feed contains required data, but the attribute naming differs from the standard set out here, it may still be possible to integrate with your feed without editing it.
While connecting your XML feed, you will see select boxes for any attributes that aren't provided in your feed. If your feed contains this data, but under a different attribute name, you can choose the source of the data for that attribute. For example, if your feed provides product titles under an attribute called <Product Title> instead of <title>, you can choose 'Product Title' from the select box in the <title> row, and click to update your feed.
Also, if your feed provides advert data in elements other than the standard <item>, you can nominate the name of the element:
Example Feed
The below example shows a feed with one product:
<?xml version="1.0" ?>
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0">
<channel>
<item>
<g:id>90539387</g:id>
<g:title><![CDATA[Long T-Shirt]]></g:title>
<g:description><![CDATA[Buy the best quality t-shirts made from 100% cotton. Sizes range from M-XXL.]]></g:description>
<g:details><![CDATA[_100% cotton]]></g:details>
<g:link>http://exampleurl.com/examplefeed/long-t-shirt/0935879875.html</g:link>
<g:image_link>http://exampleurl.com/examplefeed/image/Long_Sleeve_YELLOW</g:image_link>
<g:price>39.99</g:price>
<g:condition>new</g:condition>
<g:availability>in stock</g:availability>
<g:brand>Example</g:brand>
<g:google_product_category>167</g:google_product_category>
<g:sale_price>33.99</g:sale_price>
<g:product_type>T-Shirt</g:product_type>
<g:gtin>90285983798</g:gtin>
<g:item_group_id>90359837</g:item_group_id>
<quantity>59</quantity>
<option_values>
<color>Yellow</color>
<size>XXL</size>
</option_values>
</item>
</channel>
</rss>
Related articles