Skip to content

WooCommerce

The Pingado for WooCommerce plugin loads the Pingado snippet on your store and reports leads, begin checkout and purchases. Each one goes to your connected ad accounts from the shopper’s browser and from Pingado’s servers, with one shared event ID, so every platform counts it once.

You need WordPress 6.0 or later, WooCommerce 8.0 or later and PHP 7.4 or later. The plugin works with the classic checkout and the Checkout block, and with High-Performance Order Storage.

  1. Add your tracking domain in Pingado first. See Install the snippet.
  2. In WordPress, go to Plugins → Add New → Upload Plugin, upload pingado-woocommerce.zip and activate it.
  3. Go to WooCommerce → Pingado.
  4. Copy the snippet from Settings → Pingado Pixel in Pingado and paste it into Snippet. You can paste the whole <script> tag or only its URL.
  5. If the snippet is already in your theme or in another plugin, remove it there. The plugin adds it to the <head> of every page.
  1. On the same page, copy the Webhook secret. The plugin made it when you activated it.
  2. In Pingado, go to Settings → Payment Providers and select Connect next to WooCommerce. Paste the secret. Pingado shows your webhook URL.
  3. Back in WordPress, paste that URL into Webhook URL and select Save Changes.

The check in Pingado turns green with your next paid order. To test it straight away, place an order with a manual payment method such as cash on delivery and mark it Processing.

In Pingado, go to Settings → Conversions and turn on Begin checkout. Then open Mapping to choose where it goes in each ad account:

  • Meta: InitiateCheckout by default.
  • Google Ads: pick a conversion action in the Begin checkout category. Set it as a secondary action in Google Ads, so Smart Bidding keeps optimising for purchases.
  • TikTok: InitiateCheckout.
Event When From
Visit Every visit The snippet
Lead A new shopper fills in their billing details at checkout, creates an account, or submits any form with an email, such as a newsletter or contact form The checkout page, the next page after registering, or the form’s page
Begin checkout Once the shopper has filled in their billing details, once per checkout The checkout page
Purchase Every order, once it is paid Your store’s server, and the thank-you page
Refund A refund is made in WooCommerce Your store’s server

Lead: Pingado records every lead, and sends each person’s first one to your ad accounts. A later lead from the same person, such as a newsletter sign-up after their first order, is recorded only. A shopper becomes a lead:

  • At checkout: a new shopper becomes a lead when they fill in their billing details, right before Begin checkout, with their billing email. A shopper who is already known in that browser (an earlier order, a newsletter sign-up, or signing in) gets only Begin checkout, and so does a customer signed in to their account.
  • Creating an account, on My account or at checkout.
  • Forms: any submitted form with an email, such as a newsletter, contact or back-in-stock form, through the snippet’s form rules. To leave a form out, add data-pingado-ignore to it. The checkout form itself is not counted as a form lead, and forms a signed-in customer submits are not either.

Begin checkout fires when every required billing field is filled in on the classic checkout, or when the email, name and address are filled in on the Checkout block. It counts once per checkout: reloading the checkout page does not count it again, and a returning customer’s next order counts again. It carries the cart’s value.

Purchase is sent for every order, with its value, so your ad platforms learn from repeat customers too. In the Funnel report, orders are split into new customers (the person’s first order) and returning ones. A purchase is sent when WooCommerce marks the order paid: payment complete, or the order moves to Processing or Completed. Pending, failed and on-hold orders are not sent. A bank transfer or cash on delivery order is sent once you mark it Processing or Completed. Each order is sent once.

The thank-you page fires the same purchase in the shopper’s browser, with the event ID, value and currency the server sent, so each ad platform keeps one of the two. An order paid after the shopper left the thank-you page, or with a payment provider that never sends them back, is still sent from the server.

Refunds are recorded in Pingado and never sent to ad platforms.

A shopper who creates an account at checkout is counted as a lead once, at checkout, not again after registering.

The value is what you sold: the order total without tax and shipping. Purchases and Begin checkout’s cart value both use it, and there is no setting to change it.

When the shopper places the order, the plugin stores Pingado’s visitor ID and Meta’s _fbp and _fbc cookies on the order. The purchase reaches Pingado with them, so it is matched to the visitor’s ad click even when the payment completes later. Without a visitor ID, Pingado matches the order through the thank-you page, then through the billing email.

The billing email, phone and name typed at checkout are hashed in the shopper’s browser before they reach Pingado. The paid order goes to Pingado with the billing email and name over a signed HTTPS request. Pingado hashes and masks them when they arrive and never stores them in full. Only the shopper’s own billing details are used to identify them.

The snippet follows Google Consent Mode v2 as your cookie banner sets it. See Consent.

  • Cookie banners with Consent Mode: Complianz, CookieYes, Cookiebot, Borlabs Cookie, Real Cookie Banner and others can set Google Consent Mode v2. Turn that on in your banner’s settings.
  • WP Consent API: the plugin does not read it directly. Use a banner that also sets Google Consent Mode.
  • No Consent Mode on the page: Pingado treats consent as granted. If your store needs consent first, turn on Wait for consent on the plugin’s page.

Paid orders are always sent from the server, as with any payment provider. They carry the consent the shopper’s browser last reported, and Pingado sends nothing to ad platforms for a shopper who denied it.

WooCommerce has no test mode of its own, so every paid order counts. To record your test orders as tests, add a filter in your theme or a small plugin:

add_filter( 'pingado_order_is_test', function ( $test, $order ) {
return $test || $order->get_billing_email() === 'you@yourshop.com';
}, 10, 2 );

Pingado records test orders as tests, leaves them out of your reports and never sends them to ad platforms, apart from Meta’s Test events when you set a test event code.