Google Analytics

From WHMCS Documentation

Revision as of 16:17, 24 February 2022 by PeterM (talk | contribs) (Setup)

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.

Setup

Note
The module supports Google Analytics, Universal Analytics, and Google Analytics 4.

The first step of tracking e-commerce transactions with Google Analytics is to enable e-commerce reporting for your website's profile inside the Google Analytics panel:

Enable the Ecommerce Setting

To do this:

  1. Sign in to your account.
  2. Click the Admin cog icon in the bottom-left corner.
  3. In the View column, click Ecommerce Settings.
  4. Toggle E-Commerce Website from No to Yes.
  5. Click Save.

Next, return to the WHMCS admin area:

  1. Navigate to Configuration () > System Settings > Addon Modules or, prior to WHMCS 8.0, Setup > Addon Modules.
  2. Click Activate next to the Google Analytics module.
  3. Click Configure.
  4. Choose your Google Analytics version.
  5. Enter your Measurement ID (for Google Analytics 4) or Tracking ID (for other versions). You can find this in your Google Analytics account.
  6. Optionally, enter your Tracking Domain. We recommend entering this if you use multiple subdomains for your website.
  7. Choose one or more admin roles that can access the module.
  8. Click Save Changes.

If you are using a custom template set, you need to 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.