# الأحداث المخصصة

على عكس [الأحداث الافتراضية](/ar/product/audience-data-and-segmentation/events/default-events)، التي تكون عالمية عبر العديد من التطبيقات والقطاعات، فإن الأحداث المخصصة خاصة بتطبيقك. تتتبع هذه الأحداث إجراءات محددة فريدة لاحتياجاتك، مثل إكمال تمرين أو تمديد اشتراك. تساعدك على فهم كيفية تفاعل المستخدمين مع ميزاتك المحددة. أيضًا، توفر رؤى أعمق في سلوك المستخدم، وتساعد في [تتبع الاحتفاظ بالمستخدمين](/ar/product/statistics-and-analytics/user-retention-statistics)، وتسمح بإنشاء حملات تسويقية مخصصة وفعالة للغاية. يؤدي هذا في النهاية إلى تحسين تفاعل المستخدم ورضاه.

إذا كان الحدث المخصص يحمل بيانات إيرادات (على سبيل المثال، `order_completed` مع سمة السعر)، يمكنك تعيينه كمصدر لـ [أحداث التحويل](/ar/product/audience-data-and-segmentation/events/conversion-events/) دون إضافة كود جديد.

## إنشاء الأحداث المخصصة

لإنشاء حدث مخصص في Pushwoosh:

1. اذهب إلى **Audience > Events** وانقر على **Create Event**. في القائمة المنسدلة التي تظهر، حدد **Custom Event**.

<img src="/events-custom-events-1.webp" alt="قائمة منسدلة لإنشاء حدث تظهر خيار الحدث المخصص"/>

2. في النافذة التي تفتح، أدخل اسم الحدث الخاص بك في حقل **Event Name**. على سبيل المثال، استخدم level\_completed لتتبع وقت إكمال المستخدم لمستوى في اللعبة. قدم وصفًا موجزًا للحدث في حقل **Description**. يساعد هذا في تحديد غرض الحدث بسرعة.

<img src="/events-custom-events-2.webp" alt="نموذج إنشاء حدث مخصص مع حقلي اسم الحدث والوصف"/>

3. حدد السمات المحددة ذات الصلة بحدثك واختر نوع السمة. سمات الحدث هي أجزاء محددة من المعلومات تصف تفاصيل الحدث. وهي تلتقط جوانب مختلفة من تفاعل المستخدم داخل تطبيقك. يوفر هذا بيانات قيمة لاستهداف الرسائل وتقسيمها بدقة. يمكنك إضافة ما يصل إلى 100 سمة إلى الحدث.

أنواع السمات المتاحة:

* **integer**
* **string**
* **boolean**
* **list**
* **decimal (price)**
* **date**

للحصول على تفاصيل حول أنواع السمات، راجع [فهم الأحداث](/ar/product/audience-data-and-segmentation/events/#2-set-attributes).

<img src="/events-custom-events-3.webp" alt="تكوين سمات الحدث يوضح أنواع السمات والحقول"/>

لكل حدث يحدث، ستكون هناك قيم سمات مقابلة. على سبيل المثال، يمكن أن تتضمن سمات حدث **level\_completed** **level\_number، وcompletion\_time، وscore،** أو **points\_earned**. عند تسجيل الحدث في Pushwoosh، سيشمل قيم هذه السمات مع طابع زمني. يمكن استخدام هذه البيانات لاحقًا لبناء شرائح، واستهداف الرسائل، وجمع الإحصائيات.

بعد ملء التفاصيل اللازمة وإضافة السمات، انقر على **Create** لإنهاء إعداد الحدث. إذا قررت عدم المتابعة في إنشاء الحدث، انقر على **Cancel** لتجاهل التغييرات.

<Aside type="caution" icon="setting" title="مطلوب مساعدة المطور">
 بمجرد إعداد حدث مخصص في لوحة التحكم (Control Panel)، ستحتاج إلى مساعدة من فريق التطوير الخاص بك لدمجه في تطبيقك. شارك معهم كود التكامل الذي يمكنك العثور عليه بجوار الحدث الذي أنشأته، بالإضافة إلى [هذا الرابط](/ar/developer/guides/audience-and-segmentation/events#custom-events-implementation) للحصول على التعليمات.
</Aside>

## إدارة الأحداث المخصصة

توفر قائمة الأحداث نظرة عامة على جميع الأحداث المخصصة التي أنشأتها لتطبيقك. يساعدك كل حدث على تتبع تفاعلات أو سلوكيات محددة للمستخدم.

**تفاصيل الحدث**

* **Event Name** الذي يحدد الحدث (على سبيل المثال، "button\_clicked"، "video\_watched")
* **Attributes** أو أجزاء المعلومات الرئيسية المرتبطة بالحدث، مما يوفر سياقًا إضافيًا (على سبيل المثال، "button\_id"، "video\_category")
* **7-Day Activity** - عدد مرات حدوث الحدث في الأيام السبعة الماضية، مما يوفر عرضًا سريعًا للتفاعل الأخير

<img src="/events-custom-events-4.webp" alt="قائمة الأحداث المخصصة التي تعرض تفاصيل الحدث وخيارات الإدارة"/>

لكل حدث قائمة لمزيد من الإدارة:

* انقر على **View Code** للوصول إلى مقتطف الكود المطلوب لدمج هذا الحدث في قاعدة كود تطبيقك.
* انقر على **Event Statistics** للتعمق في الإحصائيات التفصيلية للحدث المختار، مما يوفر رؤى حول سلوك المستخدم.
* انقر على **Edit Event** لتعديل إعدادات الحدث، بما في ذلك اسمه والسمات المرتبطة به، لضمان جمع بيانات دقيقة.

<img src="/events-custom-events-6.webp" alt="قائمة إدارة الأحداث مع خيارات عرض الكود وإحصائيات الحدث وتعديل الحدث"/>

## استخدام الأحداث المخصصة في Pushwoosh

بمجرد إعداد أحداثك، يمكنك استخدامها لـ:

1. [إنشاء رحلة عميل (customer journey)](/ar/product/customer-journey/create-a-customer-journey-for-your-project) تبدأ عند وقوع حدثك المخصص، باستخدام عنصر [**Trigger-based entry**](/ar/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/).
2. [بناء شرائح حسب الأحداث](/ar/product/audience-data-and-segmentation/segmentation/create-segments/by-events/)، بما في ذلك التصفية حسب قيم سمات الحدث والعوامل.
3. تقسيم المستخدمين حسب معايير مثل عدد المرات التي قاموا فيها بحدث مخصص أو متى حدث الحدث آخر مرة. استخدم هذه الشرائح لإعداد [Audience-based entries](/ar/product/customer-journey/journey-elements/entry-elements/audience-based-entry/) لرحلات العملاء أو استخدم خيار [Segment Split](/ar/product/customer-journey/journey-elements/flow-controls/segment-split/) داخل الرحلة.
4. تعيين [تأخير زمني في رحلة العميل الخاصة بك](/ar/product/customer-journey/journey-elements/flow-controls/time-delay/#delay-based-on-user-or-event-data) بناءً على الحدث المخصص الذي يطلقه المستخدمون داخل رحلتهم.
5. استخدم الحدث المخصص في خطوة [Wait for Trigger](/ar/product/customer-journey/journey-elements/flow-controls/wait-for-trigger/) لتعيين سيناريوهات اتصال مختلفة بناءً على ما إذا كان المستخدم يطلق هذا الحدث المحدد أو عدة أحداث خلال فترة زمنية محددة.

## حالات استخدام الأحداث المخصصة

| نوع التطبيق | الحدث المخصص | الوصف | حالة الاستخدام |
| ----------------------------- | ----------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| تطبيقات اللياقة البدنية والصحة | workout\_complete | يكمل المستخدم جلسة تمرين. | أرسل رسائل تحفيزية أو مكافآت للحفاظ على تفاعل المستخدمين وتشجيعهم على ممارسة التمارين بانتظام. |
| تطبيقات التجارة الإلكترونية | cart\_abandoned | يضيف المستخدم عناصر إلى سلة التسوق الخاصة به ولكنه لا يكمل عملية الشراء. | <p>أرسل بريدًا إلكترونيًا تذكيريًا أو إشعارًا فوريًا (push notification) مع عرض خاص أو خصم على العناصر المتبقية في السلة.</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-e-commerce">استكشف الأحداث الموصى بها لتطبيقات التجارة الإلكترونية</a></p> |
| تطبيقات التعليم والتعلم الإلكتروني | complete\_course | يكمل المستخدم دورة تدريبية. | أرسل رسائل تهنئة وأوصِ بدورات متقدمة أو مواضيع ذات صلة. |
| تطبيقات الإعلام والترفيه | watch\_video | يشاهد المستخدم مقطع فيديو. | <p>أرسل إشعارات حول محتوى مشابه أو إصدارات جديدة. أوصِ بمقاطع فيديو أخرى.</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-media">استكشف الأحداث الموصى بها للتطبيقات الإعلامية</a></p> |
| تطبيقات السفر والضيافة | book\_flight | يحجز المستخدم رحلة طيران. | أرسل تذكيرات بالسفر، ونصائح للتعبئة، وتوصيات للأنشطة في وجهتهم. |
| تطبيقات الاشتراك | start\_trial | يبدأ المستخدم فترة تجريبية مجانية. | <p>أرسل رسائل تعريفية مع نصائح، وقدم المساعدة، وسلط الضوء على الميزات الرئيسية.</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-subscription-management">استكشف الأحداث الموصى بها لتطبيقات إدارة الاشتراكات</a></p> |
| تطبيقات التنقل أو مشاركة السيارات | ride\_completed | يكمل المستخدم رحلة مشاركة سيارة. | أرسل رسالة متابعة داخل التطبيق، واطلب ملاحظات، أو قدم خصمًا على الرحلة التالية. |
| تطبيقات الألعاب | level\_completed | يكمل المستخدم مستوى في اللعبة. | <p>أرسل رسائل تهنئة وقدم نصائح أو مكافآت لإكمال المستوى التالي.</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-gaming-apps">استكشف الأحداث الموصى بها لتطبيقات الألعاب</a></p> |

## تتبع الأحداث المخصصة

### إحصائيات الأحداث

يمكنك تتبع كل حدث قمت بإنشائه. للقيام بذلك:

1. انتقل إلى **Audience > Events**.
2. في قائمة **Events**، ابحث عن الحدث الذي تريد تتبعه وانقر على النقاط الثلاث بجانبه. حدد **Event Statistics**.
3. حدد النطاق الزمني الذي تريد تحليل بيانات الحدث له.
4. قم بتحسين تحليل بيانات الحدث عن طريق إضافة شروط أو فلاتر محددة بناءً على سمات مثل شرائح المستخدمين، أو أنواع الأجهزة، أو معايير مخصصة أخرى.
5. اعرض رسمًا بيانيًا يوضح تكرار إطلاق الحدث المحدد خلال النطاق الزمني المحدد.
6. يمكنك أيضًا تصدير بيانات الحدث إلى ملف CSV لمزيد من التحليل أو إعداد التقارير.

<img src="/events-custom-events-7.webp" alt="لوحة معلومات إحصائيات الحدث تعرض رسمًا بيانيًا للتكرار وخيارات تصدير البيانات"/>

لتحديث بيانات الحدث المعروضة على لوحة المعلومات، انقر على زر **Refresh**.

### لوحات المعلومات (Dashboards)

يسمح لك Pushwoosh أيضًا بتتبع الأحداث المخصصة باستخدام لوحة معلومات الأحداث، التي تحتوي على إحصائيات متعلقة بالأحداث المستخدمة في حملاتك، أو عن طريق بناء لوحة معلومات مخصصة خاصة بك. [اعرف المزيد](/ar/product/statistics-and-analytics/dashboards/)

### علامة تبويب الاحتفاظ (Retention)

استخدم علامة التبويب **Retention** لتتبع الاحتفاظ المتعلق بأحداث معينة ذات صلة بعملك. [اعرف المزيد](/ar/product/statistics-and-analytics/user-retention-statistics)