TG-Staff Magic Link & Google Ads Attribution Setup: Track Conversions with Split Links
关于作者
TG-Staff 致力于为 Telegram Bot 运营团队提供高效、可靠的客服与营销 SaaS 工具。
TG-Staff Magic Links & Google Ads Attribution Configuration Guide: Track Conversions with Diversion Links
In the Telegram ecosystem, one of the biggest headaches for advertising is the attribution gap: when a user clicks a Google Ads ad and jumps directly to your Bot, you have no way of knowing which keyword or ad creative drove the click. Without attribution data, you can’t measure ad ROI, let alone optimize bids.
TG-Staff’s Magic Diversion Links are designed to solve this problem. By capturing visitor IP, browser information, and URL parameters (including UTM parameters), they enable attribution tracking similar to Google Analytics in Telegram customer service scenarios. This guide will walk you through configuring Magic Links and integrating them with Google Ads to create a complete attribution chain from ad click to customer conversation.
Why Magic Links? The Attribution Challenge from Ad Clicks to Telegram Customer Service
Consider a typical scenario:
- You run a Google Ads campaign for the keyword “Telegram customer service tool.”
- A user clicks the ad and lands on your Telegram Bot (
t.me/YourBot?start=ads). - The user interacts with the Bot and then transfers to a human agent.
- Problem: You can’t tell whether this user came from a “brand keyword” or “competitor keyword” ad click, nor which ad creative led to the conversion.
The traditional solution is to manually add start parameters to each ad link (e.g., ?start=ad1), but this method fails to capture additional information like IP, browser type, and doesn’t allow centralized management of multiple ad links on the web.
TG-Staff Magic Links solve this by:
- Creating a unique short link for each campaign (e.g.,
https://app.tg-staff.com/abc123). - When a user clicks the link, TG-Staff’s server first captures source information (IP, User-Agent, UTM parameters, etc.).
- Then automatically redirects to your Telegram Bot, transparent to the user.
- In the TG-Staff console, you can view click counts, source distribution, user regions, and more for each link.
This means you can use Magic Links directly as the final URL in Google Ads and leverage UTM parameters for ad attribution.
Prerequisites: What You Need to Set Up
Before creating Magic Links, check two basic conditions.
Confirm Your Plan and Available Permissions
Magic Diversion Links are a feature of TG-Staff’s Standard plan and above. New users get a 3-day free trial, during which they can experience all Standard features (including Magic Links). After the trial, you need to subscribe to the Standard plan (approx. 8.99/month) or Pro plan (approx.16.99/month) to continue using them.
Steps to check:
- Log in to the TG-Staff Console.
- Go to the “My Subscription” page.
- Check your current plan status. If it shows “Free Trial” or “Standard,” you can use Magic Links. If it shows “Free,” you need to upgrade.
Prepare a Google Ads UTM Parameter Template
UTM parameters are the core of Google Ads attribution. You need to append the following parameters to your Magic Link (example):
?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_content=ad_v1
Common parameters explained:
| Parameter | Purpose | Example Value |
|---|---|---|
utm_source | Traffic source (fixed as google) | google |
utm_medium | Medium (fixed as cpc) | cpc |
utm_campaign | Campaign name | spring_sale |
utm_content | Ad creative/keyword identifier | ad_v1 or keyword_brand |
utm_term | Matched keyword (optional) | telegram_customer_service |
UTM Parameter Tips
It is recommended to set a unique utm_content parameter for each ad group, keyword, or creative in Google Ads, so that you can distinguish conversion effects from different channels in TG-Staff reports later. For example, use utm_content=brand for brand keyword ads and utm_content=competitor for competitor keyword ads.
Step-by-Step: Creating Magic Redirect Links with UTM in TG-Staff
Now let’s get into the practical steps. Assuming you have your UTM parameters ready, here’s how to create a magic link in TG-Staff.
Step 1: Access the Redirect Links Module
- In the left sidebar of the dashboard, find the “Redirect Links” module.
- Click the “Create Redirect Link” button.
Step 2: Select the Target Bot Project
- In the popup dialog, select the Telegram Bot project you want to track.
- Note: Only bot projects already added to TG-Staff will appear in the dropdown. If not added, first integrate the bot in “Project Management”.
Step 3: Add UTM Parameters
- In the “Link URL” field, the system automatically generates a base short link (e.g.,
https://app.tg-staff.com/abc123). - Append your UTM parameters to the link. For example, the full link would look like:
https://app.tg-staff.com/abc123?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_content=ad_v1 - You can use the Google Campaign URL Builder tool (search “Google URL Builder”) to generate a standard UTM link first, then copy it into TG-Staff.
Step 4: Save and Copy the Link
- Click “Save”, and the system will generate a unique redirect link.
- Copy this link for later use in Google Ads.
Avoiding Link Conflicts
If the magic link itself contains parameters (e.g., ?ref=social), use & instead of ? when adding UTM parameters, otherwise parameter overwriting may occur. The TG-Staff console handles this automatically, but be careful when manually concatenating.
Configuring Google Ads: Set Magic Link as Final URL
After creating the magic link with UTM parameters, the next step is to configure it in your Google Ads campaigns.
Step 1: Edit the campaign
- Log in to your Google Ads account and navigate to the campaign you want to track.
- Select an ad group and click the “Edit” button on the ad creative.
Step 2: Replace the final URL
- In the “Final URL” field, paste the magic link you copied earlier (including UTM parameters).
- For example, the original URL might be
t.me/YourBot?start=ads, now replace it withhttps://app.tg-staff.com/abc123?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_content=ad_v1.
Step 3: Set up an ad tracking template (optional)
- If you want to automatically append the Google Click ID (gclid), add the following to the “Tracking template”:
{lpurl}?gclid={gclid} - Note: If the magic link already contains UTM parameters, the parameters in the tracking template will be appended via
&. Ensure the final URL format is correct.
Step 4: Test the link
- After saving the ad, preview the ad to confirm that the link correctly redirects to your Telegram bot.
- Expected flow: Click ad → Redirect to
app.tg-staff.com/{code}→ Automatically redirect to the bot conversation interface.
Verifying Attribution Data: Viewing Click and Conversion Reports in TG-Staff
Once the ad campaign is live, you can view attribution data in the TG-Staff console.
View click data
- Go to the “Splitting Links” module and click the “Details” button for a specific link.
- The system displays:
- Total clicks: Total number of times the link was clicked.
- Source IP region: Geographic distribution of users by country/city.
- Browser type: Device and browser used by users.
- UTM parameter distribution: Click share by different utm_source and utm_campaign values.
View conversion data (Pro plan)
- If you are using the Pro plan, you can use the “User Profile” feature to see users’ subsequent behavior after clicking.
- For example: Click ad → Enter bot → Send message → Transfer to human agent → Complete consultation. TG-Staff records the full conversation path of this user, and you can see the user’s source channel (utm_source) and visit time in the user profile.
How to use data to optimize ads
- Compare click-through rates and conversion rates across different utm_content values to identify the best-performing ad creatives.
- If a keyword has a very low user inquiry rate, consider pausing that keyword.
- Adjust geographic targeting settings based on IP region distribution.
Best Practices: Maximizing Ad Attribution Value with Magic Links
Create separate splitting links for different campaigns
Do not use the same magic link for all ads. Create dedicated links for each ad group or even each ad creative. For example:
| Campaign | Magic Link | UTM Parameters |
|---|---|---|
| Brand keyword ads | https://app.tg-staff.com/link1 | utm_content=brand |
| Competitor keyword ads | https://app.tg-staff.com/link2 | utm_content=competitor |
| Retargeting ads | https://app.tg-staff.com/link3 | utm_content=retarget |
This allows you to clearly see the performance of each ad variant in the TG-Staff report.
Use conversation routing rules to handle peak traffic
When ads bring a large number of users, without proper conversation routing rules, users may have to wait a long time for an agent response, leading to lower conversion rates.
In TG-Staff’s “Project Settings” → “Conversation Routing”, it is recommended:
- For multi-agent teams, select the “Online First” rule: Prioritize assigning conversations to currently online agents to avoid user queuing.
- For solo teams, keep the “Round Robin” distribution.
- If ad campaigns run during fixed times (e.g., 10:00-12:00 daily), schedule agent shifts in advance.
Regularly check UTM parameter naming consistency
When working in a team, UTM parameter naming can easily become inconsistent. For example:
- One ad uses
utm_source=google, another usesutm_source=Google(case difference). - One uses
utm_campaign=spring_sale, another usesutm_campaign=Spring_Sale(underscore vs. camelCase).
Such inconsistencies cause TG-Staff reports to scatter data from the same channel across different rows, affecting attribution accuracy.
Recommendation: Create a team UTM naming convention document, using lowercase letters and underscores consistently. For example:
utm_sourcefixed asgoogle(do not use aliases likegoradwords).utm_mediumfixed ascpc(do not useppcorpaid).- Use
yyyy_mm_活动名称format forutm_campaign.
Frequently Asked Questions
Q: Does the magic splitting link support automatic UTM parameter generation?
A: The TG-Staff console does not automatically generate UTM parameters, but you can manually append parameters like ?utm_source=... to the URL when creating the link; the system will preserve and capture them. It is recommended to use the Google Campaign URL Builder tool to generate standard parameters before copying.
Q: How to distinguish clicks from Google Ads vs. organic traffic?
A: Set different utm_source values in the magic link (e.g., google for ads, organic for organic search). TG-Staff will display the utm_source distribution for each link in the report, allowing you to compare click performance across channels.
Q: What if the click count from the magic link does not match Google Ads impressions?
A: This is normal because the magic link only records actual clicks that redirect to the bot, while Google Ads impressions include exposures without clicks. Typically, magic link clicks are slightly lower than Google Ads impressions, but they more closely represent genuinely interested users.
Q: Can I use magic links during the free trial?
A: Yes. TG-Staff offers a 3-day free trial, during which all features of the Standard plan and above are available, including magic splitting links. After the trial, you need to subscribe to the Standard plan (about 8.99/month) or Pro plan (about16.99/month) to continue using them.
Q: Can magic links be used for non-Google Ads channels (e.g., Facebook, Twitter)?
A: Yes. Magic links are universal short links. You can add corresponding UTM parameters for any channel (social media, email, QR codes), and TG-Staff will unify attribution. All channels that support URL parameter passing are compatible.
Get started now: Sign up for TG-Staff free trial and create your first magic splitting link. If you encounter any issues during configuration, refer to the official documentation or contact the support bot @tgstaff_robot. If you are looking for a tool that integrates Telegram ad attribution and customer service management, TG-Staff’s magic link is a solution worth trying.
Related Articles
Only TG Data Reporting Gaps: Filling Attribution and Session Statistics with TG-Staff
Only TG faces pain points in data reporting such as attribution gaps and insufficient session statistics. This article analyzes these gaps and introduces how TG-Staff helps fill data blind spots in customer service operations through split-link attribution, session statistics, and user profiles, improving channel evaluation and customer service efficiency.
Only TG vs TG-Staff 2026 Comparison: A Guide to Choosing Agents, Stripe, Risk Control, and Routing
Who is better suited for Telegram customer service operations in 2026: Only TG or TG-Staff? This article provides a side-by-side comparison across four dimensions—agent management, Stripe payments, content risk control, and session routing—to help overseas and Web3 teams make the right selection decision.
How to Track Telegram Bot Traffic Attribution with Magic Links and UTM Parameters
Learn how to set up Telegram Bot attribution using magic links and UTM parameters. A step-by-step guide for tracking ad campaigns, traffic sources, and user behavior with TG-Staff.