Event Builder
How to test custom events
A practical guide to validate your custom event working in the store using Test Mode. Prerequisites An Event Builder is already created and active. Step 1 — Enable Test Mode Open TagFly app in admin page. Click "Test events" button Step 2 — Reproduce the trigger Depending on your event’s trigger: Click trigger: Perform the expected click on the selected element. View trigger: ScrFew readersHow to add a custom event
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.  Free trial policy Upgrades, downgrades & proration Refund & credit policy [Uninstalling, cancellation & frozen stores](#3-uninstalling-cancellaFew readersTagFly: Pricing plan
What you will learn What's included in each TagFly plan — Free, Basic, and Grow How pricing, trial days, and purchase event limits work What changes across Integration, Tracking settings, Reporting & Analytics, Multi-market, and Support as you upgrade How to choose the right plan for your store How to change your plan Plan Overview TagFly offers three plans. Each plan is billed monthly or annually (annual billing saves 15%), and includes a purchase event allowance — roughly oneFew readers
Google Analytics
How to grant required access in Google Analytics
Server-side events cannot be sent to Google Analytics 4 without a Measurement Protocol API Secret. If the connected account lacks the required permissions, the API Secret cannot be created and events will fail. Required Google Analytics role The Google account connected to TagFly must have one of the following roles: Administrator Editor ||| ⚠️ Any other role will prevent Measurement Protocol API Secret creation. This guide shows you how to **check and grant the correct GooFew readersGoogle Analytics 4: Multiple pixels
A complete guide: Multiple GA4 Pixels TagFly lets you connect more than one Google Analytics 4 (GA4) property to the same store. This guide explains how to add multiple GA4 properties, choose how each event is tracked, and avoid the most common pitfall — duplicated or split analytics data when several properties track the same domain. What you will learn What are multiple GA4 pixels? How to add a GA4 property [ChoosiFew readersA complete guide: Order Value (GA4)
The Order Value setting puts you in control of the single number TagFly sends to Google Analytics 4 (GA4) as the value of each purchase. Rather than being locked into one definition of revenue, you decide what counts — the clean product amount, the full amount the customer paid, or a custom figure you build yourself, such as the value after discounts or with specific fees added. That number drives your revenue reports in GA4 and, when GA4 conversions feed Google Ads, the conversion value thaFew readers
Multi-market tracking
This section contains no articles.
Getting Started
Installation
TagFly Google Tag Tracking GTM Installation ⭐️ Installation Step 1: Log into your Shopify account in App Store. Click the ADD APP button to buy the app for your store. Step 2: You will then be redirected to your admin page and start installing. Step 3: After press Install app, the app will be automatically installed and take you to the configuration tab, enter GTM Container ID, Analytics Tracking ID and choose tracking options for the app to work.Few readersHow to set up automation in GTM
To enable TagFly to set up Google Tag Manager automatically, sign in to your Google account and grant the permissions requested by the app Select the Tag Manager Account and Container ID in order. ![Few readersHow to filter products from being sent?
Overview The Product Filter feature allows you to control which products are included or excluded from tracking events sent to your marketing channels (Google Ads, Facebook, TikTok, Pinterest, Snapchat, Twitter, Bing Ads, Klaviyo, and Google Analytics 4). This feature is particularly useful when you want to: Exclude certain products from tracking (e.g., test products, gift cards, internal items) Track only specific product categories or collections Filter products based on tags, titles,Few readersHow to filter orders from being sent?
Learn how to filter orders from being sent, and which order attributes you can use to block or allow orders. Transaction Filtering When you create or edit a destination, move to the Transaction Filtering section The default option is "Send All", all orders will be sent to this destination With the option Block Specific Transactions or Allow Only Specific Transactions, you will add Filter RFew readersGet your GTM container ID
The first step to start tracking your data | If you already have a Google Tag Manager account, skip to Step 2 to connect it with TagFly. Step 1: Create a new GTM account Go to Google Tag Manager and follow the setup instructions to create your account. #Tutorial video Step 2: Find & Connect Your GTM Container ID Open Google Tag Manager. Locate your **ConSome readersHow to import pre-built GTM container
Follow these simple steps to import a pre-built Google Tag Manager (GTM) container for client-side tracking. Step 1: Download the GTM Container Click Download to get the pre-built container file (.json) in your destination’s settings. Step 2: Import the GTM Container into Google Tag Manager #Tutorial video #Step-by-step guideSome readers
Consent Mode
How to check if Consent Mode is active in TagFly
If you are unsure whether your consent mode is working properly, here’s our guide for you to test it. You can use either of the two provided options to check your consent mode. | Note: Consent mode is only active in regions under privacy regulations Use Tag Assistant Go to https://tagassistant.google.com/, you can debug the consent states for any sites running Google Tags. After adding the domain you want to debug, select a Tag ID from the top of Tag ASome readersHow to set up your cookie consent banner
TagFly seamlessly integrates with various cookie banners and cookie consent apps to comply with regulations such as GDPR and CCPA. If you're unsure how to set up a cookie consent banner that works smoothly with TagFly, follow this guide to take a step closer to a consent-aware journey. Use Shopify Consent Provider Apps TagFly is compatible with most Shopify cookie banners. If you're in the process of choosing a solution, we recommend: [Consentik GDPR Cookies Banner](https://apps.shopFew readersSet Consent Requirements for Client-Side Tags
Discover how to configure your GTM client-side tags to comply with consent rules Enable GTM Consent Overview Container settings Start from your Google Tag Manager homepage and make sure you're in the "Admin" tab. Go to the "Container" section on the Admin page and select "Container Settings." In the Container Settings of your Google Tag Manager, proceed to the "Additional Settings"Few readers
Google Ads
TagFly Google Ads Conversion Tracking Setup Guide
Learn how to connect and track Google Ads conversions in just a few steps Connect your Google Account & Customer ID Sign in with your Google account and authorize access to the TagFly app From the dropdown, select the Google Ads Customer ID you want to connect. | If the dropdoSome readersHow to set up Google Ads Enhanced Conversions tracking
Overview Follow this guide to learn how to set up Google Ads Enhanced Conversions tracking. Because the conversion actions are created by the app and sent via the API, Google treats them as offline conversions. Therefore, you need to enable these two Enhanced Conversions options so Google can use user-provided website data to attribute the conversions. Step 1: Enable Enhanced Conversions in GFew readersTagFly Google Ads Remarketing Setup Guide
Overview Follow this guide to learn how to set up Google Ads Remarketing. Configure Google Ads Remarketing When you add a new Google Ads channel or have already installed the Google Ads channel, go to the channel's details. In the Events section, choose the events in the Remarketing column. After that, click save and it's finished.Few readers
TikTok
Get Your TikTok Pixel Ready
If you’re looking for a simple way to create your first TikTok Pixel one, you're in the right place! Follow these steps to create your first TikTok Pixel. If you already have a TikTok Pixel, you can skip to the next step! How to Integrate TikTok Pixel & Events API with TagFly Step 1: Navigate to TikTok Events Manager Login in your [TikTok Ads Manager](https://ads.Some readersHow to Integrate TikTok Pixel & Events API with TagFly
To configure Google Tag Manager tags and server-side tracking for TikTok, simply provide us with your TikTok Pixel ID and Events API Token. Before You Begin If you’re new to TikTok Pixel setup, refer to this guide: Get your Tiktok Pixel already How to link your TikTok Pixel to TagFly Step 1: Navigate to TikTok Events Manager Login in your TikTok Ads ManagerSome readersHow to test whether your TikTok events tracking works properly
Are you concerned about the effectiveness of your event tracking? Use the Test Events feature to see what’s working and identify any issues with your tracking setup. Setting Up Server Event Testing In the Pixel you are using, go to the Test events tab Copy your Test Event Code Turn theFew readers
How to grant access to your Facebook Business Manager
If you're setting up Facebook tracking or working with a partner, you may need to grant them access to your Facebook assets such as Datasets (Pixels), Ad Accounts, or other data sources. Follow this step-by-step guide to grant the necessary permissions from your Facebook Business Manager. Now, let’s get started! From Meta Business Suite in your Business profile, click Settings in the left menu, select People and then click Invite peopleFew readersHow to auto set up in Facebook
You can connect your Facebook account to TagFly using Auto setup, which allows you to quickly link your Facebook Business account and TagFly to track events from your store. Follow the steps below to complete the setup: Step 1: Select Auto setup and connect your Facebook account Go to Facebook Dataset Settings tab when adding Facebook destination in TagFly. Select the Auto setup tab. Click Connect new account. 
If you're new to Facebook Pixel (now called Dataset ID) and looking for a simple way to create your first one, you're in the right place. Follow this easy step-by-step guide to get started. **If you already have a Facebook Pixel set up, you can skip ahead to the next step: How to integrate Facebook Pixel and CAPI to TagFly Now, let’s get started! From [FacebookSome readersHow to Integrate Facebook Pixel and Conversion API to TagFly
To configure Google Tag Manager tags and server-side tracking for Facebook, simply provide us with your Facebook Dataset ID and Conversion API Token. Before You Begin If you’re new to Facebook Pixel setup, you might find this guide helpful: How to set up your Facebook Pixel (Now is Dataset ID) How to link your Facebook Dataset ID to TagFly Access [Facebook Events MSome readersHow to test whether your pixel installation is set up correctly
Are you concerned about the effectiveness of your event tracking? Use the Test Events feature to see what’s working and identify any issues with your tracking setup. Setting Up Event Testing In the Dataset ID you are using, go to the Test events tab Copy your Test Event Code | Please note that simply using the string 'TEST...' is insufficient; in this case, the correct value to use isSome readers
How to find Pinterest Ad Account ID
Step 1: Navigate to your Pinterest Conversion Page Access the Pinterest Conversion Page Step 2: Go to the Conversion access token You will find your Ad Account ID near your business name.Some readersHow to find Pinterest Conversion Access Token
Step 1: Navigate to your Pinterest Conversion Page Access the Pinterest Conversion Page Step 2: Go to the Conversion access token Click Generate new token Conversion Access Token shouSome readersHow to find Pinterest Tag ID
To configure Google Tag Manager tags for Pinterest, we require a Pinterest Tag ID. Step 1: Navigate to your Pinterest Conversion Page Access the Pinterest Conversion Page Step 2: Access Tag Manager If you don't have a Pinterest Tag, [follow our guide](https://helSome readersHow to create a Pinterest Tag ID
Step 1: Navigate to your Pinterest Conversion Page Access the Pinterest Conversion Page Step 2: Create a new Pinterest Tag ![Skip to manual setup](httpsSome readers
Snapchat
How to find Snapchat Pixel ID
To configure Google Tag Manager tags for Snapchat, it's essential to obtain a Snap Pixel ID. Step 1: Navigate to your Snapchat Events Manager Access the Snapchat Event Manager Step 2: Grab your Pixel IDSome readersHow to find Snapchat Conversion Access Token
Learn how to generate your Snapchat Access Token to enable server-side tracking. Step 1: Navigate to your Business Dashboard Access the Snapchat Event Manager -> Business Dashboard. Step 2: Navigate to Business Details Step 3: Generate or retrieve your Access Token ![](https:/Some readers
How to find the Twitter Pixel ID
You will need to create a Twitter Pixel ID via your Twitter Ads account Step 1: Log in to your Twitter Ads account at ads.x.com Step 2: Click to Tools and select Events manager from the top navigation Are you not seeing a Tools tab in your account? This is likely because a credit card hasn’t been added to your account. Find how to add one [here](https://business.x.com/en/help/account-setup/billing-baSome readersHow to find Twitter Event ID
Step 1: In Twitter's Event Manager, click on the "Add events" button Step 2: Configure your event For example, if you're configuring an “Add to cart” event, it may look like the following At the Setup method, you should choose Define event with code, then go to the next step ![](https://storage.crisp.chat/uSome readers
Klaviyo
How to create a Klaviyo Private API Key
Discover how to create a Klaviyo Private API Key with ease In order to setup server-side tracking for Klaviyo, we'll need to have a Private API Key. Create a Klaviyo Private API Key Account settings Sign in to your Klaviyo Account. Start by navigating to the Klaviyo homepage. Then, click on the "Account" button found in the lower left-hand corner of the page. A new pop-up menu will appear; click on the "Settings" tab.  Ads conversion tracking set up guide
Learn how to set up tracking for Microsoft Ads in under a minute with TagFly Locate UET Tag ID To set up Microsoft (Bing) Ads conversion tracking, you’ll need a UET Tag ID. Sign in to your Microsoft Ads account. Go to Tools > Conversions and select UET Tag. Locate the Tag ID section — the combination of numbers you see is your UET Tag ID (e.g., 1111111).  Ads Account
Learn how to set up conversion goals to start measuring your ad campaign performance. Create Event-Based Conversion Goal Sign in to your Microsoft Ads account. Navigate to Tools > Conversions, then select the Conversion Goals tab. Click the + Create button. New Conversion Goal Settings Set Up Conversion Goal: Choose Website, thenSome readers
Miscellaneous
How to grant access to Google Ads
In your Google Ads account, click the Admin icon Click Access and security. Click the plus button Enter the email address for your invitee, then select Read only account access level.  tracking code on your website to measure conversions, track your marketing data in the most efficient way. You just simply need to copy and paste the ID into the app Do I need to delete any code after uninstalling? No, the app will not leave any code/ script after uninstalling. How do I get support if I have any issues? You can send the request to our email [[email protected]](mailto:contaFew readersHow to review setup to avoid event duplication
Event duplication can occur when the same tracking tag is installed multiple times on your store. This usually leads to inflated metrics such as page views, add to cart, or purchase events appearing more than once. This guide will help you review your setup and identify possible causes of duplicated events. 1. Reasons why event duplication happens One common cause of duplicate events is when the same Google Tag Manager (GTM) ID is added in more than one place. For example: Added dirFew readersHow to check the tracking event results
After setting up tracking events, it's important to verify whether they are working correctly. Testing helps ensure that events are triggered properly and sent to the correct tracking destinations. In this guide, we will walk through two common methods to check your tracking results: Real-time Dashboard – Test server-side events Google Tag Assistant – Test client-side events 1. Check Events with the Real-time Dashboard (Server-side) The Real-time Dashboard allows youFew readersA complete guide: Multi-market tracking
If you sell in more than one region through Shopify Markets, you've probably run into the classic tracking problem: every market's events land in the same pixel, so your Japanese, Korean, and US data all blend into one account and no ad platform gets clean regional numbers. Multi-market Tracking solves this. It lets you route tracking events to a different destination per Shopify Market — each market gets its own pixel or dataset, with separate configs and clean attribution per region, all mFew readersHow to choose a Product Identifier?
What you will learn In this article, you will learn: What is a Product Identifier? When to use Product ID, Variant ID, Metafield, or Custom ID (template) How to set up your Product Identifier Frequently Asked Questions What is a Product Identifier? Every tracking event that contains product data — such as View ContentFew readersSidekick Integration
TagFly integrates with Sidekick, Shopify's AI assistant. You can ask Sidekick questions about your pixel health, events sent to ad channels, and failed events — and get answers right inside Shopify Admin, without opening the TagFly app. This is especially useful when you're in the middle of other work in Admin and want a quick tracking check, or when you suspect something is wrong and need a fast answer before digging deeper. Availability Available to **all stores with TagFly installeFew readers