# كيفية عرض تقدم التوصيل على شاشة القفل

اسمح للعملاء بمتابعة الساعي على شاشة القفل من وقت تقديم الطلب حتى التسليم. يبني هذا الدليل تلك الرحلة باستخدام [عنصر Live Activity](/ar/product/customer-journey/journey-elements/channels/live-activity/).

## المتطلبات الأساسية

* يدعم تطبيق iOS الخاص بك Live Activities. راجع [دليل Live Activities لـ iOS SDK](/ar/developer/pushwoosh-sdk/ios-sdk/ios-live-activities/).
* تم نشر مخطط واجهة توصيل لهذا التطبيق. راجع [تكوين مخططات Live Activity لـ iOS](/ar/developer/first-steps/connect-messaging-services/ios-configuration/ios-live-activity-schemas-configuration/).

## إنشاء الأحداث

هذه أسماء أحداث مثال لهذا الدليل. عندما يرسل تطبيقك أو الواجهة الخلفية اسمًا لأول مرة، يقوم Pushwoosh [بإنشاء هذا الحدث تلقائيًا](/ar/product/audience-data-and-segmentation/events/#implementation). أنشئ الأحداث في Control Panel أولاً فقط إذا كنت ترغب في تعيين أنواع السمات بنفسك قبل الإرسال الأول.

أنشئ (أو أعد استخدام) الأحداث `OrderPlaced` و `CourierStatusChanged` و `OrderDelivered`.

[تعرف على المزيد حول إنشاء الأحداث](/ar/product/audience-data-and-segmentation/events/#implementation)

## بناء الرحلة

افتح [Customer Journey Builder](/ar/product/customer-journey/pushwoosh-journey-overview/)، وأنشئ حملة، وابنِ كل شيء أدناه على لوحة واحدة.

1. اذهب إلى **Campaigns ← Customer Journey Builder**.
2. انقر على **Create campaign**.
3. انقر على **Build a journey from scratch**.

### تعيين المدخل

1. أضف عنصر **Trigger-based entry** إلى اللوحة.
2. اضبطه على `OrderPlaced`.

![لوحة Trigger-based entry مع تعيين EVENT على OrderPlaced](/live-activity-how-to-track-deliveries-with-live-activity-3.webp)

### بدء بطاقة الطلب

1. أضف عنصر **Live Activity** بعد المدخل.
2. سمه `Order card start`.
3. اضبط **Action** على **Start**.
4. حدد **Widget** التوصيل و**Schema version**.

![بدء بطاقة الطلب مع تعيين Action على Start وتحديد Widget و Schema version للتوصيل](/live-activity-how-to-track-deliveries-with-live-activity-1.webp)

5. اضبط **Card key: event** على `OrderPlaced`.

![تعيين Card key: event على OrderPlaced](/live-activity-how-to-track-deliveries-with-live-activity-4.webp)

6. املأ **Card content** (`courierName`، `eta`، `distanceMeters`) وحقول التنبيه.

![حقول Card content courierName و eta و distanceMeters مملوءة، مع حقول التنبيه أدناه](/live-activity-how-to-track-deliveries-with-live-activity-5.webp)

7. انقر على **Apply**.


### الانتظار وتحديث البطاقة

استمر على نفس اللوحة بعد عنصر Start.

1. أضف عنصر **Wait for Trigger**.
2. انتظر `CourierStatusChanged`.
3. اضبط فترة انتظار تناسب تحديثات التوصيل الخاصة بك.

![تعيين Wait for Trigger على CourierStatusChanged مع فترة انتظار](/live-activity-how-to-track-deliveries-with-live-activity-6.webp)

4. على الفرع الذي يتم تشغيله عند وقوع الحدث، أضف عنصر **Live Activity**.
5. سمه `Order card update`.
6. اضبط **Action** على **Update**.
7. اختر نفس **Widget** و **Schema version**.

![تحديث بطاقة الطلب مع تعيين Action على Update واختيار نفس Widget و Schema version](/live-activity-how-to-track-deliveries-with-live-activity-7.webp)

8. حدد `Order card start` في **Card created by**.

![تعيين Card created by على Order card start في عنصر Update](/live-activity-how-to-track-deliveries-with-live-activity-8.webp)

9. حدّث **Card content**.

![تحديث حقول Card content في عنصر تحديث بطاقة الطلب](/live-activity-how-to-track-deliveries-with-live-activity-9.webp)

10. انقر على **Apply**.

### الانتظار وإنهاء البطاقة

استمر على نفس اللوحة بعد عنصر Update.

1. أضف عنصر **Wait for Trigger** آخر.
2. انتظر `OrderDelivered`.

![تعيين Wait for Trigger على OrderDelivered](/live-activity-how-to-track-deliveries-with-live-activity-10.webp)

3. على الفرع الذي يتم تشغيله عند وقوع الحدث، أضف عنصر **Live Activity**.
4. سمه `Order card end`.
5. اضبط **Action** على **End**.
6. اختر نفس **Widget** و **Schema version**.
7. حدد `Order card start` في **Card created by**.

![إنهاء بطاقة الطلب مع تعيين Action على End، واختيار نفس Widget و Schema version، وتعيين Card created by على Order card start](/live-activity-how-to-track-deliveries-with-live-activity-11.webp)

8. اضبط التنبيه و**Dismiss after, min** إذا لزم الأمر.

![حقول التنبيه و Dismiss after, min في عنصر إنهاء بطاقة الطلب](/live-activity-how-to-track-deliveries-with-live-activity-12.webp)

9. انقر على **Apply**.

![رحلة التوصيل الكاملة على اللوحة مع المدخل، Start، Wait for Trigger، Update، Wait for Trigger، و End](/live-activity-how-to-track-deliveries-with-live-activity-13.webp)

## ما يراه العميل

على شاشة القفل، يحصل العميل على بطاقة Live Activity واحدة تتغير مع تقدم عملية التوصيل. على سبيل المثال:

<Tabs>
<TabItem label="بعد تقديم الطلب">
الساعي `Alex M.`، الوقت المقدر للوصول `18:30`، المسافة `1200` متر.

![بطاقة Live Activity على شاشة القفل بعد تقديم الطلب تظهر الساعي Alex M.، والوقت المقدر للوصول 18:30، والمسافة 1200 متر](/live-activity-how-to-track-deliveries-with-live-activity-14.webp)
</TabItem>
<TabItem label="عندما تتغير حالة الساعي">
يتم تحديث نفس البطاقة، على سبيل المثال الساعي `Alex M.`، الوقت المقدر للوصول `18:15`، المسافة `400` متر.

![بطاقة Live Activity على شاشة القفل بعد تحديث الساعي تظهر الوقت المقدر للوصول 18:15 والمسافة 400 متر](/live-activity-how-to-track-deliveries-with-live-activity-15.webp)
</TabItem>
<TabItem label="عند التسليم">
تُغلق البطاقة وتختفي من شاشة القفل.
</TabItem>
</Tabs>