الاشتراك مع الإضافات

يتيح لك الاشتراك مع ميزات إضافية تجميع منتجات اشتراك متعددة معًا يمكن شراؤها وفوترتها وإدارتها معًا. يمكنك تقديم اشتراكاتك الحالية في كتالوج المنتجات كحِزم إضافية بسلاسة بدون الحاجة إلى تحديد أي تفاصيل مسبقًا أو إجراء أي إعدادات إضافية. يمكنك بدء مسار شراء يتضمّن عدة منتجات حالية متوفّرة عند الاشتراك، وبيعها كميزات إضافية.

الاعتبارات

يجب مراعاة النقاط التالية عند استخدام ميزة "الاشتراك مع حِزم إضافية":

• لا تتوفّر إمكانية الاشتراك مع حِزم إضافية إلا للخطط الأساسية التي يتم تجديدها تلقائيًا.

• يجب أن تتضمّن جميع السلع في عملية الشراء مدة الفوترة المتكرّرة نفسها. على سبيل المثال، لا يمكنك الحصول على اشتراك تتم فوترته سنويًا مع ميزات إضافية تتم فوترتها شهريًا.

• يمكن أن يتضمّن الاشتراك 50 منتجًا كحدّ أقصى عند شراء حِزم إضافية.

• لا تتوفّر هذه الميزة في الهند (IN) وكوريا الجنوبية (KR).

الدمج مع Play Billing Library

يوضّح هذا القسم كيفية دمج ميزة "الاشتراك مع حِزم إضافية" مع "مكتبة الفوترة في Play" (PBL). ويفترض هذا الدليل أنّك على دراية بخطوات الدمج الأولية لمكتبة الفوترة في Google Play، مثل إضافة عنصر تابع لمكتبة الفوترة في Google Play إلى تطبيقك وإعداد BillingClient والربط بخدمة Google Play. يركّز هذا القسم على جوانب دمج PBL الخاصة بالاشتراك مع حِزم إضافية.

بدء مسار شراء

لبدء عملية شراء اشتراك يتضمّن حِزمًا إضافية، اتّبِع الخطوات التالية:

1. يمكنك جلب جميع منتجات اشتراكك باستخدام طريقة BillingClient.queryProductDetailsAsync.

2. اضبط العنصر ProductDetailsParams لكل سلعة.

   يمثّل العنصر الذي يمثّله كائن ProductDetailsParams منتجًا، ويحدّد كلاً من ProductDetails الذي يشير إلى منتج الاشتراك وofferToken الذي يحدّد اشتراكًا معيّنًا base plan أو offer.

3. حدِّد تفاصيل السلعة في طريقة BillingFlowParams.Builder.setProductDetailsParamsList. تحدّد الفئة BillingFlowParams تفاصيل مسار الشراء.

   تعرض العيّنة التالية كيفية بدء عملية الفوترة لشراء اشتراك يتضمّن عدة منتجات:

   Java

      BillingClient billingClient = …;
   
       // ProductDetails obtained from queryProductDetailsAsync().
       ProductDetailsParams productDetails1 = ...;
       ProductDetailsParams productDetails2 = ...;
       ArrayList productDetailsList = new ArrayList<>();
       productDetailsList.add(productDetails1);
       productDetailsList.add(productDetails2);
   
       BillingFlowParams billingFlowParams =
           BillingFlowParams.newBuilder()
              .setProductDetailsParamsList(productDetailsList)
              .build();
       billingClient.launchBillingFlow(billingFlowParams);

القواعد السارية على السلع في عملية الشراء

• لضمان توافق تواريخ تجديد الإضافة مع تاريخ تجديد المنتج الأساسي في النهاية، قد يفرض Google Play رسومًا نسبية بعد أي مراحل تجريبية أو مراحل سعر تمهيدي.
• سيتم تقييم أهلية الاستفادة من العرض لكل سلعة على حدة.

معالجة عمليات الشراء

تتم معالجة الاشتراك مع الإضافات بالطريقة نفسها التي تتم بها معالجة عملية شراء اشتراك واحد كما هو موضّح في مقالة دمج Google Play Billing Library في تطبيقك، والفرق الوحيد هو أنّ المستخدم يمكنه الحصول على امتيازات متعددة من خلال عملية شراء واحدة. عند شراء اشتراك يتضمّن حِزمًا إضافية، يتم عرض عناصر متعدّدة يمكن استردادها باستخدام Purchase.getProducts() في Google Play Billing Library، ثم قائمة lineItems في purchases.subscriptionsv2.get من Google Play Developer API.

تعديل الاشتراكات التي تتضمّن ميزات إضافية

سيؤدي أي تغيير في اشتراكك مع حِزم إضافية إلى ترقية أو الرجوع إلى إصدار سابق. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ترقية الاشتراكات أو الرجوع إلى إصدار سابق.

لتغيير أو استعادة عملية شراء حالية للاشتراك مع إضافات في تطبيقك، عليك استدعاء واجهة برمجة التطبيقات launchBillingFlow مع مَعلمات إضافية، والتأكّد من استيفاء الشروط التالية:

• اتّصِل دائمًا بـ setOldPurchaseToken باستخدام رمز الشراء الخاص بعملية شراء الاشتراك الحالية.
• لترقية منتج أو الرجوع إلى إصدار أقدم أو الترقية إلى منتج آخر، اتّصِل بالرقم SubscriptionProductReplacementParams.setReplacementMode لتحديد كيفية التعامل مع تغيير الخطة بين المنتج القديم والمنتج الجديد الذي تم شراؤه. وفي ما عدا ذلك، لا داعي لضبط هذه المَعلمة.
• عندما لا يتم تغيير العنصر الأساسي، سيظل بإمكانك استدعاء SubscriptionProductReplacementParams.setSubscriptionReplacementMode لتطبيق سلوك استبدال معيّن. للاطّلاع على القواعد السارية في هذه الحالة، يُرجى الرجوع إلى إعادة الاشتراك أو التبديل بين الخطط ضمن الاشتراك نفسه.
• سيتم تطبيق الميزات الإضافية الجديدة على الفور مع تحصيل رسوم حسب الاستخدام لمطابقة تاريخ التجديد التالي مع المنتج الأساسي في الاشتراك.
• ستنتهي صلاحية الميزات الإضافية التي تمت إزالتها في نهاية مُدد الفوترة الحالية.
• عند بدء عملية الفوترة، عليك تحديد جميع العناصر النشطة في الاشتراك مع الميزات الإضافية باستثناء تلك التي ستتم إزالتها، بالإضافة إلى أي ميزات إضافية جديدة.

يوضّح المثال التالي كيفية استدعاء واجهة برمجة التطبيقات launchBillingFlow عند تغيير عملية شراء حالية لاشتراك يتضمّن ميزات إضافية:

BillingClient billingClient = …;

int replacementMode =…;

// ProductDetails obtained from queryProductDetailsAsync().
ProductDetailsParams productDetails1 = ...;
ProductDetailsParams productDetails2 = ...;
ProductDetailsParams productDetails3 = ...;

ArrayList newProductDetailsList = new ArrayList<>();
newProductDetailsList.add(productDetails1);
newProductDetailsList.add(productDetails1);
newProductDetailsList.add(productDetails1);

BillingFlowParams billingFlowParams =
    BillingFlowParams.newBuilder()
        .setSubscriptionUpdateParams(
          SubscriptionUpdateParams.newBuilder()
              .setOldPurchaseToken(purchaseTokenOfExistingSubscription)
              // No need to set if change does not affect the base item.
             .setSubscriptionReplacementMode(replacementMode)
             .build())
        .setProductDetailsParamsList(productDetailsList)
        .build();

billingClient.launchBillingFlow(billingFlowParams);

سيناريوهات تعديل الاشتراكات

يسرد الجدول التالي سيناريوهات التعديل المختلفة للاشتراك مع الإضافات والسلوك المقابل.

عند استخدام SubscriptionProductReplacementParams

عند استخدام SubscriptionUpdateParams

الإشعارات في الوقت الفعلي الخاصة بالمطوّرين

لم يتم توفير الحقل subscriptionId في RTDN لعمليات شراء اشتراك مع حِزم إضافية، والتي تحتوي على أذونات متعددة للوصول إلى المحتوى. بدلاً من ذلك، يمكنك استخدام واجهات Play Developer APIs للحصول على معلومات حول عملية الشراء والاطّلاع على أذونات الوصول إلى السلع المرتبطة بها.

تغييرات الأسعار للمشتركين الحاليين

يشبه تغيير أسعار الاشتراكات للمشتركين الحاليين في اشتراك يتيح شراء حِزم إضافية تغيير أسعار الاشتراك الفردي كما هو موضّح في مقالة تغيير أسعار الاشتراكات. ومع ذلك، هناك بعض القيود والاختلافات الوظيفية كما هو موضّح في هذا القسم.

إنهاء مجموعة نموذجية قديمة للأسعار

يؤثّر إنهاء مجموعة نموذجية قديمة أيضًا في الاشتراكات التي تتضمّن عمليات شراء إضافية. تنطبق القواعد التالية:

• يجب أن تتطابق جميع الزيادات المعلقة في الأسعار التي تتطلّب موافقة مع وقت التجديد مع السعر الجديد. إذا كان أحد العناصر في عملية شراء اشتراك مع حِزم إضافية يتضمّن زيادة في السعر تتطلّب موافقة المستخدم ولم يتم تأكيدها بعد، سيتم تجاهل أي زيادة جديدة في السعر تتطلّب موافقة المستخدم لعناصر أخرى في عملية الشراء ما لم تؤدِّ إلى وقت التجديد نفسه الذي يتم فيه تطبيق السعر الجديد كما هو الحال مع الزيادة الحالية في السعر في الحالة معلّقة. بعد أن يؤكّد المستخدم الزيادة في السعر، سيتم تسجيل أي تغييرات أحدث في السعر. ويمكن للمستخدمين الموافقة على جميع زيادات الأسعار غير المؤكَّدة التي تتطلّب الموافقة دفعة واحدة فقط.

  مثال:

  • لنفترض أنّ لديك اشتراكًا يتضمّن ميزات إضافية (المنتج A والمنتج B)، ويتم تجديده في اليوم السابع من كل شهر.
  • يخضع المنتج "أ" لعملية نقل مستمرة للسعر من 7 دولار أمريكي إلى 10 دولار أمريكي، ومن المتوقّع أن تصبح الزيادة في السعر سارية في 7 تموز (يوليو).
  • بدأ تغيير السعر الجديد من 5 دولار أمريكي إلى 6 دولار أمريكي للمنتج B في 2 يونيو. بما أنّ الزيادة الاختيارية في السعر تبدأ بعد 37 يومًا من عملية نقل البيانات، ستكون الزيادة الأولى في سعر السلعة B في 7 أغسطس.

  في هذا السيناريو، لن يتم تسجيل تفاصيل تغيير السعر للمنتج B عند شراء هذا الاشتراك إلى أن يوافق المستخدم على تغيير السعر للمنتج A (إلى أن يصبح في الحالة CONFIRMED)، ولن تعرض السمة SubscriptionPurchaseV2 تفاصيل تغيير السعر للمنتج B. بعد أن يؤكّد المستخدم تغيير سعر المنتج "أ"، يبدأ تغيير سعر المنتج "ب". لا يتلقّى المستخدم الزيادة في سعر المنتج "ب" التي تتطلّب موافقة إلا بعد قبول الزيادة التي تتطلّب موافقة للمنتج "أ".

• تتضمّن رسالة البريد الإلكتروني من Google Play قائمة بجميع العناصر التي سيتم تطبيق زيادة أو نقصان في أسعارها في اليوم نفسه.

إلغاء الاشتراك مع ميزات إضافية

يمكن للمستخدمين إلغاء عملية شراء اشتراك يتضمّن ميزات إضافية بالكامل من "مركز اشتراكات Play"، ولا يمكنك إلغاء عملية شراء اشتراك يتضمّن ميزات إضافية بالكامل إلا باستخدام Google Play Developer API.

عند إلغاء عملية شراء اشتراك بدون إبطالها، لن يتم تجديد أي من السلع التي تم شراؤها تلقائيًا، ولكن سيظل بإمكان المستخدم الوصول إلى السلع التي يحق له الحصول عليها، بما في ذلك أي فترات تجريبية مجانية، إلى أن تنتهي فترات الفوترة المقابلة.

إبطال الاشتراكات التي تتضمّن ميزات إضافية وردّ الأموال المدفوعة مقابلها

في ما يلي بعض الإرشادات المتعلّقة بإلغاء الاشتراكات وردّ الأموال المدفوعة مقابلها:

• استخدِم Play Console لردّ مبلغ معيّن من الأموال المدفوعة مقابل طلب محدّد بدون إبطال إمكانية الوصول إلى الاشتراك.

• اتّصِل على orders.refund لردّ الأموال بالكامل مقابل دفعات اشتراك محدّدة دفعها المستخدم بدون إبطال إمكانية الوصول إلى الاشتراك.

• اتّصِل بالرقم purchases.subscriptionsv2.revoke لإلغاء إذن الوصول إلى جميع عناصر الاشتراك على الفور. باستخدام واجهة برمجة التطبيقات هذه، يمكنك إجراء ما يلي:

  • إلغاء إذن الوصول إلى جميع العناصر وتقديم ردّ نسبي للأموال

  • عند إبطال اشتراك يتضمّن حِزمًا باستخدام عمليات ردّ الأموال حسب الاستخدام، سيتم ردّ الأموال الخاصة بآخر طلب لكل منتج بمبلغ يتناسب مع الوقت المتبقي حتى تاريخ التجديد التالي.

  • إلغاء إذن الوصول إلى جميع العناصر وتقديم ردّ كامل للأموال

  • إلغاء إذن الوصول إلى منتج فردي مع استرداد الأموال المدفوعة بالكامل مقابل المنتج

إبطال منتج فردي في اشتراك يتضمّن ميزات إضافية

لإلغاء منتجات فردية في اشتراك يتضمّن حِزمًا إضافية بدون إلغاء عملية الشراء بالكامل، استخدِم الدالة purchases.subscriptionsv2.revoke مع ضبط الحقل ItemBasedRefund في RevocationContext. يمكن ضبط productId المنتج الذي يجب إبطاله وردّ أمواله في الحقل ItemBasedRefund.

يمكن ضبط الحقل ItemBasedRefund لعمليات الشراء التي تتضمّن منتج اشتراك واحدًا أو أكثر يتجدّد تلقائيًا.

• إذا كانت هناك سلع نشطة متبقية في عملية شراء الاشتراك بعد إبطال السلعة المحدّدة في ItemBasedRefund، سيتم إبطال السلعة فقط وردّ الأموال المدفوعة بالكامل بدون التأثير في حالة الاشتراك.
• إذا لم تتبقَ أي سلع نشطة في عملية شراء الاشتراك بعد إبطال السلعة المحدّدة في ItemBasedRefund، سيتم إبطال السلعة وردّ أموالها بالكامل وإلغاء الاشتراك.

الاعتبارات

• عند استخدام ItemBasedRefund، يمكن إبطال عنصر واحد فقط في كل مرة. يمكن استدعاء الطلب عدة مرات إذا كان يجب إبطال عناصر مختلفة.
• عندما تكون حالة شراء الاشتراك هي "تم رفض الدفع"، أو إذا لم يكن المنتج المحدّد في ItemBasedRefund مملوكًا أو انتهت صلاحيته، يتم حظر إيقاف المنتج.
• لا تتوفّر ميزة إيقاف المنتج في الاشتراك المدفوع مسبقًا.

تأجيل الفوترة

يمكنك تقديم تاريخ الفوترة التالي لاشتراك يتضمّن حِزمًا إضافية باستخدام الطريقة Purchases.subscriptionsv2:defer.

عند تأجيل اشتراك يتضمّن ميزات إضافية، يتم تأجيل جميع العناصر في الاشتراك لمدة مماثلة. خلال مدة التأجيل، يحتفظ المستخدم بإمكانية الوصول الكامل إلى جميع العناصر بدون تحصيل رسوم منه. يتم تعديل تاريخ تجديد جميع العناصر إلى التاريخ الجديد.

يمكن أن يكون ذلك مفيدًا للعروض الترويجية أو مبادرات كسب ولاء العملاء. يمكن تأجيل الفوترة لمدة يوم واحد كحدّ أدنى ولمدة عام واحد كحدّ أقصى لكل طلب بيانات من واجهة برمجة التطبيقات. يمكنك طلب واجهة برمجة التطبيقات عدة مرات لتمديد فترة تأجيل الدفع قبل حلول تاريخ الفوترة الجديد.

يتم إرسال SUBSCRIPTION_DEFERRED إشعار في الوقت الفعلي خاص بالمطوّرين عند اتّخاذ هذا الإجراء.

انتهاء صلاحية السلعة أثناء رفض الدفعة

عند شراء اشتراك يتضمّن إضافات، قد تحتاج بعض عمليات التجديد إلى تمديد مجموعة فرعية فقط من أذونات الوصول إلى المحتوى، بدون التأثير في العناصر التي لها تاريخ انتهاء صلاحية مستقبلي.

بغض النظر عن المنتجات التي يتضمّنها التجديد، إذا تم رفض دفع رسوم التجديد، سيتم منح فترة سماح لشراء الاشتراك بالكامل وسيتم تعليق الحساب كما هو موضّح في المستندات التالية.

اختيار فترة الاسترداد

بما أنّ فترة السماح تمنح المستخدم إذن الاستخدام، عند شراء اشتراك يتضمّن ميزات إضافية، يتم رفض دفعة التجديد، ويتم اختيار المنتج الذي يتضمّن الحدّ الأدنى لفترة السماح من بين جميع المنتجات النشطة، ويتم تطبيق فترة السماح وفترة تعليق الاشتراك كفترة استرداد لهذا التجديد.

تشمل العناصر النشطة العناصر التي كانت نشطة عند شراء اشتراك مع حِزم إضافية قبل محاولة التجديد مباشرةً، وتستبعد أي عناصر تمت إضافتها حديثًا (ولن تكون مؤهَّلة إلا بعد الاسترداد)، وتستبعد أي عناصر لم تعُد نشطة بسبب الإزالة أو الإيقاف.

يتم تطبيق إعداد تعليق الاشتراك الخاص بالمنتج الذي تم اختيار الحدّ الأدنى لفترة السماح له. إذا كان هناك أكثر من منتج واحد يتضمّن الحدّ الأدنى لفترة السماح، ولكن يتضمّن فترات تعليق اشتراك مختلفة، سيتم تطبيق أطول فترة تعليق اشتراك.

فترة السماح

عند رفض دفعة تجديد الاشتراك، ستنتقل عملية شراء الاشتراك إلى حالة فترة السماح. وخلال فترة السماح، سيظل بإمكان المستخدم الوصول إلى جميع العناصر النشطة من فترة التجديد السابقة. بعد انتهاء فترة السماح، إذا لم يتم حلّ مشكلة طريقة الدفع، سيتم تعليق عملية شراء الاشتراك بالكامل. إذا بلغت أي عناصر أخرى تاريخ تجديدها خلال فترة السماح، سيتم بدء محاولة جديدة لتحصيل الرسوم مقابل هذه العناصر بعد استعادة الاشتراك من حالة رفض الدفع.

فترة تعليق الاشتراك

أثناء تعليق الاشتراك، يتم تعليق إمكانية الوصول إلى جميع المنتجات المضمّنة في الاشتراك إلى أن يتم استرداد الدفعة.

في حال استرداد الاشتراك الذي تم تعليقه، سيظل الاشتراك كما هو. أما إذا لم يتم استرداده، فستنتهي صلاحية السلع التي تم رفض دفع ثمنها، وسيتم استئناف إمكانية الوصول إلى السلع الأخرى خلال ما تبقى من مدة الفوترة.

مثال:

• لدى المستخدم اشتراك في الخطة الأساسية يتم تجديده في اليوم الأول من كل شهر، ثم في 15 آب (أغسطس)، يضيف خطة إضافية بقيمة 10 دولار أمريكي شهريًا مع فترة تجريبية مجانية لمدة سبعة أيام. لم يتم ضبط فترة سماح لأي من العنصرين، وكلاهما يتضمّن فترة تعليق اشتراك مدتها 30 يومًا.

• في 22 آب (أغسطس)، يتم تحصيل 2.90 دولار أمريكي من المستخدم (10*9/31) لتحديد نسبة الاشتراك حتى 31 آب (أغسطس)، ولكن تنتهي صلاحية طريقة الدفع التي يستخدمها قبل ذلك، ويتم رفض الدفع في 22 آب (أغسطس).

عندما يتم تعليق الاشتراك بسبب رفض الدفع، لن يتمكّن المستخدم من الوصول إلى أي من العناصر المضمّنة في الاشتراك مع الحِزم الإضافية. سيتم ردّ الأموال المدفوعة مقابل الفترة المتبقية من العناصر التي لن يتم تجديدها إلى المستخدمين عند انتهاء فترة تعليق الاشتراك، إما بعد استرداد الدفعة أو إلغاء الاشتراك.

في المثال السابق، تم تعليق الاشتراك في 22 آب (أغسطس).

• إذا تم استرداد الحساب في 25 آب (أغسطس)، أي قبل تاريخ التجديد العام في 1 أيلول (سبتمبر)، سيستعيد المستخدم إمكانية الوصول إلى كل من الخطة الأساسية وخطة الإضافة في اليوم نفسه. تم تغيير تاريخ الفوترة التالي إلى 4 أيلول (سبتمبر).

• إذا لم يتم استرداد الحساب بعد 30 يومًا، سيتم إلغاء الاشتراك في 21 سبتمبر، وسيتمكّن المستخدم من الوصول إلى خطة الاشتراك الإضافية، وسيستعيد إمكانية الوصول إلى خطة الاشتراك الأساسية حتى 30 سبتمبر.

في هذا المثال، يجب الحصول على expiryTime المعدَّل لجميع العناصر في الاشتراك مع الإضافات، لأنّه قد يتم استئناف إذن الوصول إلى بعض العناصر بعد فترة السماح وتعليق الحساب.

إعداد التقارير المالية والتسوية

استخدِم تقرير الأرباح لتسوية اشتراكاتك النشطة مع المعاملات على Play. يحتوي كل عنصر من عناصر المعاملة على معرّف طلب. في حال كانت عمليات الشراء تتضمّن عدة منتجات، ستتضمّن تقارير الأرباح والمبيعات المقدّرة صفوفًا منفصلة لكل معاملة، مثل الرسوم والضرائب والمبالغ المستردة، وذلك لكل منتج معنيّ.

بالنسبة إلى لوحات البيانات في Play Console:

• يتم تقسيم إحصاءات الإيرادات المعروضة في قسم التقارير المالية ضمن وحدة التحكّم حسب السلع.

• تعكس إدارة الطلبات عملية شراء اشتراك مع ميزات إضافية، وتعرض قوائم مفصّلة بالميزات التي تم شراؤها. من خلال إدارة الطلبات، يمكنك إلغاء عملية شراء أجراها أحد المستخدمين أو إبطالها أو ردّ أموالها بالكامل.