New: The Google Trends feed rule is live
XMLCimri

Sending Generic XML products to Cimri

Here is how you send the products in your XML file to Cimri with HexFeed: you enter your XML address in Settings and create a profile that maps XML tags to product fields; HexFeed pulls products, prices and stock from your XML source regularly. Then, on the Feeds screen, you create a feed with the “Cimri” option in the platform list and use rules to decide which products go out. Finally, you add the protected XML address from the feed's Access tab on the Cimri side; Cimri reads the feed on its own schedule and keeps your products up to date.

What is Cimri for?

The product XML that Cimri expects from sellers; it makes your products appear in price comparison listings on Cimri.

Feed format: XML (Cimri MerchantItems schema)

The Generic XML side

HexFeed connects to your Generic XML store via XML mapping profiles. What you need: the XML address that holds your products and a mapping profile for this XML.

Details of the Generic XML integration

Step by step: Generic XML → Cimri feed

Set up in 10 steps; menu names on the Cimri side may differ slightly depending on your account.

  1. 1

    Open your HexFeed account

    Sign up at app.hexfeed.io and create your store.

  2. 2

    Set up the Generic XML connection

    In Settings > E-Commerce Platform, select Generic XML and create a profile with “Manage XML Mapping Profiles”: enter the XML address, the tag that represents a product and the field mappings. When the profile is saved, the XML URL is written to the connection automatically.

  3. 3

    Check the first sync

    Product data is pulled from your XML source: products in the XML, the price, stock, image and category fields you map, variants (if a variant mode is selected in the profile). The numbers of added, updated and failed records for each run appear on the Integration Logs screen.

  4. 4

    Create the Cimri feed

    On the Feeds screen, click “Create Feed”; choose the “Cimri” option from the platform list, then set the feed name and the variant preference. The feed is created protected with an access key.

  5. 5

    Prepare the fields for Cimri

    On the feed's Rules tab, select the products you can compete with in price comparison (e.g. products that are in stock and in certain categories).

  6. 6

    Set up rules, discounts and images

    On the Rules tab, filter the products that will go into the feed; if needed, add a feed-specific discount, a product limit and an image template. The Filtered Products screen shows which products will go into the feed.

  7. 7

    Copy the feed address

    Copy the address from the feed's Access tab. You give Cimri the “URL with key”, which carries the key in the query string.

  8. 8

    Add the address on the Cimri side

    Enter HexFeed's feed address with key in the field that asks for the product XML address in your Cimri seller account or in your application to Cimri.

  9. 9

    Verify the upload

    After Cimri reads the feed and matches your products, check the listings on the Cimri side.

  10. 10

    Monitor access

    The feed's access logs show when the Cimri side fetched the feed; the quality score lists missing fields with sample products.

Which fields are written to the Cimri feed?

HexFeed generates the fields below from the product data that comes from your XML source. In a feed with variants, each size becomes a separate product; size and color are written under specs as “Beden” and “Renk”.

  • merchantItemFieldId, itemTitle, itemUrl
  • itemPhotoUrl and additionalPhotos
  • price, marketPrice
  • itemCategory, brand, stockStatus
  • shippingFee, shippingDay
  • specs (Beden and Renk, i.e. size and color)

What does HexFeed add to your Cimri feed?

Instead of sending the data that comes from your XML source as it is, you set up a separate feed for Cimri:

Filtering products with rules

You decide which products go into the feed with rules such as price, stock, size availability, category, brand, color, size, discount rate, product name, tag and GA4 metrics (views, add-to-carts, purchases, conversion). A product must match all the rules you define.

Product limit

You sort the products that remain after the rules by a criterion you choose (e.g. Google purchases in the last 30 days) and take the top N products into the feed.

Feed-specific discount

You schedule percentage or amount discounts that apply only to this feed, with a date range; the price in your store does not change.

Image templates

You design a discount badge, price strip or brand frame once; each product gets an image rendered with its own price and discount, and this image is used as the main image in the feed.

Stock and price sync

HexFeed refreshes product, price and stock data from your store at the frequency set for your store (from hourly to once a day; every 3 hours by default); a product that runs out of stock is written to the feed as out of stock, or removed entirely with a stock rule.

Protected feed address

The feed address is protected with an access key; requests without the key are rejected. The access logs show when the feed was fetched.

Feed quality score

Feed products are analyzed; issues such as a missing GTIN or a short description are listed with sample products, and the change from the previous analysis is shown.

Frequently asked questions about Generic XML and Cimri

What do I need to set up a Cimri feed with Generic XML?

On the Generic XML side you need the XML address that holds your products and a mapping profile for this XML; on the Cimri side you need an account where you can add the feed address. HexFeed generates a feed in XML format for Cimri from the data that comes from your XML source.

When a price or stock changes in your XML source, when does Cimri see it?

HexFeed refreshes product, price and stock data from your XML source at the frequency set for your store (from hourly to once a day; every 3 hours by default). Each time Cimri reads the feed it gets this current data; the reading frequency is determined on the Cimri side.

How are the sizes and colors of my Generic XML products reflected in the Cimri feed?

Variants are read according to the variant mode you choose in the mapping profile. Records with an empty ID are skipped; with the skip condition you can leave unwanted records out from the start. In a feed with variants, each size becomes a separate product; size and color are written under specs as “Beden” and “Renk”.

How is the discounted price shown in the Cimri feed?

The current selling price is written to the price field and the list price to the marketPrice field. If you defined a feed-specific discount, price is calculated from that discount.

How is shipping information written?

In the Cimri feed the shipping fee is written as 0 and the delivery time as “1-3 İş Günü” (1-3 business days). If your store's shipping terms are different, contact us before setup.

Can my Cimri feed address be downloaded by others?

The feed is created protected with an access key; requests without the key are rejected. You give Cimri the “URL with key”, which carries the key in the query string. You can change or remove the key from the feed's Access tab.

Set up your Generic XML → Cimri feed

Set up your Generic XML connection and create your first Cimri feed. If you would like to do the setup together, contact us.