MarketBasketAnalysis for WooCommerce
| 开发者 | brian48x |
|---|---|
| 更新时间 | 2026年11月13日 06:53 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Bundles ranked by profit, from your own orders. With proof.
MarketBasketAnalysis finds what your customers buy together, ranks it by profit, sells it as "Frequently bought together" and bundles, and shows the profit it earned. It runs entirely on your own server.
How it works
- It reads your WooCommerce order history and finds the products your customers buy together.
- It ranks each pairing by the profit it makes you. Cost comes from WooCommerce Cost of Goods Sold, so there is nothing to type. A product with no cost says so and ranks by lift instead.
- You put the winners in front of shoppers: on the product page as "Frequently bought together", or as a bundle with its own discount.
- Results shows the profit and revenue those placements earned.
- Frequently bought together widget, with one button that adds every shown item to the cart. Place it with the
[mbawoo_fbt]shortcode, the Gutenberg block, or the theme template tag. Recommendations are precomputed, so the widget adds no work at page load. - Bundles. Turn an opportunity into a bundle in one click. The plugin creates the bundle discount for you and applies it at the cart the moment a shopper has every item in the bundle, with no code to type.
- Bundle builder widget, on the product page. Shortcode
[mbawoo_bundle_builder]or the MBA Bundle Builder Gutenberg block. The shopper picks from the products bought together with the one they are viewing, sees a running subtotal, and adds the set with a single Add to Cart. - Opportunities, one ranked list. Each row shows how many times the products were bought together and the profit figure, with three actions: Show on product page, Create bundle, Hide.
- Results. Attributed profit and revenue, per bundle and per widget, counted over a 14-day attribution window, with CSV export.
- Weekly summary email, optional and off by default: profit earned and your top 3 opportunities, sent through your site's own mailer.
- Five screens: Home, Opportunities, Bundles, Results, Settings.
- Runs on your server. The analysis happens inside your WordPress install, on a schedule you choose or on demand, and individual orders and customer records never leave your server. Works with both High-Performance Order Storage (HPOS) and classic order tables. WP-CLI commands are included:
wp mbawoo run-jobandwp mbawoo purge-old-jobs.
- WordPress 6.4+ (tested up to 7.1)
- WooCommerce 8.0+ (tested up to 9.4)
- PHP 8.1+ (8.2 recommended)
- Both classic and High-Performance Order Storage (HPOS) order tables
- Multisite-compatible (per-site activation, per-site settings)
安装:
- In wp-admin, go to Plugins, Add New, search for "MarketBasketAnalysis", and click Install. Or upload the plugin folder to
/wp-content/plugins/. - Activate the plugin through the Plugins menu in WordPress.
- Make sure WooCommerce is installed and active.
- Navigate to WooCommerce, MBA: Dashboard to run your first mining job.
- (Optional) Add the FBT widget to a product page via the Gutenberg block or the
[mbawoo_fbt]shortcode. - (Optional) MBA Plus, the hosted service: paste the license key from your Plus email into WooCommerce, MBA: Settings, General tab, Connect MBA Plus, License key, and save. To buy Plus, click Get Plus there or use the install page.
屏幕截图:
![Frequently Bought Together widget on a single product page, placed with the [mbawoo_fbt] shortcode or the Gutenberg block.](https://cdn.jsdelivr.net/wp/marketbasketanalysis/assets/screenshot-2.png)
常见问题:
Does this work with a fresh store with no orders yet?
The data-driven engines (sql_pairs, fp_growth) require order history. Around 200 completed orders in the analysis window is the sensible floor below which patterns are too sparse to mine. For brand-new stores with no order history, the free ai_catalog engine produces recommendations from catalog metadata alone, using your own Anthropic or OpenAI API key (the provider bills you directly).
Will mining slow down my site?
No. Jobs run in the background via WP-Cron or are kicked off manually from the admin. The storefront widget hits precomputed rules from a fast database table; lookups are sub-millisecond and never a real-time computation at page load.
Does this support High-Performance Order Storage (HPOS)?
Yes. The miner checks the site's HPOS setting and queries the right tables automatically. No configuration needed.
Where does my data go?
Mining runs locally. The data-driven mining engines make no outbound API calls, and individual orders and customer records never leave your server. With your own key, AI features call your own Anthropic or OpenAI account directly, and we never see the catalog payload or the LLM response. With MBA Plus connected and "Use MBA's AI for suggestions" ticked, they go to MBA's servers instead. Either way they send product catalog data and aggregate statistics (for example, how many orders contain a product pair), never customer names, email addresses, or individual orders. The External services section below lists exactly what each optional service receives and when. With your own key, you set a monthly token budget under Settings, AI, so a busy month cannot surprise you; 0 means no limit.
How does the FBT widget choose recommendations?
For a given product, the widget looks up the top-scored opportunities where that product appears in the antecedent (the "if" side of an association rule). Ties are broken by lift, then confidence.
Can I customize the widget styling?
Yes. Every block exposes its CSS classes (.mbawoo-fbt, .mbawoo-fbt__item, etc.). Override in your theme's stylesheet or use the Gutenberg block's color/layout controls.
How is AI billed?
With your own Anthropic or OpenAI API key, the provider bills you directly and nothing is metered by us; you can cap the monthly token spend under Settings, AI. MBA's AI is included with MBA Plus, up to a monthly allowance set by your Plus step, and shows how much of it you have used on the AI tab.
Is the source code available?
Yes, this plugin is GPLv2+ licensed and you can read and modify any of its code.
Where do I get support?
Post in the WordPress.org support forum for this plugin. The team reads it and answers there, so other merchants benefit from the thread. For anything that includes private store details, use marketbasketanalysis.com/contact instead.
更新日志:
0.18.0
- Changed: Opportunities shows each pairing once, says which product to recommend, and keeps one notice above the list. Product codes moved into Details.
- Changed: when no product has a cost, the list shows how strongly products sell together in plain words instead of repeating "no cost" on every row.
- Changed: pairings bought together fewer than 3 times are marked Low evidence and listed last, without a profit figure.
- Changed: profit per month is the same estimate on every platform: the extra units the pairing sells beyond what sells anyway, times price less cost.
- Changed: setup takes three clicks from activation to the widget on product pages, with no theme editing.
- Added: post-purchase offers on the order received page, off by default. Turn them on under Settings.
- Added: Connect MBA Plus. Paste a license key under WooCommerce > MBA: Settings, General tab, to connect the hosted services. Local features stay available to everyone.
- Added: AI suggestions for products without sales history are shown in their own group, with a reason, and are not shown to shoppers until you set one live. Uses your own AI key, or MBA's AI on Plus when you opt in.
- Security: your own AI keys are encrypted in the database.
- Changed: activating the plugin creates its tables and settings and does nothing else. It sends no email, starts no analysis, and contacts no server.
- Changed: setup tips emails are off by default. Turn them on with the checkbox in the setup hub or under Settings, Notifications, and turn them off the same way or with the link in any of the emails.
- Changed: the first analysis starts when you first open the setup hub.
- Changed: every global name uses the mbawoo prefix, and PHP classes use the MarketBasketAnalysis\WooCommerce namespace. The shortcodes are [mbawoo_fbt] and [mbawoo_bundle_builder], and the WP-CLI command is wp mbawoo.
- Changed: the External services section lists every service the plugin contacts, what it sends, when, and links to each provider's terms and privacy policy.
- Removed: the Slack, Linear, HubSpot, and Salesforce connectors, which connected but sent nothing. Notion remains.
- Security: storefront impression tracking is tied to the shopper's own session cookie, so a copied nonce cannot record impressions for another session.
- Security: every REST route checks access in its permission callback: feed tokens, the unsubscribe token, OAuth state, webhook signatures, and manage_woocommerce for the health check.
- Security: all admin output is escaped at the point it is printed.
- Fixed: the direct-file-access guard now sits in the first lines of every file, where Plugin Check reads it.
- Removed: the Domain Path header, which pointed at a languages folder this plugin does not ship.
- Changed: plugin renamed to MarketBasketAnalysis for WooCommerce.
- Changed: every admin style and script now loads through the WordPress enqueue API; the plugin prints no inline style or script tags.
- Changed: the AI monthly token budgets (assistant chat, storefront rationales) are now yours to set under Settings, AI. They are spending guards on your own AI provider bill, and 0 means no monthly limit.
- Changed: the free AI clients moved out of the Pro namespace (MarketBasketAnalysis\WooCommerce\Ai); no behavior change.
- Security: every read of cookie, header, and request data is sanitized and unslashed at the point of use, and the public REST routes document why each one is public.
- Removed: the storefront "Powered by" credit link.
- Fixed: the Opportunities grid and its count now read only the most recent completed mining job, as the page states. Previously every historical run's rows aggregated, so re-mining showed each surviving pair once per run.
- Changed: admin page titles use the MarketBasketAnalysis brand name consistently.
- Changed: every feature in this plugin works with no license and no account: job notifications, cost-aware scoring, scoring modes, the full diagnostics event log, catalog-enrichment scans, and the autonomous agent are all included.
- Changed: the seasonal_cohort and return_aware engines are now selectable from the Jobs quick-run form, matching the Settings default-engine picker.
- New: a Catalog Hygiene page flags dead SKUs, duplicate listings, missing reorder thresholds, and mis-categorized products, each with a one-click fix.
- New: a Returns Insights page ranks products by return rate and suggests an action for the worst offenders.
- New: a Drift Alerts page surfaces divergence between mining runs.
- New: enabling a bundle proposal now creates its discount for you. The plugin auto-generates a WooCommerce coupon from the bundle's discount (percent or fixed), restricted to the bundle's products, so you no longer hand-make a coupon after you approve a bundle.
- New: the bundle discount auto-applies at the cart. The moment a shopper has every item in the bundle in their cart, the price drops on its own with no code to type; drop one item and it lifts again.
- New: a Disable bundle action on the Bundle Proposals page un-enables a live bundle and removes its discount coupon.
- Improved: the guided setup is now a single resumable hub. Each step opens in place with its own focused content, and you can jump to any step or come back later right where you left off.
- New: bundle proposals carry an editable description alongside the name. Draft AI copy, edit both, and save them together.
- New: the catalog enrichment workspace is now a full review queue. A catalog scan ranks your thinnest listings by quality score and generates suggestions for the worst ones first (description, alt text, category tags, SEO meta).
- New: edit any proposal in place before you apply it, apply suggestions one at a time, or tick several and write them all back in one click with Apply selected.
- New: a per-product Generate marketing blurb action writes a short agent and bundle-context line to a product custom field.
- New: an optional daily catalog scan on WP-Cron, off by default, using your own AI provider key. Older entries are at marketbasketanalysis.com/changelog.