انتقل إلى المحتوى

الفصل 8: التحويلات والإسناد

الجمهور المستهدف: مشترو الوسائط، مديرو الحملات

يتيح تتبع التحويلات لـ Cat-Scan قياس ما يحدث بعد الظهور: هل اتخذ المستخدم إجراءً ذا قيمة؟ تغذّي هذه البيانات تقييم المُحسِّن وتساعدك على تقييم الأداء الحقيقي للحملة.

مصادر التحويلات

يدعم Cat-Scan طريقتين للتكامل:

البكسل

يُفعَّل بكسل التتبع على صفحة التحويل الخاصة بك (مثل صفحة تأكيد الدفع).

  • نقطة النهاية: /api/conversions/pixel
  • المعاملات: buyer_id، source_type=pixel، event_name، event_value، currency، event_ts
  • لا يتطلب أي إعداد من جانب الخادم سوى وضع البكسل على صفحتك.

Webhook

يرسل خادمك أحداث التحويل إلى نقطة نهاية webhook في Cat-Scan.

  • أكثر موثوقية من البكسل (لا حاصرات إعلانات، لا اعتماد على جانب العميل).
  • يتطلب تكاملًا من جانب الخادم.
  • يدعم التحقق من التوقيع بـ HMAC للأمان.

أمان Webhook

يوفر Cat-Scan أمان webhook متعدد الطبقات:

الميزة ما تفعله
التحقق بـ HMAC يُوقَّع كل طلب webhook بمفتاح سري مشترك. يرفض Cat-Scan الطلبات غير الموقّعة أو ذات التوقيع الخاطئ.
تحديد المعدل يمنع إساءة الاستخدام بوضع حد أقصى للطلبات لكل نافذة زمنية.
مراقبة الحداثة يُنبّه إذا توقفت أحداث webhook عن الوصول (كشف الركود).

هيّئ أمان webhook في /settings/system > صحة التحويلات.

فحص الجاهزية

قبل الاعتماد على بيانات التحويلات، تحقق من الجاهزية:

  1. انتقل إلى /settings/system أو قائمة التحقق من الإعداد.
  2. تحقق من جاهزية التحويلات: تعرض ما إذا كان المصدر متصلًا ويُرسل أحداثًا ضمن نافذة الحداثة المتوقعة.
  3. تحقق من إحصائيات الاستيعاب: أعداد الأحداث حسب نوع المصدر والفترة الزمنية.

صحة التحويلات

تعرض لوحة صحة التحويلات:

  • حالة الاستيعاب (يستقبل أحداثًا أم لا)
  • حالة التجميع (الأحداث قيد المعالجة وتحويلها إلى مقاييس)
  • الطابع الزمني لآخر حدث
  • أعداد الأخطاء إن وُجدت

مواضيع ذات صلة