ویژگی ثبتنام و ورود به سیستم وفاداری به کاربران اجازه میدهد برنامه وفاداری شما را جستجو کنند و مستقیماً از «کیف پول Google» به حسابشان بپیوندند یا به سیستم آن وارد شوند. کاربران برای تکمیل فرایند به وبسایت سازگار با تلفن همراه شما هدایت میشوند و پساز آن میتوانند کارت رسمیشان را به «کیف پول Google» اضافه کنند.
پیادهسازی این ویژگی پیشنیاز تبدیل مجوزهای «ایستا» اضافهشده توسط کاربر به مجوزهای پیوندشده به میانای برنامهسازی کاربردی «پویا» است. این راهنما نمای کلی از مزایا و مراحل پیادهسازی لازم برای فعال کردن برنامه وفاداری شما برای ثبتنام، ورود به سیستم، و ارتقای مجوز را ارائه میدهد.
نمای کلی
برای شروع، مطمئن شوید که قبلاً پروژهتان را راهاندازی کردهاید و به Google Wallet API دسترسی دارید.
برای پیادهسازی این ویژگی باید این چهار مرحله را دنبال کنید:
- راهاندازی کلاس آزمایشی: «کیف پول Google» را برای آزمایش کردن جریانهایتان پیکربندی کنید.
- توسعه صفحهها: بااستفاده از
SharedDataType«کیف پول Google»، صفحههای ثبتنام/ ورود به سیستم بسازید. - اجرای Push Back: ارسال کارت وفاداری به «کیف پول Google» پساز اقدام.
- درخواست درستیسنجی: برای بازبینی ارسال کنید و فعالسازی ارتقا را درخواست کنید.
چرا «ثبتنام وفاداری» را پیادهسازی کنیم؟
برای درک ارزش این ادغام، مهم است که بین دو نوع مجوزی که در «کیف پول Google» وجود دارد تمایز قائل شویم: L1 (افزودهشده توسط کاربر) و L2 (صادرشده توسط شریک).
تفاوت بین L1 و L2
| ویژگی | L1 Pass (User-Added) | مجوز L2 (صادرشده توسط شریک) |
|---|---|---|
| مبدأ | وقتی کاربر کارت فیزیکی را بهصورت دستی اسکن میکند یا شمارهای را تایپ میکند، ایجاد میشود. | پساز اینکه کاربر بااستفاده از جریان شما ثبتنام یا ورود به سیستم کرد، بااستفاده از Wallet API ایجاد و ارسال میشود. |
| کنترل | ایستا. شریک هیچگونه رؤیتپذیری یا کنترلی بر این مجوز ندارد. | پویا. شریک بااستفاده از میانای برنامهسازی کاربردی کنترل کامل دارد. |
| عملکرد | تصویر ثابت از رمزینه. بهروزرسانی نمیشود. | میتواند تراز امتیازها و وضعیت سطح را بهروز کند، پیشنهادهای شخصیسازیشده را نمایش دهد، و اعلان دریافت کند. |
مسیرهای ارتقا: «پل» منتهی به برنامه شما
با ساختن جریان «ثبتنام وفاداری» («مقصد»)، به Google امکان میدهید «پلی» بسازد که کاربران را از مجوزهای L1 ایستا به مجوزهای L2 رسمی شما ارتقا دهد. دو راهانداز اصلی برای ارتقا وجود دارد:
- ارتقای مجوز از سطح ۱ به سطح ۲: اگر کاربری قبلاً کارت شما را بهصورت دستی اضافه کرده باشد (سطح ۱)، «کیف پول Google» میتواند از او بخواهد برای ارتقا به مجوز رسمی و پویا (سطح ۲) از جریان ورود به سیستم جدید شما بازدید کند.
- ارتقای مجوز واردشده از Gmail: اگر «کیف پول Google» کارت وفاداریای را بااستفاده از Gmail کاربر شناسایی کند، میتواند از کاربر بخواهد از جریان شما بازدید کند و برای دریافت مجوز رسمی L2 اصالتسنجی کند.
مرحله ۱: راهاندازی کلاس آزمایشی در «کیف پول Google»
نشانیهای وب ثبتنام و ورود به سیستم، نشانواره برنامه، و فیلدهای کاربر انتخابشده را تعیین کنید. سپس، از فیلدهای تودرتوی discoverableProgram در
loyaltyclass
برای تنظیم مقادیر مناسب استفاده کنید.
مقادیر را در discoverableProgram تنظیم کنید تا نسخه پیشنویس برنامه وفاداری فعالشده برای ثبتنام/ ورود به سیستم را ایجاد کنید. برای اطمینان از اینکه این مورد برای آزمایشکنندگان قابلمشاهده است، بررسی کنید که آزمایشکنندگان به Google Pay و «کنسول کیف پول» شما دسترسی داشته باشند. برای جزئیات مربوط به نحوه همرسانی دسترسی به «کنسول Pay و کیف پول Google» با افراد دیگر، به آشنایی با صفحه «کاربران» مراجعه کنید.
برای تکمیل درستیسنجی عملکرد پیادهسازیتان درطول فرایند توسعه، بااستفاده از ابزارک پشتیبانی تماس در «کنسول کیف پول و Google Pay» با ما تماس بگیرید. وقتی در کنسول هستید، Google Wallet API را در موضوع و ورود به سیستم/ ثبتنام وفاداری را در زیرموضوع انتخاب کنید.
مرحله ۲: توسعه صفحههای ثبتنام و ورود به سیستم
وقتی کاربری تصمیم میگیرد برای برنامه وفاداری شما ثبتنام کند یا وارد سیستم شود، به صفحه سفارشیشدهای در وبسایت شما هدایت میشود تا فرایند ثبتنام یا ورود به سیستم را تکمیل کند. اگر کاربری تصمیم به ثبتنام بگیرد، «کیف پول Google» از کاربر درخواست میکند که با همرسانی دادههای کاربر با شما موافقت کند.
باید یکی از این دو صفحه یا هر دو را ارائه دهید تا کاربران بتوانند این کنشها را تکمیل کنند:
- نشانی وب ورود به سیستم که کاربر میتواند ازطریق آن به سیستم حساب موجود وارد شود.
- نشانی وب ثبتنام که کاربر میتواند در آن حساب جدیدی ایجاد کند.
صفحههای ورود به سیستم و ثبتنام شما باید الزامات زیر را برآورده کند:
- تجربه کاربری سازگار با تلفن همراه ارائه دهید.
- تعداد فیلدهای الزامی را درطول فرایند ثبتنام به حداقل برسانید.
- به کاربر اجازه دهید ورود به سیستم یا ثبتنام را در یک صفحه تکمیل کند.
- از رمزگذاری
HTTPSبا گواهی معتبر استفاده کنید تا مطمئن شوید دادههای کاربر بهطور ایمن منتقل میشود. - مطمئن شوید که زمان فعال بودن صفحههای ورود به سیستم و ثبتنام شما حداقل ۹۹٫۹٪ باشد.
علاوهبر این الزامات، توصیه میکنیم به کاربران اجازه دهید بدون پر کردن هیچ فرمی یا فقط با پذیرفتن شرایط خدمات شما در برنامه وفاداریتان ثبتنام کنند.
- با بهرهگیری از دادههای کاربر ارائهشده در
SharedDataType، میتوانید حسابی ایجاد کنید و بلافاصله کارت وفاداری او را برگردانید. - سپس میتوانید گذرواژه یکبارمصرف یا پیوندی برای پیکربندی گذرواژه و جزئیات اختیاری حساب به ایمیل کاربر ارسال کنید.
- این کار احتمال رها کردن فرایند ثبتنام توسط کاربران را کاهش میدهد، زیرا هر مرحله اضافی میتواند منجر به انصراف بیشتر شود.
هنگام ارائه صفحه ورود به سیستم یا ثبتنام، «کیف پول Google» یک
Android WebView ایجاد میکند و درخواست POST به نشانی وب ارائهشده شما ارسال میشود. دادههای کاربر در پارامتر 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"
}
مرحله ۳: پیادهسازی ارسال فوری به «کیف پول Google»
پساز اصالتسنجی (ورود به سیستم) یا پساز ایجاد حساب (ثبتنام)، صفحه شما باید فوراً کارت وفاداری کاربر را به «کیف پول Google» برگرداند.
میتوانید با هدایت کردن به پیوندی که از ساختار زیر پیروی میکند، کارت وفاداری را به «کیف پول Google» برگردانید.
https://pay.google.com/gp/v/save/{jwt_generated}
طول ایمن برای نشانی وب ۲۰۰۰ نویسه است. پیوندهایتان نباید از این حد فراتر برود. اشیاء کدبندیشده در JWT باید کوچک باشند و فقط حاوی دادههای مختص کاربر باشند. سعی کنید بیشتر دادهها را در کلاس شیء نگه دارید و آن را قبلاز ساختن JWT ایجاد کنید. برای اشیای بزرگتر که از حد مجاز فراتر نمیروند، ابتدا شیء را در Google Wallet API ایجاد کنید و فقط شناسه شیء را در JWT ارسال کنید.
جریان ارتباطی معمول
جریان ارتباطی برای کاربری که ثبتنام یا ورود به سیستم را تکمیل میکند در تصویر زیر نشان داده شده است. مسئولیت اجرای همه کنشهای بین «سرور شما» برعهده شما است.

مرحله ۴: درخواست درستیسنجی و فعالسازی
پساز تکمیل کار توسعه و آزمایش جریانهای ثبتنام/ ورود به سیستم، باید درخواستی ارسال کنید تا پیادهسازی شما بازبینی و کاملاً فعال شود.
- به کنسول کیف پول و Google Pay بروید.
- از ابزارک تماس با پشتیبانی استفاده کنید.
- به تیم پشتیبانی اطلاع دهید که ادغام «ثبتنام وفاداری» را تکمیل کردهاید.
پساز بررسی کامل پیادهسازی شما که عملکرد صحیح را در ترکیب با برنامه «کیف پول Google» تأیید میکند، ویژگی ثبتنام/ ورود به سیستم وفاداری بهطور عمومی برای برنامه وفاداری شما راهاندازی خواهد شد.
برای اطمینان از تجربه کاربری بهینه، پیادهسازی ثبتنام/ ورود به سیستم شما بهطور مکرر بررسی خواهد شد تا از رعایت مداوم الزامات ویژگی اطمینان حاصل شود. درصورت وجود مغایرت به شما اطلاع داده خواهد شد و ممکن است عملکرد ورود به سیستم/ثبتنام تا زمان حل مشکل غیرفعال شود.
پرسشگان
آیا برای تصاویر استفادهشده در برنامه وفاداری من الزامی وجود دارد؟ بله، تصاویرتان باید در مکان
HTTPSمیزبانی شود، درغیراینصورت در «کیف پول Google» نمایان نخواهد بود.آیا ابزاری وجود دارد که پیادهسازی و اشکالزدایی JWT را ساده کند؟ بله، پلاتفرمهایی مثل www.jwt.io به شما امکان میدهند درطول فرایند توسعه، رمزهایتان را رمزگشایی و اشکالزدایی کنید و محتوایی را که ارسال میکنید درستیسنجی کنید. توجه داشته باشید که Google هیچ وابستگیای به این اشخاص ثالث ندارد و بهطور خاص هیچکدام از آنها را توصیه نمیکند.
چگونه دادههای کدبندیشده با Base64
SharedDataTypeرا بهدرستی مدیریت کنیم؟ مطمئن شوید که در سراسر فرایندتان از کدبندی UTF-8 استفاده میکنید. رشته JSON ابتدا با UTF-8 کدبندی میشود و سپس بااستفاده از android.util.Base64 با گزینههای NO_WRAP و URL_SAFE کدبندی میشود. این با RFC 3548 بخش ۴ مطابقت دارد.