TG-Staff 团队 avatar TG-Staff 团队

TG-Staff Magic Link & Google Ads Attribution Setup: Track Conversions with Split Links

tgstaff Ads Google Ads Attribution UTM

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.

Consider a typical scenario:

  1. You run a Google Ads campaign for the keyword “Telegram customer service tool.”
  2. A user clicks the ad and lands on your Telegram Bot (t.me/YourBot?start=ads).
  3. The user interacts with the Bot and then transfers to a human agent.
  4. 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:

  1. Log in to the TG-Staff Console.
  2. Go to the “My Subscription” page.
  3. 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:

ParameterPurposeExample Value
utm_sourceTraffic source (fixed as google)google
utm_mediumMedium (fixed as cpc)cpc
utm_campaignCampaign namespring_sale
utm_contentAd creative/keyword identifierad_v1 or keyword_brand
utm_termMatched 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.

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.

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 with https://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.

Do not use the same magic link for all ads. Create dedicated links for each ad group or even each ad creative. For example:

CampaignMagic LinkUTM Parameters
Brand keyword adshttps://app.tg-staff.com/link1utm_content=brand
Competitor keyword adshttps://app.tg-staff.com/link2utm_content=competitor
Retargeting adshttps://app.tg-staff.com/link3utm_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 uses utm_source=Google (case difference).
  • One uses utm_campaign=spring_sale, another uses utm_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_source fixed as google (do not use aliases like g or adwords).
  • utm_medium fixed as cpc (do not use ppc or paid).
  • Use yyyy_mm_活动名称 format for utm_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.