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

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

<Aside type="danger" title="تحديث طلبات واجهة برمجة التطبيقات (API) الخاصة بك">

قم بتعيين **نوع الرسالة (message type)** في طلبات 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>

لا تخضع الإشعارات الصامتة (Silent pushes) وتحديثات Live Activity لسقف التكرار.

<span id="configure-global-frequency-capping" />

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

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

1. اذهب إلى **الإعدادات > إعدادات تسليم الرسائل > سقف التكرار**.

<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/)، [App Inbox](#app-inbox)).

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

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

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

يمكنك السماح بما بين 1 و1,000 رسالة لكل فترة، ويمكن أن تتراوح الفترة بين 1 و30 يومًا. إذا أدخلت قيمة خارج هذه النطاقات، يغيّرها الحقل إلى أقرب قيمة مسموح بها، على سبيل المثال 1,500 رسالة إلى 1,000.

4. اختر **وضع العد (Counting mode)** للقناة:

   * **النافذة المتغيرة (Rolling window)** (الافتراضي): يحسب الرسائل المرسلة خلال آخر N×24 ساعة قبل كل إرسال. على سبيل المثال، مع سقف 3 إشعارات فورية كل يومين، يخرج الإشعار المرسل يوم الاثنين الساعة 9 صباحًا من العد يوم الأربعاء الساعة 9 صباحًا، ويخرج الإشعار المرسل يوم الاثنين الساعة 3 مساءً من العد يوم الأربعاء الساعة 3 مساءً.
   * **اليوم التقويمي (Calendar day)**: يحسب الرسائل المرسلة اليوم وخلال N-1 يومًا تقويميًا سابقًا، بدءًا من منتصف الليل. حدد **المنطقة الزمنية للسقف (Capping timezone)** (على سبيل المثال `America/New_York`) التي تحدد متى يحل منتصف الليل لهذه القناة. على سبيل المثال، مع نفس سقف 3 إشعارات فورية كل يومين، يوم الأربعاء يُحتسب كل إشعار مرسل منذ منتصف ليل الثلاثاء. بعد منتصف الليل مباشرة، تنتقل النافذة إلى الأربعاء والخميس. إذا لم تحدد منطقة زمنية، يحسب Pushwoosh الأيام التقويمية بتوقيت UTC.

<img src="/messaging-channels-global-frequency-capping-11.webp" alt="قسم وضع العد مع خيارات النافذة المتغيرة واليوم التقويمي ومنتقي المنطقة الزمنية للسقف"/>

<Aside type="tip">
يناسب اليوم التقويمي الفرق التي تخطط أو تقدم تقارير عن الرسائل بفترات يومية ثابتة بدلاً من نافذة 24 ساعة متغيرة.
</Aside>

وضع العد متاح أيضًا في أي مكان يمكنك فيه تعيين سقف تكرار مخصص: [الحملات لمرة واحدة](/ar/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#set-frequency-capping)، [الرسائل الفورية داخل التطبيق](/ar/product/messaging-channels/in-apps/send-in-apps/send-instant-in-apps/#configure-frequency-capping)، و[عناصر رسائل رحلة العميل](/ar/product/customer-journey/journey-elements/channels/).

### App Inbox

لتقييد رسائل [App Inbox](/ar/product/messaging-channels/message-inbox/send-app-inbox-messages/)، استخدم المفتاح **Inbox** في هذه القائمة.

لدى App Inbox عداد خاص به، منفصل عن الإشعارات الفورية وكل القنوات الأخرى. يمكن للمستخدم الذي وصل إلى حد الإشعارات الفورية لليوم أن يستقبل رسالة Inbox رغم ذلك، والعكس صحيح.

لا يوجد لدى App Inbox إعداد لمعدل الإرسال: يستلم المستخدمون رسائل Inbox واحدة تلو الأخرى عند فتح التطبيق، لذلك لا توجد ذروة تسليم تحتاج إلى تقييد.

<img src="/messaging-channels-global-frequency-capping-12.webp" alt="مفتاح Inbox مفعّل مع حد الرسائل ووضع العد الخاصين به"/>

<span id="exclude-users-from-global-frequency-capping" />

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

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

لاستبعاد المستخدمين من السقف:

1. اذهب إلى **الإعدادات > إعدادات تسليم الرسائل > سقف التكرار**.
2. في **المستخدمون المستبعدون من سقف التكرار**، أدخل [معرف مستخدم (User ID)](/ar/product/pushwoosh-knowledge-hub/users-userids/) واحدًا أو بريدًا إلكترونيًا واحدًا في كل مرة.
3. انقر على **إضافة إلى القائمة**.
4. كرر الخطوتين 2-3 لكل مستخدم إضافي.
5. انقر على **تطبيق التغييرات**.

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

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

لمسح قائمة الاستثناءات، انقر على **مسح قائمة الاستثناءات**، ثم انقر على **تطبيق التغييرات**.

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

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

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

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

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



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

<span id="ignore-global-frequency-capping" />

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

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

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

<span id="use-custom-frequency-capping" />

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

يسمح لك هذا الخيار بتعيين حد مخصص لعدد الرسائل المرسلة خلال فترة محددة. هنا، حدد عدد الرسائل (على سبيل المثال، 5) والإطار الزمني (على سبيل المثال، 10 أيام) الذي يمكن إرسال هذه الرسائل فيه. اختر وضع عد لهذا الحد المخصص: [النافذة المتغيرة أو اليوم التقويمي](#configure-global-frequency-capping)، تمامًا مثل الإعداد العالمي.
<Aside type="caution" title="هام">
عند تمكين سقف التكرار المخصص، يتم تطبيق الحد المخصص فقط. لا يتم التحقق من السقف العالمي لهذه الرسالة ولا يمكنه حظرها.

ومع ذلك، لا تزال الرسالة تُحتسب ضمن العداد العالمي للقناة.

مثال:

- **الحد العالمي للقناة:** رسالتان في اليوم.
- **الحد المخصص للحملة A:** 3 رسائل في اليوم.

نظرًا لأن الحملة A لها حد مخصص خاص بها، فإنها ترسل جميع الرسائل الثلاث اليوم. الحد العالمي البالغ 2 لا يقيدها على الإطلاق.

ولكن كل من هذه الرسائل الثلاث لا تزال تُحتسب ضمن العداد العالمي. تعتمد الحملة B على السقف العالمي، بدون حد مخصص خاص بها. بما أن العدد العالمي لليوم قد تجاوز 2 بالفعل، فلن تتمكن الحملة B من الإرسال إلى هذا المستخدم على الإطلاق اليوم، لأن رسائل الحملة A هي التي استهلكت الحصة.
</Aside>

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

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


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

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

فيما يلي خطوات إعداده:

<span id="enable-global-frequency-capping" />

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

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

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

### تكوين الرسائل الحرجة

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

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

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

<span id="customize-capping-for-specific-messages" />

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

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

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

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

<span id="view-frequency-capping-statistics" />

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

يمكنك رؤية كيفية تأثير سقف التكرار على رسائلك في عدة أماكن.

* **لوحة معلومات المشروع**: يعرض [نظرة عامة على المشروع](/ar/product/first-steps/pushwoosh-interface-overview/#project-overview) كتلة سقف التكرار في علامتي التبويب Push وEmail للفترة المحددة، وهي 30 يومًا افتراضيًا.
* **إحصائيات الرسائل الفردية**: تُدرج علامة تبويب النظرة العامة في إحصائيات رسائل [الإشعارات الفورية](/ar/product/statistics-and-analytics/messaging-statistics/push-notification-statistics/) و[البريد الإلكتروني](/ar/product/statistics-and-analytics/messaging-statistics/email-statistics/) سقف التكرار كأحد أسباب الاستبعاد في مرحلة Audience.
* **الرسائل المجمعة**: يُدرج مسار [توزيع الحملات](/ar/product/statistics-and-analytics/aggregated-messages/#campaigns-distribution) المستلمين المستبعدين بسبب سقف التكرار كأحد أسباب الاستبعاد في مرحلة Audience، كعدد واحد للمستلمين الفريدين الذين تم تخطيهم.
* **رحلة العميل (Customer Journey)**: تعرض نافذة [إحصائيات الاتصالات](/ar/product/statistics-and-analytics/journey-statistics/overall-journey-statistics/#metrics-by-channel) سقف التكرار في كل علامة تبويب للقنوات.

للحصول على إجابات عن الأسئلة الشائعة، انظر [الأسئلة الشائعة حول سقف التكرار العالمي](/ar/product/messaging-channels/message-delivery-settings/frequency-capping-faq/).