שימור מנויים באמצעות מבצעי שימור

מבצעים לשימור מנויים עוזרים לצמצם את הנטישה הרצונית על ידי הצגת הנחה למנויים ברגע שהם מנסים לבטל את המינוי שלהם ב-Google Play.

כשמנוי שעומד בדרישות מתחיל לבטל את המינוי, מוצג לו ב-Google Play מבצע לשימור לקוחות שהגדרתם, למשל "שמרו על המינוי וקבלו 50% הנחה בחודשיים הבאים". אם המנוי מקבל את ההצעה, המינוי שלו לא מבוטל. המחיר המוזל יחול בתאריך הפקת החשבונית הבא.

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

לפני שמתחילים

לפני שמגדירים מבצעים לשימור מנויים, חשוב לוודא שביצעתם את הפעולות הבאות:

מכיוון שהמבצעים לשימור מנויים ב-Google Play מוצגים מחוץ לאפליקציה, אתם לא צריכים לשנות את האפליקציה או לעדכן את השילוב של ספריית החיובים ב-Google Play כדי להשתמש בהם. כל עבודת השילוב מתבצעת ב-Google Play Console ובקצה העורפי שלכם.

איך פועלים מבצעי שימור לקוחות

מבצעי שימור מופיעים רק במרכז לניהול המינויים ב-Google Play: באפליקציית חנות Google Play וב-Google Play באינטרנט. הם לא מופיעים בתוך האפליקציה. ספריית החיובים ב-Google Play לא מחזירה מבצעים לשימור לקוחות בתוצאות של queryProductDetailsAsync(), ולכן הם לא נכללים ב-ProductDetails.getSubscriptionOfferDetails() ואי אפשר למכור אותם דרך launchBillingFlow(). אם באפליקציה שלכם נעשה שימוש בקישורי עומק כדי להפנות מנויים למרכז המינויים של Google Play או למינוי ספציפי כדי שהם יוכלו לנהל או לבטל אותו, המנויים האלה יוכלו לראות את ההצעה לשימור כשהם יתחילו את תהליך הביטול.

השלבים הבאים מתארים מה קורה כשמנוי מנסה לבטל:

  1. המנוי פותח את המינוי שלו ב-Google Play ומתחיל לבטל אותו.
  2. מערכת Google Play בודקת אם המנוי עומד בדרישות לאחד ממבצעי השימור, על סמך כללי הזכאות שהגדרתם למבצע, או על סמך הטירגוט של המבצע למנוי הזה.

  3. אם המנוי עומד בדרישות, יכול להיות שיוצג לו ב-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 בוחרת את המבצע בסדר הבא:

  1. מצב טירגוט: מבצע מטורגט לכל משתמש (retentionPerUserRule) תמיד מקבל עדיפות על פני מבצע מבוסס-כללים (retentionRule), גם אם אחוז ההנחה במבצע מבוסס-הכללים גבוה יותר.
  2. אחוז ההנחה: מבין המבצעים שעומדים בדרישות ומשתמשים באותו מצב טירגוט, מערכת Google Play מציגה את המבצע עם אחוז ההנחה הגבוה ביותר.
  3. מחיר מוזל: אם למבצעים יש אחוז הנחה זהה, Google Play מציגה את המבצע עם המחיר המוזל הנמוך ביותר.
  4. מזהה המבצע: אם עדיין יש שוויון בין המבצעים, המערכת של Google Play תציג את המבצע שהערך של offerId שלו מופיע אחרון בסדר אלפביתי.

יצירת מבצע שימור ב-Play Console

כדי ליצור מבצע שימור ב-Google Play Console:

  1. עוברים אל מונטיזציה באמצעות Play > מוצרים > מינויים.
  2. בוחרים מינוי ואז בוחרים את המינוי הבסיסי שאליו רוצים להוסיף את המבצע.
  3. מוסיפים מבצע למנויים קיימים בתהליך ביטול.
  4. בוחרים באפשרות מבצע שימור ברמת הקבוצה או מבצע שימור ברמת המשתמש.

יצירת מבצע שימור באמצעות 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 כמו כל הצעה אחרת לשימור לקוחות, ואתם מטפלים באישור באותו אופן. פרטים נוספים זמינים במאמר טיפול באירועים של מבצעי שימור לקוחות בקצה העורפי.

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

  1. יצירת מבצע שימור משתמשים לכל משתמש. כשקוראים ל-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 מציגה אותו רק למנויים שאתם מטרגטים בשלב הבא.

  2. מטרגטים את המבצע למינוי. מפעילים את השיטה 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 של המבצע לזמן של הבקשה האחרונה.

  3. מסירים את הטירגוט כשצריך. אם אתם לא רוצים יותר שהמנוי יקבל את המבצע, למשל כי הסיכון לנטישה השתנה, אתם יכולים להפעיל את ה-method‏ purchases.subscriptionsv2.deactivateOfferTargeting עם אותו שם חבילה, purchaseToken ו-offerId. קריאה מוצלחת מחזירה קוד סטטוס HTTP 204 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 מציגה מבצע שימור לכל משתמש רק במינויים שאתם מטרגטים, כך שאתם יכולים לבדוק אותו במינוי בסיסי בסביבת הייצור בלי לחשוף אותו למנויים אמיתיים. כדי לבדוק מבצע שימור משתמשים לכל משתמש:

  1. יוצרים מבצע שימור משתמשים לכל משתמש במינוי בסיסי, ואז מפעילים אותו. ב-Google Play Console, בוחרים באפשרות מבצע שימור ברמת המשתמש. בממשק API של Google Play למפתחים, מגדירים את targeting לאובייקט retentionPerUserRule. פרטים נוספים זמינים במאמר טירגוט מבצעים לשימור מנויים ספציפיים.
  2. אם בדיוק הפעלתם את המבצע, המתינו 10 עד 15 דקות עד שהשינוי יתעדכן, ואז נקו את המטמון של אפליקציית חנות Google Play.
  3. במכשיר הבדיקה, נכנסים לחשבון של בודק הרישיונות ורוכשים את מינוי Base Plan באפליקציה.
  4. מה-backend, מפעילים את ה-method‏ purchases.subscriptionsv2.activateOfferTargeting עם שם החבילה של האפליקציה, ה-purchaseToken של בודק הרישיון וה-offerId של מבצע השימור.
  5. באפליקציה של חנות Google Play, עוברים אל תשלומים ומינויים > מינויים, בוחרים את המינוי ולוחצים על ביטול המינוי. ההצעה לשימור מופיעה בתהליך הביטול.
  6. מאשרים את המבצע ומוודאים שה-backend מקבל את ה-RTDN של SUBSCRIPTION_PLAN_TRANSITION_UPDATED ומטפל בחידוש בהנחה.

בדיקת מבצע שימור מבוסס-כללים

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

  1. באפליקציית הבדיקה או במינוי הבסיסי לבדיקה, יוצרים מבצע שימור מבוסס-כללים ומגדירים את minDuration לערך P0D (0 ימים). ב-Google Play Console, בוחרים באפשרות מבצע שימור ברמת הקבוצה. בממשק ה-API של Google Play למפתחים, מגדירים את targeting לאובייקט retentionRule. פרטים נוספים מופיעים במאמר הגדרת כללי זכאות לשמירה.
  2. מפעילים את המבצע, ממתינים 10 עד 15 דקות עד שהשינוי יתעדכן ואז מנקים את המטמון של אפליקציית חנות Google Play.
  3. במכשיר הבדיקה, נכנסים לחשבון של בודק הרישיונות ורוכשים את מינוי הבסיס לבדיקה.
  4. באפליקציה של חנות Google Play, עוברים אל תשלומים ומינויים > מינויים, בוחרים את המינוי ולוחצים על ביטול המינוי. בגלל שהמבצע לא דורש תקופת מינימום למינוי בתשלום, אתם יכולים להתחיל את תהליך הביטול מיד אחרי הרכישה. ההצעה לשימור המנוי מופיעה בתהליך הביטול.
  5. מאשרים את המבצע ומוודאים שה-backend מקבל את ה-RTDN של SUBSCRIPTION_PLAN_TRANSITION_UPDATED ומטפל בחידוש בהנחה.

אחרי שמאמתים את השילוב, יוצרים ומפעילים את המבצע לשימור מנויים שמבוסס על כללים במינוי הבסיסי בסביבת הייצור.

פתרון בעיות בבדיקת מבצעי שימור

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

  • מבצע השימור פעיל, והשעה הנוכחית היא בין startTime ל-endTime, אם הגדרתם אותן.
  • במבצע שימור לכל משתמש, השדה developerTargetedOffers בתגובה של purchases.subscriptionsv2.get ל-purchaseToken של בודק הרישיונות כולל את המבצע.
  • המינוי הוא מינוי בודד, ולא מינוי עם חבילות.
  • המינוי לא נמצא בתקופת חסד, בהשהיית חשבון או בהשהיה.
  • אין שינוי בתוכנית או במחיר של המינוי בהמתנה.
  • החידוש הבא יהיה במחיר הרגיל של המינוי הבסיסי. בתקופות ניסיון בחינם ובמבצעי היכרות, המבצע לשמירת לקוחות זמין רק במהלך תקופת החיוב האחרונה של תקופת הניסיון או של שלב ההיכרות.
  • חיכיתם 10 עד 15 דקות אחרי שהפעלתם או שיניתם את המבצע, וניקיתם את המטמון של אפליקציית חנות Play.