Delvaro for WooCommerce

Plugin Banner

Delvaro for WooCommerce

by delvaro

Download
Description

Delvaro for WooCommerce connects your WooCommerce store to Delvaro’s powerful marketing automation platform. Automatically track customer behavior and trigger personalized email campaigns based on real shopping activity.

Key Features

  • Automatic Event Tracking – Product views, cart additions, checkout starts, and order completions are tracked automatically
  • Server-Side Order Tracking – Reliable order tracking that works even when customers close their browser
  • Customer Identification – Links anonymous browsing activity to customer profiles when they purchase
  • Easy Setup – Just enter your API keys and you’re ready to go
  • WooCommerce Native – Integrates seamlessly with WooCommerce settings

Tracked Events

Client-Side Events (Browser):
* page_view – Every page visit on your store
* view_product – When a customer views a product page
* add_to_cart – When items are added to the cart
* started_checkout – When a customer begins the checkout process

Server-Side Events (Reliable):
* placed_order – When an order is placed
* fulfilled_order – When an order is marked as completed
* refunded_order – When an order is refunded
* cancelled_order – When an order is cancelled

Use Cases

  • Abandoned Cart Recovery – Automatically email customers who leave items in their cart
  • Post-Purchase Follow-ups – Send review requests or cross-sell recommendations after purchase
  • Browse Abandonment – Re-engage customers who viewed products but didn’t add to cart
  • Customer Segmentation – Build segments based on purchase history and browsing behavior

Requirements

  • WordPress 6.0 or higher
  • WooCommerce 8.0 or higher
  • PHP 7.4 or higher
  • A Delvaro account (Sign up free)

External services

This plugin connects your store to Delvaro, a marketing automation service. A Delvaro account is required, and the plugin does nothing until you connect one. All five endpoints below belong to Delvaro and are covered by the same Terms of Service and Privacy Policy.

1. Event tracking (https://t.delvaro.ai)

Receives the shopping events that drive your automations. Sent from your server when an order is placed, fulfilled, refunded, or cancelled, and from the visitor’s browser on page and product views, cart additions, and checkout starts.

Data sent: page URLs visited, product details (ID, name, price, category), cart contents, order details (order total, items purchased, currency), and the customer’s email address and billing details so the order can be matched to a contact. Payment card details are never transmitted.

2. Tracking script (https://cdn.delvaro.ai)

Serves delvaro-loader.js, the browser tag that records the client-side events above. It is loaded from Delvaro’s CDN rather than bundled with the plugin because it is the service’s own tag: it is versioned and updated server-side in step with the tracking API, and a stale bundled copy would send events the API can no longer accept. It is only enqueued once you have entered a public API key.

Data sent: the standard information any browser request carries (IP address, user agent, referring page) plus your public API key, which identifies which workspace the events belong to.

3. Reviews configuration (https://b.delvaro.ai)

Fetched by your server to find out whether the Reviews add-on is active for your workspace and how review widgets should be displayed. Requested when a page containing reviews is rendered, and cached.

Data sent: your public API key only. No customer or order data.

4. Workspace API (https://api.delvaro.ai)

Used for four operations, each triggered by a specific action:

  • /lists – fetches your subscriber lists so you can pick one in the settings screen. Requested when you open the Delvaro integration settings.
  • /products/trigger-sync – asks Delvaro to fetch your product catalog. Requested once after you connect your store.
  • /reviews/summary – retrieves review counts and average ratings so they can be added to product schema. Requested when a product page is rendered, and cached.
  • /contact/register – registers a customer who opted in to marketing at checkout. Requested only when the consent checkbox is enabled and a customer ticks it.

Data sent: your API key and store URL on every request. /contact/register additionally sends that customer’s email address and name, and their consent audit trail – the exact checkbox text they agreed to, the timestamp, and their IP address – which is retained as proof of consent for GDPR, CAN-SPAM, and CASL purposes. The other three endpoints send no customer or order data.

5. Account connection (https://delvaro.com)

Handles the OAuth handshake that links your store to a Delvaro workspace, via /api/oauth/authorize, /api/oauth/token, and /api/oauth/revoke. Used when you click “Connect to Delvaro” in the settings screen, and when you disconnect.

Data sent: your store URL and the OAuth authorization code. No customer, order, or product data.

  1. Upload the plugin folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Go to WooCommerce Settings Integration Delvaro
  4. Enter your Delvaro API keys (find them in your Delvaro Dashboard under Workspace Settings API & Webhooks)
  5. Click “Test Connection” to verify your setup
  6. Save changes

Getting Your API Keys

  1. Log in to your Delvaro Dashboard
  2. Navigate to your workspace settings
  3. Go to the “API & Webhooks” tab
  4. Copy your Public API Key (pk_live_…) and Private API Key (sk_live_…)
  5. Copy your Workspace ID
Do I need both API keys?

The Public API Key is required for client-side tracking (product views, add to cart, etc.). The Private API Key is required for server-side order tracking. For complete functionality, we recommend using both.

Will this slow down my store?

No. The tracking script loads asynchronously and doesn’t block page rendering. Server-side events are sent in the background without affecting page load times.

Does this work with WooCommerce Blocks?

Yes! The plugin works with both the classic WooCommerce shortcode-based pages and the newer WooCommerce Blocks.

Does this work with High-Performance Order Storage (HPOS)?

Yes! The plugin is fully compatible with WooCommerce’s High-Performance Order Storage feature.

Is customer data secure?

Yes. All data is transmitted securely over HTTPS. We do not store sensitive payment information. Please review our Privacy Policy for details.

Can I track admin users?

By default, admin and shop manager activity is not tracked to keep your analytics clean. You can enable admin tracking in the settings if needed.

1.3.16

  • First release on the WordPress.org plugin directory. Stores that install from the directory receive updates through WordPress.org.

1.3.15

  • Hardened the OAuth site-verification endpoint: it now answers a server-supplied challenge with an HMAC proof instead of exposing the verification token
  • All review widget markup is now escaped at output time

1.3.14

  • Improved WordPress.org compatibility by enqueueing scripts through WordPress APIs
  • Corrected legal-policy links and external service disclosures
  • Removed a global admin upgrade notice

1.3.13

  • Fix hooks.

1.3.12

  • Fixed the marketing consent checkbox appearing twice on classic checkout after changing shipping method, country, or payment method
  • The “before the Place Order button” checkbox position now takes effect on stores that have a terms and conditions page configured

1.3.11

  • Increased maximum inline reviews limit from 12 to 50 in Elementor widgets, Gutenberg block, and shortcodes
  • Added [delvaro_all_reviews] and [delvaro_store_reviews] shortcode aliases for embedding store-wide reviews on any page
  • Renamed Elementor widget to “Delvaro Store & Featured Reviews” to clarify store-wide review support

1.3.10

  • Refresh diagnostics now include beacon workspace ID and public key suffix (workspace is resolved from the store’s OAuth key, not request params)

1.3.9

  • Fix critical error on WooCommerce Settings Integrations Delvaro (reviews status row called get_reviews_display on a null plugin reference)

1.3.8

  • “Go to Delvaro” in Elementor/Gutenberg editors now opens billing in a new tab (Elementor preview was swallowing normal links)
  • OAuth connection stores workspace slug for deep links to Settings Billing

1.3.7

  • Refresh endpoint bypasses the beacon CDN cache and returns diagnostics (beaconReachable, reviewsInBeacon)
  • Fixes false “inactive” after enabling Reviews when the beacon was still serving a 5-minute cached config

1.3.6

  • Companion release: Delvaro now pushes a cache flush to your store as soon as Reviews is activated or deactivated in the dashboard

1.3.5

  • Reviews add-on state re-fetches from Delvaro when you add a reviews block or Elementor widget, or save a page/product that contains one
  • Integrations settings shows live Reviews add-on status on load (no manual save required)
  • Gutenberg and Elementor editors show a clear “not activated” message with a link to Delvaro and a “Check if activated” button
  • Delvaro can push a cache flush to the store when Reviews is enabled or disabled so widgets pick up changes immediately

1.3.2

  • Editor placeholders (Gutenberg + Elementor) now show when Reviews is not activated, with a link to Delvaro and a “Check if activated” button
  • Works on pages, posts, and products (including Elementor product templates)

1.3.1

  • Reviews add-on state now re-fetches from Delvaro when you add a reviews block or Elementor widget, or save a page that contains one — no need to open Integrations settings and save
  • Integrations settings page shows live Reviews add-on status on load

1.3.0

  • NEW: Native rating write-back — Delvaro pushes each product’s exact review aggregates into WooCommerce’s native rating fields, so any theme or block that shows native stars shows your Delvaro ratings (and they survive plugin removal)

1.2.0

  • NEW: Star-rating badges under product titles and on shop/category pages (one batched request; products without reviews show nothing)
  • NEW: Elementor widgets — Delvaro Product Reviews, Featured Reviews and Rating Badge, with live editor preview
  • NEW: Search-result stars (SEO): exact per-product review ratings merged into WooCommerce’s own product schema, with a tri-state setting
  • NEW: [delvaro_rating_badge] shortcode and a Star rating variant on the Delvaro Reviews block
  • NEW: Placement can now be managed from the Delvaro dashboard (WooCommerce placement card), including a cache-flush so changes apply immediately
  • The reviews tab no longer shows a duplicated heading inside the widget (requires the Spark 0.9 widget)
  • Editor sessions no longer count page views in analytics (Elementor preview)

1.1.0

  • NEW: Product Reviews display — Delvaro reviews show automatically in a product-page tab (replacing the native Reviews tab) once the Reviews add-on is active
  • NEW: Placement options — product tab, below the product section, or manual
  • NEW: Shortcodes [delvaro_reviews] and [delvaro_featured_reviews] for any page
  • NEW: “Delvaro Reviews” Gutenberg block with product/featured source
  • NEW: Product Reviews settings section (placement, tab label, replace native reviews, max reviews)
  • NEW: Remote reviews-settings API so placement can be managed from the Delvaro dashboard
  • NEW: Hebrew (he_IL) translations for all reviews strings
  • Fail-safe: if the Reviews add-on is inactive or unreachable, native WooCommerce reviews stay untouched
  • Native WooCommerce reviews are never deleted — disable “Replace Native Reviews” to show them again

1.0.1

  • Fixed product feed reporting mismatched prices for variable products (regular and sale prices could come from different variations)
  • Variable products no longer report a sale price when none of their variations are actually on sale

1.0.0

  • Initial release
  • Client-side tracking for page views, product views, add to cart, and checkout
  • Server-side tracking for orders, fulfillment, refunds, and cancellations
  • WooCommerce Integration settings page
  • Connection test functionality
  • HPOS compatibility
  • Debug logging option
Back to top