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 Store data → 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.
• From version 2.1.0: shows bluebarry on your product and cart pages without theme edits, adds widgets to place it anywhere else, turns discounts into coupon codes and sends your categories, so they show up as collections in bluebarry.

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 Store data → 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 Store data → Integrations page in bluebarry.
5. Enter an API Key. Create one in bluebarry under Store data → 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 Store data → 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. To send the catalog right away, for example while Magento's cron jobs aren't running yet, click Sync now next to Catalog (module 2.2.0 and later) or run bin/magento bluebarry:catalog:sync.

• 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 Store data → 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.

Show bluebarry on your product and cart pages

In bluebarry, go to Store data → Integrations, click Manage on Magento and open On your store. Switch on what you want:

• Product check button: an “Is this right for me?” button under the add to cart button, on products that have a product check quiz. Pick those products on the quiz's Launch step.
• Product chat: under the add to cart button.

Recommendation blocks for product pages and the cart are switched on under Recommendations → Placements. See Design and add recommendations to your store.

Click Save. Your store updates right away, and nothing changes in your theme. If your store can't be reached from outside (for example a staging site behind a password), it picks up the change within the hour. This needs version 2.1.0 or later of the module, on Luma, Hyvä and themes built on them.

Widgets

To place something anywhere else, use a widget. In Magento Admin, click Insert Widget in a page or block, or add one under Content → Widgets. The module adds five:

• bluebarry quiz button: a button that opens a quiz.
• bluebarry quiz popup: opens a quiz as a popup after a number of seconds, after scrolling part of the page, or when the shopper is about to leave.
• bluebarry product check button: the product check button, on a product page.
• bluebarry recommendations: a recommendation block. On a product page it recommends from that product, anywhere else from the cart.
• bluebarry product chat: product chat.

The quiz widgets ask for a Quiz ID. The quiz's Launch step shows it ready to copy.

Discounts become coupon codes

From version 2.1.0, the module creates the discount codes bluebarry gives out as single-use Magento coupon codes. There is nothing to set up.

• Quiz and recommendation offers: once the shopper adds a product the offer covers, the module creates a code that only works for those products and puts it on the cart. Shoppers type no code. See Offer bundles and discounts.
• A unique code per person from a popup or a quiz's email question: a code for each shopper who signs up. See Build popup forms and Offer a discount code on the result page.
• A Magento cart takes one coupon code. A shopper who entered a code of their own keeps that one.
• The codes sit under cart price rules named bluebarry: … in Marketing → Cart Price Rules. Leave those rules as they are: deleting one ends its codes. Magento's cron jobs remove a code once it has expired.

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.