מבצעים לשימור מנויים עוזרים לצמצם את הנטישה הרצונית על ידי הצגת הנחה למנויים ברגע שהם מנסים לבטל את המינוי שלהם ב-Google Play.
כשמנוי שעומד בדרישות מתחיל לבטל את המינוי, מוצג לו ב-Google Play מבצע לשימור לקוחות שהגדרתם, למשל "שמרו על המינוי וקבלו 50% הנחה בחודשיים הבאים". אם המנוי מקבל את ההצעה, המינוי שלו לא מבוטל. המחיר המוזל יחול בתאריך הפקת החשבונית הבא.
בדף הזה מוסבר איך מבצעי שימור לקוחות פועלים, איך להגדיר אותם, איך לטפל באירועים שנוצרים כתוצאה מכך בקצה העורפי ואיך לבדוק אותם.
לפני שמתחילים
לפני שמגדירים מבצעים לשימור מנויים, חשוב לוודא שביצעתם את הפעולות הבאות:
- יצרתם מינוי עם מינוי בסיסי אחד לפחות שמתחדש אוטומטית. אפשר להוסיף מבצעי שימור לקוחות רק למינויים בסיסיים שמתחדשים אוטומטית.
- הגדרתם התראות בזמן אמת למפתחים (RTDN) והגדרתם את הקצה העורפי לקריאה ל-method
purchases.subscriptionsv2.get. ה-backend שלכם משתמש בהם כדי לזהות מתי מנוי מקבל הצעת שימור.
מכיוון שהמבצעים לשימור מנויים ב-Google Play מוצגים מחוץ לאפליקציה, אתם לא צריכים לשנות את האפליקציה או לעדכן את השילוב של ספריית החיובים ב-Google Play כדי להשתמש בהם. כל עבודת השילוב מתבצעת ב-Google Play Console ובקצה העורפי שלכם.
איך פועלים מבצעי שימור לקוחות
מבצעי שימור מופיעים רק במרכז לניהול המינויים ב-Google Play: באפליקציית חנות Google Play וב-Google Play באינטרנט. הם לא מופיעים בתוך האפליקציה. ספריית החיובים ב-Google Play לא מחזירה מבצעים לשימור לקוחות בתוצאות של queryProductDetailsAsync(), ולכן הם לא נכללים ב-ProductDetails.getSubscriptionOfferDetails() ואי אפשר למכור אותם דרך launchBillingFlow(). אם באפליקציה שלכם נעשה שימוש בקישורי עומק כדי להפנות מנויים למרכז המינויים של Google Play או למינוי ספציפי כדי שהם יוכלו לנהל או לבטל אותו, המנויים האלה יוכלו לראות את ההצעה לשימור כשהם יתחילו את תהליך הביטול.
השלבים הבאים מתארים מה קורה כשמנוי מנסה לבטל:
- המנוי פותח את המינוי שלו ב-Google Play ומתחיל לבטל אותו.
מערכת Google Play בודקת אם המנוי עומד בדרישות לאחד ממבצעי השימור, על סמך כללי הזכאות שהגדרתם למבצע, או על סמך הטירגוט של המבצע למנוי הזה.
אם המנוי עומד בדרישות, יכול להיות שיוצג לו ב-Google Play מבצע לשימור לקוחות כחלופה לביטול. גם אם המשתמשים עומדים בקריטריונים לזכאות, זה לא מבטיח שהמבצע יופיע, כי מערכת Google Play מבצעת בדיקות נוספות ברמת הפלטפורמה, כמו דרישות תאימות אזוריות. אם המבצע מוצג ב-Google Play, המנוי יכול לבצע אחת מהפעולות הבאות:
- אישור המבצע: המנוי מאשר את המבצע בלחיצה אחת. המינוי נשאר פעיל ומתחדש אוטומטית. המנוי לא מחויב באופן מיידי. המחיר המוזל חל החל מתקופת החיוב הבאה.
- להמשך הביטול: המנוי דוחה את ההצעה ומשלים את תהליך הביטול הרגיל. אתם מקבלים את ההתראה הרגילה של
SUBSCRIPTION_CANCELED. פרטים נוספים זמינים במאמר בנושא ביטולים.
אם המנוי יוצא מתהליך הביטול בלי לאשר את ההצעה או לבטל את המינוי, המינוי שלו לא משתנה. ההגבלה הזו חלה גם על האפליקציה של חנות Google Play וגם על Google Play באינטרנט. אם המשתמשים רק צופים בהצעה לשימור בלי לאשר אותה, זה לא נחשב כמימוש של ההצעה ולא מתחיל את תקופת ההמתנה בין ההצעות. מערכת Google Play בודקת את מגבלת המימושים כשהיא מציגה את המבצע, ושוב כשהמנוי מממש אותו. מבצע שמומש נספר במסגרת מגבלת המימושים כשהמינוי מתחדש במחיר המוזל. תקופת ההמתנה בין מבצעים מתחילה כשתקופת ההנחה של המבצע הקודם לשימור לקוחות באותו מינוי בסיסי מסתיימת. יכול להיות שהמנוי יראה את המבצע שוב בפעם הבאה שהוא ינסה לבטל, בתנאי שהוא עדיין עומד בדרישות.
מעבר מתוזמן בין תוכניות
כשמנוי מקבל מבצע שימור, מערכת Google Play מתייחסת אליו כאל מעבר מתוכנן בין תוכניות ברכישה הקיימת של המנוי. זה שונה מהחלפה מושהית, שדורשת תהליך רכישה חדש ויוצרת אסימון רכישה חדש. במבצע לשימור מנויים, המנוי שומר על אותו purchaseToken, ורק תנאי החיוב העתידיים משתנים.
כשהמנוי מאשר את המבצע, Google Play מבצעת את הפעולות הבאות:
- שליחת RTDN מסוג
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21) לקצה העורפי. - הוספת אובייקט
planTransitionDetailsלשדהautoRenewingPlanשל הפריט המושפע במשאבSubscriptionPurchaseV2.
לפרטים על הטיפול באירועים האלה, ראו טיפול באירועים של מבצעי שימור לקוחות בקצה העורפי.
דרישות סף
אפשר להציע מבצע לשימור לקוחות בכל שלב לפני החידוש הבא של המינוי, כל עוד מתקיימים כל התנאים הבאים:
- המינוי פעיל ומתחדש אוטומטית. מינויים שנמצאים בתקופת חסד, בהשהיית חשבון או בהשהיה לא יכולים לקבל מבצעים לשימור לקוחות.
- המינוי הוא מינוי יחיד. אי אפשר להציע מבצעים לשימור לקוחות במינויים עם חבילות.
- המינוי לא משתמש בתוכנית בסיסית של בסיס ההתקנות. מינויים בסיסיים בתשלומים לא עומדים בדרישות למבצעים לשמירת לקוחות.
- התשלום הבא הוא במחיר הרגיל של המינוי הבסיסי הקבוע. אם המנוי נמצא בתקופת ניסיון בחינם או בתקופת מחיר היכרות, המבצע זמין רק במהלך תקופת החיוב האחרונה של השלב הזה, כשהחידוש הבא הוא במחיר הרגיל.
- המנוי לא נמצא בתקופת חיוב בהנחה של מבצע שימור לקוחות שהוא קיבל בעבר. מנוי שנמצא בשלב ההנחה של מבצע שימור לא יכול לממש מבצע שימור נוסף עד שהמינוי יתחדש במחיר הרגיל של המינוי הבסיסי.
- למינוי אין מעבר מתוזמן לתוכנית בהמתנה. למינוי יכול להיות לכל היותר מעבר אחד ממתין לתוכנית מתוזמנת, שהוא אובייקט
planTransitionDetailsבמצבIN_PROGRESS. לדוגמה, מנוי שכבר קיבל הצעה לשימור לקוחות שעדיין לא נכנסה לתוקף לא יכול לקבל הצעה נוספת. - אין במינוי שינוי מחיר שלא אושר.
- המחיר המוזל של המבצע לשימור המנוי נמוך ממחיר החידוש הבא של מינוי Base Plan או שווה לו.
- המנוי עומד בכללי הזכאות שהגדרתם למבצע. במבצע לשימור משתמשים, הפעלתם טירגוט למינוי באמצעות השיטה
activateOfferTargeting.
הגדרת מבצעים לשימור לקוחות
אתם יכולים ליצור מבצעים לשימור מנויים ב-Google Play Console או באמצעות ממשק ה-API של Google Play למפתחים. לכל מבצע שימור יש אחד ממצבי הטירגוט הבאים:
- טירגוט מבוסס-כללים: מערכת Google Play מחליטה אילו מנויים עומדים בדרישות, על סמך כללי הזכאות שאתם מגדירים, כמו משך מינימלי של מינוי בתשלום.
- טירגוט לכל משתמש: ה-backend שלכם קובע אילו מנויים יכולים לראות את המבצע על ידי טירגוט למינויים ספציפיים.
למינוי בסיסי יכול להיות יותר ממבצע אחד פעיל לשימור לקוחות באותה מדינה או באותו אזור. אם מנוי עומד בדרישות של יותר ממבצע אחד, Google Play מציגה לכל היותר מבצע אחד לשימור מנויים בתהליך הביטול. מערכת Google Play בוחרת את המבצע בסדר הבא:
- מצב טירגוט: מבצע מטורגט לכל משתמש (
retentionPerUserRule) תמיד מקבל עדיפות על פני מבצע מבוסס-כללים (retentionRule), גם אם אחוז ההנחה במבצע מבוסס-הכללים גבוה יותר. - אחוז ההנחה: מבין המבצעים שעומדים בדרישות ומשתמשים באותו מצב טירגוט, מערכת Google Play מציגה את המבצע עם אחוז ההנחה הגבוה ביותר.
- מחיר מוזל: אם למבצעים יש אחוז הנחה זהה, Google Play מציגה את המבצע עם המחיר המוזל הנמוך ביותר.
- מזהה המבצע: אם עדיין יש שוויון בין המבצעים, המערכת של Google Play תציג את המבצע שהערך של
offerIdשלו מופיע אחרון בסדר אלפביתי.
יצירת מבצע שימור ב-Play Console
כדי ליצור מבצע שימור ב-Google Play Console:
- עוברים אל מונטיזציה באמצעות Play > מוצרים > מינויים.
- בוחרים מינוי ואז בוחרים את המינוי הבסיסי שאליו רוצים להוסיף את המבצע.
- מוסיפים מבצע למנויים קיימים בתהליך ביטול.
- בוחרים באפשרות מבצע שימור ברמת הקבוצה או מבצע שימור ברמת המשתמש.
יצירת מבצע שימור באמצעות Play Developer API
אפשר גם ליצור ולעדכן מבצעים לשימור מנויים באופן פרוגרמטי. כדי ליצור מבצע, צריך להפעיל את ה-method monetization.subscriptions.basePlans.offers.create. כדי לעדכן מבצעים קיימים, צריך להפעיל את ה-method monetization.subscriptions.basePlans.offers.patch או monetization.subscriptions.basePlans.offers.batchUpdate. כל שלוש השיטות תומכות בשדות retentionRule, retentionPerUserRule, startTime ו-endTime. באובייקט SubscriptionOffer, מגדירים את השדות הבאים:
-
offerId: מזהה המבצע הייחודי שלך לשימור. -
targeting: מגדירים אתretentionRuleלאובייקטRetentionTargetingRuleשמגדיר מי זכאי למבצע. כדי לראות את השדות הזמינים, קראו את המאמר הגדרת כללי זכאות לשמירה. כדי לבחור מנויים שעומדים בדרישות מה-backend, מגדירים אתretentionPerUserRule. פרטים נוספים זמינים במאמר טירגוט מבצעים לשימור מנויים ספציפיים. -
phases[]: מבצע לשמירת לקוחות תומך רק בשלב תמחור אחד. בשלב הזה, מגדירים את השדות הבאים:-
recurrenceCount: מספר תקופות החיוב שבהן ההנחה נמשכת, מ-1 עד 52. אם הערך שלrecurrenceCountגדול מ-1, השלבdurationחייב להיות שווה לתקופת החיוב של המינוי הבסיסי. -
regionalConfigs[]: מגדירים אתrelativeDiscountלהנחה כשבר שגדול מ-0 וקטן מ-1. לדוגמה, משתמשים ב-0.5כדי להגדיר 50% הנחה. במבצעי שימור לקוחות אפשר להשתמש רק ב-relativeDiscount. אין תמיכה בשלבים של מחיר קבוע (price), ערך מוחלט של הנחה (absoluteDiscount) וחינם (free).
-
-
startTime: אופציונלי. השעה שבה המבצע לשימור לקוחות זמין למנויים שעומדים בדרישות, כחותמת זמן בפורמט RFC 3339. הגדרת השדה הזה לא מפעילה את המבצע. אם לא מגדירים את השדה הזה, המבצע יהיה זמין בהתאם למצב שלו. -
endTime: אופציונלי. הזמן שבו המבצע לשימור לקוחות מפסיק להיות זמין, כחותמת זמן בפורמט RFC 3339, בלי קשר למצב המבצע. אם לא מגדירים את השדה הזה, למבצע אין תאריך סיום. אם מגדירים את השדה הזה, צריך להגדיר תאריך עתידי שמאוחר יותר מ-startTime.
ה-method monetization.subscriptions.basePlans.offers.create תמיד יוצרת את המבצע במצב DRAFT, גם אם מגדירים את startTime. כדי להפעיל את המבצע, צריך לבצע קריאה ל-method monetization.subscriptions.basePlans.offers.activate.
הגדרת כללי זכאות לשימור
האובייקט RetentionTargetingRule מכיל את השדות הבאים:
-
scope: שדה חובה. המינויים שהכלל מתייחס אליהם. במבצעים לשימור לקוחות, הערך הנתמך היחיד הואthisSubscription, המינוי שבו המבצע מוגדר. מגדירים את השדה הזה לערך{"thisSubscription": {}}. -
minDuration: שדה חובה. משך הזמן המינימלי שבו המשתמש צריך להיות מנוי בתשלום כדי לעמוד בדרישות, בפורמט ISO 8601 בימים, מ-P0DעדP1826D. לדוגמה, אפשר להשתמש ב-P90Dלמשך 90 ימים. כדי לא לדרוש תקופת מינימום למינוי בתשלום, צריך להגדיר את השדה הזה לערךP0D. -
allowMultipleClaims: אופציונלי. אם מנוי יכול לממש את המבצע יותר מפעם אחת. אםfalse, מנוי שמימש את המבצע הזה לא יוכל לממש אותו שוב. אםtrue, מנוי יכול להיות זכאי שוב אחרי שחלף הזמן שצוין ב-minOfferCooldownDurationמאז סיום תקופת ההנחה של מבצע השימור הקודם. ברירת המחדל היאfalse. -
minOfferCooldownDuration: חובה אם הערך שלallowMultipleClaimsהואtrue. משך הזמן המינימלי שצריך לעבור אחרי שתקופת ההנחה של מבצע השימור הקודם מסתיימת, לפני שהמנוי זכאי שוב למבצע. משך הזמן מצוין בימים בפורמט ISO 8601, מ-P1DעדP1826D. לדוגמה, אפשר להשתמש ב-P180Dלמשך 180 ימים. אל תגדירו את השדה הזה אםallowMultipleClaimsהואfalseאו לא מוגדר.
בדוגמה הבאה מוצגים השדות startTime, endTime ו-targeting של אובייקט SubscriptionOffer למבצע שימור שזמין למנויים ששילמו במשך 90 ימים לפחות, ושהם יכולים לממש שוב 180 ימים אחרי שההנחה הקודמת לשימור הסתיימה:
{
"offerId": "retention-50off-2m",
"startTime": "2026-12-01T00:00:00Z",
"endTime": "2027-03-01T00:00:00Z",
"targeting": {
"retentionRule": {
"scope": {
"thisSubscription": {}
},
"minDuration": "P90D",
"allowMultipleClaims": true,
"minOfferCooldownDuration": "P180D"
}
}
}
טירגוט מבצעי שימור למנויים ספציפיים
במקום לאפשר ל-Google Play להחליט על הזכאות באמצעות RetentionTargetingRule, אתם יכולים להציע מבצע לשימור לקוחות רק למנויים שה-backend שלכם בוחר. לדוגמה, אתם יכולים להציע מבצע למנויים שהמודל לחיזוי נטישה מסמן ככאלה שנמצאים בסיכון, או למנויים שמתחילים תהליך ביטול באפליקציה.
המנויים רואים הצעה לשימור משתמשים לכל משתמש באותו תהליך ביטול ב-Google Play כמו כל הצעה אחרת לשימור לקוחות, ואתם מטפלים באישור באותו אופן. פרטים נוספים זמינים במאמר טיפול באירועים של מבצעי שימור לקוחות בקצה העורפי.
כדי לטרגט מבצעי שימור למנויים ספציפיים, מבצעים את הפעולות הבאות:
יצירת מבצע שימור משתמשים לכל משתמש. כשקוראים ל-method
monetization.subscriptions.basePlans.offers.create,monetization.subscriptions.basePlans.offers.patchאוmonetization.subscriptions.basePlans.offers.batchUpdate, מגדירים אתtargetingלאובייקטretentionPerUserRuleבמקום לאובייקטretentionRule. באובייקטRetentionPerUserTargetingRuleאין שדות. אפשר להשתמש ב-retentionRuleאו ב-retentionPerUserRule, אבל לא בשניהם.{ "offerId": "retention-peruser-30off", "targeting": { "retentionPerUserRule": {} } }צריך להפעיל את המבצע לפני שמטרגטים אותו למנויים. אם תפעילו את השיטה
activateOfferTargetingעל מבצע שמעולם לא הופעל, הפעולה תיכשל ותקבלו קוד סטטוס HTTP 400 Bad Requestוסטטוס שגיאהINVALID_ARGUMENT. מידע נוסף זמין במאמר טיפול בשגיאות טירגוט. גם כשהמבצע פעיל, מערכת Google Play מציגה אותו רק למנויים שאתם מטרגטים בשלב הבא.מטרגטים את המבצע למינוי. מפעילים את השיטה
purchases.subscriptionsv2.activateOfferTargetingעם שם החבילה של האפליקציה, ה-purchaseTokenשל המינוי וה-offerIdשל המבצע לשימור משתמשים:POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{purchaseToken}:activateOfferTargeting { "offerId": "retention-peruser-30off" }קריאה מוצלחת מחזירה קוד סטטוס
204 No Contentשל HTTP בלי גוף תגובה. חנות Google Play שומרת את הטירגוט יחד עם המינוי, כך שאין צורך להפעיל את ה-API ברגע שהמנוי מבטל. בפעם הבאה שהמנוי יתחיל בתהליך הביטול ב-Google Play, המערכת של Google Play תוכל להציג את המבצע, כל עוד המינוי עומד בדרישות הסף. טירגוט לפי משתמש מחליף רק את כללי הזכאות שמוגדרים על ידיretentionRule. כל שאר דרישות הסף והבדיקות ש-Google Play מבצעת ברמת הפלטפורמה, כמו דרישות תאימות אזוריות, עדיין חלות.אפשר לטרגט יותר ממבצע שימור משתמשים אחד לאותו מינוי. כדי לעשות זאת, צריך להפעיל את ה-method
activateOfferTargetingפעם אחת לכל מבצע. מערכת Google Play עדיין מציגה לכל היותר מבצע שימור אחד בתהליך הביטול. לפרטים על האופן שבו Google Play בוחרת את המבצע, ראו הגדרת מבצעים לשימור לקוחות.ה-method
activateOfferTargetingהיא אידמפוטנטית. אם קוראים לשיטה הזו למבצע שכבר מטורגט למינוי, הקריאה מצליחה ו-Google Play מעדכן את הערך שלactivateTimeשל המבצע לזמן של הבקשה האחרונה.מסירים את הטירגוט כשצריך. אם אתם לא רוצים יותר שהמנוי יקבל את המבצע, למשל כי הסיכון לנטישה השתנה, אתם יכולים להפעיל את ה-method
purchases.subscriptionsv2.deactivateOfferTargetingעם אותו שם חבילה,purchaseTokenו-offerId. קריאה מוצלחת מחזירה קוד סטטוס HTTP204 No Contentללא גוף תגובה.גם השיטה
deactivateOfferTargetingהיא אידמפוטנטית. אם המבצע לא מטורגט למינוי, למשל כי אף פעם לא הפעלתם את הטירגוט, הקריאה תצליח ולא תהיה לה השפעה.
הטירגוט חל על purchaseToken אחד, והתוקף שלו לא פג כל עוד המינוי פעיל ומתחדש אוטומטית. הוא נשאר במקום אחרי שהמנוי רואה, מאשר או דוחה את המבצע. Google Play מסירה אותו רק כשמפעילים את השיטה deactivateOfferTargeting, או 60 יום אחרי שהמינוי פג. אם שינוי בתוכנית או הרשמה מחדש יוצרים purchaseToken חדש, הטירגוט לא מועבר.
כדי לבדוק אילו מבצעי שימור משתמשים לכל משתמש מטורגטים למינוי, מפעילים את השיטה purchases.subscriptionsv2.get. בשדה developerTargetedOffers של כל פריט מפורטים המוצרים המטורגטים. כל רשומה מכילה את הערכים offerId ו-activateTime של מועד הפעלת הטירגוט:
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"developerTargetedOffers": [
{
"offerId": "retention-peruser-30off",
"activateTime": "2026-12-03T15:04:05Z"
}
]
}
]
}
טיפול בשגיאות טירגוט
אם קריאה ל-method activateOfferTargeting או deactivateOfferTargeting נכשלת, התשובה מכילה קוד סטטוס של HTTP וסטטוס שגיאה שמתאר את הסיבה. בטבלה הבאה מפורטים קודי הסטטוס של HTTP וסטטוסי השגיאה שהשיטות האלה יכולות להחזיר:
| קוד סטטוס של HTTP | סטטוס שגיאה | שיטות | הסיבה |
|---|---|---|---|
404 Not Found |
NOT_FOUND |
שניהם | ה-purchaseToken לא קיים. |
400 Bad Request |
INVALID_ARGUMENT |
activateOfferTargeting |
המבצע offerId לא קיים במינוי הבסיסי הנוכחי, או שהמבצע עדיין במצב טיוטה ומעולם לא הופעל. |
400 Bad Request |
FAILED_PRECONDITION |
activateOfferTargeting |
המאפיין targeting של המבצע לא מוגדר כ-retentionPerUserRule. |
400 Bad Request |
FAILED_PRECONDITION |
activateOfferTargeting |
המינוי כבר לא בתוקף. |
השיטה activateOfferTargeting לא בודקת אם מינוי שלא פג תוקפו עומד בדרישות המבצע. לדוגמה, אם המינוי בוטל אבל עדיין לא פג תוקף, הקריאה תצליח ו-Google Play תשמור את הטירגוט. מערכת Google Play בודקת אם המינוי עומד בדרישות כשהמנוי נכנס לתהליך הביטול.
טיפול באירועים של מבצעי שימור לקוחות בקצה העורפי
כשמנוי מקבל הצעה לשימור, ובהמשך כשהחידוש בהנחה מתרחש, מערכת Google Play שולחת התראות RTDN לשרת שלכם. אחרי שמקבלים כל התראה, צריך להפעיל את ה-method purchases.subscriptionsv2.get עם ה-purchaseToken מההתראה כדי לקבל את מצב המינוי העדכני.
אישור של מבצע שימור לא יוצר רכישה חדשה. הערך של purchaseToken נשאר זהה, כך שאין צורך לאשר שוב את הרכישה, ו-Google Play לא יוצרת linkedPurchaseToken. משאירים את ההרשאה הקיימת של המנוי. מעבדים את הזמנת החידוש בהנחה באותו אופן שבו מעבדים כל חידוש מינוי אחר.
| סוג התראה | מתי הנתונים נשלחים? | מה לעשות? |
|---|---|---|
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) |
כשמנוי מקבל הצעה לשימור לקוחות בתהליך הביטול. | מפעילים את ה-method purchases.subscriptionsv2.get ובודקים את planTransitionDetails. הערך בעמודה transitionState הוא IN_PROGRESS. המינוי נשאר פעיל ומתחדש אוטומטית, אז צריך להמשיך לתת גישה. |
SUBSCRIPTION_RENEWED (2) |
כשתקופת החיוב הנוכחית מסתיימת והמינוי מתחדש במחיר המוזל של מבצע השימור. | מפעילים את השיטה purchases.subscriptionsv2.get, מוודאים שמזהה מבצע השימור הוא offerDetails.offerId ושהמזהה planTransitionDetails כבר לא קיים, ומאריכים את הגישה של המנוי ל-expiryTime החדש. |
האובייקט planTransitionDetails מכיל את השדות הבאים:
-
productId: מזהה המוצר של התוכנית שאליה המינוי עובר. במבצע לשימור לקוחות, זה אותו מוצר. -
basePlanId: מזהה המינוי הבסיסי של המינוי שאליו עוברים. -
offerId: המזהה של מבצע השימור שהמנוי קיבל. השדה הזה משמש לזיהוי מבצע השימור שמומש. -
transitionInfo.transitionState: מצב המעבר. במבצעים לשימור לקוחות, המצב הואIN_PROGRESSבזמן שהמעבר בהמתנה. -
transitionInfo.expectedTransitionTime: מתי התנאים של מבצע השימור אמורים להיכנס לתוקף.
הערך planTransitionDetails מופיע ב-Google Play רק כשהמעבר בהמתנה. כשהמינוי מתחדש במחיר המוזל של מבצע השימור, המעבר מסתיים ו-Google Play מסירה את planTransitionDetails מהתגובה של purchases.subscriptionsv2.get. מאותו רגע, הפריט עצמו מציג את הנחת השימור הפעילה:
-
offerDetails.offerIdהוא המזהה של מבצע השימור שהתקבל. - הערך של
offerPhaseהוא{"introductoryPrice": {}}בתקופות החיוב שבהן ניתנת הנחה. אחרי שתקופות החיוב המוזלות מסתיימות והמינוי מתחדש במחיר הרגיל של המינוי הבסיסי, הערך שלofferPhaseמשתנה ל-{"basePrice": {}}.
תגובה אחרי שהמנוי מאשר את ההצעה
אחרי שהמנוי מאשר את הצעת השימור, תקופת החיוב הנוכחית נמשכת ללא שינוי. האובייקט planTransitionDetails מציג את המעבר המתוזמן עם transitionState של IN_PROGRESS:
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"expiryTime": "2026-12-15T10:00:00Z",
"offerDetails": {
"basePlanId": "monthly-base"
},
"autoRenewingPlan": {
"autoRenewEnabled": true,
"planTransitionDetails": {
"productId": "premium_monthly_sub",
"basePlanId": "monthly-base",
"offerId": "retention-50off-2m",
"transitionInfo": {
"transitionState": "IN_PROGRESS",
"expectedTransitionTime": "2026-12-15T10:00:00Z"
}
}
}
}
]
}
תגובה אחרי החידוש בהנחה
אחרי שתאריך החידוש עובר והמנוי מחויב במחיר המוזל, השדה offerDetails.offerId מציג את מבצע השימור, השדה offerPhase מציג את הערך introductoryPrice, והתגובה כבר לא כוללת את השדה planTransitionDetails:
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"expiryTime": "2027-01-15T10:00:00Z",
"offerDetails": {
"basePlanId": "monthly-base",
"offerId": "retention-50off-2m"
},
"offerPhase": {
"introductoryPrice": {}
},
"autoRenewingPlan": {
"autoRenewEnabled": true,
"recurringPrice": {
"currencyCode": "USD",
"units": "9",
"nanos": 990000000
}
}
}
]
}
אינטראקציות במחזור החיים
כשמטפלים במבצעים לשימור לקוחות, חשוב לזכור את הדברים הבאים:
- סיום ההנחה: אחרי שתקופות החיוב בהנחה מסתיימות, המינוי מתחדש אוטומטית במחיר הרגיל של המינוי הבסיסי. תקבלו התראה מ-
SUBSCRIPTION_RENEWED, כמו בכל חידוש אחר, והערך שלofferPhaseבפריט ישתנה ל-{"basePrice": {}}. המנוי לא צריך לעשות שום דבר. - גביית תשלום אחרי ההנחה: אם החידוש במחיר הרגיל של המינוי הבסיסי אחרי סיום ההנחה נדחה והמינוי נכנס לתקופת חסד או להשהיית חשבון, גביית התשלום מתבצעת במחיר הרגיל של המינוי הבסיסי. מערכת Google Play לא מחילה את ההנחה של מבצע השימור שהושלם. אם התשלום על החידוש הראשון בהנחה נדחה, המעבר בהמתנה נשמר, והמחיר של מבצע השימור חל כשהתשלום מתחדש.
- חיוב נדחה: אם קוראים ל-method
purchases.subscriptionsv2.deferבזמן שהמעבר למבצע לשימור לקוחות הואIN_PROGRESS, המעבר בהמתנה נשמר וחל בחידוש הנדחה. כדי לראות את תאריך החידוש החדש, בודקים אתexpiryTimeשל הפריט. - שינוי התוכנית לפני המעבר: מבצע שימור לקוחות חל רק על
purchaseTokenשל המינוי שבו המנוי אישר אותו. אם המנוי עובר למינוי בסיסי או למינוי אחר לפני ה-expectedTransitionTime, מערכת Google Play יוצרת אסימון רכישה חדש, מבטלת את המעבר המתוזמן ומנקה אתplanTransitionDetails. ההצעה לשימור לקוחות בהמתנה לא חלה על התוכנית החדשה. - ביטול ושחזור: אם מנוי מבטל את המינוי אחרי שהוא אישר את הצעת השימור, המעבר המתוזמן נשאר בהמתנה ו-
transitionStateנשארIN_PROGRESS. אם המנוי משחזר את המינוי לפני שהוא פג, ההנחה של מבצע השימור עדיין חלה בחידוש. - תפוגה והרשמה מחדש: אם תוקף המינוי פג בלי שהוא שוחזר, המערכת של Google Play מבטלת את המעבר בהמתנה. אם המשתמש נרשם מחדש או נרשם שוב מאוחר יותר, מערכת Google Play יוצרת רכישת מינוי חדשה, והמבצע לשימור המשתמש שהתקבל בעבר לא חל.
- שינויים במבצע: אם משנים את ההנחה או את תקופות החיוב של מבצע שימור, השינוי חל רק על מימושים עתידיים. מנויים שכבר אישרו את המבצע ימשיכו ליהנות מהתנאים המקוריים.
- השבתת מבצע: אם אתם משביתים מבצע שימור או שהמבצע מגיע לתאריך הסיום שלו, המנויים שכבר אישרו אותו ממשיכים ליהנות מהתנאים שהם הסכימו להם. מנויים עם מעבר של
IN_PROGRESSעדיין מקבלים את ההנחה בחידוש הבא, ומנויים שכבר נמצאים בתקופות החיוב המוזלות ממשיכים לקבל את ההנחה למשך כל התקופה המוסכמת. - שינויי מחירים: שינויים במחיר של מינוי בסיסי עדיין חלים. מערכת Google Play מעבירה מנוי למחיר חדש רק אם המנוי משלם את המחיר הרגיל ואין לו מעבר בהמתנה למבצע שימור. מידע נוסף זמין במאמר שינוי מחירי המינויים.
- החזרים כספיים: אתם יכולים להעביר למנוי החזר כספי באמצעות ממשקי ה-API הרגילים להחזר כספי ולביטול, כמו השיטה
purchases.subscriptionsv2.revoke. הפעולה הזו מבצעת החזר כספי על התשלום האחרון ומבטלת את הגישה של המנוי.
מבצעי שימור לבדיקה
ב-Google Play מוצגים רק מבצעי שימור פעילים בתהליך הביטול, וכללי הזכאות נבדקים בזמן אמת. כדי לבדוק מבצעים לשימור מנויים באמצעות חשבון של בודק עם רישיון, אתם יכולים להשתמש באחת מהשיטות הבאות:
- לבדוק מבצע שימור לכל משתמש במינוי בסיסי בסביבת הייצור, בלי להציג את המבצע למנויים אמיתיים.
- בודקים את מבצע השימור שמבוסס על כללים באפליקציית בדיקה או במינוי בסיסי לבדיקה, שלמשתמשים בסביבת הייצור אין גישה אליהם.
לפני שמשתמשים באחת מהשיטות, עוברים אל הגדרות > בדיקת רישיון ב-Google Play Console ומוסיפים את חשבון Google לבדיקה כבודק רישיונות.
בדיקת מבצע שימור משתמשים לכל משתמש
מערכת Google Play מציגה מבצע שימור לכל משתמש רק במינויים שאתם מטרגטים, כך שאתם יכולים לבדוק אותו במינוי בסיסי בסביבת הייצור בלי לחשוף אותו למנויים אמיתיים. כדי לבדוק מבצע שימור משתמשים לכל משתמש:
- יוצרים מבצע שימור משתמשים לכל משתמש במינוי בסיסי, ואז מפעילים אותו. ב-Google Play Console, בוחרים באפשרות מבצע שימור ברמת המשתמש.
בממשק API של Google Play למפתחים, מגדירים את
targetingלאובייקטretentionPerUserRule. פרטים נוספים זמינים במאמר טירגוט מבצעים לשימור מנויים ספציפיים. - אם בדיוק הפעלתם את המבצע, המתינו 10 עד 15 דקות עד שהשינוי יתעדכן, ואז נקו את המטמון של אפליקציית חנות Google Play.
- במכשיר הבדיקה, נכנסים לחשבון של בודק הרישיונות ורוכשים את מינוי Base Plan באפליקציה.
- מה-backend, מפעילים את ה-method
purchases.subscriptionsv2.activateOfferTargetingעם שם החבילה של האפליקציה, ה-purchaseTokenשל בודק הרישיון וה-offerIdשל מבצע השימור. - באפליקציה של חנות Google Play, עוברים אל תשלומים ומינויים > מינויים, בוחרים את המינוי ולוחצים על ביטול המינוי. ההצעה לשימור מופיעה בתהליך הביטול.
- מאשרים את המבצע ומוודאים שה-backend מקבל את ה-RTDN של
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDומטפל בחידוש בהנחה.
בדיקת מבצע שימור מבוסס-כללים
אחרי שמפעילים מבצע שימור מבוסס-כללים, מערכת Google Play יכולה להציג אותו לכל מנוי שעומד בדרישות במינוי הבסיסי. כדי למנוע חשיפה של המבצע למשתמשים בסביבת הייצור, כדאי לבדוק אותו באפליקציית בדיקה שלא נמצאת בסביבת הייצור או במינוי בסיסי ייעודי לבדיקה שלמשתמשים בסביבת הייצור אין גישה אליו. כדי לבדוק מבצע שימור לקוחות שמבוסס על כללים:
- באפליקציית הבדיקה או במינוי הבסיסי לבדיקה, יוצרים מבצע שימור מבוסס-כללים ומגדירים את
minDurationלערךP0D(0 ימים). ב-Google Play Console, בוחרים באפשרות מבצע שימור ברמת הקבוצה. בממשק ה-API של Google Play למפתחים, מגדירים אתtargetingלאובייקטretentionRule. פרטים נוספים מופיעים במאמר הגדרת כללי זכאות לשמירה. - מפעילים את המבצע, ממתינים 10 עד 15 דקות עד שהשינוי יתעדכן ואז מנקים את המטמון של אפליקציית חנות Google Play.
- במכשיר הבדיקה, נכנסים לחשבון של בודק הרישיונות ורוכשים את מינוי הבסיס לבדיקה.
- באפליקציה של חנות Google Play, עוברים אל תשלומים ומינויים > מינויים, בוחרים את המינוי ולוחצים על ביטול המינוי. בגלל שהמבצע לא דורש תקופת מינימום למינוי בתשלום, אתם יכולים להתחיל את תהליך הביטול מיד אחרי הרכישה. ההצעה לשימור המנוי מופיעה בתהליך הביטול.
- מאשרים את המבצע ומוודאים שה-backend מקבל את ה-RTDN של
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDומטפל בחידוש בהנחה.
אחרי שמאמתים את השילוב, יוצרים ומפעילים את המבצע לשימור מנויים שמבוסס על כללים במינוי הבסיסי בסביבת הייצור.
פתרון בעיות בבדיקת מבצעי שימור
אם המבצע לשימור לקוחות לא מופיע, כדאי לבדוק את הדברים הבאים:
- מבצע השימור פעיל, והשעה הנוכחית היא בין
startTimeל-endTime, אם הגדרתם אותן. - במבצע שימור לכל משתמש, השדה
developerTargetedOffersבתגובה שלpurchases.subscriptionsv2.getל-purchaseTokenשל בודק הרישיונות כולל את המבצע. - המינוי הוא מינוי בודד, ולא מינוי עם חבילות.
- המינוי לא נמצא בתקופת חסד, בהשהיית חשבון או בהשהיה.
- אין שינוי בתוכנית או במחיר של המינוי בהמתנה.
- החידוש הבא יהיה במחיר הרגיל של המינוי הבסיסי. בתקופות ניסיון בחינם ובמבצעי היכרות, המבצע לשמירת לקוחות זמין רק במהלך תקופת החיוב האחרונה של תקופת הניסיון או של שלב ההיכרות.
- חיכיתם 10 עד 15 דקות אחרי שהפעלתם או שיניתם את המבצע, וניקיתם את המטמון של אפליקציית חנות Play.