تتبع التحويلات في حملات Telegram Ads

تتبع التحويلات للروابط داخل Telegram في حملات Telegram Ads

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

بالنسبة للروابط داخل Telegram في حملات Telegram Ads، تُسجَّل الأحداث المستهدفة التالية تلقائيًا ضمن Goal 1 افتراضيًا:

• TMA — تشغيل TMA؛
• البوتات — تشغيل البوت؛
• القنوات — الاشتراك في القناة.

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

إعداد postback للتحويلات لروابط الويب في Telegram Ads

المعلمات:

• token — رمز فريد مرتبط بحسابك. يتوفر في لوحة AdsGram ويمكن إعادة إنشائه عند الحاجة.

  كيفية الحصول على الرمز:

  1. افتح لوحة AdsGram.
  2. انقر على ملفك الشخصي في الزاوية العلوية اليمنى.
  3. ابحث عن المعلمة token وانقر على زر النسخ لنسخها.

  

• campaignid — معرّف حملة AdsGram الإعلانية التي يرتبط بها التحويل. يتوافق مع قيمة الماكرو {campaign_id} الذي يُمرَّر في الرابط الإعلاني. يُدرج AdsGram قيمة الماكرو عندما ينقر المستخدم على الرابط.

• goaltype — معلمة تحدد نوع التحويل (مرحلة القمع)، مما يساعد على تقسيم إجراءات المستخدمين المختلفة. تقبل قيمًا صحيحة من 1 إلى 3.

  استخدام goaltype:

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

كيفية إعداد تتبع التحويلات:

1. اختر حملة Telegram Ads. استخدم حملة نشطة موجودة أو أنشئ حملة جديدة.
2. اضبط رابط التتبع. تأكد من أنه يحتوي على الماكرو {campaign_id}.
3. احصل على الرمز. انسخ رمزك الفريد من لوحة AdsGram.
4. اضبط إرسال postback. اضبط خادمك لإرسال طلب API إلى AdsGram كلما أكمل المستخدم إجراءً مستهدفًا.
5. حدد نوع التحويل. عيّن قيمة goaltype المناسبة إذا أردت التمييز بين مراحل القمع.
6. اختبر التكامل. اتبع الخطوات الواردة في قسم اختبار التكامل أدناه وتحقق من ظهور التحويلات في إحصاءات 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} في الرابط.
2. انتظر النقرات. انتظر حتى ينقر المستخدمون على رابط التتبع عدة مرات.
3. أرسل postback تجريبيًا يدويًا مع المعلمة goaltype=1. استخدم token صالحًا ومعرّف الحملة التجريبية في المعلمة campaignid.
4. تحقق من النتيجة. تأكد من معالجة الطلب بنجاح ومن ظهور التحويل في إحصاءات AdsGram للحملة المحددة.

استكشاف الأخطاء وإصلاحها

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