Connect Magento

The bluebarry module for Magento 2 and Adobe Commerce adds bluebarry to your store, keeps your catalog in bluebarry up to date and tracks orders from shoppers who used bluebarry. You don't need a product feed.

What the module does

• Loads bluebarry on every page, so your quizzes and published popups can open, and switches on bluebarry search when you turn it on in bluebarry.
• Tracks every paid order from a shopper who used bluebarry, whether they took a quiz, searched, clicked a recommendation, chatted or saw a popup, and attaches the order email to their profile.
• Syncs your catalog: products and their variants, attributes, categories, prices, sale prices, images and stock. See Your products below.
• Sends your orders: each order once it is paid, and refunds and cancellations after that, plus the last 12 months when you import them under Audience → Orders. They power best sellers, units sold, frequently bought together and purchase-based segments.
• Tells bluebarry what shoppers look at: page views, product views and adds to the cart. That powers recently viewed and frequently viewed together, personalized order, behaviour segments, popup rules by product or cart, and product chat that knows the page. With Magento's cookie restriction mode on, only after the shopper allowed cookies.
• Adds to the cart from a quiz result, the search widget and recommendation blocks, and updates the mini-cart. In a quiz, set a result card's Button behaviour to Magento: Add to cart.

Install the module

Magento modules are installed from the command line, so most stores ask their developer or agency to do this part.

1. In bluebarry, go to Integrations. Under Connect your webshop, open View other CMS platforms if needed and click Install on the Magento 2 card. It opens the module on the Adobe Commerce Marketplace.
2. Have your developer install and enable the module, and make sure Magento's cron jobs run. Orders and product changes are sent to bluebarry by cron jobs every minute.
3. In Magento Admin, go to Stores → Configuration → Bluebarry → General.
4. Enter your Tenant ID. You find it at the top of the Integrations page in bluebarry.
5. Enter an API Key. Create one in bluebarry under Integrations: open the Developer area, click Manage next to API keys and create a key for Magento. Magento stores it encrypted. With several websites, switch the scope at the top of the page to set the Tenant ID and API key per website.
6. Click Save Config. Magento tells you whether each website is connected, and Connection shows the last check. In bluebarry, Magento then shows as connected under Integrations, where Manage lists your websites. Your products start arriving within a few minutes.

Your products

Once a website is connected, the module sends its whole catalog to bluebarry, then every product that changes: when you save it, change it in bulk or import it, and when an order takes its stock. Every night it sends the whole catalog again, for what changes without a save, such as a sale price that starts or ends. Catalog in the module settings shows how many products are still waiting.

• Simple, virtual, downloadable and bundle products each become a product in bluebarry. A configurable product's variants are products grouped under it, with its name, page and categories.
• Names, pages, images and prices are what guests see on the default store view of the website, in its currency: the price they pay, and the regular price while a special price or catalog price rule makes it lower.
• Attributes you show on the product page or use as a filter come along as attr_ fields, such as attr_color.
• Stock comes with a quantity while Magento manages it without backorders. What open orders reserved is already taken off.
• Already importing your Magento products through a feed? Remove the feed under Products → Feeds once the products are in, so they aren't listed twice.

Put bluebarry live

• Quizzes: copy the quiz link from the quiz's publish dialog (Implementation tab, Magento) and use it as the link on any button or banner.
• Search: open your search configuration in bluebarry, go to Launch and switch Search on your store on. Turn on Full results page as well to show bluebarry's results on Magento's search results page. More in Launch search on your store.

Good to know

• An order counts once it's paid: when Magento moves it to processing or complete. Orders paid by bank transfer, check or on delivery count once you invoice them.
• With Magento's cookie restriction mode on, an order is only linked to the shopper when they allowed cookies.
• Order amounts are reported in the currency the shopper paid in.
• Websites that share a Tenant ID share one catalog in bluebarry: the default website's.
• Set Write conversion requests to debug log to Yes if orders don't show up. The module then writes what it sent to var/log/bluebarry.log.