Product Feed Guide

To optimize FINDMINE performance, we require In Stock product information down to the Color level. This product information must be represented as a Unique Identifier (Uni) for each product that is created using the product's Product ID and Color ID.

All other data points do not need to be in separate fields.

Data points required per product

Please send the entire catalog down to the Product SKU level:

  • ID - As it correlates to your tracking pixel for transaction data (for example: SKU to size and color and style)
  • FM_Unique_ID - This ID must exactly match the ID passed into the JavaScript module and/or API; this should be the root ID for a product in your catalog, typically called a "Master ID" or "Product ID"
  • Variant_ID - One entry for each sub ID (color IDs, product-color combination IDs, size variations like L/M/S or inseam size + waist size, and any ultimate variant ID that is used to track at the purchase level); the entire variant ID hierarchy is preferred
  • Title - The title of the product; for example, "Black Classics Sunglasses", "Diamond Shape Drop Earring", "Solid Open Front Blazer", etc.
  • Availability - Value that corresponds to the stock status of the product; for example: "true", "in stock", "Out of Stock", "false", etc.
  • Image URL - The URL of the product image; can be one or multiple URLs
  • Product URL - The URL of the product's description page; this URL is what we link to from the FM JavaScript module
  • Category Path - Must map to website categories (for example: the map might look like mens>shirts>polos for a men's polo shirt)
  • Price - Numerical value corresponding to the current price of the item; for example, "$19.99", "50", "14.99", etc.
  • Sale Price or Discount - This could be indicated by the price ending in ".99" or marked as a separate field or discount field
  • Product Description - Any additional information about the product that is relevant; this could be a brief outline of the product, a list of materials, or something else
  • Size Type - Include if sizing is relevant to your catalog (for example: big and tall, petite, plus); Size Type can be pulled from the Product Title or URL
  • Team - Include if Teams are relevant to your catalog; Team can be pulled from the Product Title
  • Sport - Include if Sports are relevant to your catalog; Sport can be pulled from the Product Title
  • Gender - Include if Genders are relevant to your catalog; Gender can be pulled from the Product Title
  • Brand - Include if Brands are relevant to your catalog; Brand can be pulled from the Product Title

Please note that the fields in your feed do not need to be named exactly as indicated above because we can map your values to ours. For example, your feed may include just "Image" instead of "Image URL", or "Team Name" instead of "Team", etc.

Additional data that can enhance our algorithm’s performance

These additional data fields are used by our model to learn more about your products and deliver better looks. These are not required, but are recommended:

  • Sizes - (s,m,l,0,2,4)
  • Color Name - Teal, green camo, etc.
  • Materials - Silk, linen, velvet, etc.
  • Pattern - Floral, animal, gingham, etc.
  • Style - Edgy, formal, casual, athletic, etc.
  • Occasion - Prom, night out, weekend, festival, etc.

Example feed contents:

<product id="66926">
    <colors>
        <color>P66926_C106</color>
        <color>P66926_C7313</color>
    </colors>
  <title> Cami With Criss Cross Neckline </title>
  <imageurl>https://www.yourbrand.com/is/image/ProdATG/66926_C106</imageurl>
  <producturl>http://link.mercent.com/redirect.ashx?mr:merchantID=merchant1&amp;mr:trackingCode=5A02183A-550C-E811-80F7-0050569428E8&amp;mr:targetUrl=https://www.yourbrand.com/product/cami-with-criss-cross-neckline-/66926</producturl>
  <description>imported 97% cotton 3% spandex machine wash Fabric and care: imported 97% cotton 3% spandex machine wash</description>
  <price>18.00</price>
  <sale_price>10.00</sale_price>
  <discount>0.00</discount>
  <instock>TRUE</instock>
  <categoryid>Knit Basics</categoryid>
  <gender>Womens</gender>
  <size_type>Plus</size_type>
  <team>Houston Rockets</team>
  <sport>Basketball</sport>
  <brand>Your Brand</brand>
</product>
Pixel: Transaction Analytics Guide →