Set up NudgePilot for WooCommerce

NudgePilot shows shoppers who seem unsure one short message with your own shipping or returns terms, or a quick comparison of products they looked at, and measures whether it helps your sales. Setup takes a few minutes.

Before you start

• WordPress 6.9 or later, WooCommerce, and PHP 8.0 or later.
• Your store must be online at a public https:// address. NudgePilot can't connect a store on localhost or behind a password.
• Your site's REST API must be reachable (it is, unless a security plugin blocks it for visitors; see Troubleshooting).

1. Install and connect

• In WordPress, go to Plugins › Add New, search for NudgePilot for WooCommerce, then install and activate it.
• Open WooCommerce › NudgePilot and click Connect to NudgePilot. NudgePilot checks that the plugin really runs on your store, then connects it. No account, email or payment details are needed.

2. Add your shipping details

• Go to Messages › Shipping and click Copy from WooCommerce: NudgePilot reads the shipping zone for your own country and fills in free shipping, a free-shipping minimum or a flat rate.
• Add your delivery time and, if you like, a same-day cutoff. Check the preview, then Save. Shoppers only ever see what you enter here.

3. Choose how shoppers are asked for consent

NudgePilot uses a random visit number in the shopper's browser, so in the EU and UK it needs the shopper's consent.

• With a cookie banner (recommended): install the free WP Consent API plugin and a cookie banner that supports it, such as Complianz, CookieYes or Cookiebot. NudgePilot then runs only for shoppers who accept statistics cookies, and stops if they change their mind. Settings › Privacy shows which banner it found.
• If your store doesn't need consent for this (for example, it doesn't sell in the EU or UK), choose My store doesn't ask for consent under Settings › Privacy. Check your local law.

Settings › Privacy also has wording you can copy into your privacy policy (it's in WordPress's Settings › Privacy › Policy Guide too).

4. Turn it on

On Home, switch on Show messages. From now on, each visit is put at random into one of three groups (no message, a simple rule, or Smart timing), so Results can show whether the message helps.

Where messages appear

• Settings › Where messages appear: in the corner of the page (recommended), or inside your cart page, in both the Cart block and the classic cart. The checkout never shows a message.
• To see a message on your store, use Preview on your store there. Only you see it, and nothing is counted. Your own visits as a store manager are never counted.

Returns and product comparison

On every plan you can also show your returns terms (Messages › Returns, linking to your returns page) and a short comparison of products a shopper viewed in the same category, with up to three product attributes you choose (Messages › Product comparison).

Plans

• Free: 10,000 visits a month and the shipping message, with no payment details.
• Pro ($9.99 a month, 500,000 visits) and Scale ($39.99 a month, 2,500,000 visits) handle more visits, with a 14-day free trial the first time. Every plan includes every message.
• Choose, switch or cancel under Settings › Plan. Paid plans are sold by Paddle, our reseller, which handles payment, tax and invoices. A cancelled plan runs until the end of the period you paid for. See the Refund Policy.
• If your store has more visits than your plan includes, NudgePilot never charges more: it keeps helping a random share of visits until the month ends.

Results

Results compares sales in the three groups: visits, checkouts, purchases and sales per visit. A sale counts when an order is paid within 24 hours of the shopper starting checkout. Give it a few weeks: NudgePilot tells you when there's enough data to be confident.

Page caches, speed and security

• NudgePilot's script is small (about 5 KB), loads after your page, and is the same for every shopper, so page caching plugins keep working. When you change settings, NudgePilot asks common caching plugins (WP Rocket, W3 Total Cache, LiteSpeed Cache and others) to refresh.
• If your site sends a Content Security Policy, allow https://nudgepilot.live for connections (connect-src).

Staging copies and moving your site

If a copy of your site answers at another address (a staging site, or after a move), NudgePilot pauses there, so the copy can't mix into your live store's results. WooCommerce › NudgePilot explains what to do: connect the new address, or remove the connection from the copy.

Troubleshooting

• Connecting fails because NudgePilot can't reach your store: a security plugin or firewall may block WordPress's REST API for visitors. Allow requests to /wp-json/nudgepilot/v1/verify, then click Connect again.
• Connecting times out: some hosts run only one PHP process at a time. Try again; if it keeps happening, ask your host to allow two at once.
• Messages don't appear: check that NudgePilot is on (Home), that shipping details are saved, and, if you use a cookie banner, that the WP Consent API plugin is active. Your own visits as a store manager never show messages; use the preview.

Disconnect or delete

• Deactivating the plugin stops NudgePilot on your store at once and keeps your connection.
• Disconnecting (Settings › Connection) stops NudgePilot and deletes its record of your shoppers' visits. Your results are kept for 30 days in case you connect again.
• Deleting the plugin deletes your store and its results from NudgePilot, ends a paid plan, and removes everything the plugin stored on your site.
• If NudgePilot hears nothing from your store for 90 days, it deletes your store's data, unless you have a paid plan.

Help

Email hamet.gh@gmail.com. See also the Privacy Policy, Terms of Service and Data Processing Agreement.