---
title: "تتبع Telegram Ads: الماكرو وpostback التحويلات"
description: "كيفية تتبع حملات Telegram Ads في AdsGram: الماكرو لروابط الويب، وpostback التحويلات عبر API تأكيد التحويل، والأحداث التلقائية في Goal 1 للتطبيقات المصغّرة والبوتات والقنوات."
outline: [2,4]
---
# تتبع Telegram Ads
لمزيد من التفصيل في تتبع أداء حملات Telegram Ads ونسب مصادر الإجراءات المستهدفة بشكل صحيح، يُنصح باستخدام **نظام تحليلات**.

## الماكرو المدعومة لروابط الويب في Telegram Ads
للتتبع التفصيلي، استخدم الماكرو. سيستبدلها AdsGram تلقائيًا ببيانات حقيقية في رابط التتبع الخاص بك.
- `{campaign_id}`
- `{banner_id}`
- `{publisher_id}`
- `{useragent}`
- `{click_id}`
- `{ip}`
- `{campaign}` — اسم الحملة

> [!IMPORTANT] مهم
> ينطبق هذا الدعم على روابط الويب في Telegram Ads فقط. لا تزال ماكرو AdsGram غير مدعومة للروابط المؤدية إلى Telegram Mini Apps (TMA) أو البوتات أو قنوات Telegram في حملات Telegram Ads.

::: warning تحذير
لكي تعمل API تأكيد التحويل بشكل صحيح مع روابط الويب في حملات Telegram Ads، يجب أن يتضمن رابط الحملة الماكرو `{campaign_id}`. إذا كان الماكرو الإلزامي مفقودًا، فلن يعمل تتبع التحويلات.

في حملات Telegram Ads، لا تُدعم ماكرو AdsGram للروابط المؤدية إلى Telegram Mini Apps (TMA) أو البوتات أو القنوات. لذلك لا يمكن استخدام API تأكيد التحويل لتتبع التحويلات من هذه الروابط في حملات Telegram Ads. لمزيد من المعلومات، راجع قسم [تتبع التحويلات للروابط داخل Telegram في حملات Telegram Ads](#تتبع-التحويلات-للروابط-داخل-telegram-في-حملات-telegram-ads) أدناه.
:::

> [!IMPORTANT] مهم
> يتم كشف الماكرو `{publisher_id}` فقط كمعرّف فريد للناشر — دون تحديد اسمه أو أي معلومات تعريفية أخرى.

مثال على رابط الحملة:
```
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)

## إعداد postback للتحويلات لروابط الويب في Telegram Ads
### المعلمات:
- `token` — رمز فريد مرتبط بحسابك. يتوفر في لوحة AdsGram ويمكن إعادة إنشائه عند الحاجة.

  **كيفية الحصول على الرمز:**
  1. افتح لوحة AdsGram.
  1. انقر على ملفك الشخصي في الزاوية العلوية اليمنى.
  1. ابحث عن المعلمة `token` وانقر على زر النسخ <img src="../../images/icons/copy.png" alt="Copy" width="18" style="display: inline" /> لنسخها.

  ![نسخ الماكرو](../../advertiser/images/copy_macros.webp =200x)
- `campaignid` — معرّف حملة AdsGram الإعلانية التي يرتبط بها التحويل. يتوافق مع قيمة الماكرو `{campaign_id}` الذي يُمرَّر في الرابط الإعلاني. يُدرج AdsGram قيمة الماكرو عندما ينقر المستخدم على الرابط.
- `goaltype` — معلمة تحدد نوع التحويل (مرحلة القمع)، مما يساعد على تقسيم إجراءات المستخدمين المختلفة. تقبل قيمًا صحيحة من 1 إلى 3.

  ##### استخدام goaltype:
  1. حدد مراحل القمع في منتجك أو خدمتك.
  1. قم بتعيين المراحل إلى قيم goaltype:
      - 1. التسجيل
      - 2. الإيداع/الشراء الأول
      - 3. الإيداع/الشراء المتكرر
  1. قم بتكوين تتبع التحويل للمراحل ذات الصلة من رحلة المستخدم.
  1. أضف معلمة goaltype إلى طلب API عند إرسال بيانات التحويل.
  1. استخدم هذه المعلمة في تحليلاتك لإجراء تحليل أداء مفصّل حسب نوع التحويل.

### كيفية إعداد تتبع التحويلات:
1. **اختر حملة Telegram Ads.** استخدم حملة نشطة موجودة أو أنشئ حملة جديدة.
1. **اضبط رابط التتبع.** تأكد من أنه يحتوي على الماكرو `{campaign_id}`.
1. **احصل على الرمز.** انسخ رمزك الفريد من لوحة AdsGram.
1. **اضبط إرسال postback.** اضبط خادمك لإرسال طلب API إلى AdsGram كلما أكمل المستخدم إجراءً مستهدفًا.
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` بمعرّف حملتك الإعلانية.

**الاستجابة المتوقعة:** `200 OK` — تم تسجيل التحويل بنجاح.

### اختبار التكامل
لاختبار تتبع التحويلات، اتبع الخطوات التالية:
1. **أنشئ حملة أو اخترها.** أنشئ حملة Telegram Ads أو اخترها واضبط رابط التتبع وفقًا للوثائق. تأكد من تضمين الماكرو `{campaign_id}` في الرابط.
1. **انتظر النقرات.** انتظر حتى ينقر المستخدمون على رابط التتبع عدة مرات.
1. **أرسل postback تجريبيًا يدويًا** مع المعلمة `goaltype=1`. استخدم `token` صالحًا ومعرّف الحملة التجريبية في المعلمة `campaignid`.
1. **تحقق من النتيجة.** تأكد من معالجة الطلب بنجاح ومن ظهور التحويل في إحصاءات AdsGram للحملة المحددة.

### استكشاف الأخطاء وإصلاحها
- **يظهر التحويل في الإحصاءات:** التكامل مضبوط بشكل صحيح ويعمل في السيناريو الذي تم اختباره.
- **يعيد الخادم خطأ:** تحقق من عنوان URL للطلب وقيم المعلمات `token`، `campaignid` و`goaltype`.
- **ينجح الطلب لكن التحويل لا يظهر:** يتم تحديث الإحصاءات مرة كل ساعة. إذا لم يظهر التحويل بعد ساعة، فتواصل مع دعم AdsGram أو مدير حسابك، واحرص على إرفاق سجلات الطلب والاستجابة.

## تتبع التحويلات للروابط داخل Telegram في حملات Telegram Ads
في حملات Telegram Ads، لا تُدعم ماكرو AdsGram للروابط التي تقود إلى وجهات داخل Telegram، ولا تُمرَّر إلى هذه الروابط الإعلانية. لذلك لا يمكن استخدام API تأكيد التحويل لتتبع التحويلات من الروابط التي تقود إلى Telegram Mini Apps (TMA) أو البوتات أو القنوات.

بالنسبة للروابط داخل Telegram في حملات Telegram Ads، تُسجَّل الأحداث المستهدفة التالية تلقائيًا ضمن **Goal 1** افتراضيًا:
- TMA — تشغيل TMA؛
- البوتات — تشغيل البوت؛
- القنوات — الاشتراك في القناة.

تُسجَّل التحويلات تلقائيًا، لذلك لا يلزم أي إعداد إضافي.