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

تنبيه

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

المعلمات:

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

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

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

  

• record — قيمة فريدة لكل نقرة أو ظهور، تتوافق مع الماكرو {record_data}. يُدرج AdsGram هذه القيمة تلقائيًا في رابط التتبع.

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

  استخدام goaltype:

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

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

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

مثال على طلب API عند حدوث تحويل:

GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record=7f3a1b6c5d2e4f8a&goaltype=2

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

استبدل YOUR_UNIQUE_TOKEN برمز حسابك و7f3a1b6c5d2e4f8a بالقيمة الفعلية لـ {record_data} من رابط التتبع.

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

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

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

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

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

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