# إعدادات تسليم الرسائل

## تكوين سقف التكرار العالمي (Global frequency capping)
لمنع إغراق المستخدمين برسائل متعددة من حملات متداخلة، استخدم **Global frequency capping**. تحد هذه الميزة من عدد الرسائل التسويقية التي يتلقاها المستخدم خلال إطار زمني محدد. بمجرد الوصول إلى حد الرسائل لقناة ما، لن يتم إرسال أي رسائل أخرى حتى تتم إعادة تعيين الفترة.

<Aside type="danger" title="حدّث طلبات API الخاصة بك">

قم بتعيين **نوع الرسالة** في طلبات API حتى يتم تطبيق تحديد سقف التكرار بالطريقة التي تقصدها.

*   **الإشعارات الفورية (Push):** [`message_type`](/ar/developer/api-reference/messages-api/api-prerequisites/#message_type) في طلبات [`createMessage`](/ar/developer/api-reference/messages-api/#createmessage)
*   **البريد الإلكتروني (Email):** [`email_type`](/ar/developer/api-reference/email-api/#createemailmessage) في طلبات [`createEmailMessage`](/ar/developer/api-reference/email-api/#createemailmessage)

لا تخضع عمليات الإرسال **الخاصة بالمعاملات (Transactional)** لتحديد سقف التكرار. إذا حذفت النوع، فسيتم تطبيق تحديد السقف.

بالنسبة للوحة التحكم (Control Panel)، راجع [الرسائل التسويقية مقابل رسائل المعاملات](/ar/product/messaging-channels/marketing-vs-transactional/).

</Aside>

للتحكم في عدد الرسائل المرسلة إلى مستخدم خلال إطار زمني محدد:

1.  اذهب إلى **Settings > Message delivery settings > Frequency capping**.

<img src="/messaging-channels-global-frequency-capping-1.webp" alt="علامة تبويب إعدادات تحديد سقف التكرار في إعدادات تسليم الرسائل"/>

2.  قم بتشغيل المفتاح لتمكين تحديد سقف التكرار للقنوات المطلوبة ([إشعارات فورية](/ar/product/messaging-channels/push-notifications/)، [رسائل بريد إلكتروني](/ar/product/messaging-channels/emails/)، [رسائل داخل التطبيق](/ar/product/messaging-channels/in-apps/)، [رسائل قصيرة](/ar/product/messaging-channels/sms/)، [رسائل واتساب](/ar/product/messaging-channels/whatsapp-messages/)).

3.  قم بتعيين الحد الأقصى لعدد الرسائل لكل مستخدم لكل قناة والفترة الزمنية المقابلة.

<img src="/messaging-channels-global-frequency-capping-2.webp" alt="تكوين الحد الأقصى للرسائل لكل قناة وفترة زمنية"/>

> على سبيل المثال، يمكنك السماح بما يصل إلى 4 إشعارات فورية، ورسالتي بريد إلكتروني، ورسالتي واتساب في فترة 5 أيام.

الحد الأقصى لفترة تحديد سقف التكرار هو 30 يومًا.

### استثناء المستخدمين من سقف التكرار العالمي

يمكنك استثناء مستخدمين محددين من حدود سقف التكرار العالمي. تتجاوز الرسائل المرسلة إلى المستخدمين المستثنين حدود القناة بغض النظر عن الفترة التي تم تكوينها.

لاستثناء المستخدمين من تحديد السقف:

1.  اذهب إلى **Settings > Message delivery settings > Frequency capping**.
2.  في **Users excluded from frequency capping**، أدخل [User ID](/ar/product/pushwoosh-knowledge-hub/users-userids/) واحدًا أو بريدًا إلكترونيًا واحدًا في كل مرة.
3.  انقر على **Add to list**.
4.  كرر الخطوتين 2-3 لكل مستخدم إضافي.
5.  انقر على **Apply changes**.

<img src="/messaging-channels-global-frequency-capping-10.webp" alt="قسم المستخدمين المستثنين من تحديد سقف التكرار مع حقل User ID أو البريد الإلكتروني وزر إضافة إلى القائمة"/>

يبقى المستخدمون مستثنين حتى تقوم بإزالتهم من القائمة في إعدادات تسليم الرسائل.

لمسح قائمة الاستثناءات، انقر على **Clear exceptions list**.

### سقف التكرار العالمي لرسائل Journey

<Aside type="caution" title="هام">
 يرجى ملاحظة أنه لتغيير إعدادات تحديد السقف لرحلات (journeys) نشطة، ستحتاج أولاً إلى إيقاف الرحلة مؤقتًا.
</Aside>

عند إنشاء عناصر الرسائل في رحلات العملاء (customer journeys)، يتم تطبيق إعدادات **Global frequency capping** بشكل افتراضي.

<img src="/messaging-channels-global-frequency-capping-3.webp" alt="مؤشر تحديد سقف التكرار في إعدادات رسائل الرحلة"/>
<Aside>
إذا لم يتم تعيين حد في إعدادات تسليم الرسائل، فستستخدم الرسالة سقف تكرار عالمي **غير محدود**. إذا لزم الأمر، انقر على رابط **Set up** في إعدادات التسليم لتكوين الحدود.

<img src="/messaging-channels-global-frequency-capping-5.webp" alt="إعدادات التسليم تظهر سقف تكرار غير محدود ورابط الإعداد عندما لا يتم تكوين الحد"/>
</Aside>



ومع ذلك، لديك خيار تخصيص كيفية التعامل مع رسائل معينة عن طريق تجاوز إعدادات سقف التكرار العالمي. يمكنك القيام بما يلي:

#### تجاهل سقف التكرار العالمي

حدد **Send messages without global frequency capping** لتجاوز قواعد سقف التكرار العالمي. سيتلقى المستخدم هذه الرسالة بغض النظر، حتى لو تجاوز حدود الرسائل المحددة للقناة. استخدم هذا الخيار بحذر لتجنب إرسال عدد كبير جدًا من الرسائل.

<img src="/messaging-channels-global-frequency-capping-9.webp" alt="إعدادات التسليم مع تحديد خيار إرسال الرسائل بدون سقف تكرار عالمي"/>

#### استخدام سقف تكرار مخصص

يسمح لك هذا الخيار بتعيين حد مخصص لعدد الرسائل المرسلة خلال فترة محددة. هنا، حدد عدد الرسائل (على سبيل المثال، 5) والإطار الزمني (على سبيل المثال، 10 أيام) الذي يمكن إرسال هذه الرسائل فيه.
<Aside type="caution" title="هام">
لا يعزل سقف التكرار المخصص الرسالة عن حدود السقف العالمي. لا تزال جميع الرسائل المرسلة على نفس القناة (على سبيل المثال، داخل التطبيق) عبر رحلات وحملات مختلفة تُحتسب. إذا تلقى مستخدم رسالة في حملة واحدة، فقد يمنع ذلك تسليم الرسائل من رحلة أخرى، حتى لو تم تعيين سقف مخصص.
</Aside>

<img src="/messaging-channels-global-frequency-capping-4.webp" alt="سقف التكرار المخصص"/>

<Aside type="tip">
إذا كنت ترغب في تحديد عدد المرات التي يمكن للمستخدمين تلقي رسائل من رحلة معينة (على سبيل المثال، مرة واحدة فقط كل 10 أيام)، استخدم [Campaign entry limits](/ar/product/customer-journey/journey-settings/#campaign-entry-limit)، وليس تحديد سقف التكرار.
تقيد حدود الدخول (Entry Limits) عدد المرات التي يمكن للمستخدمين الدخول فيها إلى رحلة وتلقي رسائلها.
</Aside>


### سيناريو مثال

تخيل أنك تدير حملات تسويقية متعددة عبر الإشعارات الفورية ورسائل البريد الإلكتروني والرسائل القصيرة. لمنع إغراق عملائك بعدد كبير جدًا من الرسائل، قررت إعداد سقف التكرار (Frequency capping) وتحديد عدد الرسائل التي يمكن لكل مستخدم تلقيها إلى 3 إشعارات فورية، ورسالتي بريد إلكتروني، ورسالة قصيرة واحدة لكل مستخدم خلال 7 أيام.

إليك الخطوات لإعداد ذلك:

##### تمكين سقف التكرار العالمي

1.  اذهب إلى **Settings > Message delivery settings > Frequency capping**.
2.  قم بتشغيل المفتاح للإشعارات الفورية ورسائل البريد الإلكتروني والرسائل القصيرة.
3.  حدد الحد الأقصى لعدد الرسائل التي يمكن للمستخدم تلقيها: 3 إشعارات فورية، ورسالتي بريد إلكتروني، ورسالة قصيرة واحدة.
4.  حدد الفترة الزمنية لمدة 7 أيام.

<img src="/messaging-channels-global-frequency-capping-6.webp" alt="لقطة شاشة تظهر إعدادات تحديد سقف التكرار مع 3 إشعارات فورية، ورسالتي بريد إلكتروني، ورسالة قصيرة واحدة لكل 7 أيام"/>

##### تكوين الرسائل الهامة

إذا كنت تريد التأكد من تسليم الرسائل المهمة دائمًا على الفور، مثل تأكيدات الدفع، بغض النظر عن أي حدود للرسائل، حدد **Send messages without global frequency capping** في إعدادات التسليم لخطوات الرحلة المحددة التي تحتاج إلى ذلك.

<img src="/messaging-channels-global-frequency-capping-9.webp" alt="إعدادات التسليم مع تحديد خيار إرسال الرسائل بدون سقف تكرار عالمي"/>

تشمل أمثلة الرسائل الهامة الأخرى التنبيهات الأمنية، وطلبات إعادة تعيين كلمة المرور، وتحديثات التطبيقات الهامة، والمزيد.

##### تخصيص تحديد السقف لرسائل معينة

لنفترض أنك تريد إرسال إشعار فوري بعرض خاص في كل مرة يكمل فيها المستخدم إجراءً معينًا داخل التطبيق. ومع ذلك، لتجنب تكرار نفس الرسالة كثيرًا، تريد التأكد من عرض هذه الرسالة مرة واحدة كل 3 أيام على الأكثر، على الرغم من أن سقف التكرار الخاص بك يسمح بـ 3 إشعارات فورية في الأسبوع.

إليك كيفية تكوين ذلك:

1.  قم بإعداد رحلة عميل (customer journey) يتم تشغيلها عند إكمال المستخدم للإجراء المستهدف.
2.  داخل منشئ رحلة العميل، اذهب إلى إعدادات عنصر الرسالة وحدد **Use custom frequency capping**.
3.  قم بتعيين السقف المخصص إلى رسالة واحدة كل 3 أيام.
<Aside type="caution" title="هام">
لا يعزل سقف التكرار المخصص الرسالة عن **Frequency capping**. لا تزال جميع الرسائل المرسلة على نفس القناة، بما في ذلك تلك من رحلات أو حملات أخرى، تُحتسب ضمن السقف العالمي. إذا كان المستخدم قد تلقى بالفعل 3 رسائل فورية هذا الأسبوع من مصادر أخرى، فقد يتم حظر هذه الرسالة، حتى لو كان السقف المخصص يسمح بها.

</Aside>


### الأسئلة الشائعة حول سقف التكرار العالمي

##### كيف يحسب سقف التكرار العالمي الوقت؟

"اليوم" في تحديد سقف التكرار هو 24 ساعة بالضبط من وقت إرسال الرسالة. على سبيل المثال، إذا تم إرسال رسالة في **12 يناير 2024، الساعة 01:00 صباحًا**، فإن فترة تحديد السقف تنطبق حتى **13 يناير 2024، الساعة 01:00 صباحًا**.

##### ما هي الرسائل التي تتأثر بسقف التكرار العالمي؟

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

*   الرسائل المستندة إلى API
*   رسائل رحلة العميل (Customer Journey)
*   الإشعارات الفورية ورسائل البريد الإلكتروني لمرة واحدة
*   حملات الرسائل داخل التطبيق
*   رسائل SMS و WhatsApp

##### هل يمكنني استثناء مستخدمين محددين من سقف التكرار العالمي؟

نعم. في **Settings > Message delivery settings > Frequency capping**، أضف `User ID` أو بريدًا إلكترونيًا إلى **Users excluded from frequency capping**. يتجاوز هؤلاء المستخدمون حدود السقف العالمي.

##### ماذا يحدث إذا قمت بتغيير إعدادات سقف التكرار العالمي أثناء تشغيل رحلة عميل (Customer Journey)؟

يتم تطبيق الإعدادات المحدثة على الفور. يتحقق Pushwoosh من قواعد تحديد السقف في كل مرة يحاول فيها إرسال رسالة.

##### ماذا يحدث إذا قمت بتعطيل سقف التكرار العالمي؟

لن تكون الرسائل المستقبلية محدودة بقواعد تحديد السقف. ومع ذلك، لن يتم إرسال الرسائل التي تم حظرها مسبقًا بسبب تحديد السقف بأثر رجعي.

##### كيف يؤثر تمكين سقف التكرار العالمي على الحملات الجارية؟

ستتبع جميع الحملات النشطة، سواء تم إطلاقها عبر API أو من خلال واجهة Pushwoosh، قواعد تحديد السقف الجديدة على الفور.

##### ماذا لو قمت بتمكين سقف التكرار العالمي ولكن ما زلت أستخدم إعدادات تحديد السقف القديمة في نموذج إرسال الإشعارات الفورية (Send Push) (القديم)؟

سيستمر النظام في استخدام إعدادات تحديد السقف القديمة للرسائل المرسلة عبر نموذج Send Push القديم.

##### كيف يؤثر سقف التكرار على الرسائل المستندة إلى API؟

تخضع رسائل API **التسويقية** للسقف العالمي. قم بتعيين `message_type` إلى **transactional** في [`/createMessage`](/ar/developer/api-reference/messages-api/#createmessage) أو `email_type` إلى **transactional** في [`/createEmailMessage`](/ar/developer/api-reference/email-api/#createemailmessage) حتى لا يتم تحديد سقف لهذه الإرسالات. إذا حذفت النوع في طلب API، فسيتم تطبيق تحديد سقف التكرار.


## عرض إحصائيات سقف التكرار

يمكنك رؤية كيفية تأثير تحديد سقف التكرار على رسائلك في عدة أماكن. يعرض كل عرض مقياسين: **Suppressions** (الرسائل التي لم يتم إرسالها لأن المستلم قد وصل بالفعل إلى حد سقف التكرار الخاص به) و **Affected users** (المستخدمون الفريدون الذين تم قمع رسالة واحدة على الأقل لهم).

*   **لوحة معلومات المشروع (Project dashboard)**: يعرض [Project overview](/ar/product/first-steps/pushwoosh-interface-overview/#project-overview) كتلة Frequency capping لآخر 30 يومًا.
*   **إحصائيات الرسائل الفردية**: تتضمن علامة تبويب الأداء (Performance) في إحصائيات رسائل [الإشعارات الفورية](/ar/product/statistics-and-analytics/messaging-statistics/push-notification-statistics/) و[البريد الإلكتروني](/ar/product/statistics-and-analytics/messaging-statistics/email-statistics/) صفًا لـ Frequency capping.
*   **الرسائل المجمعة**: تتضمن علامة تبويب الأداء (Performance) في [إحصائيات الرسائل المجمعة](/ar/product/statistics-and-analytics/aggregated-messages/) صفًا لـ Frequency capping.
*   **رحلة العميل (Customer Journey)**: تعرض نافذة [Communications statistics](/ar/product/statistics-and-analytics/journey-statistics/overall-journey-statistics/#frequency-capping) تقارير تحديد سقف التكرار في علامات تبويب Push و Email و SMS و WhatsApp.


## تعيين حدود معدل الإرسال

قم بتعيين حدود معدل إرسال فردية لكل قناة رسائل: الإشعارات الفورية ورسائل البريد الإلكتروني والرسائل القصيرة.

لإعداد حدود معدل الإرسال:

1.  اذهب إلى **Settings > Message delivery settings > Send rate**.
2.  قم بتمكين أو تعطيل تحديد المعدل لكل قناة حسب الحاجة.
3.  حدد الحد الأقصى لعدد الرسائل التي سيتم إرسالها في الثانية لإدارة سرعة التسليم ومنع الحمل الزائد على الواجهة الخلفية أثناء عمليات الإرسال ذات الحجم الكبير.
<Aside type="caution" title="هام">
سيؤثر تمكين ميزة معدل الإرسال العالمي (Global Send Rate) على جميع حملاتك الحالية للقناة المحددة، بما في ذلك تلك المرسلة عبر API. يرجى أخذ لحظة لمراجعتها.
</Aside>

<img src="/messaging-channels-global-frequency-capping-8.webp" alt="شاشة تكوين معدل الإرسال تظهر حدود معدل الإشعارات الفورية والبريد الإلكتروني والرسائل القصيرة والمفاتيح"/>

4.  انقر على **Apply changes**، ثم قم بالتأكيد لحفظ إعداداتك.

### التحكم في حدود معدل الإرسال للرسائل الفردية

بالإضافة إلى تعيين معدل إرسال عالمي لكل قناة، يمكنك أيضًا التحكم في معدل الإرسال للرسائل الفردية في رحلة العميل. يتم ذلك في إعدادات الرسالة أو عنصر الرحلة المحدد.

يمكنك اختيار:

*   استخدام إعدادات معدل الإرسال العالمية
*   إرسال الرسائل بدون معدل إرسال
*   استخدام معدل إرسال مخصص

للحصول على إرشادات مفصلة حول تكوين معدل الإرسال لكل رسالة، راجع [أدلة العناصر الخاصة بالقناة.](/ar/product/customer-journey/journey-elements/channels/)