پیشنهادهای حفظ مشتری به شما کمک میکند ریزش داوطلبانه را کاهش دهید. این کار با نشان دادن تخفیف به مشترکین در لحظهای که میخواهند اشتراکشان را در Google Play لغو کنند انجام میشود.
وقتی مشترک واجدشرایطی شروع به لغو اشتراک میکند، Google Play پیشنهاد حفظ مشتری را که پیکربندی کردهاید به او نشان میدهد، مثلاً «اشتراکتان را حفظ کنید و برای ۲ ماه آینده ۵۰٪ تخفیف بگیرید». اگر مشترک پیشنهاد را بپذیرد، اشتراکش لغو نمیشود. قیمت با تخفیف از تاریخ صورتحساب بعدی آنها شروع میشود.
این صفحه توضیح میدهد که پیشنهادهای حفظ مشتری چگونه کار میکنند، چگونه آنها را پیکربندی کنید، چگونه رویدادهای حاصل را در زیرینه خود مدیریت کنید، و چگونه آنها را آزمایش کنید.
قبلاز شروع
قبلاز راهاندازی پیشنهادهای حفظ مشتری، مطمئن شوید که کارهای زیر را انجام دادهاید:
- اشتراکی با حداقل یک طرح پایه تمدید خودکار ایجاد کرده باشید. پیشنهادهای ویژه حفظ کاربر را فقط میتوان به طرحهای پایه با امکان تمدید خودکار اضافه کرد.
- «اعلانهای بیدرنگ توسعهدهنده» (RTDN) را پیکربندی کرده باشید و
بخش باطنیتان را برای فراخوانی روش
purchases.subscriptionsv2.getراهاندازی کرده باشید. بخش پشتی شما از اینها برای تشخیص زمانی که مشترک پیشنهاد حفظ مشتری را میپذیرد استفاده میکند.
چون Google Play پیشنهادهای حفظ مشتری را خارج از برنامهتان نشان میدهد، برای استفاده از آنها نیازی نیست برنامهتان را تغییر دهید یا ادغام «کتابخانه خدمات صورتحساب Google Play» را بهروز کنید. همه کارهای ادغام در «کنسول Google Play» و پشتبام شما انجام میشود.
نحوه عملکرد پیشنهادهای حفظ مشتری
پیشنهادهای حفظ مشتری فقط در مدیریت اشتراک 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است. برای مثال، مشترکی که قبلاً پیشنهاد حفظ مشتری را پذیرفته است و هنوز اعمال نشده است، نمیتواند پیشنهاد دیگری دریافت کند. - اشتراک تغییر قیمت تأییدنشده ندارد.
- قیمت تخفیفدار پیشنهاد حفظ مشتری کمتر یا مساوی با قیمت تمدید طرح پایه بعدی مشترک باشد.
- مشترک با قوانین واجدشرایط بودنی که برای پیشنهاد پیکربندی کردهاید مطابقت داشته باشد. برای پیشنهاد حفظ کاربر، هدفیابی را برای اشتراک با روش
activateOfferTargetingفعال کردید.
پیکربندی پیشنهادهای حفظ مشتری
میتوانید پیشنهادهای حفظ مشتری را در «کنسول Google Play» یا بااستفاده از Google Play Developer API ایجاد کنید. هر پیشنهاد حفظ مشتری از یکی از حالتهای هدفیابی زیر استفاده میکند:
- هدفیابی مبتنی بر قانون: Google Play براساس قوانین واجدشرایط بودن که شما تنظیم کردهاید، مثلاً حداقل مدت اشتراک پولی، تصمیم میگیرد کدام مشترکان واجدشرایط هستند.
- هدفیابی براساس کاربر: باطن شما تصمیم میگیرد که کدام مشترکین میتوانند پیشنهاد را با هدفیابی آن برای اشتراکهای خاص ببینند.
طرح پایه میتواند بیشاز یک پیشنهاد حفظ مشتری فعال در یک کشور یا منطقه داشته باشد. وقتی مشترک برای بیشاز یک پیشنهاد ویژه واجدشرایط باشد، Google Play حداکثر یک پیشنهاد ویژه حفظ مشتری را در جریان لغو نشان میدهد. Google Play پیشنهاد ویژه را به ترتیب زیر انتخاب میکند:
- حالت هدفیابی: پیشنهاد هدفیابیشده برای هر کاربر (
retentionPerUserRule) همیشه بر پیشنهاد مبتنی بر قانون (retentionRule) اولویت دارد، حتی اگر پیشنهاد مبتنی بر قانون درصد تخفیف بالاتری داشته باشد. - درصد تخفیف: از میان پیشنهادهای واجدشرایطی که از حالت هدفیابی یکسان استفاده میکنند، Google Play پیشنهادی را نشان میدهد که بالاترین درصد تخفیف نمایشدادهشده را دارد.
- قیمت تخفیفخورده: اگر پیشنهادها درصد تخفیف یکسانی داشته باشند، Google Play پیشنهاد با کمترین قیمت تخفیفخورده را نشان میدهد.
- شناسه پیشنهاد ویژه: اگر پیشنهادهای ویژه همچنان برابر باشند، Google Play پیشنهاد ویژهای را نشان میدهد که
offerIdآن در ترتیب حروف الفبا آخر باشد.
ایجاد پیشنهاد حفظ مشتری در «کنسول Play»
برای ایجاد پیشنهاد حفظ مشتری در «کنسول Google Play»، کارهای زیر را انجام دهید:
- به درآمدزایی با Play > محصولات > اشتراکها بروید.
- اشتراکی را انتخاب کنید، سپس طرح پایهای را که میخواهید پیشنهاد به آن اضافه شود انتخاب کنید.
- پیشنهادی برای مشترکین کنونی که قصد لغو دارند اضافه کنید.
- پیشنهاد ویژه حفظ اشتراک در سطح همگروه یا پیشنهاد ویژه حفظ اشتراک در سطح کاربر را انتخاب کنید.
ایجاد پیشنهاد حفظ مشتری با Play Developer API
همچنین میتوانید پیشنهادهای حفظ مشتری را بهصورت برنامهنویسیشده ایجاد و بهروز کنید. برای ایجاد
پیشنهاد، روش monetization.subscriptions.basePlans.offers.create را
فراخوانی کنید. برای بهروزرسانی پیشنهادهای موجود، روش
monetization.subscriptions.basePlans.offers.patch یا
monetization.subscriptions.basePlans.offers.batchUpdate را فراخوانی کنید. هر سه روش از فیلدهای retentionRule، retentionPerUserRule، startTime، و endTime پشتیبانی میکنند. در شیء SubscriptionOffer، فیلدهای زیر را تنظیم کنید:
offerId: شناسه پیشنهاد ویژه حفظ مشتری منحصربهفرد شما.-
targeting:retentionRuleرا روی شیءRetentionTargetingRuleتنظیم کنید که تعریف میکند چه کسی واجدشرایط پیشنهاد است. برای فیلدهای دردسترس، به تنظیم قوانین واجدشرایط بودن برای نگهداری مراجعه کنید. برای انتخاب مشترکین واجدشرایط از باطن خود،retentionPerUserRuleرا تنظیم کنید. برای جزئیات، به هدفیابی پیشنهادهای حفظ مشتری برای مشترکین خاص مراجعه کنید. phases[]: پیشنهاد ویژه حفظ کاربر فقط از یک مرحله قیمتگذاری پشتیبانی میکند. در آن مرحله، فیلدهای زیر را تنظیم کنید:recurrenceCount: تعداد دورههای صورتحساب که تخفیف در آنها اعمال میشود، از ۱ تا ۵۲. اگرrecurrenceCountبزرگتر از ۱ باشد، فازdurationباید با دوره صورتحساب طرح پایه برابر باشد.-
regionalConfigs[]:relativeDiscountرا روی تخفیف بهعنوان کسری بزرگتر از ۰ و کوچکتر از ۱ تنظیم کنید. برای مثال، از0.5برای ۵۰٪ تخفیف استفاده کنید. پیشنهادهای ویژه حفظ کاربر فقط ازrelativeDiscountپشتیبانی میکنند. از فازهای قیمت ثابت (price)، تخفیف قطعی (absoluteDiscount)، و رایگان (free) پشتیبانی نمیشود.
-
startTime: اختیاری. زمانی که پیشنهاد حفظ مشتری برای مشترکین واجدشرایط دردسترس قرار میگیرد، بهصورت مُهر زمان RFC 3339. تنظیم این فیلد پیشنهاد ویژه را فعال نمیکند. اگر این فیلد را تنظیم نکنید، پیشنهاد ویژه براساس وضعیتش دردسترس قرار میگیرد. -
endTime: اختیاری. زمانی که پیشنهاد حفظ مشتری دیگر دردسترس نیست، بهصورت مُهر زمان RFC 3339، صرفنظر از وضعیت پیشنهاد. اگر این فیلد را تنظیم نکنید، پیشنهاد ویژه تاریخ پایان نخواهد داشت. اگر این فیلد را تنظیم کنید، باید در آینده و بعدازstartTimeباشد.
روش monetization.subscriptions.basePlans.offers.create همیشه پیشنهاد ویژه را در وضعیت DRAFT ایجاد میکند، حتی اگر startTime را تنظیم کنید. برای فعال کردن پیشنهاد،
روش monetization.subscriptions.basePlans.offers.activate را
فراخوانی کنید.
تنظیم قوانین واجدشرایط بودن برای نگهداری
شیء RetentionTargetingRule حاوی فیلدهای زیر است:
-
scope: الزامی. اشتراکهایی که قانون درنظر میگیرد. برای پیشنهادهای ویژه حفظ مشتری، تنها مقدار پشتیبانیشدهthisSubscriptionاست، اشتراکی که پیشنهاد ویژه در آن تعریف شده است. این فیلد را روی{"thisSubscription": {}}تنظیم کنید. -
minDuration: الزامی. حداقل زمانی که کاربر باید مشترک پولی بوده باشد تا واجدشرایط شود، بهعنوان مدتزمان ISO 8601 برحسب روز، ازP0DتاP1826D. برای مثال، ازP90Dبهمدت ۹۰ روز استفاده کنید. برای اینکه حداقل زمان اشتراک پولی لازم نباشد، این فیلد را رویP0Dتنظیم کنید. -
allowMultipleClaims: اختیاری. اینکه آیا مشترک میتواند بیشاز یکبار از پیشنهاد ویژه استفاده کند یا نه. اگرfalse، مشترکی که قبلاً این پیشنهاد ویژه را مطالبه کرده است دیگر هرگز واجدشرایط آن نخواهد بود. اگرtrue، مشترک میتواند پساز گذشت زمانminOfferCooldownDurationاز پایان دوره تخفیف پیشنهاد حفظ قبلی، دوباره واجدشرایط شود. پیشفرضها بهfalse. minOfferCooldownDuration: اگرallowMultipleClaimsبرابر باtrueباشد، الزامی است. حداقل زمانی که باید پساز پایان دوره تخفیف پیشنهاد حفظ قبلی بگذرد تا مشترک دوباره واجدشرایط شود، بهصورت مدتزمان ISO 8601 برحسب روز، ازP1DتاP1826D. برای مثال، ازP180Dبرای ۱۸۰ روز استفاده کنید. اگرallowMultipleClaimsبرابر باfalseاست یا تنظیم نشده است، این فیلد را تنظیم نکنید.
مثال زیر فیلدهای startTime، endTime، و targeting
شیء SubscriptionOffer را برای پیشنهاد حفظ مشتری نشان میدهد که برای
مشترکینی که حداقل ۹۰ روز پرداخت داشتهاند دردسترس است و میتوانند ۱۸۰ روز پساز پایان تخفیف حفظ مشتری قبلیشان دوباره آن را مطالبه کنند:
{
"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 تعیین کند، میتوانید پیشنهاد حفظ مشتری را فقط برای
مشترکینی که باطن شما انتخاب میکند دردسترس قرار دهید. برای مثال، میتوانید پیشنهادی را برای مشترکینی که مدل پیشبینی ریزش شما آنها را بهعنوان درمعرض خطر پرچمگذاری میکند یا مشترکینی که فرایند لغو را در برنامهتان شروع میکنند هدفیابی کنید.
مشترکین پیشنهاد حفظ مشتری را برای هر کاربر در همان جریان لغو Google Play مانند هر پیشنهاد حفظ مشتری دیگری میبینند و شما پذیرش را به همان روش مدیریت میکنید. برای جزئیات، به مدیریت رویدادهای پیشنهاد حفظ مشتری در پسبک مراجعه کنید.
برای هدفیابی پیشنهادهای حفظ مشتری برای مشترکین خاص، کارهای زیر را انجام دهید:
پیشنهاد ویژه حفظ اشتراک بهازای هر کاربر ایجاد کنید. وقتی روش
monetization.subscriptions.basePlans.offers.create،monetization.subscriptions.basePlans.offers.patch، یاmonetization.subscriptions.basePlans.offers.batchUpdateرا فراخوانی میکنید،targetingرا بهجای شیءretentionRuleروی شیءretentionPerUserRuleتنظیم کنید. شیءRetentionPerUserTargetingRuleفیلدی ندارد. پیشنهاد میتواند ازretentionRuleیاretentionPerUserRuleاستفاده کند، اما نه از هر دو.{ "offerId": "retention-peruser-30off", "targeting": { "retentionPerUserRule": {} } }پیشنهاد ویژه را قبلاز هدفیابی آن برای مشترکین فعال کنید. اگر روش
activateOfferTargetingرا برای پیشنهادی که هرگز فعال نشده است فراخوانی کنید، فراخوانی با رمز وضعیت HTTP400 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" }فراخوانی موفقیتآمیز رمز وضعیت HTTP
204 No Contentرا بدون بدنه پاسخ برمیگرداند. Google Play هدفیابی را با اشتراک ذخیره میکند، بنابراین نیازی نیست که در لحظه لغو اشتراک توسط مشترک، با میانای برنامهسازی کاربردی تماس بگیرید. دفعه بعد که مشترک شروع به لغو اشتراک در Google Play میکند، Google Play میتواند پیشنهاد را نشان دهد، بهشرطی که اشتراک شرایط صلاحیت را داشته باشد. هدفیابی براساس کاربر فقط جایگزین قوانین واجدشرایط بودن میشود کهretentionRuleتعریف میکند. همه الزامات واجدشرایط بودن دیگر و بررسیهای سطح پلاتفرم که Google Play انجام میدهد، مانند الزامات رعایت خطمشی منطقهای، همچنان اعمال میشوند.میتوانید بیشاز یک پیشنهاد حفظ کاربر را برای یک اشتراک هدفیابی کنید. برای انجام این کار، روش
activateOfferTargetingرا یکبار برای هر پیشنهاد ویژه فراخوانی کنید. Google Play همچنان حداکثر یک پیشنهاد حفظ مشتری را در جریان لغو نشان میدهد. برای جزئیات بیشتر درباره نحوه انتخاب پیشنهاد ویژه توسط Google Play، پیکربندی پیشنهادهای ویژه حفظ مشتری را ببینید.روش
activateOfferTargetingیکسانتوان است. اگر آن را برای پیشنهادی که قبلاً برای اشتراک هدفیابی شده است فراخوانی کنید، فراخوانی موفقیتآمیز خواهد بود و Google PlayactivateTimeپیشنهاد را به زمان آخرین درخواست بهروز میکند.درصورت نیاز، هدفیابی را بردارید. اگر دیگر نمیخواهید مشترکی پیشنهاد را دریافت کند، مثلاً بهدلیل تغییر ریسک ریزش او، روش
purchases.subscriptionsv2.deactivateOfferTargetingرا با همان نام بسته،purchaseToken، وofferIdفراخوانی کنید. تماس موفق رمز وضعیت HTTP204 No Contentرا بدون بدنه پاسخ برمیگرداند.روش
deactivateOfferTargetingنیز یکسانتوان است. اگر پیشنهاد اشتراک را هدفیابی نکرده باشد، مثلاً چون هرگز هدفیابی را فعال نکردهاید، فراخوانی موفقیتآمیز است و تأثیری ندارد.
هدفیابی برای یک purchaseToken اعمال میشود و تا زمانی که اشتراک فعال است و بهطور خودکار تمدید میشود، منقضی نمیشود. این نشان پساز اینکه مشترک پیشنهاد را میبیند، میپذیرد، یا رد میکند، در جای خود باقی میماند. Google Play فقط زمانی آن را برمیدارد که روش deactivateOfferTargeting را فراخوانی کنید، یا ۶۰ روز پساز انقضای اشتراک. اگر تغییر طرح یا ازسرگرفتن اشتراک باعث ایجاد purchaseToken جدیدی شود،
هدفیابی منتقل نمیشود.
برای بررسی اینکه کدام پیشنهادهای حفظ کاربر برای اشتراک هدفیابی شدهاند،
روش purchases.subscriptionsv2.get را فراخوانی کنید. فیلد developerTargetedOffers
هر مورد سطری پیشنهادهای هدفیابیشده را فهرست میکند. هر ورودی حاوی
offerId و activateTime است که هدفیابی را فعال کردهاید:
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"developerTargetedOffers": [
{
"offerId": "retention-peruser-30off",
"activateTime": "2026-12-03T15:04:05Z"
}
]
}
]
}
رسیدگی به خطاهای هدفیابی
وقتی فراخوانی روش activateOfferTargeting یا deactivateOfferTargeting ناموفق باشد، پاسخ حاوی رمز وضعیت 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 را به باطن شما ارسال میکند. پساز دریافت هر اعلان، روش purchases.subscriptionsv2.get را با purchaseToken از اعلان فراخوانی کنید تا جدیدترین وضعیت اشتراک را دریافت کنید.
پذیرفتن پیشنهاد حفظ مشتری خرید جدیدی ایجاد نمیکند. purchaseToken
تغییر نمیکند، بنابراین نیازی نیست خرید را دوباره تأیید کنید و Google
Play linkedPurchaseToken تولید نمیکند. حق استفاده فعلی مشترک را حفظ کنید. سفارش تمدید تخفیفدار را مانند هر تمدید اشتراک دیگری پردازش کنید.
| نوع اعلان | وقتی ارسال میشود | چه کاری باید انجام داد |
|---|---|---|
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) |
وقتی مشترک پیشنهاد حفظ مشتری را در جریان لغو میپذیرد. | با روش 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: زمانی که انتظار میرود شرایط پیشنهاد حفظ مشتری اعمال شود.
Google Play فقط زمانی planTransitionDetails را اضافه میکند که انتقال درحال انتظار باشد. وقتی اشتراک با قیمت تخفیفدار پیشنهاد حفظ مشتری تمدید میشود،
انتقال تکمیل میشود و 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 تخفیف پیشنهاد حفظ مشتری تکمیلشده را اعمال نمیکند. اگر پرداخت برای اولین تمدید با تخفیف رد شود، انتقال معلقه حفظ میشود و قیمت پیشنهاد حفظ مشتری هنگام بازیابی پرداخت اعمال میشود.
- صورتحساب معوق: اگر روش
purchases.subscriptionsv2.deferرا درحین انتقال پیشنهاد حفظ مشتریIN_PROGRESSفراخوانی کنید، انتقال معلق حفظ میشود و در تمدید معوق اعمال میشود. برای دریافت تاریخ تمدید جدید،expiryTimeمورد خطی را بررسی کنید. - تغییر طرح قبلاز انتقال: پیشنهاد حفظ مشتری فقط برای
purchaseTokenاشتراکی اعمال میشود که مشترک آن را پذیرفته است. اگر مشترک قبلازexpectedTransitionTimeبه طرح پایه یا اشتراک دیگری برود، Google Play یک کلید خرید جدید تولید میکند، انتقال زمانبندیشده را لغو میکند، وplanTransitionDetailsرا پاک میکند. پیشنهاد حفظ مشتری معلقه برای طرح جدید اعمال نمیشود. - لغو و بازیابی: اگر مشترک پساز پذیرفتن پیشنهاد حفظ مشتری اشتراک را لغو کند، انتقال زمانبندیشده معلق میماند و
transitionStateرویIN_PROGRESSباقی میماند. اگر مشترک اشتراک را قبلاز انقضا بازیابی کند، تخفیف پیشنهاد حفظ مشتری همچنان در تمدید اعمال میشود. - انقضا و ازسرگرفتن اشتراک: اگر اشتراک بدون بازیابی شدن منقضی شود، Google Play انتقال معلقه را لغو میکند. اگر کاربر بعداً دوباره مشترک شود یا ثبتنام کند، Google Play خرید اشتراک جدیدی ایجاد میکند و پیشنهاد حفظ مشتری که قبلاً پذیرفته شده است اعمال نمیشود.
- تغییرات پیشنهاد: اگر تخفیف یا دورههای صورتحساب پیشنهاد حفظ مشتری را تغییر دهید، این تغییر فقط برای پسخریدهای آینده اعمال میشود. مشترکینی که قبلاً پیشنهاد را پذیرفتهاند شرایط اصلی را حفظ میکنند.
- غیرفعال کردن پیشنهاد: اگر پیشنهاد حفظ مشتری را غیرفعال کنید یا پیشنهاد به تاریخ پایان خود برسد، مشترکینی که قبلاً آن را پذیرفتهاند شرایطی را که با آن موافقت کردهاند حفظ میکنند. مشترکینی که انتقال
IN_PROGRESSدارند همچنان در تمدید بعدیشان تخفیف دریافت میکنند و مشترکینی که درحالحاضر در دورههای صورتحساب تخفیفدار هستند، تخفیف را برای کل مدت توافقشده حفظ میکنند. - تغییرات قیمت: تغییرات قیمت طرح پایه همچنان اعمال میشود. Google Play مشترک را فقط زمانی به قیمت جدید منتقل میکند که مشترک قیمت معمولی را پرداخت کند و هیچ انتقال پیشنهاد حفظ مشتری معلقی نداشته باشد. برای اطلاعات بیشتر، تغییر قیمت اشتراک را ببینید.
- استرداد مبلغ: میتوانید بااستفاده از میاناهای برنامهسازی کاربردی استاندارد استرداد مبلغ و لغو، مانند روش
purchases.subscriptionsv2.revoke، مبلغ را به مشترک مسترد کنید. این جدیدترین پرداخت را مسترد میکند و دسترسی مشترک را بهپایان میرساند.
آزمایش پیشنهادهای ویژه حفظ اشتراک
Google Play فقط پیشنهادهای ویژه حفظ مشتری فعال را در جریان لغو نشان میدهد و قوانین واجدشرایط بودن را در زمان واقعی تقویم ارزیابی میکند. برای آزمایش کردن پیشنهادهای حفظ مشتری با حساب آزمونگر پروانه، از یکی از روشهای زیر استفاده کنید:
- پیشنهاد حفظ کاربر را در طرح پایه تولید آزمایش کنید، بدون اینکه پیشنهاد را به مشترکین واقعی نشان دهید.
- پیشنهاد حفظ مشتری مبتنی بر قانون را در برنامه آزمایشی یا در طرح پایه آزمایشی که کاربران نسخه تولیدی به آن دسترسی ندارند آزمایش کنید.
قبلاز استفاده از هریک از این روشها، به تنظیمات > آزمایش کردن پروانه در «کنسول Google Play» بروید و «حساب Google» آزمایشی را بهعنوان آزمونگر پروانه اضافه کنید.
آزمایش پیشنهاد ویژه حفظ اشتراک برای هر کاربر
Google Play پیشنهاد ویژه حفظ مشتری را برای هر کاربر فقط به اشتراکهایی که شما هدفیابی میکنید نشان میدهد، بنابراین میتوانید آن را در طرح پایه تولید بدون نمایش به مشترکین واقعی آزمایش کنید. برای آزمایش کردن پیشنهاد ویژه حفظ اشتراک برای هر کاربر، کارهای زیر را انجام دهید:
- پیشنهاد ویژه حفظ اشتراک برای هر کاربر را تحت طرح پایه ایجاد کنید و سپس آن را فعال کنید. در «کنسول Google Play»، پیشنهاد ویژه حفظ اشتراک در سطح کاربر را انتخاب کنید.
با Google Play Developer API،
targetingرا روی شیءretentionPerUserRuleتنظیم کنید. برای جزئیات، به هدفیابی پیشنهادهای حفظ مشتری برای مشترکین خاص مراجعه کنید. - اگر بهتازگی پیشنهاد ویژه را فعال کردهاید، ۱۰ تا ۱۵ دقیقه صبر کنید تا تغییر اعمال شود، سپس حافظه نهان برنامه «فروشگاه Google Play» را پاک کنید.
- در دستگاه آزمایشی، با حساب آزمونگر پروانه به سیستم وارد شوید، سپس طرح پایه را در برنامهتان خریداری کنید.
- از باطن خود، روش
purchases.subscriptionsv2.activateOfferTargetingرا با نام بسته برنامهتان،purchaseTokenآزمایشکننده پروانه، وofferIdپیشنهاد حفظ مشتری فراخوانی کنید. - در برنامه «فروشگاه Google Play»، به پرداختها و اشتراکها > اشتراکها بروید، اشتراک را انتخاب کنید، و روی لغو اشتراک ضربه بزنید. پیشنهاد حفظ مشتری در جریان لغو ظاهر میشود.
- پیشنهاد را بپذیرید، سپس تأیید کنید که پسای شما
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDRTDN را دریافت میکند و تمدید تخفیفدار را مدیریت میکند.
آزمایش پیشنهاد ویژه حفظ اشتراک مبتنی بر قانون
پساز فعال کردن پیشنهاد حفظ مشتری مبتنی بر قانون، Google Play میتواند آن را به هر مشترک واجدشرایطی در طرح پایه نشان دهد. برای جلوگیری از نمایش پیشنهاد به کاربران تولید، آن را در یک برنامه آزمایشی غیرتولید یا در یک طرح پایه آزمایشی اختصاصی که کاربران تولید به آن دسترسی ندارند آزمایش کنید. برای آزمایش پیشنهاد ویژه حفظ اشتراک مبتنی بر قانون، کارهای زیر را انجام دهید:
- در برنامه آزمایشی یا طرح پایه آزمایشیتان، پیشنهاد حفظ مشتری مبتنی بر قانون ایجاد کنید و
minDurationرا رویP0D(۰ روز) تنظیم کنید. در «کنسول Google Play»، پیشنهاد ویژه حفظ اشتراک در سطح همگروه را انتخاب کنید. با Google Play Developer API،targetingرا روی شیءretentionRuleتنظیم کنید. برای جزئیات، تنظیم قوانین واجدشرایط بودن برای نگهداری را ببینید. - پیشنهاد را فعال کنید، ۱۰ تا ۱۵ دقیقه صبر کنید تا تغییر اعمال شود، و سپس حافظه نهان برنامه «فروشگاه Google Play» را پاک کنید.
- در دستگاه آزمایشی، با حساب آزمونگر پروانه به سیستم وارد شوید و سپس طرح پایه آزمایشی را خریداری کنید.
- در برنامه «فروشگاه Google Play»، به پرداختها و اشتراکها > اشتراکها بروید، اشتراک را انتخاب کنید، و روی لغو اشتراک ضربه بزنید. چون این پیشنهاد به حداقل مدت اشتراک پولی نیاز ندارد، میتوانید بلافاصله پساز خرید، فرایند لغو را شروع کنید. پیشنهاد حفظ مشتری در جریان لغو نشان داده میشود.
- پیشنهاد را بپذیرید، سپس تأیید کنید که پسای شما
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDRTDN را دریافت میکند و تمدید تخفیفدار را مدیریت میکند.
پساز درستیسنجی ادغام، پیشنهاد حفظ مبتنی بر قانون را در طرح پایه تولید ایجاد و فعال کنید.
عیبیابی کردن آزمایش پیشنهاد ویژه حفظ اشتراک
اگر پیشنهاد حفظ مشتری نشان داده نمیشود، موارد زیر را بررسی کنید:
- پیشنهاد ویژه حفظ مشتری فعال است و زمان فعلی بین
startTimeوendTimeاست (اگر آنها را تنظیم کرده باشید). - برای پیشنهاد ویژه حفظ اشتراک بهازای هر کاربر، فیلد
developerTargetedOffersدر پاسخpurchases.subscriptionsv2.getبرایpurchaseTokenآزمایشکننده پروانه شامل پیشنهاد ویژه است. - اشتراک یک اشتراک تکی است، نه اشتراک دارای برافزا.
- اشتراک در مهلت ارفاقی، تعلیق حساب، یا توقف موقت نباشد.
- اشتراک هیچ تغییر طرح یا تغییر قیمت معلقهای ندارد.
- تمدید بعدی با قیمت معمول طرح پایه انجام میشود. برای دورههای آزمایشی رایگان و پیشنهادهای ویژه مقدماتی، پیشنهاد ویژه حفظ کاربر فقط درطول آخرین دوره صورتحساب دوره آزمایشی یا مرحله مقدماتی دردسترس است.
- ۱۰ تا ۱۵ دقیقه پساز فعال کردن یا تغییر پیشنهاد ویژه صبر کردهاید و حافظه نهان برنامه «فروشگاه Play» را پاک کردهاید.