تخطّ إلى المحتوى الرئيسي

سجل إصدارات Canvas

يستخدم Canvas نظام إصدارات بأسلوب Salesforce: يبقى المستخدمون على الإصدار الذي بدأوا به، لضمان تجربة متسقة طوال الرحلة. عند نشر إصدار جديد، يستخدمه فقط المستخدمون الجدد الداخلون إلى Canvas، فيما يستمر المستخدمون الحاليون على إصدارهم الأصلي.

آلية الإصدارات​

دورة حياة الإصدار​

Draft (editable) → Published (immutable) → Archived (read-only)
  1. Draft: يمكنك تحرير Canvas بحرية، وتحفظ التغييرات تلقائيًا.
  2. Published: عند النشر يُنشأ إصدار جديد. لا يمكن تعديل الإصدارات المنشورة.
  3. Archived: عند نشر إصدار جديد يصبح السابق مؤرشفًا. تبقى الإصدارات المؤرشفة نشطة للمستخدمين الذين ما زالوا في الرحلة.

يعرض السجل الإصدارات المنشورة فقط. حفظ المسودة يحدّث نسخة العمل ولا يضيف إصدارًا، لذا تعرض الرحلة التي لم تُنشر قط لم يُنشر بعد وقائمة فارغة - تظهر الإصدارات عند النشر.

ما يحدث عند النشر​

عند النقر على Publish:

  1. تُحفظ مسودتك الحالية تلقائيًا أولًا؛ تُثبت كل العُقد التي أضفتها أو عدلتها قبل أخذ لقطة النشر. كان النشر سابقًا بلا حفظ يدوي قد يأخذ لقطة قديمة ويفقد عُقدًا أضيفت حديثًا؛ أُصلح ذلك وأصبح النشر مشروطًا بحفظ ناجح.
  2. تُنشأ لقطة إصدار جديدة تتضمن:
    • كل العُقد والحواف، أي بنية المسار.
    • إعداد مشغّل الدخول.
    • إعدادات Canvas.
    • إصدارات القوالب المثبتة وقت النشر.
  3. يصبح الإصدار المنشور السابق مؤرشفًا.
  4. يستخدم الداخلون الجدد الإصدار الجديد.
  5. يستمر المستخدمون الحاليون على إصدارهم الأصلي حتى الإكمال.

تثبيت الإصدار​

عندما يدخل مستخدم Canvas، يُثبَّت على الإصدار المنشور الحالي:

حالة المستخدمما يحدث عند نشر إصدار جديد
دخل للتويستخدم الإصدار الجديد إذا دخل بعد النشر
في عُقدة تأخيريستمر على إصداره الأصلي
ينتظر حدثًايستمر على إصداره الأصلي
يعالج رسالةيستمر على إصداره الأصلي

يضمن ذلك ألا يختبر المستخدم تغييرات غير متوقعة في منتصف الرحلة.

نشر إصدار جديد​

الخطوة 1: نفّذ التغييرات​

حرر Canvas في وضع المسودة:

  • أضف عُقدًا أو أزلها أو عدلها.
  • حدّث محتوى الرسائل.
  • غيّر أوقات التأخير.
  • عدّل منطق التفرع.

تُحفظ كل التغييرات تلقائيًا في المسودة.

الخطوة 2: راجع التغييرات​

قبل النشر، راجع ما تغيّر:

  1. انقر أيقونة Version History في رأس Canvas.
  2. اختر Compare with Published.
  3. راجع الفرق المرئي الذي يوضح:
    • العُقد المضافة بالأخضر.
    • العُقد المحذوفة بالأحمر.
    • العُقد المعدلة بالأصفر.

الخطوة 3: النشر​

  1. انقر Save & update live في رأس Canvas. تُنشر الإصدارات الجديدة على رحلة مباشرة بالفعل؛ أما في رحلة غير مباشرة، فينقلك Publish إلى خطوة Summary في المعالج لتشغيلها.
  2. أضف Change Summary يصف التغييرات، وهو اختياري لكنه موصى به.
  3. أكد النشر.
نُشر الإصدار 3 في 2024-01-15 14:30
ملخص التغيير: "أضيف Email متابعة بعد 3 أيام وحُدّث الخصم إلى 20%"
نشره: [email protected]

لوحة سجل الإصدارات​

ادخل إلى السجل بالنقر على أيقونة الساعة في رأس Canvas.

قائمة الإصدارات​

اعرض جميع الإصدارات مع:

  • رقم الإصدار، v1 وv2 وv3…
  • تاريخ ووقت النشر.
  • من نشره.
  • ملخص التغيير.
  • الحالة، Published أو Archived.

إحصاءات الإصدار​

يتتبع كل إصدار تحليلاته الخاصة:

المقياسالوصف
Total Entriesالمستخدمون الذين دخلوا في هذا الإصدار
Active Usersالمستخدمون الموجودون حاليًا في Canvas
Completedالمستخدمون الذين وصلوا إلى الخروج
Exited Earlyالمستخدمون الذين غادروا قبل الإكمال
Failedالمستخدمون الذين فشلت رحلتهم بسبب أخطاء
Conversion Rateنسبة إرسالات هذا الإصدار التي أفضت إلى الهدف الأساسي. ويُقرأ «غير مقيس» لا 0% حين لا يكون للإصدار هدف، أو حين تسبق إرسالاته ختم الإصدار فيتعذر إسنادها إليه
Avg Completion Timeمتوسط الوقت من الدخول إلى عُقدة النهاية
Avg Time to Convertغير مقيس. فهو مشتق من حدث لا يصدره شيء، فيبلّغ العمود بذلك بدل عرض متوسط مختلق

فهم مقاييس الوقت​

Avg Completion Time يقيس مدة إكمال المستخدمين لرحلة Canvas كاملة، من الدخول إلى عُقدة END. يشمل ذلك كل أوقات التأخير والانتظار.

مثال:
├── يدخل المستخدم Canvas في اليوم 0
├── يتلقى Email ترحيبيًا
├── يتابع خلال Canvas
├── يتلقى Email متابعة في اليوم 3
└── يصل إلى عُقدة END في اليوم 3 ← إكمال (وقت الإكمال: 3 أيام)
نصيحة
  • تعني «غير مقيس» في Conversion Rate أن الإصدار بلا هدف، أو أن إرسالاته جرت قبل أن تختم الرحلات إصدارها على كل إرسالة. وهذا يختلف عن إصدار لم يتحقق هدفه أبدًا، فيُقرأ 0%.

معاينة إصدار​

انقر أيقونة العين بجانب إصدار لفتح رحلته للقراءة فقط. انقر أي عقدة لرؤية الإعدادات التي كانت لها في ذلك الإصدار - قناة الرسالة ومحتواها، ومدة التأخير، وشروط التقسيم، والمشغّل، وطريقة webhook وعنوان URL ونوع المصادقة والترويسات والمحتوى. لا تُعرض بيانات الاعتماد أبداً: تظهر أسرار المصادقة وترويسات التفويض مخفية. لا يمكن تعديل أي شيء في المعاينة أو حفظه، ولا تعرض المقاييس الحية لأنها تصف الرحلة الحالية لا الإصدار.

مقارنة الإصدارات​

اختر إصدارين للمقارنة:

  • اعرض فرقًا مرئيًا لبنية المسار.
  • قارن مقاييس الأداء جنبًا إلى جنب.
  • حدّد الإصدار الأفضل أداءً.

التراجع إلى إصدار سابق​

إذا لم يحقق إصدار جديد أداءً جيدًا، يمكنك التراجع:

  1. افتح Version History.
  2. اعثر على الإصدار الذي تريد استعادته.
  3. انقر Rollback to This Version.
  4. أكد التراجع.
مهم

ينشئ التراجع إصدارًا جديدًا بالمحتوى القديم. لا يحذف الإصدار الحالي، ويستمر المستخدمون عليه في رحلتهم.

مثال:

  • v1: الأصل.
  • v2: تغير الخصم إلى 25%.
  • v3: تراجع إلى v1، بالمحتوى نفسه ورقم إصدار جديد.

إصدارات القوالب​

تُصدر القوالب، Email وSMS وPush وIn-app، أيضًا وتُثبَّت عند نشر Canvas.

آلية العمل​

  1. تعدل قالب Email.
  2. تنشر القالب، فينشئ إصدار قالب.
  3. عند نشر Canvas، يلتقط إصدارات القوالب الحالية.
  4. يرى مستخدمو ذلك الإصدار من Canvas دائمًا إصدارات القوالب تلك.

تحرير القوالب​

عند تعديل قالب مستخدم في Canvas نشط:

الحالةما يحدث
تعدل القالب دون نشرهتغييرات مسودة فقط؛ يرى المستخدمون النشطون الإصدار القديم
تنشر القالبيُنشأ إصدار قالب جديد
تنشر Canvasيستخدم إصدار Canvas الجديد إصدار القالب الجديد
إصدار Canvas قديميظل يستخدم إصدار القالب القديم

يمنع ذلك أن تؤثر التغييرات العرضية في المستخدمين في منتصف الرحلة.

التنفيذات اليتيمة​

عندما تؤرشف كل الإصدارات باستثناء الحالي، قد يكون بعض المستخدمين على إصدارات يتيمة.

يتيم: مستخدم على إصدار لم يعد منشورًا وأصبح مؤرشفًا.

ما يحدث للمستخدمين اليتامى:

  • يكملون الرحلة على الإصدار المؤرشف.
  • تبقى كل العُقد والمنطق متاحين.
  • يستمر تتبع التحليلات للإصدار.
  • لا يمكن إجراء تغييرات على الإصدار.

يمكنك رؤية المستخدمين اليتامى في تبويب Canvas Executions مع مؤشر تحذير.

الترحيل القسري، Admin فقط​

في حالات نادرة، مثل إصلاحات عاجلة للأخطاء، يمكن للمسؤولين ترحيل المستخدمين قسرًا إلى إصدار جديد:

  1. افتح Version History.
  2. انقر Migration Options.
  3. اختر المستخدمين للترحيل، أو رحّل كل المتوافقين.
  4. أكد الترحيل.

توافق الترحيل​

لا يمكن ترحيل جميع المستخدمين. يفحص النظام:

  • وجود العُقدة: وجود عُقدة المستخدم الحالية في الإصدار الجديد.
  • ثبات نوع العُقدة: بقاء نوع العُقدة، كالتأخير أو الرسالة، كما هو.
  • مسار صالح: وجود مسار صالح من الموقع الحالي.

نتائج الترحيل:

  • Migrated: انتقل بنجاح إلى الإصدار الجديد.
  • Incompatible: لا يمكن ترحيله؛ يستمر على الإصدار القديم.
استخدم بحذر

ينبغي استخدام الترحيل القسري للإصلاحات الحرجة فقط. فقد يربك المستخدمين إذا تغيرت رحلتهم فجأة.

التحليلات لكل إصدار​

يحافظ كل إصدار على تحليلات منفصلة:

مقاييس خاصة بالإصدار​

تحليلات الإصدار 2، نُشر في Jan 10
├── إجمالي الدخول: 15,234
├── نشط: 3,456
├── مكتمل: 8,123 (67%)
├── خرج: 3,655 (24%)
├── فشل: 0
├── معدل التحويل: 45.2%
└── متوسط وقت الإكمال: 12.4 يومًا

تحليلات الإصدار 3، نُشر في Jan 15
├── إجمالي الدخول: 2,341
├── نشط: 1,892
├── مكتمل: 312 (13%)
├── خرج: 137 (6%)
├── فشل: 0
├── معدل التحويل: 28.1%
└── متوسط وقت الإكمال: 2.1 يوم، جارٍ

مقارنة الأداء​

استخدم تحليلات الإصدار من أجل:

  • اختبار A/B للتغييرات بمقارنة معدلات التحويل بين الإصدارات.
  • تحديد التحسينات: هل حسن تغيير معدل الإكمال؟
  • تشخيص المشكلات: هل تسبب تغيير في الانقطاع؟

سجل التدقيق​

تسجل كل إجراءات الإصدارات:

الإجراءما يُسجّل
Publishمن نشر ومتى وملخص التغيير
Rollbackمن تراجع وإلى أي إصدار
Archiveوقت أرشفة الإصدار
Migrateمن بدأ الترحيل وعدد المستخدمين المتأثرين

اعرض سجل التدقيق في Settings > Audit Log أو في لوحة سجل الإصدارات.

أفضل الممارسات​

1. اكتب ملخصات تغيير واضحة​

جيد: "أضفنا Email تذكير في اليوم 7 وزدنا الخصم من 15% إلى 20%"
سيئ: "Updated canvas"

2. راجع قبل النشر​

  • قارن بالإصدار الحالي.
  • افحص القوالب المتأثرة.
  • راجع تحليلات الإصدار الحالي.

3. اختبر التغييرات المهمة​

للتغييرات الكبيرة:

  1. أنشئ Canvas للاختبار.
  2. تحقق من المسار.
  3. طبّقه بعد ذلك على الإنتاج.

4. راقب بعد النشر​

بعد نشر إصدار جديد:

  • تحقق من أن معدل الدخول طبيعي.
  • راقب مقاييس الإكمال المبكر.
  • انتبه لزيادة الخروج.

5. استخدم التراجع باعتدال​

تراجع عندما:

  • تكتشف خطأً حرجًا.
  • يحدث هبوط مهم في الأداء.
  • يُنشر محتوى خاطئ.

لا تتراجع بسبب:

  • أخطاء مطبعية بسيطة؛ انشر إصلاحًا فقط.
  • تغيرات الأداء الطبيعية.

حدود الإصدارات​

الحدالقيمة
الإصدارات لكل Canvasغير محدودة
الاحتفاظ بالإصدار المؤرشفحتى اكتمال كل التنفيذات
الاحتفاظ بسجل التدقيقسنة واحدة

خيارات فلترة الشرائح​

عند إنشاء شرائح أو استهداف مستخدمين، يمكنك الفلترة حسب إصدار Canvas:

الفلترة حسب إصدار Canvas​

في منشئ الشرائح أو تحليلات Canvas:

فلاتر إصدار Canvas:
├── في إصدار محدد، مثل v2
├── في أحدث إصدار
├── في إصدار مؤرشف، مستخدمون يتامى
├── دخل قبل الإصدار X
└── دخل بعد الإصدار X

حالات الاستخدام​

استهدف مستخدمين في إصدار قديم:

الشريحة: "Users on Canvas v1"
الفلتر: canvas_version = 1 AND canvas_id = "onboarding-flow"
الاستخدام: أبلغهم بالتغييرات القادمة أو اعرض إعادة البدء

استهدف المستخدمين اليتامى:

الشريحة: "Orphaned Canvas Users"
الفلتر: version_status = "orphaned"
الاستخدام: أرسل إشعارًا بحالة رحلتهم

الخطوات التالية​