The Flowbox Extension for Magento can be downloaded from Magento's Marketplace by clicking here.
1. General configuration
To access the configuration options for feed generation, in the admin sidebar navigate to:
Stores > Settings > Configuration > Catalog > Flowbox
Checkout Script API Key - Provided during the onboarding, please ask your Customer Success Manager (CSM) should you require it again.
Identifier - Catalog attribute used to identify the products of the store.
Include Not Visible Individually - This option allows you to determine if the products that are not visible in the store (for example, the children of configurable products) should be part of the product feed.
Include Products Out of Stock - This option allows you to determine whether or not Out of Stock products will be included in the product feed.
Use Parent Value For - Whenever possible, the value of the selected attributes will be the same as the value from the parent product to which the product belongs.
Custom Taxonomy Source - Allows you to determine a custom URL for the Google Taxonomy for mapping Categories of your store with it.
If left blank, the module will use the default Taxonomy under the path:
www.google.com/basepages/producttype/taxonomy-with-ids.LanguageCode.txt
The "LanguageCode" parameter of the URL will be automatically replaced by the language code of the store.
2. Category mapping
For product categorisation purposes, Flowbox uses the categorisation data from Google Product Taxonomy to carry out a mapping between the categories of your shop and the Google Taxonomy category, that can be added to the <g:google_product_category> field in the product feed.
To do so, our module includes a new category attribute, which you will find in:
Catalog > Category > Search Engine Optimisation > Select Taxonomy
The list of categories is preloaded, so you can simply start searching by keyword to show the suggested categories.
The module detects the language of the store view we are in, so the Google Taxonomy loaded for suggestions will be displayed in the language of the store we are in.
Once the mapping is assigned in a language, the rest of the languages will load the equivalent category in the rest of the languages of our store.
3. Feed creation
In the admin sidebar, navigate to:
Marketing > Flowbox > Flowbox Feed
To create a new product feed, click on "Add New Feed" on the top right corner, opening the following screen:
Feed Name - Name your Feed for internal identification purposes.
File Name - Name of the file to generate. It can't contain spaces or special characters.
Store View - Select what View to generate the feed from.
Product Selection - In this section we can add conditions to filter what products we want to include in the feed.
To make a product attribute available to use as a condition, it must have had the "Use for Promo Rule Conditions" option set to "Yes".
You can find this setting in:
Stores > Attributes > Product > Select Attribute from the list > Storefront Properties (see screenshot below).
To begin with Product Selection, first we have to select the base conditions of the rules:
If ALL/ANY of these conditions are True/False
The combinations that allow the application of Magento's rules are deep and complex. For more information, please see the Adobe Commerce official documentation.
Once the base conditions are set, we can go ahead with the selection of filtering conditions. Click on the "+" sign to add a condition:
We can use the available attributes for filtering, as well as create combinations of these to control those products that will be part of the feed.
The filtering options derive from the catalogue of each shop, however our recommendation is to leave the Product Selection empty, including in the feed the all the products that meet the conditions set in the General Configuration section.
4. Using the product feed in Flowbox
The URL of the feed can be constructed as follows:
https://your_store_name.domain/media/flowbox_catalog_feed/fileName_languageCode
As an example, if your feed's file name is "testfeed" and the store view is "English", the URL will be:
https://your_store_name.domain/media/flowbox_catalog_feed/testfeed_en
Alternatively, the product feed files are publicly available in the "media/flowbox_catalog_feed/" directory.