این سند نحوه مدیریت رویدادهای چرخه حیات اشتراک، مانند تمدید و انقضا را شرح میدهد. همچنین ویژگیهای اضافی اشتراک را شرح میدهد، مثل ارائه تبلیغات و اجازه دادن به کاربران برای مدیریت اشتراکهای خودشان.
اگر محصولات آبونهای را برای برنامهتان پیکربندی نکردهاید، به ایجاد و پیکربندی محصولات مراجعه کنید.
نمای کلی اشتراکها
اشتراک تراکنشی تکرارشونده است که حقوق خاصی را به کاربران اعطا میکند. حقوق استفاده نشاندهنده مجموعهای از مزایا است که کاربران میتوانند درطول دوره زمانی مشخصی به آنها دسترسی داشته باشند. برای مثال، اشتراک ممکن است به کاربر حق دسترسی به ویژگیهای پولی را بدهد.
ازطریق طرحهای پایه و پیشنهادها، میتوانید چندین پیکربندی برای یک محصول اشتراکی ایجاد کنید. برای مثال، میتوانید پیشنهاد مقدماتی برای کاربرانی که هرگز در برنامهتان مشترک نشدهاند ایجاد کنید. بهطور مشابه، میتوانید پیشنهاد ارتقا برای کاربرانی که قبلاً مشترک شدهاند ایجاد کنید.
برای نمای کلی دقیق از محصولات اشتراکی، طرحهای پایه، و پیشنهادها، به اسناد موجود در مرکز راهنمایی کنسول Play مراجعه کنید.
«کتابخانه خدمات صورتحساب Play» از انواع اشتراک زیر پشتیبانی میکند:
اشتراک - در این نوع، یک مورد با یک حق استفاده مطابقت دارد. برای مثال، اشتراک در سرویس جاریسازی موسیقی.
اشتراک با برافزا - در این نوع، یک خرید میتواند چندین حق استفاده متمایز را در یک خرید واحد داشته باشد. برای مثال، اشتراک در سرویس جاریسازی موسیقی و اشتراک ویدیو. برای اطلاعات خاص مربوط به اشتراک با برافزا، به اشتراکهای با برافزا مراجعه کنید.
ادغام طرحهای پیشپرداخت
طرحهای پیشپرداخت پساز انقضا بهطور خودکار تمدید نمیشوند. برای تمدید کردن حق اشتراک بدون وقفه، کاربر باید طرح پیشپرداخت را برای همان اشتراک افزایش موجودی کند.
برای افزودن موجودی، جریان صورتحساب را همانطور که برای خرید اصلی انجام میدهید راهاندازی کنید. لازم نیست مشخص کنید که خرید از نوع افزایش موجودی است.
افزودن موجودی طرح پیشپرداخت همیشه از حالت جایگزینی CHARGE_FULL_PRICE استفاده میکند و
نیازی نیست این حالت را بهطور صریح تنظیم کنید. هزینه یک دوره صورتحساب کامل بلافاصله از کاربر کسر میشود و حق استفاده او بهمدت مشخصشده در افزایش موجودی تمدید میشود.
پساز افزودن موجودی، فیلدهای زیر در
Purchase شیء نتیجه
بهروزرسانی میشوند تا جدیدترین خرید افزودن موجودی را نشان دهند:
- شناسه سفارش
- زمان خرید
- امضا
- کد خرید
- تصدیق شده
فیلدهای Purchase زیر همیشه حاوی همان دادههای موجود در خرید اصلی هستند:
- نام بسته
- وضعیت خرید
- محصولات
- تمدید خودکار
اعلامیه خرید پیشپرداخت
مشابه اشتراکهای تمدید خودکار، باید طرحهای پیشپرداخت را پساز خرید تأیید کنید. هم خرید اولیه و هم هرگونه افزایش موجودی باید تأیید شود. برای اطلاعات بیشتر، پردازش خریدها را ببینید.
بهدلیل احتمال کوتاه بودن مدت طرح پیشپرداخت، مهم است که خرید را در اسرع وقت تأیید کنید.
طرحهای پیشپرداخت با مدت یک هفته یا بیشتر باید ظرف سه روز تأیید شوند.
طرحهای پیشپرداخت با مدت کمتر از یک هفته باید ظرف نیمی از مدت طرح تأیید شوند. برای مثال، توسعهدهندگان ۱٫۵ روز فرصت دارند تا طرح پیشپرداخت سهروزه را تأیید کنند.
ادغام اشتراکهای قسطی
اشتراک قسطی نوعی اشتراک است که در آن کاربران هزینه اشتراک را در چند قسط درطول یک دوره زمانی پرداخت میکنند، بهجای اینکه کل هزینه اشتراک را پیشاپیش پرداخت کنند.
ملاحظات بیشتر برای اشتراکهای قسطی:
- دردسترس بودن در کشورها: ویژگی اشتراکهای قسطی فقط در اسپانیا، ایتالیا، برزیل، و فرانسه دردسترس است (برای اطلاع از جدیدترین موارد دردسترس بودن، «کنسول» را بررسی کنید).
- تنظیم قیمت: هنگام تنظیم قیمت برای اشتراک اقساطی در «کنسول»، قیمت نشاندهنده مبلغ پرداخت ماهانه است. این مورد، در ترکیب با دوره تعهد تنظیمشده، مبلغ کل اشتراک را در صفحه خرید ایجاد میکند.
- دوره تعهد: مدت کل تعهد اشتراک اولیه که درطول آن پرداختهای ماهانه الزامی است. برای مثال، اگر طرح پایهای دوره تعهد ۱۵ ماهه داشته باشد، کاربر ۱۵ پرداخت ماهانه درطول این دوره انجام خواهد داد.
- تمدیدها: درزمینه اشتراکهای قسطی، «تمدید» بهمعنای پایان دوره تعهد است، خواه دوره تعهد اولیه باشد یا دوره تعهد بعدی. پساز ثبتنام اولیه، اولین تمدید پساز تکمیل کل دوره تعهد اولیه انجام میشود. تمدیدهای بعدی پساز تکمیل هر دوره تعهد بعدی انجام میشود. نوع تمدید برای اشتراکهای قسطی میتواند «تمدید خودکار ماهانه» یا «تمدید خودکار برای مدتزمان یکسان» باشد. برای «تمدید خودکار ماهانه»، تعهد بعدی وجود ندارد و طرح مانند اشتراک ماهانه عمل میکند که در آن هر هزینه اشتراک ماهانه بهمنزله تمدید است.
- دوره صورتحساب: در زمینه اشتراکهای قسطی، این به فاصله تکرارشوندهای اشاره دارد که در آن پرداختهای فردی انجام میشود، همانطور که در طرح پایه مشخص شده است.
- رفتارهای تغییر طرح درمقابل تغییر قیمت: برای تغییرات قیمت و لغو، تعهد قطعی است. یعنی اگر کاربری بخواهد اشتراک را لغو کند یا توسعهدهندهای بخواهد قیمت را تغییر دهد، این تغییر در پایان دوره تعهد اعمال میشود. برای تغییرات طرح، تعهد قطعی نیست. این یعنی تغییر طرح نباید تا پایان دوره تعهد منتظر بماند، بلکه براساس حالت جایگزینی تنظیمشده، فوراً یا در تاریخ پرداخت بعدی اعمال میشود.
- تغییر طرح اشتراک یکسان: تغییر طرح از طرح پایه اقساطی به طرح پایه غیراقساطی برای همان محصول اشتراکی مجاز نیست.
اعلانهای بیدرنگ توسعهدهنده (RTDN):
SUBSCRIPTION_CANCELLATION_SCHEDULEDRTDN بلافاصله پساز لغو ازسوی کاربر ارسال میشود، درحالیکه پرداختها برای دوره تعهد باقی میماند. لغو اشتراک معلقه است و فقط در پایان دوره تعهد اعمال خواهد شد. سپس، اگر کاربر آن را بازیابی نکند،SUBSCRIPTION_CANCELEDوSUBSCRIPTION_EXPIREDRTDN در پایان دوره تعهد ارسال میشود.پرداختها / تحقق درآمد: پرداختهای توسعهدهنده زمانی انجام میشود که کاربران پرداختهای ماهانه خود را انجام دهند، مشروط به همان شرایطی که برای سایر اشتراکها اعمال میشود. وقتی کاربر برای اشتراک قسطی ثبتنام میکند، توسعهدهندگان پیشپرداخت دریافت نمیکنند.
وصول پرداختهای انجامنشده: اگر کاربری نتواند هیچیک از پرداختهای اشتراک قسطی را انجام دهد، نه Google و نه «توسعهدهنده» هیچکدام برای وصول این پرداختهای انجامنشده یا معوقه از کاربر تلاش نخواهند کرد، بهجز اینکه Google ممکن است بهطور دورهای درطول هر «مهلت ارفاقی» یا دوره «تعلیق حساب» قابلاجرا، مطابق با رویههای معمول خود برای تلاش مجدد پرداخت، دوباره برای دریافت پرداخت تلاش کند. Google درقبال پرداختهای قسطی پرداختنشده باقیمانده به «توسعهدهنده» مسئولیتی نخواهد داشت.
دردسترس بودن «کتابخانه خدمات صورتحساب Play»: فیلد
installmentDetailsفقط برای PBL 7 یا جدیدتر دردسترس است. برای PBL 5 و نسخههای جدیدتر، اشتراک قسطی بااستفاده ازqueryProductDetails()برگردانده میشود، اما اشتراک شامل اطلاعات دقیق قسطی مانند تعداد پرداختهای متعهدشده طرح نخواهد بود.
استفاده از پیوندهای عمیق برای اینکه کاربران بتوانند اشتراک را مدیریت کنند
برنامه شما باید پیوندی در صفحه تنظیمات یا اولویتها داشته باشد که به کاربران اجازه دهد اشتراکهایشان را مدیریت کنند. میتوانید این پیوند را در ظاهر و حس طبیعی برنامهتان بگنجانید.
میتوانید پیوند عمیقی از برنامهتان به مرکز اشتراکهای Google Play برای اشتراکهای منقضینشده اضافه کنید که میتوانید آن را بااستفاده از فیلد subscriptionState از منبع اشتراک تعیین کنید. براساس این،
چند روش وجود دارد که میتوانید پیوند عمیق به مرکز اشتراکهای «فروشگاه Play» ایجاد کنید.
پیوند به مرکز اشتراکها
از نشانی وب زیر برای هدایت کاربران به صفحهای که همه اشتراکهایشان را نشان میدهد استفاده کنید، همانطور که در شکلهای ۱ و ۲ نشان داده شده است:
https://play.google.com/store/account/subscriptions
این پیوند عمیق میتواند برای کمک به کاربر در بازیابی اشتراک لغوشده از مرکز اشتراکهای «فروشگاه Play» مفید باشد.
پیوند به صفحه مدیریت اشتراک خاص (توصیه میشود)
برای پیوند دادن مستقیم به صفحه مدیریت اشتراک منقضینشده، نام بسته و productId مرتبط با اشتراک خریداریشده را مشخص کنید. برای تعیین برنامهنویسیشده productId برای اشتراک موجود، باطن برنامهتان را پُرسمان کنید یا برای دریافت فهرست اشتراکهای مرتبط با کاربر خاصی، BillingClient.queryPurchasesAsync() را فراخوانی کنید. هر اشتراک حاوی
productId مربوطه بهعنوان بخشی از اطلاعات وضعیت اشتراک است.
هر شیء SubscriptionPurchaseLineItem مرتبط با خرید اشتراک حاوی مقدار productId مرتبط با اشتراکی است که کاربر در آن قلم کالا خریداری کرده است.
از نشانی وب زیر برای هدایت کاربران به صفحه مدیریت اشتراک خاصی استفاده کنید،
«your-sub-product-id» و «your-app-package» را بهترتیب با
productId و نام بسته برنامه جایگزین کنید:
https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package
سپس کاربر میتواند روشهای پرداخت خود را مدیریت کند و به ویژگیهایی ازجمله لغو، ازسرگیری اشتراک، و توقف موقت دسترسی داشته باشد.
به کاربران اجازه دهید اشتراکشان را ارتقا یا تنزل دهند یا آن را تغییر دهند
میتوانید گزینههای مختلفی را برای تغییر طرح اشتراک به مشترکین فعلی ارائه دهید تا نیازهایشان بهتر برآورده شود:
- اگر چند سطح اشتراک میفروشید، مثلاً اشتراک «پایه» و «ممتاز»، میتوانید به کاربران اجازه دهید با خریدن طرح پایه یا پیشنهاد اشتراکی متفاوت، سطح اشتراکشان را تغییر دهند.
- میتوانید به کاربران اجازه دهید دوره صورتحساب فعلیشان را تغییر دهند، مثلاً از طرح ماهانه به طرح سالانه بروند.
- همچنین میتوانید به کاربران اجازه دهید بین طرحهای تمدید خودکار و پیشپرداخت جابهجا شوند.
با ارائه پیشنهادهای اشتراک برای ارائه تخفیف به کاربران واجدشرایط، میتوانید هرکدام از این تغییرات را تشویق کنید. برای مثال، میتوانید پیشنهادی ایجاد کنید که هنگام جابهجایی از طرح ماهانه به طرح سالانه، ۵۰٪ تخفیف برای سال اول ارائه دهد و این پیشنهاد را به کاربرانی محدود کنید که مشترک طرح ماهانه هستند و این پیشنهاد را خریداری نکردهاند. اطلاعات بیشتر درباره معیارهای واجدشرایط بودن برای پیشنهاد در «مرکز راهنمایی» دردسترس است
شکل ۳ نمونه برنامهای را با سه طرح مختلف نشان میدهد:
برنامه شما میتواند صفحهای مشابه شکل ۳ نشان دهد و به کاربران گزینههایی برای تغییر اشتراکشان ارائه دهد. در همه موارد، باید برای کاربران مشخص باشد که طرح اشتراک فعلیشان چیست و چه گزینههایی برای تغییر آن دارند.
وقتی کاربران تصمیم میگیرند اشتراکشان را ارتقا دهند، تنزل دهند، یا تغییر دهند، شما حالت جایگزینی را مشخص میکنید که تعیین میکند مقدار سرشکنشده دوره صورتحساب پولی فعلی چگونه اعمال شود و چه زمانی تغییر حق استفاده رخ دهد.
حالتهای جایگزین
جدول زیر حالتهای جایگزینی دردسترس و نمونه استفاده را فهرست میکند، و تعداد پرداختهایی که پرداختشده درنظر گرفته میشود.
حالت جایگزینی |
شرح |
نمونه استفاده |
پرداختهای تعهدشده که بهعنوان پرداختشده ثبت شدهاند (برای جایگزینی اشتراک قسطی) |
|
مورد اشتراک بلافاصله ارتقا یا تنزل مییابد. هر زمان باقیمانده براساس تفاوت قیمت تنظیم میشود و با جلو بردن تاریخ صورتحساب بعدی، به اشتراک جدید اعتبار داده میشود. این رفتار پیشفرض است. |
به سطح گرانتری ارتقا دهید، بدون اینکه فوراً پرداخت اضافی داشته باشید. |
0 |
|
مورد اشتراک بلافاصله ارتقا مییابد و چرخه صورتحساب بدون تغییر باقی میماند. سپس تفاوت قیمت برای دوره باقیمانده از کاربر کسر میشود. توجه: این گزینه فقط برای ارتقای محصول اشتراکی دردسترس است که در آن قیمت هر واحد زمانی افزایش مییابد. |
ارتقا به سطح گرانتر، بدون تغییر تاریخ صورتحساب. |
1 |
|
مورد اشتراک بلافاصله ارتقا یا تنزل مییابد و بلافاصله قیمت کامل حق استفاده جدید از کاربر کسر میشود. مقدار باقیمانده از اشتراک قبلی یا برای همان حق استفاده منتقل میشود یا هنگام جابهجایی به حق استفاده متفاوت، بهصورت تناسبی برای زمان محاسبه میشود. توجه: اگر اشتراک جدید دوره آزمایشی رایگان یا پیشنهاد مقدماتی داشته باشد، در زمان ارتقا یا تنزل، بسته به اینکه کدامیک اعمال شود، از کاربر ۰ دلار یا قیمت پیشنهاد مقدماتی کسر میشود. |
ارتقا دادن از دوره صورتحساب کوتاهتر به دوره صورتحساب طولانیتر. |
۱ (توجه: اگر اشتراک جدید دوره آزمایشی رایگان داشته باشد، ۰ است.) |
|
مورد اشتراک بلافاصله ارتقا یا تنزل مییابد و قیمت جدید هنگام تمدید اشتراک کسر میشود. چرخه صورتحساب بدون تغییر باقی میماند. |
به سطح اشتراک بالاتری ارتقا دهید و درعینحال هرگونه دوره رایگان باقیمانده را حفظ کنید. |
0 |
|
مورد اشتراک فقط زمانی ارتقا یا تنزل مییابد که اشتراک تمدید شود، اما خرید جدید بلافاصله با دو مورد زیر صادر میشود:
توجه: برای اشتراکهای قسطی، تغییر طرح در شروع تاریخ پرداخت بعدی اتفاق میافتد. |
به سطح ارزانتری تنزل دهید. |
1 |
|
برنامه زمانی پرداخت برای مورد اشتراک در جایگزینی بدون تغییر باقی میماند. |
افزودن یا برداشتن مورد اشتراک از اشتراک دارای برافزا وقتی مورد خاصی نباید تغییر کند. |
موجود نیست |
برای کسب اطلاعات بیشتر درباره کاربردهای مختلف بیشفروشی و بازگرداندن مشتریان ازطریق پیشنهادهای ارتقا یا تنزل، راهنمای پیشنهادهای ویژه و تبلیغات را بخوانید.
تنظیم حالت جایگزینی برای خرید
میتوانید از حالتهای جایگزینی مختلفی برای انواع مختلف انتقال اشتراک استفاده کنید، که براساس اولویتها و منطق کسبوکارتان است. این بخش توضیح میدهد که چگونه یک حالت جایگزینی برای تغییر در اشتراک تنظیم کنید و محدودیتهایی که اعمال میشود را شرح میدهد.
ازسر گرفتن اشتراک یا تعویض طرح در همان اشتراک
میتوانید حالت جایگزینی پیشفرضی را در «کنسول Google Play» مشخص کنید. این
تنظیم به شما امکان میدهد انتخاب کنید اگر مشترکین فعلیْ طرح پایه یا پیشنهادی متفاوت برای اشتراک فعلیشان بخرند یا پساز لغو کردن، اشتراکشان را ازسر بگیرند، چه زمانی هزینه از حسابشان کسر شود. گزینههای دردسترس عبارتاند از کسر هزینه فوری، معادل
CHARGE_FULL_PRICE، و کسر هزینه در تاریخ صورتحساب بعدی، معادل
WITHOUT_PRORATION. اینها تنها حالتهای جایگزینی مربوط هنگام
عوض کردن طرحهای پایه در همان اشتراک هستند.
برای مثال، اگر پساز لغو کاربر اما قبلاز پایان اشتراک، پیشنهاد بازگرداندن مشتری را برای همان طرح اجرا میکنید، میتوانید خرید جدید را بهعنوان خرید معمولی بدون نشان دادن هیچ مقداری در SubscriptionUpdateParams پردازش کنید. سیستم از حالت جایگزینی پیشفرضی که در اشتراک پیکربندی کردهاید استفاده میکند و بهطور خودکار انتقال طرح از خرید قدیمی به خرید جدید را مدیریت میکند.
جابهجایی بین طرحها در اشتراکها، یا لغو حالت جایگزینی پیشفرض
اگر کاربر درحال تغییر محصولات اشتراک است—درحال خرید اشتراک دیگری است—یا اگر میخواهید حالت جایگزینی پیشفرض را به هر دلیلی لغو کنید، نرخ تناسبی را در زمان اجرا بهعنوان بخشی از پارامترهای جریان خرید مشخص میکنید.
برای ارائه صحیح
ReplacementMode
در SubscriptionProductReplacementParams یا SubscriptionUpdateParams بهعنوان بخشی
از پیکربندی جریان خرید زمان اجرای خود، به محدودیتهای زیر توجه کنید:
- هنگام ارتقا، تنزل، یا شروع جابهجایی به اشتراک یکسان
به طرح پیشپرداخت از طرح پیشپرداخت، طرح تمدید خودکار، یا
طرح اقساطی، تنها حالت جایگزینی مجاز
CHARGE_FULL_PRICEاست. اگر حالت جایگزینی دیگری را مشخص کنید، خرید ناموفق خواهد بود و خطایی به کاربر نشان داده میشود. - هنگام جابهجایی طرحها در همان اشتراک به طرح تمدید خودکار از طرح پیشپرداخت یا طرح تمدید خودکار، حالتهای تناسبی معتبر
CHARGE_FULL_PRICEوWITHOUT_PRORATIONهستند. اگر حالت تناسبی دیگری را مشخص کنید، خرید ناموفق خواهد بود و خطایی به کاربر نشان داده میشود. - تعویض طرحها در همان محصول اشتراکی از طرح پایه اقساطی به طرح پایه غیراقساطی مجاز نیست.
- هنگام استفاده از حالت جایگزینی
KEEP_EXISTINGدرSubscriptionProductReplacementParamsبرای بدون تغییر نگه داشتن پرداخت محصول درطول جایگزینی، شناسه محصول قدیمی باید با شناسه محصول جدید یکسان باشد. حالتKEEP_EXISTINGدرSubscriptionUpdateParamsپشتیبانی نمیشود.
نمونهها و رفتارهای جایگزین
برای درک نحوه عملکرد هر حالت تناسبی، سناریو زیر را درنظر بگیرید:
سام اشتراک محتوای آنلاین از برنامه Country Gardener دارد. او اشتراک ماهانه نسخه سطح ۱ محتوا را دارد که فقط نوشتاری است. این اشتراک برای او ۲ دلار در ماه هزینه دارد و در روز اول ماه تمدید میشود.
در ۱۵ آوریل، Samwise تصمیم میگیرد به نسخه سالانه اشتراک سطح ۲ ارتقا دهد که شامل بهروزرسانیهای ویدیو است و ۳۶ دلار در سال هزینه دارد.
هنگام ارتقا دادن اشتراک، توسعهدهنده حالت تناسبی را انتخاب میکند. فهرست زیر توضیح میدهد که هر حالت تناسبی چگونه بر اشتراک Samwise تأثیر میگذارد:
WITH_TIME_PRORATION
اشتراک سطح ۱ Samwise بلافاصله بهپایان میرسد. چون او برای یک ماه کامل (۱ تا ۳۰ آوریل) پرداخت کرده است اما در نیمه دوره اشتراک ارتقا داده است، نصف اشتراک یک ماه (۱ دلار) برای اشتراک جدید او اعمال میشود. بااینحال، چون هزینه اشتراک جدید ۳۶ دلار در سال است، موجودی اعتبار ۱ دلاری فقط هزینه ۱۰ روز (۱۶ تا ۲۵ آوریل) را پرداخت میکند؛ بنابراین در ۲۶ آوریل، ۳۶ دلار برای اشتراک جدید از او کسر میشود و در ۲۶ آوریل هر سال بعداز آن نیز ۳۶ دلار دیگر از او کسر میشود.
باید PurchasesUpdatedListener برنامهتان را بهمحض موفقیتآمیز بودن خرید فراخوانی کنید و بتوانید خرید جدید را بهعنوان بخشی از فراخوانی queryPurchasesAsync() بازیابی کنید. بخش پشتی شما بلافاصله
SUBSCRIPTION_PURCHASED «اعلان بیدرنگ توسعهدهنده» دریافت میکند.
CHARGE_PRORATED_PRICE
از این حالت میتوان استفاده کرد زیرا قیمت اشتراک سطح ۲ بهازای هر واحد زمانی (۳۶ دلار در سال = ۳ دلار در ماه) بیشتر از قیمت اشتراک سطح ۱ بهازای هر واحد زمانی (۲ دلار در ماه) است. اشتراک سطح ۱ Samwise بلافاصله بهپایان میرسد. چون او هزینه یک ماه کامل را پرداخت کرده است اما فقط از نیمی از آن استفاده کرده است، اشتراک نیم ماه (۱ دلار) برای اشتراک جدید او اعمال میشود. اما چون هزینه اشتراک جدید ۳۶ دلار در سال است، هزینه ۱۵ روز باقیمانده ۱٫۵۰ دلار میشود؛ بنابراین، تفاوت ۰٫۵۰ دلاری برای اشتراک جدید از او کسر میشود. در ۱ مه، ۳۶ دلار برای سطح اشتراک جدید از حساب سام کسر میشود و در ۱ مه هر سال بعداز آن نیز ۳۶ دلار دیگر از حساب او کسر میشود.
باید PurchasesUpdatedListener برنامهتان را بهمحض موفقیتآمیز بودن خرید فراخوانی کنید و بتوانید خرید جدید را بهعنوان بخشی از فراخوانی queryPurchasesAsync() بازیابی کنید. بخش پشتی شما بلافاصله
SUBSCRIPTION_PURCHASED «اعلان بیدرنگ توسعهدهنده» دریافت میکند.
WITHOUT_PRORATION
اشتراک سطح ۱ Samwise بلافاصله بدون هزینه اضافی به سطح ۲ ارتقا مییابد و در ۱ مه، ۳۶ دلار برای سطح اشتراک جدیدش از او کسر میشود و در ۱ مه هر سال بعداز آن نیز ۳۶ دلار دیگر از او کسر میشود.
باید PurchasesUpdatedListener برنامهتان را بهمحض موفقیتآمیز بودن خرید فراخوانی کنید و بتوانید خرید جدید را بهعنوان بخشی از فراخوانی queryPurchasesAsync() بازیابی کنید. بخش پشتی شما بلافاصله
SUBSCRIPTION_PURCHASED «اعلان بیدرنگ توسعهدهنده» دریافت میکند.
DEFERRED
اشتراک سطح ۱ Samwise تا زمان انقضا در ۳۰ آوریل ادامه مییابد. در ۱ مه، اشتراک سطح ۲ اعمال میشود و از Samwise مبلغ ۳۶ دلار برای سطح اشتراک جدیدش کسر میشود.
باید PurchasesUpdatedListener برنامهتان را بهمحض موفقیتآمیز بودن خرید فراخوانی کنید و بتوانید خرید جدید را بهعنوان بخشی از فراخوانی queryPurchasesAsync() بازیابی کنید. بخش پشتی شما بلافاصله
SUBSCRIPTION_PURCHASED «اعلان بیدرنگ توسعهدهنده» دریافت میکند. باید خرید را
پردازش کنید، همانطور که هر خرید جدید دیگری را در آن
موقعیت پردازش میکنید. بهویژه، مطمئن شوید که خرید جدید را تأیید میکنید. توجه داشته باشید که
startTime اشتراک جدید در لحظهای که جایگزینی
اجرا میشود (یعنی زمانی که اشتراک قدیمی منقضی میشود) پر میشود. در آن زمان،
SUBSCRIPTION_RENEWED RTDN برای طرح اشتراک جدید دریافت میکنید. درباره رفتار ReplacementMode.DEFERRED در مدیریت جایگزینی معوق بیشتر بخوانید.
CHARGE_FULL_PRICE
اشتراک سطح ۱ Samwise بلافاصله بهپایان میرسد. اشتراک سطح ۲ او امروز شروع میشود و ۳۶ دلار از او کسر میشود. چون او هزینه یک ماه کامل را پرداخت کرده است اما فقط از نیمی از آن استفاده کرده است، نیمی از اشتراک یک ماهه (۱ دلار) به اشتراک جدید او اعمال میشود. چون هزینه اشتراک جدید ۳۶ دلار در سال است، ۱/۳۶ سال به دوره اشتراک او اضافه میشود (حدود ۱۰ روز). بنابراین، هزینه بعدی Samwise یک سال و ۱۰ روز دیگر بهمبلغ ۳۶ دلار از حسابش کسر میشود. پساز آن، هر سال ۳۶ دلار از او کسر میشود.
هنگام انتخاب حالت تناسبی، حتماً توصیههای جایگزینی ما را مرور کنید.
KEEP_EXISTING
ساموایز اشتراک محتوای آنلاین از برنامه Country Gardener دارد. او اشتراک ماهانه «طرح ۱» برای محتوای پایه دارد. قیمت آغازین این اشتراک ۲ دلار در ماه برای ۳ ماه و سپس ۴ دلار در ماه است. Samwise این را در ۱ آوریل خریداری کرد. برنامه Country Gardener «طرح ۲» را بهعنوان محتوای تخصصی برافزا با قیمت ۳ دلار در ماه ارائه میدهد. در ۱۵ آوریل، Samwise «طرح ۲» را به اشتراک برنامه Country Gardener خود اضافه کرد و «طرح ۱» موجود را نیز نگه داشت. برنامه زمانی پرداخت Samwise بهصورت زیر است:
- قیمت تناسبی ۱٫۵۰ دلار برای «طرح ۲»، با سررسید ۱۵ آوریل.
- قیمت ۵٫۰۰ دلار در ماه برای ۲ ماه بعدی که هم قیمت آغازین «طرح ۱» و هم قیمت معمول «طرح ۲» را پوشش میدهد.
- پساز آن، پرداخت ماهانه ثابت ۷٫۰۰ دلار.
راهاندازی تغییرات اشتراک درونبرنامه
برنامه شما میتواند بااستفاده از همان مراحل راهاندازی جریان خرید، به کاربران ارتقا یا تنزل ارائه دهد. بااینحال، هنگام ارتقا یا تنزل، باید جزئیات اشتراک فعلی، اشتراک آینده (ارتقایافته یا تنزلیافته)، و حالت جایگزینی را که باید استفاده شود ارائه دهید.
از SubscriptionProductReplacementParams برای جایگزینی استفاده کنید (ترجیح داده میشود)
مثال زیر نحوه بهروزرسانی اشتراک را بااستفاده از
SubscriptionProductReplacementParams نشان میدهد.
اکنون شیء
BillingFlowParams.ProductDetailsParamsدارای روشsetSubscriptionProductReplacementParams()برای مشخص کردن اطلاعات جایگزینی سطح محصول است.SubscriptionProductReplacementParamsدو روش تنظیمکننده دارد:setOldProductId:این محصول قدیمی است که باید با محصول موجود درProductDetails.فعلی جایگزین شودsetReplacementMode:این حالت جایگزینی سطح مورد است. حالتهای اساساً همانSubscriptionUpdateParamsهستند، اما نگاشت مقدار بهروز شده است.
پارامترهای بهروزرسانی سطح خرید موجود
BillingFlowParams.setSubscriptionUpdateParams()باید باsetOldPurchaseToken()ساخته شود.وقتی
setSubscriptionProductReplacementParams()برای هریک ازProductDetailsParamsفراخوانی شود،SubscriptionUpdateParams.setSubscriptionReplacementMode()تأثیری نخواهد داشت.
نمونه کد زیر نشان میدهد که چگونه طرح اشتراک را
از (old_product_1، old_product_2) به (product_1، product_2،
product_3) تغییر دهید. در این سناریو، product_1 جایگزین old_product_1 میشود،
product_2 جایگزین old_product_2 میشود، و product_3 بلافاصله به
اشتراک اضافه میشود.
کاتلین
val billingClient: BillingClient = this.billingClient val replacementModeForBasePlan: Int = SubscriptionProductReplacementParams.ReplacementMode.KEEP_EXISTING val replacementModeForAddon: Int = SubscriptionProductReplacementParams.ReplacementMode.CHARGE_PRORATED_PRICE val purchaseTokenOfExistingSubscription: String = "your_old_purchase_token" // ProductDetails instances obtained from queryProductDetailsAsync(); val productDetailsParams1 = ProductDetailsParams.newBuilder() .setProductDetails(productDetails1) // Required: Set the ProductDetails object .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_1") .setReplacementMode(replacementModeForBasePlan) .build() ) .build() val productDetailsParams2 = ProductDetailsParams.newBuilder() .setProductDetails(productDetails2) // Required: Set the ProductDetails object .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_2") .setReplacementMode(replacementModeForAddon) .build() ) .build() // Example for a third item without replacement params val productDetailsParams3 = ProductDetailsParams.newBuilder() .setProductDetails(productDetails3) // Required: Set the ProductDetails object .build() val newProductDetailsList = listOf( productDetailsParams1, productDetailsParams2, productDetailsParams3 ) val billingFlowParams = BillingFlowParams.newBuilder() .setSubscriptionUpdateParams( SubscriptionUpdateParams.newBuilder() .setOldPurchaseToken(purchaseTokenOfExistingSubscription) .build() ) .setProductDetailsParamsList(newProductDetailsList) .build() // To launch the billing flow: billingClient.launchBillingFlow(activity, billingFlowParams)
جاوا
BillingClient billingClient = …; int replacementModeForBasePlan =…; int replacementModeForAddon =…; // ProductDetails obtained from queryProductDetailsAsync(). ProductDetailsParams productDetails1 = ProductDetailsParams.newBuilder() .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_1") .setReplacementMode(replacementModeForBasePlan)) .build(); ProductDetailsParams productDetails2 = ProductDetailsParams.newBuilder() .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_2") .setReplacementMode(replacementModeForAddon)) .build(); ProductDetailsParams productDetails3 = ...; ArrayListnewProductDetailsList = new ArrayList<>(); newProductDetailsList.add(productDetails1); newProductDetailsList.add(productDetails2); newProductDetailsList.add(productDetails3); BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder() .setSubscriptionUpdateParams( SubscriptionUpdateParams.newBuilder() .setOldPurchaseToken(purchaseTokenOfExistingSubscription) .build()) .setProductDetailsParamsList(productDetailsList) .build(); billingClient.launchBillingFlow(billingFlowParams);
تنظیم SubscriptionUpdateParams برای جایگزینی (منسوخشده)
مثال زیر نحوه بهروزرسانی اشتراک را بااستفاده از
SubscriptionUpdateParams نشان میدهد.
کاتلین
val offerToken = productDetails .getSubscriptionOfferDetails(selectedOfferIndex) .getOfferToken() val billingParams = BillingFlowParams.newBuilder().setProductDetailsParamsList( listOf( BillingFlowParams.ProductDetailsParams.newBuilder() .setProductDetails(productDetails) .setOfferToken(offerToken) .build() ) ).setSubscriptionUpdateParams( BillingFlowParams.SubscriptionUpdateParams.newBuilder() .setOldPurchaseToken("old_purchase_token") .setSubscriptionReplacementMode( BillingFlowParams.ReplacementMode.CHARGE_FULL_PRICE ) .build() ).build() billingClient.launchBillingFlow( activity, billingParams ) // ...
جاوا
String offerToken = productDetails .getSubscriptionOfferDetails(selectedOfferIndex) .getOfferToken(); BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder() .setProductDetailsParamsList( ImmuableList.of( ProductDetailsParams.newBuilder() // fetched using queryProductDetailsAsync .setProductDetails(productDetails) // offerToken can be found in // ProductDetails=>SubscriptionOfferDetails .setOfferToken(offerToken) .build())) .setSubscriptionUpdateParams( SubscriptionUpdateParams.newBuilder() // purchaseToken can be found in Purchase#getPurchaseToken .setOldPurchaseToken("old_purchase_token") .setSubscriptionReplacementMode(ReplacementMode.CHARGE_FULL_PRICE) .build()) .build(); BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams); // ...
توصیههای جایگزین
جدول زیر سناریوهای مختلف تناسبی را بههمراه آنچه برای هر سناریو توصیه میکنیم نشان میدهد:
| سناریو | حالت جایگزین توصیهشده | نتیجه |
|---|---|---|
| ارتقا دادن به سطح گرانتر | CHARGE_PRORATED_PRICE |
کاربر بلافاصله دسترسی پیدا میکند و دوره صورتحساب او تغییر نمیکند. |
| تنزل به سطح ارزانتر | DEFERRED |
کاربر قبلاً هزینه سطح گرانتر را پرداخت کرده است، بنابراین تا تاریخ صورتحساب بعدی دسترسی دارد. |
| ارتقا دادن درطول دوره آزمایشی رایگان، حفظ دوره آزمایشی | WITHOUT_PRORATION |
کاربر برای باقیمانده دوره آزمایشی بدون هزینه اضافی به سطح بالاتری ارتقا میدهد. |
| ارتقا دادن درطول دوره آزمایشی رایگان - پایان دسترسی به دوره آزمایشی رایگان | CHARGE_PRORATED_PRICE |
کاربر بلافاصله به سطح جدید دسترسی پیدا میکند، مقدار باقیمانده از دوره آزمایشی رایگان منتقل میشود. مقدار انتقالیافته براساس قیمتگذاری طرح پایه محاسبه میشود. |
| برنامه زمانی پرداخت برخیاز موارد اشتراک را بدون تغییر نگه میدارد درحالیکه موارد اشتراک دیگر را به «اشتراک با برافزاها» اضافه یا از آن حذف میکند. | KEEP_EXISTING |
کاربر همچنان قیمت قدیمی را برای محصول تغییرنیافته پرداخت میکند. موارد جدید بلافاصله اضافه میشوند. سایر موارد قدیمی را میتوان با مشخص کردن حالت جایگزینی تعویض کرد یا برداشت. |
مدیریت خریدهای تغییر اشتراک
تغییر طرح از هر نظر خرید جدید محسوب میشود و باید پساز تکمیل موفقیتآمیز جریان صورتحساب، بهعنوان خرید جدید پردازش و تأیید شود. علاوهبر پردازش مناسب خرید جدید، باید خریدی را که جایگزین میشود از رده خارج کنید.
رفتار درونبرنامه مانند هر خرید جدیدی است. برنامه شما نتیجه خرید جدید را در PurchasesUpdatedListener دریافت میکند و خرید جدید در queryPurchasesAsync دردسترس است.
وقتی خریدی جایگزین خرید موجود میشود، Google Play Developer API مقدار linkedPurchaseToken را در
منبع اشتراک برمیگرداند. میتوانید itemReplacement را در بخش SubscriptionPurchaseLineItem در
خرید جدید بررسی کنید تا جزئیات جایگزینی سطح مورد را متوجه شوید.
علاوهبراین، میتوانید از فیلد offerPhase برای شناسایی فاز پیشنهاد فعلی (مانند دوره تناسبی یا دوره آزمایشی رایگان) برای اشتراک جدید استفاده کنید تا تجربههای کاربری سفارشیشده ارائه دهید. حتماً
نشان ارائهشده در linkedPurchaseToken را باطل کنید تا
مطمئن شوید از نشان قدیمی برای دسترسی به سرویسهایتان استفاده نمیشود. برای اطلاعات درباره مدیریت خریدهای ارتقا و تنزل،
ارتقا، تنزل، و ثبتنام مجدد را ببینید.
وقتی کد خرید جدید را دریافت کردید، همان فرایند درستیسنجی را که برای
درستیسنجی کد خرید جدید استفاده کردید دنبال کنید. حتماً این خریدها را با BillingClient.acknowledgePurchase() از «کتابخانه صورتحساب Google Play» یا Purchases.subscriptions:acknowledge از Google Play Developer API تأیید کنید.
رسیدگی به تعویض معوق
حالت جایگزینی معوق به شما امکان میدهد به کاربر اجازه دهید تا قبلاز شروع طرح جدید، از حق استفاده باقیمانده در طرح قدیمی خود استفاده کند.
وقتی از ReplacementMode.DEFERRED برای خرید جدید استفاده میکنید،
queryPurchasesAsync() پساز جریان خرید، یک توکن خرید جدید برمیگرداند که تا زمان انجام جایگزینی معوقه در تاریخ تمدید بعدی، همچنان با محصول قدیمی مرتبط است و پساز آن محصول جدید برگردانده میشود.
در گذشته میتوانستید این تجربه کاربری را با
ProrationMode.DEFERRED منسوخشده بهدست آورید، اما ProrationMode.DEFERRED با «کتابخانه خدمات صورتحساب Play» نسخه ۶ منسوخ شده است. برای درک تفاوتهای رفتاری، جدول زیر را ببینید:
زمان |
ProrationMode.DEFERRED (منسوخشده) |
ReplacementMode.DEFERRED |
بلافاصله پساز موفقیت جریان خرید (برنامه) |
حق استفاده از طرح قدیمی تا تاریخ تمدید بعدی ادامه دارد. برای اطمینان از اینکه برنامه حق استفاده صحیح را ارائه میدهد، توکن خرید جدید ظاهر نمیشود، بنابراین در این مرحله نمیتوان آن را پردازش کرد. |
نشان خرید جدید ظاهر میشود، بنابراین باید در این مرحله پردازش شود و زمان جایگزینی درنظر گرفته شود. |
بلافاصله پساز موفقیت جریان خرید (باطن) |
SUBSCRIPTION_PURCHASED RTDN پساز جریان خرید ارسال نمیشود. بخش پشتیبان هنوز از خرید جدید مطلع نشده است. |
SUBSCRIPTION_PURCHASED RTDN با product_id قدیمی بلافاصله پساز جریان خرید برای کد خرید جدید ارسال میشود. فراخوانی روش purchases.subscriptionsv2.get با کد خرید جدید، خریدی را برمیگرداند که دارای «startTime» است که زمان خرید را با دو قلم کالا نشان میدهد:
SUBSCRIPTION_EXPIRED برای کد خرید قدیمی ارسال شد. هنگام فراخوانی روش purchases.subscriptionsv2.get با کد خرید قدیمی، منقضیشده بهنظر میرسد (حق استفاده از طرح قدیمی برای زمان باقیمانده به خرید جدید منتقل میشود). |
درصورت جایگزینی - اولین تمدید پساز جریان خرید (برنامه) |
اکنون ژتون خرید جدید ظاهر شده است، بنابراین باید پردازش شود. |
خرید جدید باید قبلاً هنگام موفقیت جریان خرید پردازش شده باشد، بنابراین برنامه نباید هیچ اقدام خاصی بهجز اطمینان از اعطای حق استفاده صحیح انجام دهد. |
درصورت جایگزینی - اولین تمدید پساز جریان خرید (باطن) |
اکنون وقتی اولین SUBSCRIPTION_RENEWED RTDN ارسال میشود، خرید جدید میتواند پردازش و تأیید شود. از |
خرید جدید پردازش و تأیید شد، وقتی SUBSCRIPTION_PURCHASED RTDN برای کد خرید جدید ارسال شد و بهعنوان «startTime» ثبت شد. با ReplacementMode.DEFERRED، اولین تمدیدها از رفتار استاندارد هر تمدید دیگری پیروی میکنند و نیازی نیست منطق خاصی را برای جایگزینیها هنگام وقوع این رویداد مدیریت کنید. هنگام فراخوانی روش purchases.subscriptionsv2.get با کد خرید جدید، خریدی با دو قلم کالا برگردانده میشود:
|
ازاینپس باید بهجای ProrationMode.DEFERRED منسوخشده از ReplacementMode.DEFERRED استفاده شود، زیرا رفتار یکسانی را درخصوص تغییرات حق استفاده ارائه میدهد، اما روشی را برای مدیریت خرید ارائه میدهد که با رفتارهای سایر خریدهای جدید سازگارتر است.
مدیریت مشتری
بااستفاده از اعلانهای بیدرنگ توسعهدهنده، میتوانید بهطور همزمان تشخیص دهید که کاربر چه زمانی تصمیم به لغو میگیرد. وقتی کاربری اشتراکش را لغو میکند، اما قبلاز اینکه اشتراکش منقضی شود، میتوانید برای او اعلان لحظهای یا پیام درونبرنامهای ارسال کنید و از او بخواهید دوباره مشترک شود.
برای کاهش لغوهایی که در Google Play شروع میشود، میتوانید پیشنهادهای حفظ مشتری را پیکربندی کنید. Google Play به مشترکین واجدشرایطی که قصد لغو اشتراکشان را دارند پیشنهاد حفظ مشتری نشان میدهد و اگر آن را بپذیرند، اشتراکشان با قیمت تخفیفخورده ادامه مییابد.
پساز اینکه کاربر اشتراکش را لغو کرد، میتوانید تلاش کنید او را برگردانید چه در برنامهتان، چه ازطریق «فروشگاه Play». جدول زیر سناریوهای مختلف اشتراک را بههمراه کنشهای بازگرداندن مشتری و الزامات برنامه مرتبط شرح میدهد.
| قبلاز انقضای اشتراک | پساز انقضای اشتراک | |||
| درونبرنامه | در «فروشگاه Play» | درونبرنامه | در «فروشگاه Play» | |
| ویژگی بازگرداندن | اشتراک درونبرنامه | بازگرداندن | اشتراک درونبرنامه | ازسرگرفتن اشتراک |
| کاربر روند تسویهحساب را طی میکند | بله | نه | بله | بله |
| اشتراک کاربر همچنان با همان SKU مرتبط است | کاربر میتواند برای همان SKU یا SKU دیگری ثبتنام کند | بله | کاربر میتواند برای همان SKU یا SKU دیگری ثبتنام کند | بله |
| ایجاد کردن کد خرید جدید | بله | نه | بله | بله |
| بهطور پیشفرض فعال است | نه | بله، پشتیبانی برای همه توسعهدهندگان لازم است | نه |
برنامههای بدون «کتابخانه خدمات صورتحساب» نسخه ۲.۰+: خیر برنامههای دارای «کتابخانه خدمات صورتحساب» نسخه ۲.۰+: بله. توسعهدهندگان میتوانند در «کنسول» انصراف دهند. |
| وقتی هزینه از کاربر کسر میشود |
اگر از همان SKU استفاده شود: پایان دوره صورتحساب فعلی. اگر از SKU دیگری استفاده شود: به حالت سرشکن بستگی دارد. |
پایان دوره صورتحساب فعلی | بیدرنگ | بیدرنگ |
| پیادهسازی الزامی است | ارائه میانای کاربر ثبتنام مجدد در برنامه |
تشخیص تغییر در وضعیت اشتراک پیوند عمیق به «فروشگاه Play» |
ارائه میانای کاربر ثبتنام مجدد در برنامه | مدیریت خریدهای خارج از برنامه |
قبلاز انقضای اشتراک - درونبرنامه
برای اشتراکهایی که لغو شدهاند اما هنوز منقضی نشدهاند، میتوانید به مشترکین اجازه دهید اشتراکشان را در برنامهتان با اعمال همان جریان خرید محصول درونبرنامه برای مشترکین جدید بازیابی کنند. مطمئن شوید میانای کاربر شما نشان میدهد که کاربر اشتراک فعلی دارد. برای مثال، ممکن است بخواهید تاریخ انقضای فعلی کاربر و قیمت تکرارشونده را با دکمه فعالسازی مجدد نمایش دهید.
در بیشتر مواقع، میخواهید همان قیمت و شناسه محصولی را که کاربر قبلاً مشترک آن بوده است به او پیشنهاد دهید، به این صورت:
- خرید اشتراک جدیدی را با همان SKU شروع کنید.
- اشتراک جدید جایگزین اشتراک قدیمی میشود و در همان تاریخ انقضا تمدید میشود. اشتراک قدیمی بلافاصله بهعنوان منقضیشده علامتگذاری میشود.
- بهعنوان مثال، آشیل اشتراکی در Example Music App دارد و این اشتراک در ۱ اوت منقضی میشود. در ۱۰ ژوئیه، او دوباره در اشتراک یکماهه با همان قیمت ماهانه مشترک میشود. اشتراک جدید با اعتبار باقیمانده سرشکن میشود، بلافاصله فعال میشود، و همچنان در ۱ اوت تمدید میشود.
اگر میخواهید قیمت متفاوتی ارائه دهید—برای مثال، دوره آزمایشی رایگان جدید یا تخفیف بازگشت مشتری—میتوانید درعوض «واحد نگهداری موجودی» متفاوتی به کاربر ارائه دهید:
- ارتقا یا تنزل را با SKU متفاوت بااستفاده از حالت جایگزینی
WITHOUT_PRORATIONآغاز کنید. - اشتراک جدید جایگزین اشتراک قدیمی میشود و در همان تاریخ انقضا تمدید میشود. در تاریخ انقضای اصلی، قیمت SKU جدید، ازجمله هرگونه
قیمت آغازین، از کاربر کسر میشود. اگر اشتراک قدیمی بااستفاده از شناسه حساب مبهم ایجاد شده باشد، همان شناسه باید برای ارتقا و تنزل به
BillingFlowParamsارسال شود. - بهعنوان مثال، آشیل اشتراکی در Example Music App دارد و این اشتراک در ۱ اوت منقضی میشود. در ۱۰ ژوئیه، او دوباره در اشتراک سالانه با قیمت آغازین مشترک میشود. اشتراک جدید بلافاصله فعال میشود و در ۱ اوت قیمت آغازین از کاربر کسر میشود.
- اگر تصمیم گرفتید دوره آزمایشی رایگان یا قیمت آغازین را در SKU بازگرداندن مشتری بگنجانید، با لغو انتخاب چارگوش مجاز کردن یک دوره آزمایشی رایگان برای هر برنامه در «کنسول Google Play»، مطمئن شوید که کاربر واجدشرایط است. این چارگوش کاربر را به دریافت یک دوره آزمایشی رایگان برای هر برنامه محدود میکند.
وقتی کد خرید را دریافت کردید، خرید را پردازش کنید، درست مثل زمانی که اشتراک جدیدی را پردازش میکنید. علاوهبراین، Google Play Developer API
linkedPurchaseToken را در منبع اشتراک برمیگرداند. حتماً
توکن ارائهشده در
linkedPurchaseToken را باطل کنید تا مطمئن شوید از توکن قدیمی برای
دسترسی به سرویسهایتان استفاده نمیشود.
قبلاز انقضای اشتراک - در «فروشگاه Play»
وقتی اشتراک لغو شده است اما هنوز فعال است، کاربران میتوانند با کلیک کردن روی ازسرگرفتن اشتراک (قبلاً بازیابی) در مرکز اشتراکهای Google Play، اشتراک را بازیابی کنند. با این کار، همان اشتراک و کد خرید حفظ میشود.
برای اطلاعات بیشتر درباره بازیابی اشتراکها، بازیابیها را ببینید.
پساز انقضای اشتراک - درونبرنامه
میتوانید به مشترکین منقضیشده اجازه دهید با اعمال همان جریان خرید محصول درونبرنامه که برای مشترکین جدید اعمال میشود، در برنامهتان دوباره مشترک شوند. به موارد زیر توجه کنید:
- برای ارائه تخفیف به کاربران، ممکن است بخواهید شناسه محصولی با قیمتگذاری ویژه برای اشتراکتان ارائه دهید که به آن واحد نگهداری موجودی بازگرداندن مشتری نیز میگویند. میتوانید پیشنهاد ویژه را در برنامهتان ارائه دهید یا میتوانید پیشنهاد ویژه را در خارج از برنامه، مثلاً ازطریق ایمیل، به کاربر اطلاع دهید.
- برای شروع اشتراک بازگرداندن مشتری، جریان خرید را در برنامه Android خود بااستفاده از «کتابخانه خدمات صورتحساب Google Play» راهاندازی کنید. این فرایند همانند فرایند اشتراک جدید است، اما میتوانید SKU دردسترس کاربر را تعیین کنید.
- اگر تصمیم گرفتید دوره آزمایشی رایگان یا قیمت آغازین را در SKU بازگرداندن مشتری بگنجانید، با لغو انتخاب چارگوش مجاز کردن یک دوره آزمایشی رایگان برای هر برنامه در «کنسول Google Play»، مطمئن شوید که کاربر واجدشرایط است. این چارگوش کاربر را به دریافت یک دوره آزمایشی رایگان برای هر برنامه محدود میکند.
- اگر کاربر دوباره در همان «واحد نگهداری موجودی» مشترک شود، دیگر واجدشرایط دوره آزمایشی رایگان یا قیمت آغازین نخواهد بود. مطمئن شوید که میانای کاربر شما این موضوع را منعکس میکند.
وقتی کد خرید را دریافت کردید، خرید را پردازش کنید، درست مثل زمانی که اشتراک جدیدی را پردازش میکنید. linkedPurchaseToken را در منبع اشتراک دریافت نخواهید کرد.
پساز انقضای اشتراک - در «فروشگاه Play»
اگر فعال باشد، کاربران میتوانند با کلیک کردن روی ازسرگرفتن اشتراک در مرکز اشتراکهای Google Play، تا یک سال پساز انقضا، دوباره در همان SKU مشترک شوند. این کار یک نشانه اشتراک و خرید جدید تولید میکند.
ازسرگرفتن اشتراک بهعنوان خرید خارج از برنامه درنظر گرفته میشود، بنابراین حتماً روالهای مطلوب را برای تأیید کردن صحیح آنها ازطریق باطن دنبال کنید.
تبلیغ اشتراک
میتوانید کد ترویجی ایجاد کنید تا به کاربران منتخب دوره آزمایشی رایگان تمدیدشدهای برای اشتراک موجود ارائه دهید. برای کسب اطلاعات بیشتر، کدهای ترویجی را ببینید.
برای دورههای آزمایشی رایگان، Google Play قبلاز شروع دوره آزمایشی رایگان تأیید میکند که کاربر روش پرداخت معتبری دارد. ممکن است برخیاز کاربران این درستیسنجی را بهصورت تعلیق یا کسر هزینه در روش پرداختشان ببینند. این تعلیق یا کسر هزینه موقتی است و بعداً برگردانده یا مسترد میشود.
پساز پایان دوره آزمایشی، کل مبلغ اشتراک از روش پرداخت کاربر کسر میشود.
اگر کاربر در هر زمانی درطول دوره آزمایشی رایگان اشتراک را لغو کند، اشتراک تا پایان دوره آزمایشی فعال میماند و پساز پایان دوره آزمایشی رایگان، هزینهای از او کسر نمیشود.
بهتعویق انداختن صورتحساب برای مشترک
میتوانید دوره حق استفاده را برای اشتراک بااستفاده از روش subscriptionsv2.defer تمدید کنید. وقتی اشتراکی را با برافزاها بهتعویق میاندازید، همه موارد موجود در اشتراک برای مدت یکسانی بهتعویق میافتند. درطول دوره تعویق، کاربر با دسترسی کامل مشترک محتوای شما میشود اما هزینهای از او کسر نمیشود. تاریخ تمدید اشتراک بهروز میشود تا تاریخ جدید را نشان دهد.
برای طرحهای پیشپرداخت، میتوانید از API تعویق صورتحساب برای بهتعویق انداختن زمان انقضا استفاده کنید.
صورتحساب معوقه به شما امکان میدهد کارهای زیر را انجام دهید:
- بهعنوان پیشنهاد ویژه، دسترسی رایگان به کاربران بدهید، مثلاً یک هفته رایگان برای خرید فیلم.
- برای نشان دادن حسن نیت، دسترسی رایگان به مشتریان بدهید.
صدور صورتحساب را میتوان حداقل یک روز و حداکثر یک سال بهازای هر فراخوانی میانای برنامهسازی کاربردی بهتعویق انداخت. برای بهتعویق انداختن بیشتر صورتحساب، میتوانید قبلاز رسیدن تاریخ صورتحساب جدید، دوباره با API تماس بگیرید.
بهعنوان مثال، دارسی اشتراک ماهانه محتوای آنلاین برای برنامه Fishing Quarterly دارد. او معمولاً در روز اول هر ماه ۱٫۲۵ پوند صورتحساب دریافت میکند. در ماه مارس، او در یک نظرسنجی آنلاین برای ناشر برنامه شرکت کرد. ناشر با بهتعویق انداختن پرداخت بعدی تا ۱۵ مه، یعنی شش هفته پساز تاریخ صورتحساب قبلی او در آوریل، شش هفته رایگان به او پاداش میدهد.
- هزینهای برای آوریل یا اوایل مه از دارسی کسر نمیشود و او همچنان به محتوا دسترسی دارد. در ۱۵ مه، هزینه اشتراک عادی ۱.۲۵ پوندی برای آن ماه از او کسر میشود. تاریخ تمدید بعدی او اکنون ۱۵ ژوئن است.
هنگام بهتعویق انداختن، شاید بخواهید ازطریق ایمیل یا درون برنامه به کاربر اطلاع دهید که تاریخ صورتحسابش تغییر کرده است.
رسیدگی به پرداختهای ردشده
اگر مشکلی در پرداخت برای تمدید اشتراک وجود داشته باشد، Google بهطور دورهای تلاش میکند اشتراک را برای مدتی قبلاز لغو تمدید کند. این دوره بازیابی میتواند شامل مهلت ارفاقی و بهدنبال آن دوره توقف حساب باشد. درطول این مدت، Google ایمیلها و اعلانهایی برای کاربر ارسال میکند و از او میخواهد روش پرداختش را بهروز کند.
درصورت رد شدن پرداخت، اشتراک وارد مهلت ارفاقی میشود (اگر مهلت ارفاقی پیکربندی شده باشد). درطول مهلت ارفاقی، باید مطمئن شوید که کاربر همچنان به حقوق اشتراک دسترسی دارد.
پساز پایان مهلت ارفاقی، اشتراک وارد دوره تعلیق حساب میشود. درطول تعلیق حساب، باید مطمئن شوید که کاربر به حق استفاده اشتراک دسترسی ندارد.
میتوانید طول دوره مهلت ارفاقی و تعلیق حساب هر طرح پایه تمدید خودکار را در «کنسول Google Play» مشخص کنید. مشخص کردن طول کمتر از مقادیر پیشفرض ممکن است تعداد اشتراکهای بازیابیشده از پرداختهای ردشده را کاهش دهد.
برای بهحداکثر رساندن احتمال بازیابی اشتراک درطول رد پرداخت، میتوانید کاربر را از مشکل پرداخت مطلع کنید و از او بخواهید آن را برطرف کند.
میتوانید این کار را خودتان انجام دهید، همانطور که در بخشهای مهلت ارفاقی و تعلیق حساب توضیح داده شده است، یا میتوانید میانای برنامهسازی کاربردی پیامرسانی درونبرنامه را پیادهسازی کنید که در آن Google پیامی را به کاربران در برنامه شما نشان میدهد.
وقتی مشکلی در پرداخت وجود داشته باشد، Google Play میتواند اعلانی به کاربرانتان نشان دهد. برای تسهیل این کار، میتوانید از ویژگی پیامرسانی درونبرنامه استفاده کنید تا آنها را از پرداختهای معوقه مطلع کنید. اگر پیامرسانی درونبرنامه را فعال کرده باشید، پیام مربوط به مشکلات پرداخت درطول مهلت ارفاقی و تعلیق حساب یکبار در روز نشان داده میشود. این کار به کاربران فرصت میدهد بدون ترک کردن برنامه، پرداختشان را اصلاح کنند. برای اطلاعات بیشتر، به پیامرسانی درونبرنامهای مراجعه کنید.
پیامرسانی درونبرنامهای
اگر پیامرسانی درونبرنامه را با
InAppMessageCategoryId.TRANSACTIONAL فعال کرده باشید،
Google Play درصورت وجود مشکل پرداخت یا افزایش قیمت با الزام به توافق معوقه،
پیامی به کاربران نشان خواهد داد.
توصیه میکنیم هرگاه کاربر برنامه را باز میکند، این میانای برنامهسازی کاربردی را فراخوانی کنید تا مشخص شود آیا پیام باید نشان داده شود یا نه.
اگر کاربر اشتراکش را باموفقیت بازیابی کرد یا افزایش قیمت را تأیید کرد، کد پاسخ
SUBSCRIPTION_STATUS_UPDATED
را بههمراه یک توکن خرید دریافت خواهید کرد. سپس باید از این توکن خرید برای فراخوانی
Google Play Developer API و بازآوری وضعیت اشتراک در برنامهتان استفاده کنید.
ادغام پیامرسانی درونبرنامهای
برای نمایش پیامرسانی درونبرنامه به کاربر، از
BillingClient.showInAppMessages() استفاده کنید.
در اینجا نمونهای از راهاندازی جریان پیامرسانی درونبرنامه آورده شده است:
کاتلین
val inAppMessageParams = InAppMessageParams.newBuilder() .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL) .build() // Note: To display the in-app message, PBL requires an activity instance that // can provide a valid window token. This token is necessary for the Play Store // to display the message overlay correctly on top of the application's window. // The passed Activity must be in a state where its window is created and // attached to the WindowManager. billingClient.showInAppMessages( activity, inAppMessageParams, object : InAppMessageResponseListener { override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) { if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) { // The flow has finished and there is no action needed from developers. } else if (inAppMessageResult.responseCode == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED ) { // The subscription status changed. For example, a subscription // is recovered from a suspended state, or a user confirms a // price increase. Developers should expect the purchase // token to be returned with this response code and use // the purchase token with the Google Play Developer API. } } } )
جاوا
InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder() .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL) .build(); // Note: To display the in-app message, PBL requires an activity instance that // can provide a valid window token. This token is necessary for the Play Store // to display the message overlay correctly on top of the application's window. // The passed Activity must be in a state where its window is created and // attached to the WindowManager. billingClient.showInAppMessages(activity, inAppMessageParams, new InAppMessageResponseListener() { @Override public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) { if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) { // The flow has finished and there is no action needed from developers. } else if (inAppMessageResult.responseCode == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) { // The subscription status changed. For example, a subscription // is recovered from a suspended state, or a user confirms a // price increase. Developers should expect the purchase // token to be returned with this response code and use // the purchase token with the Google Play Developer API. } } });
رسیدگی به لغوها و وضعیتهای معلقه
این بخش نحوه رسیدگی به اشتراکهای لغوشده یا فسخشده و همچنین نحوه مدیریت اشتراکهایی را که درطول فرایند خرید وارد وضعیت معلقه میشوند توضیح میدهد.
لغو یا فسخ کردن
میتوانید از Google Play Developer API برای لغو یا فسخ اشتراک استفاده کنید. این عملکرد در کنسول Google Play نیز دردسترس است.
لغو: کاربران میتوانند اشتراک را در Google Play لغو کنند. همچنین میتوانید گزینهای برای لغو کردن در برنامه یا وبسایتتان به کاربران ارائه دهید. برنامه شما باید این لغوها را همانطور که در لغوها شرح داده شده است مدیریت کند.
لغو کردن: وقتی لغو میکنید، کاربر بلافاصله دسترسی به اشتراک را ازدست میدهد. برای مثال، اگر خطای فنیای وجود داشته باشد که مانع از دسترسی کاربر به محصول شما شود و کاربر نخواهد به استفاده از محصول ادامه دهد، میتوان از این گزینه استفاده کرد. برنامهتان باید این لغوها را همانطور که در لغوها شرح داده شده است مدیریت کند.
جدول زیر تفاوتهای بین لغو و فسخ را نشان میدهد.
| توقف تمدید | لغو دسترسی | |
| لغو | بله | نه |
| لغو کردن | بله | بله |
رسیدگی به تراکنشهای معلق اشتراک
تراکنشهای معلق ممکن است در خرید اولیه، افزودن موجودی، ارتقا، یا تنزل اتفاق بیفتد. خرید اشتراک با وضعیت
SUBSCRIPTION_STATE_PENDING شروع میشود و سپس به
SUBSCRIPTION_STATE_ACTIVE تغییر میکند. اگر تراکنش منقضی شده باشد یا کاربر آن را لغو کرده باشد، به SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED میرود. باید و
فقط باید پساز تکمیل تراکنش، حق استفاده کاربر را بهروز کنید.
تغییر وضعیت اشتراک برای خرید اولیه با تراکنشهای معلقه
ساده است. وقتی کاربر تراکنش معلقی را شروع میکند، برنامه شما Purchase با وضعیت PENDING دریافت میکند. وقتی تراکنش تکمیل شد، برنامهتان دوباره Purchase را دریافت میکند و وضعیت به PURCHASED بهروز میشود. پیام
SubscriptionNotification با نوع SUBSCRIPTION_PURCHASED به
کارخواه RTDN شما ارسال میشود. فرایند عادی را برای تأیید خرید دنبال کنید، به کاربر دسترسی به محتوا را بدهید و خرید را تأیید کنید. اگر تراکنش
منقضی یا لغو شود، پیام SubscriptionNotification با نوع
SUBSCRIPTION_PENDING_PURCHASE_CANCELED به مشتری RTDN شما ارسال میشود. در چنین مواردی، کاربر نباید هرگز به محتوا دسترسی پیدا میکرد.
افزودن موجودی، ارتقا، یا تنزل با تراکنشهای معلق شامل تغییرات وضعیت برای اشتراکهای قدیمی و جدید میشود. وقتی کاربر تراکنش معلقه
افزودن موجودی، ارتقا، یا تنزل را آغاز میکند، برنامه شما Purchase را برای
اشتراک قدیمی با شیء PendingPurchaseUpdate دریافت میکند. در این زمان، کاربر
همچنان مالک اشتراک قدیمی است و هنوز اشتراک جدید را
دریافت نکرده است. فراخوانی getProducts() و getPurchaseToken() در شیء PendingPurchaseUpdate شناسههای محصول و کد خرید اشتراک جدید را برمیگرداند. وقتی تراکنش تکمیل شد، برنامهتان
Purchase را با مجموعه کد خرید سطح بالا برای اشتراک جدید و
مجموعه وضعیت PURCHASED دریافت میکند. پیام SubscriptionNotification با نوع
SUBSCRIPTION_PURCHASED به کارخواه RTDN شما ارسال میشود. فقط در این زمان، باید
نشان خرید قدیمی را با نشان خرید جدید جایگزین کنید و دسترسی کاربر به محتوا را
بهروز کنید. اگر تراکنش منقضی یا لغو شود،
SubscriptionNotification پیامی با نوع
SUBSCRIPTION_PENDING_PURCHASE_CANCELED به مشتری RTDN شما ارسال میشود. در چنین مواردی، کاربر باید همچنان به محتوای اشتراک قدیمی دسترسی داشته باشد.