If you’re using the HomeRunner WordPress plugin, you don’t need to worry about writing code or manually pushing events. HomeRunner automatically pushes key eCommerce events to the dataLayer
. Your job is simply to configure Google Tag Manager (GTM) to listen to these events and forward them to Google Analytics 4 (GA4).
This guide walks you through the GTM configuration only.
✅ What You’ll Track #
HomeRunner pushes the following eCommerce events:
Event Name | Description |
---|---|
view_item_list | When a user sees a list of properties (e.g., search results) |
select_item | When a user selects/clicks a property from a list |
view_item | When a user views a property detail page |
begin_checkout | When the checkout process is initiated |
generate_lead | When a user submits a lead or inquiry form |
purchase | When a booking is confirmed and paid |
🧭 Prerequisite: Create a GTM Container #
- Go to https://tagmanager.google.com
- Create a new GTM account and container (if you haven’t already)
- Install the GTM container snippet on your website (Note: HomeRunner already handles this if enabled)
🎯 Step 1: Create Triggers for Each Event #
- In GTM, go to Triggers > New
- Choose Trigger Type:
Custom Event
- Set the Event Name (e.g.,
view_item
) - Name the trigger something like
Trigger - view_item
- Repeat this for each event:
view_item_list
select_item
view_item
begin_checkout
generate_lead
purchase
🏷️ Step 2: Create GA4 Tags for Each Event #
- In GTM, go to Tags > New
- Choose Tag Type:
Google Analytics: GA4 Event
- Select your GA4 Configuration Tag (or create one using your GA4 Measurement ID)
- Set the Event Name to match the trigger (
view_item
,purchase
, etc.) - (Optional) Add any Event Parameters (e.g.,
transaction_id
,value
) if needed, using{{DL - variable name}}
from the dataLayer - Under Triggering, select the corresponding event trigger (e.g.,
Trigger - view_item
) - Save the tag
- Repeat for all six events
🔎 Step 3: Preview and Test #
- Click Preview in GTM
- Enter your site’s URL
- Interact with your site (view a property, begin checkout, etc.)
- In the Tag Assistant, confirm that the events fire correctly and the right GA4 tags are triggered
📢 Step 4: Publish the Container #
Once everything is working:
- Click Submit in GTM
- Add a version name and description (e.g., “eCommerce event forwarding setup”)
- Click Publish
📈 Step 5: Verify in GA4 #
- Open Google Analytics
- Go to Admin > DebugView to see real-time events
- Go to Reports > Events after a few hours/days to confirm events are coming in
- Optionally mark events like
purchase
orgenerate_lead
as Conversions
✅ You’re All Set! #
With this GTM setup, you’re now forwarding HomeRunner-powered eCommerce events directly into GA4 for real-time and conversion tracking. No coding required — just a few GTM clicks.
If you need help verifying dataLayer values or want to set up enhanced event parameters, feel free to reach out.