التسجيل في برنامج ولاء المستخدمين وترقية البطاقات

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

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

نظرة عامة

للبدء، تأكَّد من أنّك أعددت مشروعك سابقًا وأنّ لديك إذن الوصول إلى Google Wallet API.

يجب اتّباع هذه الخطوات الأربع لتنفيذ الميزة:

  1. إعداد صف اختبار: يمكنك ضبط "محفظة Google" لاختبار المسارات.
  2. تطوير الصفحات: يمكنك إنشاء صفحات التسجيل أو تسجيل الدخول باستخدام واجهة برمجة التطبيقات SharedDataType في "محفظة Google".
  3. تنفيذ ميزة الإضافة إلى المحفظة: أرسِل بطاقة الولاء إلى "محفظة Google" بعد تنفيذ الإجراء.
  4. طلب التحقّق: أرسِل طلبًا للمراجعة واطلب تفعيل الترقية.

أهمية تفعيل ميزة "التسجيل في برنامج الولاء"

لفهم قيمة عملية الدمج هذه، من المهم التمييز بين نوعَي البطاقات المتوفّرة في "محفظة Google": المستوى 1 (التي يضيفها المستخدم) والمستوى 2 (التي يصدرها الشريك).

الفرق بين المستوى الأول والمستوى الثاني

الميزة بطاقة L1 (أضافها المستخدم) بطاقة L2 (صادرة عن الشريك)
Origin يتم إنشاؤها عندما يمسح المستخدم ضوئيًا بطاقة مادية أو يكتب رقمًا يدويًا. يتم إنشاؤها وإرسالها باستخدام واجهة برمجة التطبيقات Wallet API بعد أن يشترك المستخدم أو يسجّل الدخول باستخدام المسار الذي حدّدته.
التحكّم ثابتة: لا يمكن للشريك الاطّلاع على هذه البطاقة أو التحكّم فيها. ديناميكية: يتمتع الشريك بالتحكّم الكامل باستخدام واجهة برمجة التطبيقات.
الوظائف صورة ثابتة لرمز شريطي لا يمكن تعديلها. يمكنه تعديل أرصدة النقاط وحالة الفئة وعرض العروض المخصّصة وتلقّي الإشعارات.

مسارات الترقية: "الجسر" المؤدي إلى برنامجك

من خلال إنشاء مسار "التسجيل في برنامج الولاء" ("الوجهة")، تتيح لـ Google إنشاء "جسر" ينقل المستخدمين من بطاقات المستوى الأول الثابتة إلى بطاقات المستوى الثاني الرسمية. هناك محفّزان أساسيان للترقية:

  1. ترقية البطاقات من المستوى 1 إلى المستوى 2: إذا سبق للمستخدم إضافة بطاقتك يدويًا (المستوى 1)، يمكن أن تطلب منه "محفظة Google" الانتقال إلى مسار تسجيل الدخول الجديد للترقية إلى البطاقة الديناميكية الرسمية (المستوى 2).
  2. ترقية البطاقات المستورَدة من Gmail: إذا رصدت "محفظة Google" بطاقة ولاء باستخدام حساب المستخدم على Gmail، يمكنها أن تطلب من المستخدم الانتقال إلى مسار الإجراءات والمصادقة للحصول على بطاقة L2 الرسمية.

الخطوة 1: إعداد صف اختبار في "محفظة Google"

حدِّد عناوين URL للتسجيل وتسجيل الدخول وشعار البرنامج وحقول المستخدم المختارة. بعد ذلك، استخدِم الحقول المُدمجة discoverableProgram في loyaltyclass لضبط القيم المناسبة.

اضبط القيم في discoverableProgram لإنشاء نسخة مسودة من برنامج الولاء الذي تم تفعيل ميزة التسجيل/تسجيل الدخول فيه. للتأكّد من أنّ هذا الخيار يظهر للمختبِرين، تحقَّق من إمكانية وصولهم إلى Google Pay وWallet Console. للحصول على تفاصيل حول كيفية مشاركة إذن الوصول إلى Google Pay وWallet Console مع مستخدمين آخرين، يُرجى الاطّلاع على مزيد من المعلومات حول صفحة "المستخدمون".

لإكمال عملية التحقّق من وظائف عملية التنفيذ أثناء عملية التطوير، يُرجى التواصل معنا باستخدام تطبيق الدعم المصغّر في Google Pay وWallet Console. في وحدة التحكّم، اختَر Google Wallet API في الموضوع، واختَر تسجيل الدخول إلى برنامج الولاء/التسجيل فيه في الموضوع الفرعي.

الخطوة 2: تطوير صفحات التسجيل وتسجيل الدخول

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

يجب تقديم إحدى الصفحتَين أو كلتيهما للسماح للمستخدمين بإكمال هذه الإجراءات:

  1. عنوان URL لتسجيل الدخول يمكن للمستخدم من خلاله تسجيل الدخول إلى حساب حالي
  2. عنوان URL للتسجيل يمكن للمستخدم من خلاله إنشاء حساب جديد

يجب أن تستوفي صفحتا تسجيل الدخول والتسجيل المتطلبات التالية:

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

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

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

عند عرض صفحة تسجيل الدخول أو التسجيل، ستنشئ "محفظة Google" مكوّن WebView لنظام Android وسيتم إرسال طلب POST إلى عنوان URL الذي قدّمته. يتم تقديم بيانات المستخدم في المَعلمة SharedDataType المضمّنة في طلب POST مع Content-Type من application/x-www-form-urlencoded وترميز UTF-8. قيمة المَعلمة SharedDataType هي عنصر JSON بترميز Base64.

استنادًا إلى الإجراء الذي اختاره المستخدم والحقول التي حدّدتها لطلبها من المستخدم، قد يحتوي عنصر JSON على الحقول التالية.

الحقل التسجيل
البريد الإلكتروني ✓
firstName ✓
lastName ✓
addressLine [1-3] ✓
مدينة ✓
الولاية ✓
الرمز البريدي ✓
بلد ✓
هاتف ✓

يُرجى الرجوع إلى ما يلي للاطّلاع على نموذج عنصر JSON تم فك ترميزه ومضمّن في SharedDataType.

المورد

{
  "firstName": "Jane",
  "lastName": "Doe",
  "addressLine1": "1600 Amphitheatre Pkwy",
  "addressLine2": "Apt 123",
  "addressLine3": "Attn:Jane",
  "city": "Mountain View",
  "state": "CA",
  "zipcode": "94043",
  "country": "US",
  "email": "jane.doe@example.com",
  "phone": "555-555-5555"
}

الخطوة 3: تنفيذ عملية الإرجاع الفوري إلى "محفظة Google"

بعد المصادقة (تسجيل الدخول) أو بعد إنشاء الحساب (التسجيل)، من المفترض أن تعيد صفحتك على الفور بطاقة الولاء الخاصة بالمستخدم إلى "محفظة Google".

يمكنك إعادة بطاقة الولاء إلى "محفظة Google" من خلال إعادة التوجيه إلى رابط يتّبع البنية التالية.

https://pay.google.com/gp/v/save/{jwt_generated}

الطول الآمن لعنوان URL هو 2000 حرف. يجب ألا تتجاوز الروابط هذا الحدّ. يجب أن تكون العناصر المرمّزة في رموز JWT صغيرة، وأن تحتوي فقط على بيانات خاصة بالمستخدم. حاوِل الاحتفاظ بمعظم البيانات في فئة العنصر، وإنشائها قبل إنشاء رمز JWT. بالنسبة إلى العناصر الأكبر حجمًا التي لا تتجاوز الحدّ الأقصى، ننصحك أولاً بإنشاء العنصر في Google Wallet API وإرسال معرّف العنصر فقط في رمز JWT.

سير عملية التواصل المعتاد

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

مسارات تسجيل الدخول للتسجيل

الخطوة 4: طلب التحقّق والتفعيل

بعد إكمال عملية التطوير واختبار مسارات التسجيل/تسجيل الدخول، عليك إرسال طلب لمراجعة عملية التنفيذ وتفعيلها بالكامل.

  1. انتقِل إلى Google Pay & Wallet Console.
  2. استخدِم التطبيق المصغّر التواصل مع فريق الدعم.
  3. أبلِغ فريق الدعم بأنّك أكملت عملية دمج ميزة "التسجيل في برنامج الولاء".

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

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

الأسئلة الشائعة

  • هل هناك أي متطلبات للصور المستخدَمة في برنامج الولاء؟ نعم، يجب استضافة صورك في موقع HTTPS، وإلا لن تظهر في "محفظة Google".

  • هل تتوفّر أي أدوات تسهّل تنفيذ رموز JWT وتصحيح أخطائها؟ نعم، تتيح لك منصات مثل www.jwt.io فك ترميز الرموز المميّزة وتصحيح أخطائها أثناء عملية التطوير، ما يتيح لك التحقّق من المحتوى الذي ترسله. يُرجى العِلم أنّ Google ليست تابعة لأي من هذه الجهات الخارجية ولا تنصح بالتعامل مع أي منها تحديدًا.

  • كيف يمكننا التعامل بشكل صحيح مع بيانات SharedDataType المرمّزة باستخدام Base64؟ تأكَّد من استخدام ترميز UTF-8 طوال العملية. يتم أولاً ترميز سلسلة JSON باستخدام UTF-8، ثم ترميزها باستخدام android.util.Base64 مع الخيارَين NO_WRAP وURL_SAFE. يتوافق ذلك مع القسم 4 من RFC 3548.