Google Analytics

From WHMCS Documentation

About this Addon Module

Google Analytics allows you to track how people find your site, how they navigate through it and how they become customers. You can see trends of pageviews, visits, bounce rate, conversion rate, geographical locations and much more.

And in WHMCS, we've made it easy to install and use by creating an addon module that fully automates the integration process.

Addon Name Latest Release Current Version Compatible With Included in WHMCS
Google Analytics N/A N/A WHMCS Yes

Activating Google Analytics

First, you must activate ecommerce reporting for your website's profile in Google Analytics. Because this addon ships with WHMCS by default, you can then immediately activate it in the Admin Area.

To do this:

  1. Sign in to your Google Analytics account.
  2. Perform the necessary steps to enable ecommerce for your website.
    Enable the Ecommerce Setting
  3. In WHMCS, go to Configuration () > System Settings > Addon Modules or, prior to WHMCS 8.0, Setup > Addon Modules.
  4. Click Activate for Google Analytics.
  5. Click Configure.
  6. Choose your Google Analytics version.
  7. Enter your Measurement ID (for Google Analytics 4) or Tracking ID (for other versions). You can find this in your Google Analytics account.
  8. Optionally, enter your Tracking Domain. We recommend entering this if you use multiple subdomains for your website.
  9. Select the admin role groups who will have access to this addon.
  10. Click Save Changes.
  11. If you are using a custom template set, ensure that your footer.tpl file contains the {$footeroutput} template tag just before the closing </body> tag. This ensures that the tracking code is returned.

Goal Tracking

Once integrated, you can also take advantage of goal tracking. Goal tracking allows you to set specific pages that indicate that a user has reached the ultimate intended destination. For most people, this is completing an order by placing it and paying.

In WHMCS, the goal URL for a completed and paid order is /whmcspath/cart.php?a=complete. This is the page a user sees after completing checkout and paying using any of the online real-time gateways.

Unfortunately, if using an offline gateway such as Mail in Payment or Bank Transfer, with which you aren't paid in real-time, goal tracking will not be able to track the conversions of those users.

Success Conditions

The goal tracking code is rendered on the Order Complete stage of the ordering process. The system will direct clients to the Order Complete page and render the goal tracking code when all three conditions are met:

  • The client successfully completes payment.
  • Your gateway has notified WHMCS of the payment.
  • The invoice in WHMCS is marked paid.

If the conditions are not met, the client will be directed to the unpaid invoice with a notice displaying the invoicePaymentSuccessAwaitingNotify language string:

Thank you for completing the payment process. We are awaiting notification to confirm the payment you just made. We will send you an email confirmation as soon as this has been received.

This situation might occur if a payment gateway needs to perform extra checks before approving a payment or is experiencing delays sending payment notifications because of a technical issue.



Change Log