Skip to content

التتبع

لمزيد من التفصيل في تتبع أداء الحملة ونسب مصادر الإجراءات المستهدفة بشكل صحيح، يُنصح باستخدام نظام تحليلات.

أنواع الماكرو التي يكشفها AdsGram:

للتتبع المفصّل، استخدم الماكرو. سيستبدلها AdsGram تلقائياً ببيانات حقيقية في رابط التتبع الخاص بك.

  • {campaign_id}
  • {banner_id}
  • {publisher_id}
  • {click_id}
  • {record_data}

تحذير

يجب أن تحتوي روابط الحملات على الماكرو التالية لكي يعمل API تأكيد التحويل بشكل صحيح:

إذا كان الماكرو المطلوب مفقودًا، سيفشل تتبع التحويلات.

في حملات Telegram Ads، لا تُدعم الماكروهابطل Gram ولا تُمرّر إلى عنوان URL الإعلاني. وبالتالي، لا يمكن استخدام API تأكيد التحويل لتتبع التحويلات في الحملات التي تُنفّذ على Telegram Ads.

مهم

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

مثال على رابط الحملة:

https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id}&record={record_data}

مهم

إذا كان رابط الوجهة يفتح TMA عبر معلمة start، استخدم الرابط التالي، على سبيل المثال:

https://t.me/[name_of_the_bot]?start=[unique_referral_link]_{campaign_id}_{banner_id}_{publisher_id}_{click_id}_{record_data}

تُبرز اللوحة الماكرو المضافة إلى الرابط Added macros والماكرو المفقودة Missed macros.

الماكرو المحددة

API لتأكيد التحويل

لأنظمة التحليلات المخصصة أو التكامل المباشر مع الخادم، استخدم API.

نقطة نهاية API هي عنوان URL خاص حيث يُصدر خادمك طلباً فور تسجيل حدث تحويل المستخدم. يتيح هذا لـ AdsGram استلام بيانات فورية حول نتائج الحملة.

نقطة النهاية:

https://api.adsgram.ai/confirm_conversion

أدلة الإعداد التفصيلية