> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# استعادة عربات التسوق المتروكة

> يقوم بالكشف التلقائي عن عمليات الدفع غير المكتملة أو الفاشلة ويرسل سلاسل من رسائل البريد الإلكتروني المستهدفة لإعادة العملاء لإكمال مشترياتهم.

<Info>
  استعادة عربات التسوق المتروكة (ACR) تكشف عن عمليات الدفع غير المكتملة أو الفاشلة وتُرسل سلاسل من رسائل البريد الإلكتروني الإلكترونية لإعادة العملاء. اجمعها مع حوافز الخصم الاختيارية لتعظيم معدلات الاستعادة.
</Info>

## ما هي استعادة عربات التسوق المتروكة؟

يقوم ACR بتحديد العملاء الذين بدأوا ولكن لم يكملوا عملية الدفع تلقائيًا — سواء كان الدفع فاشلاً أو غادروا قبل الدفع — ويرسل سلسلة من رسائل البريد الإلكتروني للاسعادة لإعادتهم.

* **الدفع الفاشل**: حاول العميل الدفع ولكن تم رفضه أو حدث خطأ
* **عمليات الدفع غير المكتملة**: زار العميل صفحة الدفع ولكنه لم يحاول الدفع

## كيف يعمل ACR

<Steps>
  <Step title="Detection">
    نقوم بمسح المدفوعات التي مر عليها أكثر من 60 دقيقة ولم تنجح بعد. يشمل ذلك المدفوعات الفاشلة وعمليات الدفع التي لم يحاول العميل الدفع فيها مطلقًا.
  </Step>

  <Step title="Classification">
    لكل عملية دفع متروكة يتم تصنيفها حسب السبب:

    * **فشل الدفع**: حاول العميل الدفع ولكن فشل
    * **إكمال الدفع غير مكتمل**: زار العميل صفحة الدفع ولكن لم يحاول الدفع
  </Step>

  <Step title="Email Sequence">
    بالاعتماد على التصنيف، يقوم النظام بإرسال حتى 3 رسائل استرجاع إلكترونية في فواصل زمنية محددة. تحتوي كل رسالة على رابط استعادة فريد.
  </Step>

  <Step title="Recovery">
    عندما ينقر العميل على رابط الاستعادة، يأخذه إلى صفحة استعادة تعرض عربته الأصلية. يمكنهم إكمال الدفع بجلسة دفع جديدة.
  </Step>
</Steps>

## دورة حياة الحالة

تتقدم كل عملية دفع متروكة من خلال هذه الحالات:

| الحالة       | الوصف                                                                       |
| ------------ | --------------------------------------------------------------------------- |
| `abandoned`  | تم الكشف عن الدفع المتروك، لم تُرسل أي رسائل بعد                            |
| `recovering` | تم إرسال على الأقل رسالة استرجاع واحدة                                      |
| `recovered`  | أكمل العميل الدفع عبر رابط الاسترجاع                                        |
| `exhausted`  | تم إرسال جميع الرسائل دون استعادة، أو تفوقت عملية دفع جديدة على هذه العملية |
| `opted_out`  | ألغى العميل الاشتراك في رسائل الاسترجاع                                     |

## إعداد ACR

قم بتمكين وتكوين ACR من **الإعدادات** في لوحة التحكم الخاصة بك.

<Frame caption="Abandoned Cart Recovery settings in the dashboard">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/acr-settings.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=564184c25e7ec3e98f1ec07264ebba5d" alt="صفحة إعدادات ACR تُظهر التبديل، وإعدادات الخصم، ومحرر تسلسل البريد الإلكتروني" style={{ maxHeight: '500px', width: 'auto' }} width="2838" height="1386" data-path="images/recovery/acr-settings.png" />
</Frame>

### الإعدادات العالمية

| الإعداد               | الوصف                                                        | الافتراضي |
| --------------------- | ------------------------------------------------------------ | --------- |
| **مُمَكّن**           | التبديل الرئيسي لـ ACR                                       | إيقاف     |
| **تمكين الخصم**       | إنشاء رمز خصم تلقائي لرسائل الاسترجاع                        | إيقاف     |
| **نسبة الخصم**        | نسبة الخصم التي سيتم تطبيقها على الدفع لهذا العميل           | 0         |
| **أيام صلاحية الخصم** | كم عدد الأيام التي يظل فيها رمز الخصم المولد تلقائيًا صالحًا | 5         |

### تسلسلات البريد الإلكتروني

يدعم ACR تسلسلين بريد إلكتروني: **فشل الدفع** و**إتمام الدفع غير مكتمل** — كل منهما مع ما يصل إلى 3 رسائل قابلة للتكوين.

<Frame caption="ACR email sequence configuration">
  <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/acr-email-config.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=3f2bd0fbdf6b2b6bfe898c17bf2693a4" alt="محرر تسلسل البريد الإلكتروني يظهر الموضوع، الجسد، التوقيت، وتبديل التمكين لكل بريد في التسلسل" style={{ maxHeight: '500px', width: 'auto' }} width="1138" height="1670" data-path="images/recovery/acr-email-config.png" />
</Frame>

| الإعداد      | الوصف                                                               |
| ------------ | ------------------------------------------------------------------- |
| **مُمَكّن**  | تبديل فردي للبريد الإلكتروني للتشغيل أو الإيقاف دون حذفها           |
| **التأخير**  | كم من الوقت بعد الكشف عن الدفع المتروك لإرسال هذا البريد الإلكتروني |
| **الموضوع**  | سطر موضوع البريد الإلكتروني مع متغيرات قالب                         |
| **الجسم**    | جسد البريد الإلكتروني بتنسيق HTML مع متغيرات قالب                   |
| **الرد على** | عنوان البريد الإلكتروني لردود العملاء                               |

التوقيت الافتراضي للبريد الإلكتروني:

| البريد # | التأخير الافتراضي |
| -------- | ----------------- |
| 1        | 1 ساعة            |
| 2        | 24 ساعة           |
| 3        | 72 ساعة           |

### أمثلة على رسائل الاسترجاع الإلكترونية

يرسل ACR رسائل بريد مختلفة اعتمادًا على سبب التخلي. أدناه أمثلة لكل نوع كما يراه العميل.

<Tabs>
  <Tab title="Payment Failed">
    <Frame caption="Recovery email sent when a payment attempt fails">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/acr-failed-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=a8da91be6212c9fdd2b373572e3c1912" alt="رسالة استرجاع لبريد مدفوعات فاشل تُظهر اسم المتجر، ورسالة حول فشل الدفع، وملخص الطلب مع تفاصيل المنتج، والخصم، وزر استئناف الدفع" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/acr-failed-email.png" />
    </Frame>
  </Tab>

  <Tab title="Checkout Incomplete">
    <Frame caption="Recovery email sent when a customer leaves without attempting payment">
      <img src="https://mintcdn.com/dodopayments/tvJ2MmXYymW0IZ3R/images/recovery/acr-abandoned-email.png?fit=max&auto=format&n=tvJ2MmXYymW0IZ3R&q=85&s=05adcd350e1ceefa7854c86a37c862b9" alt="رسالة استرجاع لإتمام الدفع غير المكتمل تُظهر اسم المتجر، ورسالة حول الحفظ لعميل، وملخص الطلب مع تفاصيل المنتج، والخصم، وزر استئناف الدفع" style={{ maxHeight: '500px', width: 'auto' }} width="1070" height="1502" data-path="images/recovery/acr-abandoned-email.png" />
    </Frame>
  </Tab>
</Tabs>

## خصومات الاسترجاع

عند تفعيل الخصم، يُنشئ ACR تلقائيًا رمز خصم فريد للاستخدام مرة واحدة لكل عملية دفع متروكة. هذا الخصم:

* يقتصر على المنتج(s) من عملية الدفع الأصلية
* لديه فترة انتهاء صلاحية قابلة للتكوين
* يقتصر على استرداد واحد
* مخفي من قائمة الخصومات في لوحة التحكم لديك (للاستخدام الداخلي فقط)

<Tip>
  ابدأ بخصم معتدل (5-10٪) لاختبار تأثير التحويل قبل الزيادة. حتى الحافز الصغير يمكن أن يحسن بشكل كبير معدلات الاسترجاع.
</Tip>

## تجربة استرجاع العميل

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

## التحليلات

تتبع أداء ACR من قسم **التحليلات** في لوحة التحكم الخاصة بك.

<Frame caption="Recovery analytics dashboard showing ACR and dunning metrics">
  <img src="https://mintcdn.com/dodopayments/B3-0kuKcZDP1TiJD/images/recovery/recovery-analytics.png?fit=max&auto=format&n=B3-0kuKcZDP1TiJD&q=85&s=d3bf0c7474818bc4584b75654423e14c" alt="لوحة تحليلات الاسترجاع تُظهر عدد محاولات الدفع المتروكة، معدل الاسترجاع، الإيرادات المستعادة، متوسط الوقت للاسترجاع، والأقساط حسب المنتج والبريد الإلكتروني" style={{ maxHeight: '500px', width: 'auto' }} width="2548" height="2190" data-path="images/recovery/recovery-analytics.png" />
</Frame>

| المقياس                                 | الوصف                                              |
| --------------------------------------- | -------------------------------------------------- |
| **الدفع المتروك**                       | إجمالي عدد محاولات الدفع المتروكة التي تم اكتشافها |
| **معدل الاسترجاع**                      | نسبة محاولات الدفع المتروكة التي تمت استعادتها     |
| **الإيرادات المستعادة**                 | إجمالي الإيرادات المستعادة عبر ACR                 |
| **متوسط. وقت الاسترجاع**                | متوسط الوقت من التخلي إلى الاسترجاع                |
| **الاسترجاع عن طريق البريد الإلكتروني** | التحليل البريد الذي في التسلسل أدى إلى الاسترجاع   |
| **الاسترجاع عن طريق المنتج**            | المنتجات التي لديها أعلى معدلات الاسترجاع          |

## أحداث Webhook

| حدث                            | الوصف                                      |
| ------------------------------ | ------------------------------------------ |
| `abandoned_checkout.detected`  | تم اكتشاف محاولة دفع متروكة وبدأ الاسترجاع |
| `abandoned_checkout.recovered` | أكمل العميل الدفع عبر سير الاسترجاع        |

<Card title="Recovery Webhook Payloads" icon="code" href="/developer-resources/webhooks/intents/recovery">
  عرض مخططات حمولة الـ webhook الكاملة لأحداث ACR.
</Card>

## الحالات النادرة

| السيناريو                                          | السلوك                                                                                    |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| يكمل العميل الشراء قبل إرسال البريد التالي         | يتم اكتشاف الاسترجاع في وقت الإرسال؛ يتم تأشير محاولة الدفع كأنها مُستعادة إذا كانت مؤهلة |
| يبدأ العميل محاولة دفع جديدة                       | يتم تأشير محاولة الدفع المتروكة القديمة باسم `exhausted`                                  |
| ينقر العميل على "الدفع" بعد أن تم الاسترجاع بالفعل | تُظهر صفحة الاسترجاع تأكيدًا بأن الدفع تم بالفعل                                          |
| يلغي العميل الاشتراك                               | يتم تأشير محاولة دفع متروكة باسم `opted_out`؛ لا تُرسل أي رسائل أخرى                      |

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

* **ابدأ بالإعدادات الافتراضية**: تم تحسين توقيت وموضوعات البريد الإلكتروني الافتراضية لأنماط الاسترجاع الشائعة. قم بالتخصيص بعد الحصول على بيانات أساسية.
* **شخصنة الرسائل الإلكترونية**: استخدم متغيرات القالب لجعل البريد الإلكتروني يبدو شخصيًا وملائمًا للعميل.
* **راقب التحليلات**: تتبع معدلات الاسترجاع حسب البريد الإلكتروني لتحديد أي الرسائل تدفع أكثر التحويلات. قُم بتعطيل الرسائل ذات الأداء الضعيف.
* **استخدام الخصومات بشكل استراتيجي**: ابدأ صغيرًا (5-10٪) لحماية الهامش أثناء اختبار تأثير التحويل.
* **احتفظ بالرسائل الإلكترونية مختصرة**: يجب أن تكون رسائل الاسترجاع قصيرة وموجهة نحو العمل. يؤدي دعوتك للعمل بشكل واضح إلى تحقيق نتائج أفضل من الشروحات الطويلة.

<Info>
  تم تصميم ACR للعمل تلقائيًا بمجرد تمكينه. ابدأ بالإعدادات الافتراضية، راقب التحليلات الخاصة بك، وقم بالتحديث بناءً على بيانات الأداء.
</Info>

## مقترن

<CardGroup cols={2}>
  <Card title="Recovery Webhooks" icon="webhook" href="/developer-resources/webhooks/intents/recovery">
    ردود فعل على أحداث `abandoned_checkout.detected` و`abandoned_checkout.recovered`.
  </Card>

  <Card title="Subscription Dunning" icon="rotate" href="/features/recovery/subscription-dunning">
    استعادة الاشتراكات المفقودة باستخدام رسائل الدن الالكترونية التلقائية.
  </Card>

  <Card title="Customer Portal" icon="id-card" href="/features/customer-portal">
    ينفذ العملاء عمليات الاسترجاع من خلال بوابة العملاء.
  </Card>

  <Card title="Discounts" icon="percent" href="/features/discount-codes">
    يمكن لـ ACR إنشاء رموز خصم تلقائيًا لتحفيز الاسترجاع.
  </Card>
</CardGroup>