# Retention Messaging API של Apple: הודעה לפני ביטול מנוי

> ה-Retention Messaging API של Apple מציג את ההודעה שלך כשמנוי לוחץ Cancel Subscription. פורמטים, תנאים, גישה והטמעה.

עמוד מקורי: [Retention Messaging API של Apple: הודעה לפני ביטול מנוי](https://devoria.fr/he/blog/apple-retention-messaging-api-cancellation-message)
כותב: [Mehdi Azizi](https://devoria.fr/he/mehdi-azizi)
פרסום: 2026-11-04
עדכון תוכן אחרון: 2026-11-04


ה-Retention Messaging API הוא שירות של Apple, משרת לשרת, שמציג את ההודעה שלך למנוי ברגע שהוא לוחץ על Cancel Subscription. ההודעה מופיעה בעמוד אישור, לפני שהביטול נכנס לתוקף. **היא יכולה להזכיר את הערך של המנוי שלך, להציע תוכנית אחרת או הצעת מבצע (promotional offer), אבל הכפתור לביטול תמיד נשאר שם.** ה-API נמצא בגרסת preview מאז יולי 2025, בבקשת גישה, ו-Apple הכריזה על גרסה פשוטה יותר בתוך App Store Connect לסתיו 2026.

המדריך הזה מסביר מה ה-API מציג, ממתי הוא קיים, מי יכול להשתמש בו, מה התנאים ואיך מטמיעים אותו. הכול מגיע מהתיעוד של Apple ומהסשן של WWDC26 שמוקדש לו, שקראתי שוב ב-3 בנובמבר 2026.

אני מוכר מנויים באפליקציות ה-iOS שלי: Solys, חוסם רשתות חברתיות, TradaZen, סימולטור מסחר, Nolera, אפליקציה למדידת בגדים עם AI, ו-Vigie. ביקשתי גישה ל-API לכל הארבע ב-25 באוקטובר 2026, והכנתי את ההודעות שלהן בכל השפות שלהן. ב-28 באוקטובר האישור של Apple עוד לא הגיע: אז המדריך הזה מתאר את הכללים ואת ההכנה שלי, עדיין לא תוצאות.

## מה ה-Retention Messaging API עושה

לפי [התיעוד של Apple](https://developer.apple.com/documentation/retentionmessaging), ה-API נותן לך לבחור את ההודעה שהמערכת מציגה כשלקוח צופה בעמוד הפרטים של מנוי ואולי עומד לבטל. אתה מכין את ההודעות מראש, לכל מוצר ולכל שפה.

המסלול תמיד אותו דבר:

1. המנוי פותח את המנוי שלו, למשל ב-Apple Account, Subscriptions, או דרך ה-App Store.
2. הוא לוחץ על Cancel Subscription.
3. המערכת מציגה עמוד אישור (Confirm Cancellation), עם ההודעה שלך.
4. הוא יכול לבטל בכל זאת, להשאיר את המנוי, או לקבל את מה שההודעה שלך מציעה.

ההודעה מוצגת ב-iOS 15.1 וב-iPadOS 15.1 ומעלה, ב-visionOS 1 וב-macOS 14 ומעלה.

## ממתי, ולמי

| תאריך          | מה משתנה, לפי Apple                                      |
| -------------- | -------------------------------------------------------- |
| 16 ביולי 2025  | גרסה 1.0: ה-preview הראשון של ה-API                      |
| 9 בדצמבר 2025  | בדיקת ביצועים של השרת לזמן אמת                           |
| 31 במרץ 2026   | נקודות (bullets) בהודעות, הגדרת כתובת זמן האמת דרך ה-API |
| 27 באפריל 2026 | תמיכה במנויים חודשיים עם התחייבות ל-12 חודשים            |
| יוני 2026      | WWDC26: הכרזה על מודול בתוך App Store Connect            |

התאריכים לקוחים מ[יומן הגרסאות של ה-API](https://developer.apple.com/documentation/retentionmessaging/retention-messaging-changelog), חוץ מהאחרון, שלקוח מהסשן של WWDC26. ה-API עדיין ב-preview: התיעוד מפנה ל[טופס בקשת גישה](https://developer.apple.com/contact/request/retention-messaging-api/), שדורש להתחבר לחשבון המפתח שלך.

ב-WWDC26, הסשן [Explore Retention Messaging in App Store Connect](https://developer.apple.com/videos/play/wwdc2026/309/) מציג מודול שמגדירים בלי קוד, בתוך App Store Connect. Apple אומרת שהוא "פתוח לכולם". גרסת זמן האמת, לעומת זאת, נשארת בבקשה. [עמוד החידושים של ה-App Store](https://developer.apple.com/app-store/whats-new/) מכריז על המודול ל"סתיו הזה". **נכון ל-3 בנובמבר 2026, העזרה של App Store Connect עוד לא מקדישה לו אף עמוד, והמודול לא הופיע בחשבון שלי ב-28 באוקטובר.**

ה-API רלוונטי לאפליקציות שמוכרות מנוי מתחדש אוטומטית. זה לא שמור למפרסמים גדולים: RevenueCat מציינים ב[מחקר שלהם על 22 מיליון הודעות](https://www.revenuecat.com/blog/growth/apple-retention-messaging-benchmarks) שגם אפליקציות קטנות יכולות לבקש גישה.

## 4 סוגי ההודעות

| סוג           | מה המנוי רואה                | הודעת ברירת מחדל | זמן אמת |
| ------------- | ---------------------------- | ---------------- | ------- |
| טקסט          | כותרת, טקסט, עד חמש נקודות   | כן               | כן      |
| טקסט עם תמונה | אותו דבר, עם תמונה           | כן               | כן      |
| החלפת תוכנית  | טקסט ומנוי אחר מאותה קבוצה   | לא               | כן      |
| הצעת מבצע     | טקסט והצעה להמשיך במחיר מוזל | לא               | כן      |

לפי העמוד על [הכנת ההודעות](https://developer.apple.com/documentation/retentionmessaging/setting-up-retention-messages), הודעת ברירת מחדל יכולה להיות רק טקסט, עם או בלי תמונה. **עם ה-API, כדי להציע הצעה או תוכנית אחרת צריך לענות בזמן אמת.** המודול שהוכרז ב-App Store Connect, לעומת זאת, יציע הודעה עם הצעה, בלי שרת.

הצעת המבצע היא זו שאתה יוצר ב-App Store Connect. לפי [העזרה על הצעות מבצע](https://developer.apple.com/help/app-store-connect/manage-subscriptions/set-up-promotional-offers-for-auto-renewable-subscriptions), היא מכוונת למנויים נוכחיים ולשעברים. בהודעת שימור, השרת שלך הוא שחותם עליה, לפי העמוד על הכנת ההודעות. החלפת תוכנית מציעה מנוי מאותה קבוצה. אם אתה חדש בהצעות האלה, קרא קודם את המדריך שלי על [קודי הצעה והצעות מבצע](https://devoria.fr/he/blog/app-store-connect-offer-codes-promo-code).

## מה אפשר להציג: המגבלות המדויקות

| רכיב             | המגבלה של Apple                                  |
| ---------------- | ------------------------------------------------ |
| כותרת            | עד 66 תווים                                      |
| טקסט             | עד 144 תווים                                     |
| נקודות           | עד 5                                             |
| תמונה ברוחב מלא  | PNG בלי שקיפות, רוחב 3,840 px, גובה 160 עד 2,160 |
| תמונת נקודה      | 1,024 × 1,024 px                                 |
| תמונות לאפליקציה | עד 2,000                                         |

האורכים לקוחים מהתיאור של [גוף הבקשה לשליחת הודעה](https://developer.apple.com/documentation/retentionmessaging/uploadmessagerequestbody), והפורמטים מהעמוד על [שליחת תמונה](https://developer.apple.com/documentation/retentionmessaging/upload-image). Apple מבקשת גם תמונות שעובדות טוב גם במצב בהיר וגם במצב כהה.

כל הודעה וכל תמונה עוברות בדיקה של Apple. הסטטוס שלהן עובר מ-`PENDING` ל-`APPROVED`, והמערכת מציגה רק מה שאושר. ב-sandbox האישור אוטומטי. התיעוד קובע כלל תוכן ברור: לא לשלוח שום דבר מטעה או לא מדויק.

## התנאים שצריך לעמוד בהם

- **הודעת ברירת מחדל לכל מוצר, בכל שפה.** בלעדיה, שום דבר לא מוצג בשפה הזו. היא גם הגלגל הרזרבי אם השרת שלך לא עונה.
- **הודעות ותמונות מאושרות** לפני כל עלייה לאוויר.
- **לזמן אמת, שרת מהיר.** העמוד על [הגדרת כתובת זמן האמת](https://developer.apple.com/documentation/retentionmessaging/setting-up-retention-messaging-endpoint) דורש תעודת SSL תקפה, TLS 1.2 ותשובה בפחות מ-700 ms בפרודקשן. מעבר לזה, הבקשה נכשלת והודעת ברירת המחדל מוצגת.
- **בדיקת ביצועים שעברה בהצלחה ב-sandbox**, לפני שאתה מגדיר את כתובת הפרודקשן.
- **אימות של האפליקציה.** כל בקשה של Apple כוללת את מזהה האפליקציה, `appAppleId`. אם הוא לא תואם לשלך, Apple מבקשת לא לענות.

בקשת זמן האמת נותנת לך את מזהה הטרנזקציה המקורית, את המוצר ואת שפת המכשיר. עליך לבחור את ההודעה, לפי הכללים שלך.

## הטמעת Retention Messaging: שלוש דרכים

| דרך                     | למי                          | מה צריך                                  |
| ----------------------- | ---------------------------- | ---------------------------------------- |
| מודול App Store Connect | כולם, ברגע שייצא             | בלי קוד; טקסט, תמונה או הצעה             |
| API, עם השרת שלך        | מי שיש לו back-end           | גישה מ-Apple, כתובת HTTPS, בדיקת ביצועים |
| API, דרך RevenueCat     | אפליקציות שכבר על RevenueCat | גישה מ-Apple, הגדרות בדשבורד             |

כשכמה הגדרות קיימות במקביל, Apple מסבירה בסשן של WWDC26 את סדר העדיפויות: קודם תשובת זמן האמת. אם היא חסרה או לא תקינה, ההגדרה של App Store Connect. אם היא לא קיימת, הודעת ברירת המחדל שהוגדרה דרך ה-API.

### עם שרת משלך

1. בקש גישה דרך הטופס של Apple.
2. שלח את התמונות שלך, ואז את ההודעות, עם כותרת וטקסט לכל אחת.
3. חכה לאישור שלהן, ואז הגדר הודעת ברירת מחדל לכל מנוי ולכל שפה.
4. לזמן אמת, צור את הכתובת `Get Retention Message` בשרת שלך והגדר אותה ב-sandbox.
5. הרץ את [בדיקת הביצועים](https://developer.apple.com/documentation/retentionmessaging/initiate-performance-test), ב-sandbox, עם טרנזקציית בדיקה.
6. אחרי שהבדיקה עברה, הגדר את כתובת הפרודקשן שלך.

### עם RevenueCat

זו הדרך שבחרתי: אין שרת לכתוב, והאפליקציות שלי כבר עוברות דרך RevenueCat, כמו שאני מסביר ב[RevenueCat ומנוי in-app ב-iOS](https://devoria.fr/he/blog/revenuecat-in-app-subscription-ios). לפי [התיעוד של RevenueCat](https://www.revenuecat.com/docs/platform-resources/apple-platform-resources/apple-retention-messaging-api):

1. בטופס של Apple, הכתובת שצריך לתת היא זו ש-RevenueCat מציגים בהגדרות של אפליקציית ה-App Store שלך.
2. אחרי האישור, פתח את Lifecycle, ואז Retention, וחבר את כתובת ה-sandbox.
3. הרץ את בדיקת הביצועים עם מנוי sandbox או TestFlight פעיל. היא יכולה לקחת עד שעה.
4. צור קודם הודעת ברירת מחדל, שפה אחרי שפה.
5. אחר כך הוסף הודעות זמן אמת, עם כללים. אחד מהם, "Is in free trial", מכוון לאנשים בתקופת ניסיון חינמית.
6. עבור לפרודקשן: הגדרות ה-sandbox לא מועברות, צריך ליצור מחדש את ההודעות.

## לכתוב הודעה ששומרת בלי למלכד

הטקסט קבוע ונבדק על ידי Apple לפני שהוא מוצג. אז הוא לא יכול לדבר על האדם שקורא אותו, וגם לא על היום שבו הוא קורא אותו. הנה הודעת ברירת המחדל שהכנתי ל-TradaZen, בצרפתית (כאן בתרגום):

```text
כותרת (57 תווים במקור):
רצית ללמוד לסחור, ואתה ממשיך בעיניים עצומות?

טקסט (127 תווים במקור):
בלי אימון, הכסף האמיתי שלך משלם על כל טעות. כאן הן לא עולות כלום. הרצף, הליגה והשיעורים שלך נעצרים.
```

הכללים שקבעתי לעצמי לארבע האפליקציות:

- **הכותרת מחזירה את האדם למטרה שלו**, בצורת שאלה. היא לא מביישת אותו.
- **הטקסט אומר מה בדיוק נעצר.** אני כותב שהגישה "ננעלת" כשהנתונים נשארים, אף פעם לא שהם "יימחקו".
- **בלי מילות זמן** כמו "מחר" או "היום": אותו טקסט מוצג בכל רגע בתקופה.
- **בלי הבטחת רווח**, בלי דחיפות מזויפת. כותרת ראשונה שהבטיחה לשנות את החיים בזכות מסחר נפסלה לפני השליחה. [guideline 5.6](https://developer.apple.com/app-store/review/guidelines/#5.6) אוסרת כל פרקטיקה מניפולטיבית, וה-paywall של TradaZen כבר נדחה בגלל זה, כמו שאני מספר ב[guideline 5.6 וה-paywall](https://devoria.fr/he/blog/guideline-5-6-paywall-app-store-rejection).
- **לכל שפה יש טקסט משלה**, באוצר המילים של האפליקציה המתורגמת, וספור עד התו האחרון.

ל-TradaZen אני מתכנן גם הודעת זמן אמת לאנשים בתקופת ניסיון על המנוי השנתי. היא תציע תוכנית שנתית זולה יותר מאותה קבוצה, כי המספרים שלי מראים שהאנשים האלה משתמשים באפליקציה בדיוק כמו אלה שמשלמים: המחיר הוא מה שהם מסרבים לו. ההגדרה הזו מחכה לאישור של Apple.

## למה אפשר לצפות

אל תצפה לנס. Apple קוראת שיעור הצלה (save rate) לחלק מהמנויים ששומרים על המנוי אחרי שהגיעו לעמוד האישור. בסשן של WWDC26, Apple מכריזה שמנויים שאימצו את Retention Messaging מרוויחים בממוצע 1.4 נקודות בשיעור הזה. הודעות עם הצעת מבצע משיגות את השיפור הגבוה ביותר שנצפה, 5.5 נקודות, והתוצאות משתנות ממפתח למפתח. מצידו, המחקר של RevenueCat מציין שמנויים מקבלים רק כ-1.1% מהצעות המבצע ו-0.6% מהחלפות התוכנית.

אז ההודעה לא מחליפה את העבודה מראש. ניסיון חינמי שמבוטל תוך דקה נקבע ב-paywall ובסשנים הראשונים: הסיבות והמנופים נמצאים במדריך שלי על [ניסיון חינמי שבוטל](https://devoria.fr/he/blog/ios-free-trial-cancelled-immediately), והיצירה של הניסיון ב[הצעת ההיכרות](https://devoria.fr/he/blog/introductory-offer-app-store-connect-free-trial-ios).

## להכין את המנוי שלך לפני ההודעה

ה-[iOS & Android Kit](https://devoria.fr/he/kits/ios) יוצא מקוד הבסיס של האפליקציות שלי: onboarding, paywall ומנויים כבר כתובים, והמסלול בארבעה שלבים מוביל אותך עד ה-App Store, בקצב שלך. כל השרשרת, מהמוצרים ב-App Store Connect ועד ה-paywall, מתוארת בעמוד [מנוי in-app ב-iOS](https://devoria.fr/he/expertise/ios-in-app-subscription).

אם אתה מכין את ההשקה הראשונה שלך, [עשה את האבחון החינמי שלך](https://devoria.fr/he/diagnostic): הוא אומר לך מה באמת תוקע את הפרויקט שלך ושולח לך את הצ'קליסט שלי נגד דחיות של Apple.

## שאלות נפוצות

### מה זה ה-Retention Messaging API של Apple?

זה שירות משרת לשרת שבוחר את ההודעה שמוצגת למנוי כשהוא לוחץ על Cancel Subscription. ההודעה מוצגת בעמוד אישור, לפני הביטול. היא יכולה להזכיר את הערך של המנוי, להציע תוכנית אחרת או הצעת מבצע.

### האם Retention Messaging זמין לכל המפתחים?

ה-API הוא preview, בבקשת גישה מ-Apple. ב-WWDC26, Apple הכריזה על מודול ב-App Store Connect, פתוח לכולם, שמתוכנן לסתיו 2026. נכון ל-3 בנובמבר 2026, העזרה של App Store Connect עוד לא מתארת אותו.

### באילו גרסאות iOS ההודעה מוצגת?

ב-iOS 15.1 וב-iPadOS 15.1 ומעלה, ב-visionOS 1 וב-macOS 14 ומעלה. במכשיר ישן יותר, הביטול קורה בלי הודעה.

### האם ההודעה מונעת מהמנוי לבטל?

לא. עמוד האישור שומר כפתור לביטול. המנוי יכול גם להשאיר את המנוי שלו, או לקבל את ההצעה או את התוכנית המוצעת.

### אפשר להציע הנחה ברגע הביטול?

כן. עם ה-API, זו הודעת הצעת מבצע, בזמן אמת בלבד: ההצעה נוצרת ב-App Store Connect ונחתמת על ידי השרת שלך. המודול שהוכרז ב-App Store Connect מאפשר גם הודעה עם הצעה. החלפת תוכנית, לעומת זאת, מציעה מנוי אחר מאותה קבוצה.

### כמה תווים מותר בהודעת שימור?

הכותרת עד 66 תווים, הטקסט עד 144. אפשר להוסיף עד חמש נקודות ותמונת PNG בלי שקיפות. כל שפה צריכה הודעת ברירת מחדל משלה.

### צריך שרת כדי להשתמש ב-Retention Messaging?

להודעות ברירת המחדל אין כתובת לארח: מספיק לקרוא ל-API כדי לשלוח ולהגדיר אותן. עם RevenueCat, הם אלה שמשחקים את תפקיד השרת. זמן אמת דורש כתובת HTTPS שעונה בפחות מ-700 ms. המודול שהוכרז ב-App Store Connect מוגדר בלי קוד.


## הפרויקט שלך

[iOS & Android Kit](https://devoria.fr/he/kits/ios): תבנה אפליקציה לאייפון ולאנדרואיד עם Claude Code: קוד ההתחלה של האפליקציות שלי, כל הדרך עד החנויות וכל הקיטים. ‏349 ‏⁦₪⁩.

[אבחון: מה מפריד בינך לבין אפליקציית האייפון שלך](https://devoria.fr/he/diagnostic): 7 שאלות, 60 שניות: תדע מה באמת חוסם אותך מלפרסם את אפליקציית האייפון שלך, תקבל מסלול ב-4 שלבים ואת הקיט שמתאים לך.