Grouping product variants in the data feed

or send an email to support@doofinder.com

Grouping products which share the same basic set of attributes can help you improve your search results.

The case for product variations: an example.

Say you have these items in your feed

* CAMPER mountain boots. (size: 38, color: blue)
* CAMPER mountain boots. (size: 36, color: blue)
* CAMPER mountain boots. (size: 36, color: red)

Those are indeed three different products and when looking for "mountain boots", these three search results would appear.

However, you may prefer the user obtained just one single CAMPER mountain boots search results with all three variants that is, the red and blue colors as well as the 38 and 36 sizes, available in the facets panel of your search results.

The de-facto standard

Google has come up with a mechanism to do that in the data feed: the item group id. Long story short: all items with the same item_group_id attribute are considered variants of the same item.

So, what happens when I check the "group products by item_group_id" ?

Just that. All products that share same item_group_id attribute are displayed as one product only in the search results, but all their variants (like color or size), if defined as facets, are displayed in the facets panel.

Back to our first example, when the user looks for "mountain boots", only one "CAMPER mountain boots" result is shown, but "blue" and "red" colors and "38", "36" sizes are available at the facets panel.

Follow the leader! Marking an item as the "group leader"

If there's an item with the field df_group_leader set to "true", that item will be chosen as the group representative in search results (if there is no other more relevant sort criteria involved) . For product type feeds you can also use g:group_leader, group leader and group_leader.

In a nutshell

  • Check the group products by item_group_id checkbox` at the Configuration -> Data Sources section of your control panel.
  • Make sure the products that you want to be grouped share the same item_group_id field in your data feed.
  • You're good to go!

What exactly is the name of the field again?

Text Format

  • Grouping items: For product type feeds, you can use both item group id, item_group_id or group_id. The latter will work for every datatype (not just the "product" datatype)
  • Marking an item as the group leader: For product type feeds, you can use either group leader, group_leader or df_group_leader. The latter will work for every datatype (not just the "product" datatype)

XML Format

  • Grouping items: For product type feeds, You can go with <g:item_group_id> or <item_group_id> or even <group_id>. The latter will work for evey datatype (not just the "product" datatype)
  • Marking an item as the group leader: For product type feeds, you can use either d:group_leader, group_leader or df_group_leader. The latter will work for every datatype (not just the "product" datatype)

Below you can download some examples to see how it works.