إعداد postback للتحويلات لروابط الوجهة في نظام Telegram البيئي

تنبيه

لا تنطبق التعليمات الواردة في هذا القسم على حملات Telegram Ads. لمزيد من المعلومات حول تتبع التحويلات للروابط داخل Telegram في حملات Telegram Ads، راجع هذا القسم.

المعلمات:

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

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

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

  

• tgid — معرّف Telegram للمستخدم الذي نقر على الرابط الإعلاني.

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

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

  استخدام goaltype:

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

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

1. اختر حملة. استخدم حملة نشطة موجودة أو أنشئ حملة جديدة.
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&tgid=98110997&goaltype=2&campaignid=72156

في هذا المثال، تمثل goaltype=2 تحويلًا مثل الإيداع الأول أو الشراء الأول.

استبدل قيم المثال ببياناتك الفعلية:

• YOUR_UNIQUE_TOKEN — رمز حسابك في AdsGram؛
• 98110997 — معرّف Telegram للمستخدم الذي نقر على الرابط الإعلاني؛
• 72156 — معرّف حملتك الإعلانية.

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

اختبار التكامل

لاختبار تتبع التحويلات، اتبع الخطوات التالية:

1. أنشئ حملة أو اخترها. اضبط الرابط الإعلاني وفقًا للوثائق وتأكد من أنه يحتوي على الماكرو {campaign_id}.
2. انتظر النقرات. انتظر حتى ينقر المستخدمون على الرابط الإعلاني عدة مرات.
3. احصل على معرّف Telegram للمستخدم. احصل على tgid لمستخدم نقر على رابط الحملة المحددة.
4. أرسل postback تجريبيًا يدويًا. عيّن goaltype=1 وحدد رمزًا صالحًا، ومعرّف Telegram للمستخدم في المعلمة tgid، ومعرّف الحملة التجريبية في المعلمة campaignid.
5. تحقق من النتيجة. تأكد من معالجة الطلب بنجاح ومن ظهور التحويل في إحصاءات AdsGram للحملة المحددة.

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

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