التتبع

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

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

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

• {campaign_id}
• {banner_id}
• {publisher_id}
• {useragent}
• {device_model}
• {click_id}
• {ip}
• {campaign} — اسم الحملة
• {os_version}
• {lang}
• {gaid}
• {idfa}
• {record_data}

دعم الماكرو لروابط الويب في Telegram Ads

أصبحت الماكرو التالية مدعومة الآن أيضاً لروابط الويب في حملات Telegram Ads:

• {campaign_id}
• {banner_id}
• {publisher_id}
• {useragent}
• {click_id}
• {ip}
• {campaign} — اسم الحملة

مهم

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

تحذير

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

• {record_data} - مطلوب لـ روابط الويب، بالإضافة إلى Keitaro و Kochava.
• {campaign_id} - مطلوب لـ روابط Telegram ولـ روابط الويب في Telegram Ads.

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

في حملات Telegram Ads، لا تُدعم ماكرو AdsGram للروابط التي تقود إلى Telegram Mini Apps (TMA) أو البوتات أو القنوات. لذلك لا يمكن استخدام API تأكيد التحويل لتتبع التحويلات من هذه الروابط في حملات Telegram Ads. لمزيد من المعلومات حول تتبع التحويلات للروابط داخل Telegram في حملات 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}

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

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

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

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

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

https://api.adsgram.ai/confirm_conversion

أدلة الإعداد التفصيلية لـ postback التحويلات

• روابط حملات Telegram Ads
• روابط الهبوط لنظام Telegram البيئي
• تتبع مشتركي قناة Telegram
• روابط الهبوط للويب
• تكاملات الشركاء — أدلة التكامل لـ Adjust و AppMetrica و Keitaro و Kochava