Diversion Link IP Tracking Guide: How to Capture Visitor Information and Attribution Parameters Before Redirect

In Telegram Bot operations, tracking user sources is a core challenge for optimizing ad campaigns and measuring channel effectiveness. When users click a link from social media, ads, or emails to enter your Bot, how do you know which channel they came from? What device did they use? Where is their IP located? Traditional Telegram Bot links cannot natively carry this information, leading to a gap in attribution analysis.

Diversion Link IP tracking is designed to solve this pain point. By setting up an intermediate page before redirecting to the Telegram Bot, it captures the visitor’s IP address, browser information, and custom parameters from the URL in an instant, enabling precise attribution analysis. This article will guide you step by step on how to configure diversion links and demonstrate how to use captured data to optimize operational decisions.

What is Diversion Link IP Tracking and Why Is It Crucial for Attribution Analysis?

A diversion link is a short link with a pre-redirect capture mechanism. Its workflow is as follows:

1. The user clicks the diversion link (e.g., https://app.tg-staff.com/abc123).
2. The system automatically records the visitor’s IP address, User-Agent, screen resolution, language preference, and other information on the intermediate page.
3. Simultaneously, it parses all custom parameters carried in the URL (e.g., ?utm_source=twitter&campaign=summer).
4. After recording, it immediately redirects the user to the specified Telegram Bot conversation.

Compared to in-Bot message tracking, this mechanism has an irreplaceable advantage: source data is reliably captured before any interaction between the user and the Bot.

Pain Points of Traditional Telegram Attribution

• Parameter loss: Ordinary Bot links (e.g., t.me/yourbot?start=xxx) can pass the start parameter, but this parameter is consumed after the user’s first click and cannot be associated with the user profile long-term. Moreover, the t.me domain has very limited support for URL parameters, and standard parameters like utm_* cannot be natively parsed.
• Inability to capture IP and device: The Telegram client itself does not pass the user’s IP or browser information to the Bot. You cannot know whether the user entered via a mobile scan, web version, or desktop client.
• Difficulty in cross-session attribution: When users enter the Bot multiple times, traditional methods struggle to associate multiple sessions with the same ad source.

How Diversion Links Solve Attribution Gaps

Diversion links complete a “data snapshot” before the redirect through an official short link intermediate page. TG-Staff automatically writes the captured visitor environment and URL parameters into the backend user profile. This means:

• Every session has a source label: No matter how many times a user clicks, each entry is associated with the latest captured data.
• No additional development required: No need to write SDKs or modify Bot code; just configure a link to make it work.
• Data can be traced long-term: Captured parameters are persistently saved as custom fields in the user profile, supporting subsequent filtering and export.

How to Configure Split Links for IP and Parameter Capture

The following are the complete steps to configure split links in the TG-Staff console. The entire process takes about 5 minutes and requires no programming knowledge.

Step 1: Create a Project and Get a Bot Token

1. Log in to the TG-Staff App Console.
2. Click “Create Project” and enter a project name (e.g., “Customer Service System”).
3. Follow the prompts to create or select a Bot in Telegram, obtain its token, and paste it into the console.
4. After binding the Bot, the project will be activated.

Step 2: Generate a Split Link

1. In the left menu of the project, find and enter the “Split Links” module.
2. Click the “Create Split Link” button.
3. The system will generate a short link in the format https://app.tg-staff.com/{随机代码}. This short link automatically captures visitor information without any additional configuration.
4. (Optional) You can set a remark name for the split link, such as “Twitter Summer Promotion”, to distinguish different links in the backend.

Step 3: Use the Split Link in Ads or Social Media

1. Copy the generated split link.

2. Paste it into ad copy, social media posts, emails, or QR codes. For example:

   立即咨询：https://app.tg-staff.com/abc123?utm_source=twitter&utm_medium=post&campaign=summer2025

3. You can append any number of URL parameters. The system automatically captures all query parameters starting with ?, including but not limited to:

   • utm_source: Traffic source (e.g., facebook, twitter, google)
   • utm_medium: Medium (e.g., cpc, social, email)
   • utm_campaign: Campaign name
   • source, campaign_id, ref and other custom parameters

How Captured Visitor Information Is Used for Attribution Analysis

Data capture is just the first step; the key is how to use this data to make more informed operational decisions.

Viewing Attribution Data in User Profiles

1. In the TG-Staff console, go to the “Users” or “User Profiles” module.

2. Click on any user to view their details.

3. In the “Custom Fields” area, you will see all parameters captured by the routing link, for example:

   Field Name	Value
   utm_source	twitter
   utm_medium	post
   campaign	summer2025
   ip	203.0.113.xxx
   user_agent	Mozilla/5.0 (iPhone; CPU iPhone OS 17_4 like Mac OS X) …

4. These fields update with each new session, so you can see the channel source of the user’s most recent entry.

Making Operational Decisions Based on Attribution Data

• Channel Performance Comparison: By filtering on the “utm_source” field, you can count sessions, average response time, and conversion rates from different channels. For example, you may find that Twitter brings high inquiry volume but low conversion, while Facebook ads have a 30% higher conversion rate. This insight allows you to adjust budget allocation.
• User Segmentation for Broadcasts: In the “Message Broadcast” module, create a user segment based on the condition “utm_campaign” equals “summer2025” to send targeted follow-up messages for the summer campaign. This is more precise than a mass broadcast and effectively boosts click-through rates.
• A/B Testing Ad Creatives: Create separate routing links for different ad copy within the same channel (e.g., ?ad_id=A and ?ad_id=B) to compare which copy drives users more willing to interact with agents.

Routing Links vs. Regular Bot Links: Attribution Capabilities Comparison

Comparison Dimension	Regular Bot Link (t.me/yourbot?start=xxx)	Routing Link (app.tg-staff.com/{code})
Parameter Reliability	Only effective on first click, parameters easily lost	Captured on every click, parameters persistently stored
IP Capture	Not supported	Automatically captured, includes geographic info
Device Information	Not supported	Automatically captures User-Agent, screen resolution, language
Cross-Session Association	Difficult, requires manual recording within bot	Automatically linked to user profile, supports long-term tracking
Configurability	Only supports start parameter, no customization	Supports any URL parameter, no mapping rules needed
Development Required	Requires parsing parameters in bot code	Zero-code configuration, out-of-the-box

As the table shows, if you need any form of attribution analysis or user source tracking, routing links are almost indispensable.

Best Practices: Optimizing Ad Traffic Funnels with Routing Links

Integrating routing links into the complete traffic funnel creates a measurable, optimizable closed-loop system.

Scenario 1: Multi-Channel Ad Attribution

Funnel: Ad → Routing Link → Bot Auto-Reply → Human Agent

You can use different routing links (or the same link with different utm_campaign parameters) for each ad group in Google Ads, Facebook Ads, or Twitter Ads. When a user clicks:

• The system automatically captures their IP and device info.
• Based on preset auto-replies, the bot guides the user to leave contact info or state their needs.
• When an agent sees the user in the backend, the “Custom Fields” already contain the source channel label.

Outcome: You can directly track inquiry volume, agent response time, and conversion sessions per channel in the TG-Staff backend, quantifying each channel’s ROI.

Scenario 2: Event Traffic and Segmentation

Funnel: Event Poster → Routing Link → Bot Welcome Message → Auto-Tagging

Attach a ?source=event_2025 parameter to the QR code or link on the event poster. After users scan and enter the bot:

• The routing link captures parameters and writes them into the user profile.
• The bot automatically sends an event-specific welcome message (e.g., “Welcome to the 2025 Summer Summit!”).
• Later, you can filter all users with source=event_2025 in “User Profiles” to push event recaps, surveys, or next event announcements.

Frequently Asked Questions

Q: Is the IP address captured by a diversion link the user’s real IP?

A: Yes, when a user clicks a diversion link, the intermediate page directly captures the source IP address of the user’s request before redirecting to the bot. However, please note that if the user is using a VPN or proxy, the captured IP may not reflect their actual geographic location.

Q: What URL parameters can be customized?

A: Any standard URL query parameters are supported, such as ?utm_source=facebook&utm_medium=cpc&campaign=promo2025. The system automatically captures and stores them in custom fields of the user profile without requiring additional mapping rules.

Q: Do diversion links support HTTPS? Is the data secure?

A: Yes, all diversion links use HTTPS encryption for transmission. Captured data is stored on TG-Staff’s secure servers, complying with industry-standard encryption requirements.

Q: Can I use diversion links with the free trial?

A: The diversion link feature is available in the Standard plan and above. After registration, you can enjoy a 3-day free trial, during which you can experience the full functionality, including using diversion links and viewing captured data.

Q: Can captured attribution data be exported?

A: Yes. In the user profile module, attribution data is displayed as custom fields. You can export the data as a CSV file via the backend export feature for further processing in external analysis tools.

Summary and Next Steps

Diversion Link IP Tracking solves the long-standing attribution challenge in Telegram Bot operations. By capturing visitor IP, device information, and URL parameters before the redirect, you can clearly know where each user comes from, what device they use, and whether they eventually convert into a valid inquiry. This capability is crucial for advertising, evaluating channel performance, and user segmentation operations.

If you are running a Telegram Bot and want to move beyond “blind targeting,” now is the perfect time to act:

1. Visit the TG-Staff website to learn about plan details; registration gives you a 3-day free trial.
2. Log in to the app console to create your first diversion link.
3. Use the link in ads or social media, then return to the backend to view captured visitor data.
4. If you have any questions, feel free to contact @tgstaff_robot for one-on-one configuration guidance.

Check the TG-Staff documentation for more advanced configuration on diversion links and session routing.