integrations / woocommerce

WooCommerce orders, joined to the visits behind them.

Virling ties each WooCommerce order to the visit that came before it, so your store sees which channel, campaign and landing page bring buyers, not just traffic. Open source, one Rust binary, or hosted.

Start free trial See the demo

Virling reads WooCommerce orders, their refunds and, with WooCommerce Subscriptions, subscriptions from your store's REST API with a read-only key.

Create a key

In WordPress, open WooCommerce, Settings, Advanced, REST API, and add a key. WooCommerce's guide: REST API.
Set Permissions to Read.
In Virling, paste the consumer key and the consumer secret joined by a colon, as ck_...:cs_..., and enter your store's address, such as https://shop.example.com.

The store must be reachable over https, with pretty permalinks on so /wp-json/wc/v3/ answers.

What is imported

Orders from the last 90 days on the first run, then new ones every minute, newest first. Processing and completed orders count as paid, failed and cancelled ones as failed. Pending and on-hold orders wait until they are paid.
Refunds. Each order's refunds lower its revenue. Orders from the last 60 days are read again every 6 hours, so later refunds show up.
Renewals. With WooCommerce Subscriptions, a renewal order is marked as a renewal and keeps the channel of the first payment. See Renewals.
Subscription status, once an hour, when WooCommerce Subscriptions is installed. Without it, Retention uses payment recency.

Guest orders have no customer ID, so each counts as its own customer.

How a payment finds its visitor

Virling reads virling_vid from the order's meta data. Add this to your theme's functions.php, or to a snippets plugin, so every new order stores the visitor ID from the virling_vid cookie. It covers the classic and the block checkout:

// WooCommerce: add to your theme's functions.php (or a snippets plugin)
// so every order keeps the visitor ID from the virling_vid cookie.
add_action('woocommerce_checkout_create_order', 'virling_vid_on_order');
add_action('woocommerce_store_api_checkout_update_order_from_request', 'virling_vid_on_order');
function virling_vid_on_order($order) {
  $vid = $_COOKIE['virling_vid'] ?? '';
  if (preg_match('/^[A-Za-z0-9-]{8,64}$/', $vid)) $order->update_meta_data('virling_vid', $vid);
}

Frequently asked questions

How do I see which channel a WooCommerce order came from?

Connect your store to Virling with a read-only REST API key and add a short snippet to functions.php that saves the visitor ID on each order. Virling reads virling_vid from the order meta data and ties the order to the visit before it.

Does it work with the WooCommerce block checkout?

Yes. The snippet covers both the classic checkout and the block checkout.

Does Virling track WooCommerce Subscriptions renewals?

Yes. With WooCommerce Subscriptions installed, renewal orders are marked as renewals and keep the channel of the first payment.

Full reference: WooCommerce in the docs.