# أسباب التسرب والتخطي في رحلة العميل

بالنقر المزدوج على نقطة في Journey تم إطلاقها، يمكنك رؤية أسباب التسرب وعدد حالات التسرب لكل سبب.

لا تظهر بعض الأحداث في تلك اللوحة على الإطلاق: يتم تسجيلها كـ **Skipped** في إحصائيات النقطة بدلاً من ذلك. انظر [أسباب التخطي](#skip-reasons).

## أسباب التسرب

تؤدي هذه الأخطاء إلى إزالة المسافر من Journey.

### الحساب معلق

**ماذا يعني:** الحساب معطل، لذا فإن Pushwoosh API غير متاح. في معظم الأحيان، يؤدي هذا إلى إيقاف Journey بالكامل قبل أن تصل إلى المسافر التالي. إذا تم تعليق الحساب بعد أن بدأت خطوة ما في الإرسال بالفعل، فيمكن لتلك الخطوة المحددة أيضًا أن تتسبب في تسرب المسافر المتأثر بنفس السبب.

**ماذا تفعل:** اتصل بـ [فريق دعم العملاء](https://help.pushwoosh.com/hc/en-us/requests/new/?utm_content=docs&utm_term=post&utm_campaign=troubleshooting) أو مدير نجاح العملاء المخصص لك لاستعادة الوصول. إذا تم إيقاف Journey مؤقتًا، فاستأنفها بمجرد استعادة الوصول.

### تم الوصول إلى حدود رسائل البريد الإلكتروني

**ماذا يعني:** تم تجاوز حد إرسال البريد الإلكتروني لحسابك، لذا لا يمكن إرسال هذا البريد الإلكتروني.

**ماذا تفعل:** اتصل بـ [فريق دعم العملاء](https://help.pushwoosh.com/hc/en-us/requests/new/?utm_content=docs&utm_term=post&utm_campaign=troubleshooting) أو مدير نجاح العملاء لرفع الحد.

<span id="internal-error" />

### خطأ داخلي

**ماذا يعني:** مؤشر خطأ عام يعني أن Journey لا يمكن أن تستمر لهذا المسافر في هذه الخطوة. الأسباب الشائعة:

* سمة الحدث (Event) المشار إليها بواسطة عنصر [**Time delay**](/ar/product/customer-journey/journey-elements/flow-controls/time-delay/) مفقودة، أو أن قيمتها ليست بتنسيق التاريخ المتوقع. يؤدي عدم وجود Tag في نفس العنصر إلى [Tag not found](#tag-not-found) بدلاً من ذلك، ولكن وجود Tag بقيمة في تنسيق خاطئ يندرج هنا أيضًا.
* تغير UserID الخاص بالمسافر أثناء تقدم Journey، لذا لم يعد النظام قادرًا على العثور على الملف الشخصي لتحديث Tags.
* مشكلة في [الإعداد المسبق للإشعارات الفورية (push preset)](/ar/product/content/push-presets/) أو القالب المستخدم في عنصر [**Send Push**](/ar/product/customer-journey/journey-elements/channels/push/).

**ماذا تفعل:** بالنسبة لسبب Time delay، تأكد من أن Tag من [نوع التاريخ (Date type)](/ar/product/audience-data-and-segmentation/user-data-tags/tags#types-of-tags) بقيم بتنسيق `2006-01-02T15:04:05` (بتوقيت UTC)، أو أنك [أنشأت الحدث (Event)](/ar/product/audience-data-and-segmentation/events#1-create-events-in-pushwoosh-control-panel) بسمة من [نوع التاريخ (Date type)](/ar/product/audience-data-and-segmentation/events#2-set-attributes) وقيم بتنسيق `2006-01-02 15:04:05` عند إرسالها عبر `[/postEvent](/ar/developer/api-reference/user-centric-api#postevent)`. بالنسبة للأسباب الأخرى، راجع تكوين العنصر المتأثر وبيانات المسافرين الذين يدخلون تلك الخطوة، أو اتصل بـ [فريق دعم العملاء](https://help.pushwoosh.com/hc/en-us/requests/new/?utm_content=docs&utm_term=post&utm_campaign=troubleshooting) مع تفاصيل Journey والعنصر.

### عدم تطابق المستخدم

**ماذا يعني:** لا يتطابق UserID الحالي للجهاز مع UserID المسجل له في Journey.

<Aside type="note">
على سبيل المثال، يتم تسجيل البريد الإلكتروني للعميل في معامل UserID ثم يتم تعيينه عن طريق الخطأ لمستخدم آخر. إذا حاولت تعيين Tag خاص بمستخدم في عنصر [Update user profile](/ar/product/customer-journey/journey-elements/flow-controls/update-user-profile/)، فسيحدث الخطأ، حيث يعتبر أن Tag قد تم تعيينه بالفعل لمستخدم آخر.
</Aside>

**ماذا تفعل:** تحقق من عملية تسجيل الجهاز وتأكد من عدم نقل UserID إلى مستخدم آخر بينما لا يزال الجهاز نشطًا في Journey.

### لم يتم العثور على الجهاز

**ماذا يعني:** لا يوجد لدى Pushwoosh سجل جهاز لـ [HWID](/ar/product/pushwoosh-knowledge-hub/device-identifiers/#hwid) الذي دخل Journey. يمكن أن يحدث هذا إذا:

* كان HWID معروفًا فقط لنظام خارج Pushwoosh ولم يتم تمريره أبدًا إلى Pushwoosh، ومع ذلك أدى حدث (Event) ما بطريقة ما إلى تشغيل Journey.
* تم تسجيل الجهاز من قبل، ولكن تم مسح HWID الخاص به لاحقًا من قاعدة البيانات.

**ماذا تفعل:** تحقق من عملية تسجيل الجهاز وتأكد من تسجيل الأجهزة بشكل صحيح قبل أن تؤدي إلى تشغيل الحدث (Event) الذي يدخل Journey.

### لم يتم العثور على المستخدم

**ماذا يعني:** لا يوجد لدى Pushwoosh سجل مستخدم لـ [UserID](/ar/product/pushwoosh-knowledge-hub/users-userids/) الذي دخل Journey. يمكن أن يحدث هذا إذا:

* كان UserID معروفًا فقط لنظام خارج Pushwoosh ولم يتم تمريره أبدًا إلى Pushwoosh، ومع ذلك أدى حدث ما بطريقة ما إلى تشغيل Journey.
* تم تسجيل المستخدم من قبل، ولكن تم مسح UserID الخاص به لاحقًا من قاعدة البيانات.
* كان UserID هو عنوان بريد إلكتروني لم يتم [ربطه بالجهاز](/ar/developer/first-steps/collecting-user-ids/) أبدًا، لذا لا يتعرف Pushwoosh على المستخدم ومستلم البريد الإلكتروني كشخص واحد.

**ماذا تفعل:** تحقق من عملية تسجيل المستخدم وتأكد من عدم مسح قيم UserID عن طريق الخطأ من قاعدة البيانات. إذا كنت تستخدم عناوين البريد الإلكتروني كـ UserIDs، فتأكد من أن فريق التطوير الخاص بك يربطها بالجهاز.

### لم يتم العثور على الفلتر

**ماذا يعني:** كان [Segment](/ar/product/audience-data-and-segmentation/segmentation/) المستخدم بواسطة Journey موجودًا عند إنشائه، ولكن تم حذفه بعد تنشيط Journey. على عكس الأخطاء الأخرى في هذه الصفحة، يؤدي هذا إلى إيقاف Journey بالكامل، وليس فقط المسافر المتأثر.

**ماذا تفعل:** لا يمكن إعادة تشغيل Journey منتهية: استنسخ Journey، ووجه النسخة إلى Segment آخر (أو أعد إنشاء المحذوف)، وقم بتشغيل النسخة.

### لم يتم العثور على الوسائط الغنية

**ماذا يعني:** كانت الوسائط الغنية المستخدمة في هذا العنصر موجودة عند إنشاء Journey ولكن تم حذفها بعد تنشيط Journey.

**ماذا تفعل:** حدد وسائط غنية أخرى (أو أعد إنشاء المحذوفة) في العنصر.

<span id="tag-not-found" />

### لم يتم العثور على Tag

**ماذا يعني:** لم يتم تعيين Tag مستخدم في عنصر [**Time delay**](/ar/product/customer-journey/journey-elements/flow-controls/time-delay/) لبعض المسافرين، لذا يتسربون في تلك الخطوة.

**ماذا تفعل:** تحقق من تعيين Tag للمسافرين بشكل صحيح وأنه لم يتم حذفه، أو قم بإعداد **Time delay** بشكل مختلف لتقليل عدد المسافرين المتسربين.

<Aside type="note">
لا ينطبق هذا على عنصر [**Update user profile**](/ar/product/customer-journey/journey-elements/flow-controls/update-user-profile/): إذا تم حذف Tag الذي يعينه بعد تنشيط Journey، يتم تخطي تحديث Tag هذا بصمت، ولا يتم تسرب المسافر.
</Aside>

### إعداد مسبق للإشعارات الفورية غير صالح

**ماذا يعني:** كان الإعداد المسبق للإشعارات الفورية (push preset) المستخدم في عنصر الرسالة موجودًا عند إنشاء Journey ولكن تم حذفه بعد تنشيط Journey. يؤدي هذا إلى إيقاف Journey بالكامل، وليس فقط المسافر المتأثر.

**ماذا تفعل:** حدد إعدادًا مسبقًا آخر (أو أعد إنشاء المحذوف) في العنصر، ثم استأنف Journey المتوقفة.

<span id="content-not-approved" />

### المحتوى غير معتمد

**ماذا يعني:** كان الإعداد المسبق للإشعارات الفورية (push preset) أو قالب البريد الإلكتروني المستخدم في عنصر [**Send Push**](/ar/product/customer-journey/journey-elements/channels/push/) أو [**Send Email**](/ar/product/customer-journey/journey-elements/channels/email/) في حالة **Approved** (معتمد) عند آخر إطلاق أو استئناف لـ Journey، ولكنه توقف عن كونه **Approved** أثناء تشغيل Journey بالفعل، على سبيل المثال بعد أن أدى تعديل إلى إنشاء إصدار **Draft** (مسودة) جديد. يتم اكتشاف المحتوى غير المعتمد بالفعل قبل الإطلاق أو الاستئناف في وقت سابق بواسطة [فحص ما قبل الإطلاق (pre-launch check)](/ar/product/customer-journey/journey-settings/#pre-launch-check)، والذي يمنع Journey من الإطلاق أو الاستئناف حتى تقوم بإصلاحه. كما يقوم عنصر **Send Push** بإيقاف Journey بالكامل، وليس فقط المسافر المتأثر. أما عنصر **Send Email** فيتسبب فقط في تسرب المسافر المتأثر ويترك Journey قيد التشغيل.

**ماذا تفعل:** افتح الإعداد المسبق أو القالب، وأرسله للموافقة، وانتظر حتى تصبح حالته **Approved** (معتمد). إذا أوقف عنصر **Send Push** الرحلة، فاستأنفها بمجرد اعتماد المحتوى.

### لقد مر الوقت بالفعل

**ماذا يعني:** كان الوقت المحسوب لعنصر [**Time delay**](/ar/product/customer-journey/journey-elements/flow-controls/time-delay/)، بناءً على سمة الحدث (Event) أو Tag المحدد، في الماضي بالفعل.

**ماذا تفعل:** قم بإعداد **Time delay** بشكل مختلف، أو تحقق من قيمة التاريخ في سمة الحدث (Event) أو Tag المستخدم.

### لا توجد قسائم متبقية في المجمع

**ماذا يعني:** لا توجد قسائم غير مستخدمة متبقية في المجمع المحدد. وهذا يشمل القسائم التي تم إرسالها بالفعل، بالإضافة إلى أي قسائم [تم حذفها من المجمع](/ar/product/content/vouchers#delete-vouchers).

**ماذا تفعل:** [أضف المزيد من القسائم](/ar/product/content/vouchers#add-vouchers-to-an-existing-pool) إلى المجمع.

### تم حذف مجمع القسائم

**ماذا يعني:** كان مجمع القسائم المستخدم في العنصر موجودًا عند إنشاء Journey ولكن تم حذفه بعد تنشيط Journey.

**ماذا تفعل:** قم بتوصيل مجمع قسائم مختلف في العنصر. لا يمكن استعادة مجمع محذوف.

### انتهت صلاحية مجمع القسائم

**ماذا يعني:** لقد مر تاريخ انتهاء صلاحية المجمع، لذا لم يعد من الممكن إرسال قسائم منه.

**ماذا تفعل:** [أنشئ مجمع قسائم جديدًا](/ar/product/content/vouchers#create-a-voucher-pool) بتاريخ انتهاء صلاحية لاحق (أو بدون تاريخ) وقم بتوصيله في العنصر، أو قم بتوصيل مجمع مختلف لم تنته صلاحيته.

<span id="request-error" />

### خطأ في الطلب

**ماذا يعني:** فشل طلب عنصر [**Webhook**](/ar/product/customer-journey/journey-elements/channels/webhook/) في الاكتمال: خطأ في الشبكة، أو مهلة، أو عنوان URL وجهة غير صالح أو محظور (خاص، داخلي، loopback، أو link-local، بما في ذلك بيانات السحابة الوصفية)، أو تجاوز حد معدل webhooks للحساب، أو تبريد الوجهة بعد فشل متكرر، أو استجابة غير 2xx من الوجهة (بعد إعادة محاولة Pushwoosh الخاصة، على `500`، `502`، `503`، أو `504`). إذا فشل عرض عنوان URL أو قالب نص الطلب قبل إرسال الطلب، يتم تصنيف ذلك على أنه [خطأ داخلي](#internal-error) بدلاً من ذلك؛ يتم إسقاط الرؤوس غير الصالحة في العنصر بصمت من الطلب بدلاً من التسبب في أي من الخطأين.

**ماذا تفعل:** تحقق من أن عنوان URL الوجهة صحيح وعام ويمكن الوصول إليه، وأنه يعيد استجابة ناجحة (2xx). انظر [المهلة وإعادة المحاولة والطلبات الفاشلة](/ar/product/customer-journey/journey-elements/channels/webhook/#timeout-retries-and-failed-requests) لمعرفة الشروط الدقيقة.

<span id="no-user-id" />

### لا يوجد User ID

**ماذا يعني:** وصل المسافر إلى عنصر [**Issue Wallet Pass**](/ar/product/customer-journey/journey-elements/channels/issue-wallet-pass/) بدون [User ID](/ar/product/pushwoosh-knowledge-hub/users-userids/). يتم إصدار بطاقة المحفظة لمستخدم، وليس لجهاز مجهول، لذلك لا يوجد أحد لإصدارها له. لا تتم إعادة محاولة هذا الإجراء.

**ماذا تفعل:** تحقق من تدفق تسجيل المستخدم في تطبيقك وتأكد من أنه يعين User ID قبل أن يصل المسافرون إلى هذا العنصر.

<span id="pass-issuance-failed" />

### فشل إصدار البطاقة

**ماذا يعني:** لم يتمكن عنصر [**Issue Wallet Pass**](/ar/product/customer-journey/journey-elements/channels/issue-wallet-pass/) من إصدار بطاقة من إحدى حملاته المكونة، على سبيل المثال لأن الحملة تم حذفها أو أرشفتها. لا تتم إعادة محاولة هذا الإجراء.

**ماذا تفعل:** افتح العنصر وتحقق من أن حملاته المكونة لا تزال موجودة وليست مؤرشفة. تصدر حملة Draft البطاقات بشكل جيد، ولا تحتاج إلى أن تكون Active. حدد حملة مختلفة إذا لزم الأمر. لا يمكن استعادة حملة محذوفة.

<span id="skip-reasons" />

## أسباب التخطي

لا تظهر هذه الأحداث في لوحة التسرب (Drop-offs): يواصل المسافر إلى الخطوة التالية كالمعتاد، وتسجل إحصائيات النقطة أنها **Skipped** (تم تخطيها) بدلاً من ذلك.

### تم الوصول إلى تحديد التكرار

**ماذا يعني:** لقد وصل المسافر بالفعل إلى حد [تحديد التكرار (frequency capping)](/ar/product/messaging-channels/message-delivery-settings/frequency-capping/) في هذه الخطوة. هذا سلوك متوقع: يتم تخطي الرسالة، لكن المسافر يواصل في Journey.

**ماذا تفعل:** لا يلزم اتخاذ أي إجراء. لتغيير عدد مرات حدوث ذلك، اضبط إعدادات تحديد التكرار الخاصة بك.

### لا توجد معرفات مطابقة

**ماذا يعني:** في عنصر [**Audience sync**](/ar/product/customer-journey/journey-elements/flow-controls/audience-sync/)، لا يمتلك المسافر أيًا من المعرفات المطلوبة لمطابقة الجمهور المحدد. يتم تخطي المسافر لهذه الخطوة ويواصل في Journey.

**ماذا تفعل:** لا يلزم اتخاذ أي إجراء لهذا المسافر. لتقليل عدد مرات حدوث ذلك، قم بتكوين تعيين بيانات المستخدم (**Map user data**) في إعدادات تكامل إعلانات Meta الخاصة بك لتحسين جودة مطابقة المعرفات.