أسباب التسرب والتخطي في رحلة العميل
بالنقر المزدوج على نقطة في Journey تم إطلاقها، يمكنك رؤية أسباب التسرب وعدد حالات التسرب لكل سبب.
لا تظهر بعض الأحداث في تلك اللوحة على الإطلاق: يتم تسجيلها كـ Skipped في إحصائيات النقطة بدلاً من ذلك. انظر أسباب التخطي.
أسباب التسرب
Anchor link toتؤدي هذه الأخطاء إلى إزالة المسافر من Journey.
الحساب معلق
Anchor link toماذا يعني: الحساب معطل، لذا فإن Pushwoosh API غير متاح. في معظم الأحيان، يؤدي هذا إلى إيقاف Journey بالكامل قبل أن تصل إلى المسافر التالي. إذا تم تعليق الحساب بعد أن بدأت خطوة ما في الإرسال بالفعل، فيمكن لتلك الخطوة المحددة أيضًا أن تتسبب في تسرب المسافر المتأثر بنفس السبب.
ماذا تفعل: اتصل بـ فريق دعم العملاء أو مدير نجاح العملاء المخصص لك لاستعادة الوصول. إذا تم إيقاف Journey مؤقتًا، فاستأنفها بمجرد استعادة الوصول.
تم الوصول إلى حدود رسائل البريد الإلكتروني
Anchor link toماذا يعني: تم تجاوز حد إرسال البريد الإلكتروني لحسابك، لذا لا يمكن إرسال هذا البريد الإلكتروني.
ماذا تفعل: اتصل بـ فريق دعم العملاء أو مدير نجاح العملاء لرفع الحد.
خطأ داخلي
Anchor link toماذا يعني: مؤشر خطأ عام يعني أن Journey لا يمكن أن تستمر لهذا المسافر في هذه الخطوة. الأسباب الشائعة:
- سمة الحدث (Event) المشار إليها بواسطة عنصر Time delay مفقودة، أو أن قيمتها ليست بتنسيق التاريخ المتوقع. يؤدي عدم وجود Tag في نفس العنصر إلى Tag not found بدلاً من ذلك، ولكن وجود Tag بقيمة في تنسيق خاطئ يندرج هنا أيضًا.
- تغير UserID الخاص بالمسافر أثناء تقدم Journey، لذا لم يعد النظام قادرًا على العثور على الملف الشخصي لتحديث Tags.
- مشكلة في الإعداد المسبق للدفع (push preset) أو القالب المستخدم في عنصر Send Push.
ماذا تفعل: بالنسبة لسبب Time delay، تأكد من أن Tag من نوع التاريخ (Date type) بقيم بتنسيق 2006-01-02T15:04:05 (بتوقيت UTC)، أو أنك أنشأت الحدث (Event) بسمة من نوع التاريخ (Date type) وقيم بتنسيق 2006-01-02 15:04:05 عند إرسالها عبر [/postEvent](/ar/developer/api-reference/user-centric-api#postevent). بالنسبة للأسباب الأخرى، راجع تكوين العنصر المتأثر وبيانات المسافرين الذين يدخلون تلك الخطوة، أو اتصل بـ فريق دعم العملاء مع تفاصيل Journey والعنصر.
عدم تطابق المستخدم
Anchor link toماذا يعني: لا يتطابق UserID الحالي للجهاز مع UserID المسجل له في Journey.
ماذا تفعل: تحقق من عملية تسجيل الجهاز وتأكد من عدم نقل UserID إلى مستخدم آخر بينما لا يزال الجهاز نشطًا في Journey.
لم يتم العثور على الجهاز
Anchor link toماذا يعني: لا يوجد لدى Pushwoosh سجل جهاز لـ HWID الذي دخل Journey. يمكن أن يحدث هذا إذا:
- كان HWID معروفًا فقط لنظام خارج Pushwoosh ولم يتم تمريره أبدًا إلى Pushwoosh، ومع ذلك أدى حدث (Event) ما بطريقة ما إلى تشغيل Journey.
- تم تسجيل الجهاز من قبل، ولكن تم مسح HWID الخاص به لاحقًا من قاعدة البيانات.
ماذا تفعل: تحقق من عملية تسجيل الجهاز وتأكد من تسجيل الأجهزة بشكل صحيح قبل أن تؤدي إلى تشغيل الحدث (Event) الذي يدخل Journey.
لم يتم العثور على المستخدم
Anchor link toماذا يعني: لا يوجد لدى Pushwoosh سجل مستخدم لـ UserID الذي دخل Journey. يمكن أن يحدث هذا إذا:
- كان UserID معروفًا فقط لنظام خارج Pushwoosh ولم يتم تمريره أبدًا إلى Pushwoosh، ومع ذلك أدى حدث ما بطريقة ما إلى تشغيل Journey.
- تم تسجيل المستخدم من قبل، ولكن تم مسح UserID الخاص به لاحقًا من قاعدة البيانات.
- كان UserID هو عنوان بريد إلكتروني لم يتم ربطه بالجهاز أبدًا، لذا لا يتعرف Pushwoosh على المستخدم ومستلم البريد الإلكتروني كشخص واحد.
ماذا تفعل: تحقق من عملية تسجيل المستخدم وتأكد من عدم مسح قيم UserID عن طريق الخطأ من قاعدة البيانات. إذا كنت تستخدم عناوين البريد الإلكتروني كـ UserIDs، فتأكد من أن فريق التطوير الخاص بك يربطها بالجهاز.
لم يتم العثور على الفلتر
Anchor link toماذا يعني: كان Segment المستخدم بواسطة Journey موجودًا عند إنشائه، ولكن تم حذفه بعد تنشيط Journey. على عكس الأخطاء الأخرى في هذه الصفحة، يؤدي هذا إلى إيقاف Journey بالكامل، وليس فقط المسافر المتأثر.
ماذا تفعل: لا يمكن إعادة تشغيل Journey منتهية: استنسخ Journey، ووجه النسخة إلى Segment آخر (أو أعد إنشاء المحذوف)، وقم بتشغيل النسخة.
لم يتم العثور على الوسائط الغنية
Anchor link toماذا يعني: كانت الوسائط الغنية المستخدمة في هذا العنصر موجودة عند إنشاء Journey ولكن تم حذفها بعد تنشيط Journey.
ماذا تفعل: حدد وسائط غنية أخرى (أو أعد إنشاء المحذوفة) في العنصر.
لم يتم العثور على Tag
Anchor link toماذا يعني: لم يتم تعيين Tag مستخدم في عنصر Time delay لبعض المسافرين، لذا يتسربون في تلك الخطوة.
ماذا تفعل: تحقق من تعيين Tag للمسافرين بشكل صحيح وأنه لم يتم حذفه، أو قم بإعداد Time delay بشكل مختلف لتقليل عدد المسافرين المتسربين.
إعداد الدفع المسبق غير صالح
Anchor link toماذا يعني: كان إعداد الدفع المسبق (push preset) المستخدم في عنصر الرسالة موجودًا عند إنشاء Journey ولكن تم حذفه بعد تنشيط Journey. يؤدي هذا إلى إيقاف Journey بالكامل، وليس فقط المسافر المتأثر.
ماذا تفعل: حدد إعدادًا مسبقًا آخر (أو أعد إنشاء المحذوف) في العنصر، ثم استأنف Journey المتوقفة.
المحتوى غير معتمد
Anchor link toماذا يعني: كان إعداد الدفع المسبق (push preset) أو قالب البريد الإلكتروني المستخدم في عنصر Send Push أو Send Email في حالة Approved (معتمد) عند آخر إطلاق أو استئناف لـ Journey، ولكنه توقف عن كونه Approved أثناء تشغيل Journey بالفعل، على سبيل المثال بعد أن أدى تعديل إلى إنشاء إصدار Draft (مسودة) جديد. يتم اكتشاف المحتوى غير المعتمد بالفعل قبل الإطلاق أو الاستئناف في وقت سابق بواسطة فحص ما قبل الإطلاق (pre-launch check)، والذي يمنع Journey من الإطلاق أو الاستئناف حتى تقوم بإصلاحه. كما يقوم عنصر Send Push بإيقاف Journey بالكامل، وليس فقط المسافر المتأثر. أما عنصر Send Email فيتسبب فقط في تسرب المسافر المتأثر ويترك Journey قيد التشغيل.
ماذا تفعل: افتح الإعداد المسبق أو القالب، وأرسله للموافقة، وانتظر حتى تصبح حالته Approved (معتمد). إذا أوقف عنصر Send Push الرحلة، فاستأنفها بمجرد اعتماد المحتوى.
لقد مر الوقت بالفعل
Anchor link toماذا يعني: كان الوقت المحسوب لعنصر Time delay، بناءً على سمة الحدث (Event) أو Tag المحدد، في الماضي بالفعل.
ماذا تفعل: قم بإعداد Time delay بشكل مختلف، أو تحقق من قيمة التاريخ في سمة الحدث (Event) أو Tag المستخدم.
لا توجد قسائم متبقية في المجمع
Anchor link toماذا يعني: لا توجد قسائم غير مستخدمة متبقية في المجمع المحدد. وهذا يشمل القسائم التي تم إرسالها بالفعل، بالإضافة إلى أي قسائم تم حذفها من المجمع.
ماذا تفعل: أضف المزيد من القسائم إلى المجمع.
تم حذف مجمع القسائم
Anchor link toماذا يعني: كان مجمع القسائم المستخدم في العنصر موجودًا عند إنشاء Journey ولكن تم حذفه بعد تنشيط Journey.
ماذا تفعل: قم بتوصيل مجمع قسائم مختلف في العنصر. لا يمكن استعادة مجمع محذوف.
انتهت صلاحية مجمع القسائم
Anchor link toماذا يعني: لقد مر تاريخ انتهاء صلاحية المجمع، لذا لم يعد من الممكن إرسال قسائم منه.
ماذا تفعل: أنشئ مجمع قسائم جديدًا بتاريخ انتهاء صلاحية لاحق (أو بدون تاريخ) وقم بتوصيله في العنصر، أو قم بتوصيل مجمع مختلف لم تنته صلاحيته.
خطأ في الطلب
Anchor link toماذا يعني: فشل طلب عنصر Webhook في الاكتمال: خطأ في الشبكة، أو مهلة، أو عنوان URL وجهة غير صالح أو محظور (خاص، داخلي، loopback، أو link-local، بما في ذلك بيانات السحابة الوصفية)، أو تجاوز حد معدل webhooks للحساب، أو تبريد الوجهة بعد فشل متكرر، أو استجابة غير 2xx من الوجهة (بعد إعادة محاولة Pushwoosh الخاصة، على 500، 502، 503، أو 504). إذا فشل عرض عنوان URL أو قالب نص الطلب قبل إرسال الطلب، يتم تصنيف ذلك على أنه خطأ داخلي بدلاً من ذلك؛ يتم إسقاط الرؤوس غير الصالحة في العنصر بصمت من الطلب بدلاً من التسبب في أي من الخطأين.
ماذا تفعل: تحقق من أن عنوان URL الوجهة صحيح وعام ويمكن الوصول إليه، وأنه يعيد استجابة ناجحة (2xx). انظر المهلة وإعادة المحاولة والطلبات الفاشلة لمعرفة الشروط الدقيقة.
لا يوجد User ID
Anchor link toماذا يعني: وصل المسافر إلى عنصر Issue Wallet Pass بدون User ID. يتم إصدار بطاقة المحفظة لمستخدم، وليس لجهاز مجهول، لذلك لا يوجد أحد لإصدارها له. لا تتم إعادة محاولة هذا الإجراء.
ماذا تفعل: تحقق من تدفق تسجيل المستخدم في تطبيقك وتأكد من أنه يعين User ID قبل أن يصل المسافرون إلى هذا العنصر.
فشل إصدار البطاقة
Anchor link toماذا يعني: لم يتمكن عنصر Issue Wallet Pass من إصدار بطاقة من إحدى حملاته المكونة، على سبيل المثال لأن الحملة تم حذفها أو أرشفتها. لا تتم إعادة محاولة هذا الإجراء.
ماذا تفعل: افتح العنصر وتحقق من أن حملاته المكونة لا تزال موجودة وليست مؤرشفة. تصدر حملة Draft البطاقات بشكل جيد، ولا تحتاج إلى أن تكون Active. حدد حملة مختلفة إذا لزم الأمر. لا يمكن استعادة حملة محذوفة.
أسباب التخطي
Anchor link toلا تظهر هذه الأحداث في لوحة التسرب (Drop-offs): يواصل المسافر إلى الخطوة التالية كالمعتاد، وتسجل إحصائيات النقطة أنها Skipped (تم تخطيها) بدلاً من ذلك.
تم الوصول إلى تحديد التكرار
Anchor link toماذا يعني: لقد وصل المسافر بالفعل إلى حد تحديد التكرار (frequency capping) في هذه الخطوة. هذا سلوك متوقع: يتم تخطي الرسالة، لكن المسافر يواصل في Journey.
ماذا تفعل: لا يلزم اتخاذ أي إجراء. لتغيير عدد مرات حدوث ذلك، اضبط إعدادات تحديد التكرار الخاصة بك.
لا توجد معرفات مطابقة
Anchor link toماذا يعني: في عنصر Audience sync، لا يمتلك المسافر أيًا من المعرفات المطلوبة لمطابقة الجمهور المحدد. يتم تخطي المسافر لهذه الخطوة ويواصل في Journey.
ماذا تفعل: لا يلزم اتخاذ أي إجراء لهذا المسافر. لتقليل عدد مرات حدوث ذلك، قم بتكوين تعيين بيانات المستخدم (Map user data) في إعدادات تكامل إعلانات Meta الخاصة بك لتحسين جودة مطابقة المعرفات.