تتيح ميزة تسجيل برنامج الولاء وتسجيل الدخول للمستخدمين إمكانية البحث عن برنامج الولاء والانضمام إلى حسابه أو تسجيل الدخول إليه من "محفظة Google". سيتم توجيه المستخدمين إلى موقعك الإلكتروني المتوافق مع الأجهزة الجوّالة لإكمال العملية، وبعدها يمكنهم إضافة بطاقاتهم إلى "محفظة Google".
يقدّم هذا الدليل نظرة عامة على خطوات التنفيذ المطلوبة لتفعيل برنامج الولاء لهذه الميزة.
نظرة عامة
للبدء، تأكَّد من أنّه سبق لك إعداد مشروعك ومن إمكانية الوصول إلى Google Wallet API.
يجب اتّباع الخطوات الأربع التالية لتطبيق ميزة التسجيل وتسجيل الدخول في برنامج الولاء:
- يمكنك إعداد صف تجريبي في "محفظة Google" لاختبار إجراءات التسجيل/تسجيل الدخول.
- تطوير صفحات التسجيل/تسجيل الدخول التي تستخدم
SharedDataTypeفي "محفظة Google" - يمكنك تطبيق ميزة إرسال بطاقة الولاء مرة أخرى على "محفظة Google" بعد التسجيل أو تسجيل الدخول.
- يُرجى طلب إثبات الهوية والتفعيل.
إعداد صف تجريبي في "محفظة Google"
حدِّد عناوين URL للتسجيل وتسجيل الدخول وشعار البرنامج وحقول المستخدمين التي تم اختيارها. بعد ذلك،
استخدِم حقول discoverableProgram المدمجة في
loyaltyclass لضبط
القيم المناسبة.
حدِّد القيم في discoverableProgram لإنشاء نسخة مسودة من برنامج الولاء الذي يمكّن التسجيل/تسجيل الدخول. للتأكُّد من ظهور هذا الملف للمختبِرين، يُرجى التأكّد من
إمكانية وصول المختبِرين إلى حسابك على Google Pay و"وحدة التحكّم في المحفظة". للاطّلاع على تفاصيل حول كيفية مشاركة إذن الوصول إلى Google Pay و"محفظة Google" مع مستخدمين آخرين، يُرجى الاطّلاع على المقالة
مزيد من المعلومات حول صفحة "المستخدمون".
لإكمال عملية التحقّق من وظيفة التنفيذ أثناء عملية التطوير، يُرجى التواصل معنا باستخدام أداة التواصل مع فريق الدعم في Google Pay و Wallet Console. في وحدة التحكّم، اختَر Google Wallet API في الموضوع، واختَر تسجيل الدخول/التسجيل في برنامج الولاء في الموضوع الفرعي.
تطوير صفحات التسجيل وتسجيل الدخول التي تستخدم بيانات مستخدم "محفظة Google"
عندما يختار المستخدم تسجيل الدخول أو التسجيل في برنامج الولاء، يتم توجيهه إلى صفحة مخصصة على موقعك الإلكتروني لإكمال عملية التسجيل أو تسجيل الدخول. إذا اختار مستخدم التسجيل، فسوف تطلب محفظة Google من المستخدم الموافقة على مشاركة بياناته معك.
وعليك تقديم إحدى الصفحتين أو كلتيهما للسماح للمستخدمين بإكمال هذه الإجراءات.
- عنوان URL لتسجيل الدخول حيث يمكن للمستخدم تسجيل الدخول إلى حساب حالي.
- عنوان URL للتسجيل حيث يمكن للمستخدم إنشاء حساب جديد.
يجب أن تستوفي صفحات تسجيل الدخول والتسجيل المتطلبات التالية:
- قدِّم تجربة مستخدم متوافقة مع الأجهزة الجوّالة.
- واحرص على تقليل عدد الحقول المطلوبة أثناء عملية التسجيل.
- السماح للمستخدم بإكمال عملية تسجيل الدخول أو التسجيل في صفحة واحدة
- استخدِم تشفير
HTTPSمع شهادة صالحة لضمان نقل بيانات المستخدمين بأمان. - ضمان وقت تشغيل لا يقل عن 99.9% من صفحات تسجيل الدخول والتسجيل.
وبالإضافة إلى المتطلبات المذكورة أعلاه، ننصحك بالسماح للمستخدمين بالتسجيل في برنامج الولاء بدون ملء أي نموذج أو إبقاء الصفحة تقتصر على قبول بنود الخدمة فقط.
- من خلال الاستفادة من بيانات المستخدمين المقدَّمة في
SharedDataType، يمكنك إنشاء حساب ودفع بطاقة الولاء على الفور. - يمكنك بعد ذلك إرسال رسالة إلكترونية إلى المستخدم تحتوي على كلمة مرور صالحة لمرة واحدة أو رابط لضبط كلمة المرور وتفاصيل الحساب الاختيارية.
- ويحدّ ذلك من فرصة تراجُع المستخدمين عن عملية التسجيل، لأنّ كل خطوة إضافية يمكن أن تؤدي إلى المزيد من الانسحاب.
عند مشاركة عرض صفحة تسجيل الدخول أو التسجيل، ستنشئ "محفظة Google"
واجهة WebView لنظام Android ويتم تقديم طلب POST إلى عنوان URL الذي قدّمته. يتم توفير بيانات المستخدم في المعلَمة SharedDataType التي يتم تضمينها في طلب POST باستخدام نوع المحتوى
Application/x-www-form-urlEncrypt وترميز UTF-8. وتكون قيمة المعلَمة SharedDataType هي كائن JSON مرمّز باستخدام Base64.
استنادًا إلى الإجراء الذي اختاره المستخدم والحقول التي حدّدتها لطلبه من المستخدم، قد يحتوي كائن JSON على الحقول التالية.
| الحقل | التسجيل | تسجيل الدخول |
|---|---|---|
| بريد إلكتروني | ✓ | ✓ |
| firstName | ✓ | |
| lastName | ✓ | |
| addressLine [1-3] | ✓ | |
| city | ✓ | |
| state | ✓ | |
| الرمز البريدي | ✓ | |
| بلد | ✓ | |
| الهاتف | ✓ |
يمكنك الاطّلاع أدناه على نموذج تم فك ترميزه من عناصر 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"
}
إضافة بطاقة الولاء بشكل فوري إلى "محفظة Google"
بعد المصادقة (تسجيل الدخول) أو بعد إنشاء الحساب (التسجيل)، من المفترض أن تعيد صفحتك على الفور إرسال بطاقة ولاء المستخدم إلى "محفظة Google".
يمكنك إرجاع بطاقة الولاء إلى "محفظة Google" من خلال إعادة توجيهك إلى رابط يتبع البنية أدناه.
https://pay.google.com/gp/v/save/{jwt_generated}
يبلغ الطول الآمن لعنوان URL 2000 حرف. ويجب أن تبقى الروابط أقل من هذا الحدّ يجب أن تكون العناصر المشفرة بتنسيق JWT صغيرة، وتحتوي فقط على البيانات الخاصة بالمستخدم. حاول الاحتفاظ بمعظم البيانات في فئة الكائن، إنشائها قبل إنشاء JWT. بالنسبة إلى العناصر الأكبر التي لا تناسب الحدّ الأقصى المسموح به، ننصحك أولاً بإنشاء العنصر في Google Wallet API وإرسال معرّف العنصر فقط في JWT.
تدفق التواصل المعتاد
ويتم توضيح كيفية التواصل للمستخدم الذي يُكمل التسجيل أو تسجيل الدخول في الصورة التالية. وتتحمّل أنت مسؤولية تنفيذ جميع الإجراءات بين "خادمك".
طلب إثبات الهوية والتفعيل
بعد إكمال أعمال التطوير واختبار مسارات التسجيل/تسجيل الدخول، يمكنك إرسال طلب من خلال أداة الدعم في Google Pay و"محفظة Google".
بعد إجراء مراجعة كاملة لعملية التنفيذ للتأكّد من صحة الوظائف في الجمع بين تطبيق "محفظة 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.