Skip to main content
Version: 4.2

Container Triggers

Triggers serve as conditions that assess whether they are true or false during runtime. These triggers, when attached to a tag, determine whether the tag is activated or not. To ensure accurate tag analysis, it's crucial to configure the following triggers within your container.

This page will provide a list of triggers that you need to create in your Google Tag Manager container to track all events and actions in your WHMCS.

WHMCS Events Triggers

To create a new trigger click on Triggers on the left menu and New button. In the modal that will open, click on the Trigger Configuration box, this will open the Choose trigger type list on the right side of the page.

Ecommerce Events

The following triggers are responsible for triggering the ecommerce events necessary for the correct tracking of actions in the data layers created by the WHMCS GTM module.

info

Ecommerce events are vital to properly track your WHMCS checkout funnel and orders, set them up carefully.

NameTrigger TypeEvent NameThis trigger fires on
WHMCS EE - Add to CartCustom Eventadd_to_cartAll Custom Events
WHMCS EE - Begin CheckoutCustom Eventbegin_checkoutAll Custom Events
WHMCS EE - PurchaseCustom EventpurchaseAll Custom Events
WHMCS EE - Remove from CartCustom Eventremove_from_cartAll Custom Events
WHMCS EE - View CartCustom Eventview_cartAll Custom Events
WHMCS EE - View ItemCustom Eventview_itemAll Custom Events
WHMCS EE - View Item ListCustom Eventview_item_listAll Custom Events
WHMCS EE - Add Payment InfoCustom Eventadd_payment_infoAll Custom Events
WHMCS EE - Add Shipping InfoCustom Eventadd_shipping_infoAll Custom Events
  • add_to_cart: This trigger fires when a product is added to the cart.
  • begin_checkout: This trigger fires when the checkout process begins.
  • purchase: This trigger fires when a purchase is completed.
  • remove_from_cart: This trigger fires when a product is removed from the cart.
  • view_cart: This trigger fires when the cart is viewed.
  • view_item: This trigger fires when a product is viewed.
  • view_item_list: This trigger fires when a list of products is viewed (products group).
  • add_payment_info: This trigger fires when customer selects a payment method.
  • add_shipping_info: This trigger fires when customer starts to fill in the address fields.

General Events

The following triggers are responsible for triggering events that are not related to ecommerce actions. These events are used to track some user interactions with WHMCS.

NameTrigger TypeEvent NameThis trigger fires on
WHMCS EG - LoginCustom EventloginAll Custom Events
WHMCS EG - Sign UpCustom Eventsign_upAll Custom Events
WHMCS EG - Ticket OpenCustom Eventticket_openAll Custom Events
WHMCS EG - Ticket CloseCustom Eventticket_closeAll Custom Events
  • login: This trigger fires when a user logs in.
  • sign_up: This trigger fires when a new customer signs up.
  • ticket_open: This trigger fires when a ticket is opened.
  • ticket_close: This trigger fires when a ticket is closed.

Google Ads conversion make use of the ecommerce event purchase to track the conversion of Google Ads campaigns. The trigger below is used to track the conversion of Google Ads campaigns with all the necessary data.