This guide walks you through creating, configuring, and testing an Event Builder from the Admin Event Builder screen, plus validating it on your storefront.

Prerequisites

• You’re logged in to the Shopify store with TagFly installed.
• You know the page and element you want to track (e.g., Add to cart button, quantity minus, banner, etc.).

Step 1 — Open Event Builder screen

• In the TagFly app (Admin), go to the Event Builder page.
• Click the "Add event" button to create a new event.

Step 2 — Select element for custom tracking

After clicking the 'Add event' button, a new tab will open your store with a toolbar (as shown in the image) set to 'Select Element Mode' by default.

Your task is to click on the element you want to custom track and then proceed with the next steps

Step 3 — Custom event configuration

After you select the element you want to track, a modal will appear, allowing you to configure information such as the event name, trigger type, and the platforms you want to send the event to.

Event Builder — Field reference

1. Event name

• What it is: A human-readable identifier for your event (e.g., add_to_cart_custom).
• Used for: Display in logs/test mode and as the event name sent to destinations.

2. Trigger type

• Click: Fires when the user clicks an element matching your selector.
• View: Fires when the element enters the viewport (first visible time per page load).

3. Platforms

• What it is: Destinations that will receive the event (e.g., Google Analytics, Facebook, TikTok, Snapchat, Pinterest).
• Tip: Enable only the platforms you actively use.

4. Page scope

• What it is: Where your event applies.

For example, let's say you set up custom tracking for a click on the 'Add to Cart' button for Product A.

• If you select 'All Pages', this custom event will fire when you click that 'Add to Cart' button on any product, not just Product A.
• If you select 'Current Page Only', this custom event will only fire when you click the 'Add to Cart' button specifically on Product A.

5. Custom parameters

• Purpose: Send additional data to your destinations

Step 4 — Complete setup

After selecting and filling in the necessary information, click the 'Create event' button to finish creating the custom event

Troubleshooting quick tips

• No event firing:
• • Check Active status, Trigger type, Page scope/path.
  • Re-verify the selector matches the intended element/state.
  • Refresh the page after creating the event.

Updated on: 30/10/2025