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