شراء مراحل نشاط الطلاب (RTDN)

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

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

يقدّم Google Play إشعارات في الوقت الفعلي خاصة بالمطوّرين (RTDN) لتتبُّع أحداث مراحل نشاط الشراء، كما يمكن استخدام واجهات برمجة التطبيقات Play Developer API للاشتراكات وعمليات الشراء داخل التطبيق لاتّخاذ الإجراءات اللازمة استنادًا إلى هذه الأحداث. من خلال استخدام هذه الأدوات وبناء نظام قوي لإدارة مراحل نشاط الشراء، يمكنك توفير تجربة مستخدم سلسة وإدارة عمليات الشراء والصلاحيات بكفاءة.

إنشاء عميل إشعارات للمطوّرين في الوقت الفعلي

يمكن أن تمرّ عمليات الشراء التي يتم إجراؤها على نظام الفوترة في Google Play بعدة تغييرات على الأذونات طوال مراحل نشاطها. يمكن أن تؤدي إجراءات مختلفة إلى تشغيل هذه التغييرات، بما في ذلك ما يلي:

  • الإجراءات التي يبدأها المستخدمون في تطبيقك
  • الإجراءات التي يبدأها المستخدمون من خلال تطبيق "متجر Play"
  • الإجراءات التي يتم بدؤها مباشرةً من الأنظمة الخلفية
  • الإجراءات التي تبدأها من خلال Google Play Console

مثلاً:

  • مستخدم يلغي اشتراكًا من خلال مركز الاشتراكات على "متجر Play".
  • مطوّر البرامج تأجيل فوترة الاشتراك باستخدام واجهة برمجة التطبيقات Google Play Developer API
  • مطوِّر البرامج الذي يردّ أموالاً عن عملية شراء ويلغي استحقاقها من خلال Google Play Console

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

على الرغم من إمكانية استخدام واجهة برمجة التطبيقات Google Play Developer API للتحقّق يدويًا من حالة عملية الشراء، لا يشكّل الاعتماد على عمليات الفحص الدورية طريقة فعّالة للغاية لتتبُّع التغييرات، كما أنّه عُرضة للأخطاء وحالات التأخير. يمكن أن تساعدك سجلات RTDN في الاستجابة للتغييرات فورًا بدون الحاجة إلى وضع منطق تتبُّع مراحل نشاط عمليات الشراء في Google Play.

يتناول هذا القسم كيفية إنشاء عميل لـ RTDNs. إنّ RTDN هي ميزة تم إنشاؤها باستخدام Google Cloud Pub/Sub، وترسل إلى الخلفية إشعارًا فوريًا عند تغيير حالة استحقاق المستخدم. يتكوّن نظام النشر/الاشتراك من ناشر يرسل الإشعارات وعميلًا يشترك في تلك الإشعارات. من خلال استخدام ميزة RTDN، يمكنك تتبُّع كل التغييرات التي تطرأ على حالة استحقاق المستخدم في الوقت الفعلي والاستجابة لها على الفور.

ناشر RTDN

تعمل خلفية Google Play كناشر لرموز RTDN. لإعداد ميزة RTDN لتطبيقك، اتّبِع التعليمات الواردة في دليل الإعداد. تتيح هذه الخطوات لنظام الفوترة في Google Play أن يكون الناشر لقواعد RTDN الخاصة بتطبيقك. لإكمال هذا الإعداد، عليك التعرّف على وحدة تحكّم Google Cloud Platform لإعداد إعدادات النشر/الاشتراك الأساسية.

مشترك في ميزة RTDN

بعد إعداد الناشر، يجب إعداد الخلفية لاستخدام بروتوكولات RTDN. لإجراء ذلك، تحتاج إلى إنشاء برنامج لتلقّي رسائل Google Cloud Pub/Sub. تتكوَّن الوظيفة الأساسية لعميل RTDN من تلقّي مثيلات من PubSubMessage، إما من خلال طلبات HTTPS في نقطة نهاية مسجَّلة أو باستخدام مكتبات عميل Cloud Pub/Sub. يمكنك الاطّلاع على مستندات النشر/الاشتراك لمعرفة المزيد من المعلومات حول استخدام استراتيجية الدفع أو السحب، أو مستندات إعداد ميزة RTDN للحصول على إرشادات حول اختيار الاستراتيجية الأنسب لاحتياجاتك.

لكل رسالة تتلقاها، يجب أن تقوم الخلفية بما يلي:

  • فُكَّ حزمة الحقل data بترميز base-64، الذي يحتوي على كائن RTDN.
  • شغِّل أي عمليات لازمة في الخلفية تتعلّق بتغيير الصلاحيات التي يتم الإبلاغ عنها من خلال حدث RTDN.

التعامل مع عمليات نقل حالة الشراء

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

راجِع الأدلة التالية لمزيد من المعلومات عن هذه السيناريوهات: