---
title: "Telegram Ads ट्रैकिंग: मैक्रो और रूपांतरण पोस्टबैक"
description: "AdsGram में Telegram Ads अभियानों को कैसे ट्रैक करें: वेब लिंक के लिए मैक्रो, रूपांतरण पुष्टि API के ज़रिए रूपांतरण पोस्टबैक, और Mini App, बॉट व चैनल के लिए Goal 1 में स्वचालित इवेंट।"
outline: [2,4]
---
# Telegram Ads ट्रैकिंग
Telegram Ads अभियानों के प्रदर्शन की अधिक विस्तृत ट्रैकिंग और लक्ष्य क्रियाओं के स्रोतों का सही attribution सुनिश्चित करने के लिए, एक **विश्लेषण प्रणाली** का उपयोग करना अनुशंसित है।

## Telegram Ads में वेब लिंक के लिए समर्थित मैक्रो
विस्तृत ट्रैकिंग के लिए मैक्रो का उपयोग करें। AdsGram आपके ट्रैकिंग लिंक में उन्हें अपने-आप वास्तविक डेटा से बदल देगा।
- `{campaign_id}`
- `{banner_id}`
- `{publisher_id}`
- `{useragent}`
- `{click_id}`
- `{ip}`
- `{campaign}` — अभियान का नाम

> [!IMPORTANT] महत्वपूर्ण
> यह समर्थन केवल Telegram Ads में वेब लिंक पर लागू होता है। Telegram Ads अभियानों में Telegram Mini Apps (TMA), बॉट या Telegram चैनलों की ओर ले जाने वाले लिंक के लिए AdsGram मैक्रो अभी भी समर्थित नहीं हैं।

::: warning चेतावनी
Telegram Ads अभियानों में वेब लिंक के साथ रूपांतरण पुष्टि API के सही ढंग से काम करने के लिए, अभियान URL में `{campaign_id}` मैक्रो होना आवश्यक है। यदि आवश्यक मैक्रो मौजूद नहीं है, तो रूपांतरण ट्रैकिंग काम नहीं करेगी।

Telegram Ads अभियानों में, Telegram Mini Apps (TMA), बॉट या चैनलों की ओर ले जाने वाले लिंक के लिए AdsGram मैक्रो समर्थित नहीं हैं। इसलिए Telegram Ads अभियानों में ऐसे लिंक से रूपांतरण ट्रैक करने के लिए रूपांतरण पुष्टि API का उपयोग नहीं किया जा सकता। अधिक जानकारी के लिए नीचे [Telegram Ads अभियानों में Telegram के अंदर के लिंक के लिए रूपांतरण ट्रैकिंग](#telegram-ads-अभियानों-में-telegram-के-अंदर-के-लिंक-के-लिए-रूपांतरण-ट्रैकिंग) देखें।
:::

> [!IMPORTANT] महत्वपूर्ण
> `{publisher_id}` मैक्रो केवल एक यूनिक प्रकाशक पहचानकर्ता के रूप में प्रकट किया जाता है — इसका नाम या अन्य पहचान योग्य जानकारी शामिल नहीं होती।

कैंपेन URL का उदाहरण:
```
https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id}
```

डैशबोर्ड उन मैक्रोस को हाइलाइट करता है जो लिंक में जोड़े गए हैं <img src="../../images/icons/added_macros.png" alt="Added macros" width="18" style="display: inline" /> और जो गायब हैं <img src="../../images/icons/missed_macros.png" alt="Missed macros" width="18" style="display: inline" />।

![चयनित मैक्रो](../../advertiser/images/selected_macroses.webp =500x)

## Telegram Ads में वेब लिंक के लिए रूपांतरण पोस्टबैक सेट करना
### पैरामीटर:
- `token` — आपके अकाउंट से जुड़ा एक यूनिक टोकन। यह AdsGram डैशबोर्ड में उपलब्ध है और ज़रूरत होने पर दोबारा जनरेट किया जा सकता है।

  **अपना टोकन कैसे प्राप्त करें:**
  1. AdsGram डैशबोर्ड खोलें।
  1. ऊपर दाएँ कोने में अपनी प्रोफ़ाइल पर क्लिक करें।
  1. `token` पैरामीटर ढूँढें और उसे कॉपी करने के लिए कॉपी बटन <img src="../../images/icons/copy.png" alt="Copy" width="18" style="display: inline" /> पर क्लिक करें।

  ![Copy macros](../../advertiser/images/copy_macros.webp =200x)
- `campaignid` — उस AdsGram विज्ञापन अभियान का ID जिससे रूपांतरण जुड़ा है। यह विज्ञापन लिंक में पास किए गए `{campaign_id}` मैक्रो के मान से मेल खाता है। जब उपयोगकर्ता लिंक पर क्लिक करता है, तब AdsGram मैक्रो का मान भर देता है।
- `goaltype` — एक पैरामीटर जो रूपांतरण के प्रकार (फ़नल चरण) को निर्दिष्ट करता है, विभिन्न उपयोगकर्ता क्रियाओं को खंडित करने में मदद करता है। यह 1 से 3 तक पूर्णांक मान लेता है।

  ##### goaltype उपयोग:
  1. अपने प्रोडक्ट या सेवा में फ़नल चरणों को परिभाषित करें।
  1. चरणों को goaltype मानों से मैप करें:
      - 1. पंजीकरण
      - 2. पहला जमा/खरीद
      - 3. पुनः जमा/खरीद
  1. उपयोगकर्ता यात्रा के संबंधित चरणों के लिए रूपांतरण ट्रैकिंग कॉन्फ़िगर करें।
  1. रूपांतरण डेटा भेजते समय अपने API अनुरोध में goaltype पैरामीटर जोड़ें।
  1. अपने विश्लेषण में इस पैरामीटर का उपयोग करके रूपांतरण प्रकार के अनुसार विस्तृत प्रदर्शन विश्लेषण करें।

### रूपांतरण ट्रैकिंग कैसे सेट करें:
1. **Telegram Ads अभियान चुनें।** किसी मौजूदा सक्रिय अभियान का उपयोग करें या नया बनाएं।
1. **ट्रैकिंग लिंक कॉन्फ़िगर करें।** सुनिश्चित करें कि उसमें `{campaign_id}` मैक्रो शामिल है।
1. **अपना टोकन प्राप्त करें।** AdsGram डैशबोर्ड से अपना यूनिक टोकन कॉपी करें।
1. **पोस्टबैक भेजना सेट करें।** अपने सर्वर को इस तरह कॉन्फ़िगर करें कि जब भी कोई उपयोगकर्ता लक्षित कार्य पूरा करे, वह AdsGram को API अनुरोध भेजे।
1. **रूपांतरण का प्रकार बताएं।** अगर आप फ़नल चरणों में अंतर करना चाहते हैं, तो उपयुक्त `goaltype` मान सेट करें।
1. **इंटीग्रेशन जाँचें।** नीचे **इंटीग्रेशन परीक्षण** अनुभाग के चरणों का पालन करें और पुष्टि करें कि रूपांतरण AdsGram आंकड़ों में दिखाई दे रहे हैं।

#### रूपांतरण होने पर API अनुरोध का उदाहरण:
```
GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&campaignid=72156&goaltype=2
```
इस उदाहरण में `goaltype=2` पहला जमा या खरीद जैसे रूपांतरण को दर्शाता है।

`YOUR_UNIQUE_TOKEN` की जगह अपने अकाउंट का टोकन और `72156` की जगह अपने विज्ञापन अभियान का ID लिखें।

**अपेक्षित प्रतिक्रिया:** `200 OK` — रूपांतरण सफलतापूर्वक दर्ज हो गया है।

### इंटीग्रेशन परीक्षण
रूपांतरण ट्रैकिंग का परीक्षण करने के लिए ये चरण अपनाएं:
1. **अभियान बनाएं या चुनें।** एक Telegram Ads अभियान बनाएं या चुनें और दस्तावेज़ के अनुसार ट्रैकिंग लिंक कॉन्फ़िगर करें। सुनिश्चित करें कि लिंक में `{campaign_id}` मैक्रो शामिल है।
1. **क्लिक की प्रतीक्षा करें।** तब तक प्रतीक्षा करें जब तक उपयोगकर्ता ट्रैकिंग लिंक पर कई बार क्लिक न कर लें।
1. **`goaltype=1` पैरामीटर के साथ मैन्युअल रूप से टेस्ट पोस्टबैक भेजें।** एक मान्य `token` और `campaignid` पैरामीटर में टेस्ट अभियान का ID इस्तेमाल करें।
1. **परिणाम जाँचें।** पुष्टि करें कि अनुरोध सफलतापूर्वक प्रोसेस हुआ और चुने गए अभियान के AdsGram आंकड़ों में रूपांतरण दिखाई दे रहा है।

### समस्या निवारण
- **रूपांतरण आंकड़ों में दिखाई देता है:** इंटीग्रेशन सही तरीके से कॉन्फ़िगर है और परीक्षण किए गए परिदृश्य के लिए काम कर रहा है।
- **सर्वर त्रुटि लौटाता है:** अनुरोध URL और `token`, `campaignid` और `goaltype` पैरामीटर के मान जाँचें।
- **अनुरोध सफल है, लेकिन रूपांतरण दिखाई नहीं देता:** आंकड़े हर घंटे में एक बार अपडेट होते हैं। अगर एक घंटे बाद भी रूपांतरण नहीं दिखता, तो AdsGram सपोर्ट या अपने अकाउंट मैनेजर से संपर्क करें। अनुरोध के साथ रिक्वेस्ट और रिस्पॉन्स लॉग अवश्य संलग्न करें।

## Telegram Ads अभियानों में Telegram के अंदर के लिंक के लिए रूपांतरण ट्रैकिंग
Telegram Ads अभियानों में, Telegram के अंदर के गंतव्यों पर ले जाने वाले लिंक के लिए AdsGram मैक्रो समर्थित नहीं हैं और ऐसे विज्ञापन लिंक में पास नहीं किए जाते। इसलिए रूपांतरण पुष्टि API का उपयोग Telegram Mini Apps (TMA), बॉट या चैनलों पर ले जाने वाले लिंक से रूपांतरण ट्रैक करने के लिए नहीं किया जा सकता।

Telegram Ads अभियानों में Telegram के अंदर के लिंक के लिए, निम्नलिखित लक्षित इवेंट डिफ़ॉल्ट रूप से अपने आप **Goal 1** में दर्ज होते हैं:
- TMA — TMA लॉन्च;
- बॉट — बॉट लॉन्च;
- चैनल — चैनल सब्सक्रिप्शन।

रूपांतरण अपने आप दर्ज होते हैं, इसलिए किसी अतिरिक्त कॉन्फ़िगरेशन की आवश्यकता नहीं है।