ฟีเจอร์การลงทะเบียนบัตรของขวัญ (การลงชื่อเข้าใช้) ช่วยให้ผู้ใช้ค้นหาบัตรของขวัญและเพิ่มลงใน Google Wallet ได้ ระบบจะนำผู้ใช้ไปยังเว็บไซต์ที่เหมาะกับอุปกรณ์เคลื่อนที่เพื่อดำเนินการ หลังจากนั้น ลูกค้าจะเพิ่มบัตรลงใน Google Wallet ได้
คู่มือนี้จะกล่าวถึงภาพรวมของขั้นตอนการติดตั้งใช้งานที่จำเป็นเพื่อเปิดใช้โปรแกรมบัตรของขวัญสำหรับฟีเจอร์นี้
ภาพรวม
ในการเริ่มต้นใช้งาน ให้ตรวจสอบว่าคุณได้ตั้งค่าโปรเจ็กต์ไว้ก่อนหน้านี้และมีสิทธิ์เข้าถึง Google Wallet API
คุณต้องทำตาม 4 ขั้นตอนต่อไปนี้เพื่อใช้ฟีเจอร์การลงชื่อเข้าใช้ สำหรับโปรแกรมบัตรของขวัญ
- ตั้งค่าคลาสทดสอบใน Google Wallet เพื่อทดสอบขั้นตอนการลงชื่อเข้าใช้
- พัฒนาหน้าลงชื่อเข้าใช้ที่ใช้ Google Wallet
SharedDataType - ดำเนินการส่งคืนบัตรของขวัญไปยัง Google Wallet หลังจากลงชื่อเข้าใช้
- ขอการยืนยันและการเปิดใช้งาน
ตั้งค่าชั้นเรียนการสอบใน Google Wallet
กำหนด URL การลงชื่อเข้าใช้และโลโก้โปรแกรม จากนั้นให้ทำดังนี้
ใช้ช่องที่ซ้อนกัน discoverableProgram ช่องใน
giftcardclass เพื่อตั้งค่า
ค่าที่เหมาะสม
ตั้งค่าใน discoverableProgram เพื่อสร้างเวอร์ชันร่างของ
โปรแกรมบัตรของขวัญที่เปิดใช้การลงชื่อเข้าใช้ ยืนยันว่าผู้ทดสอบจะเห็นข้อมูลนี้
ผู้ทดสอบมีสิทธิ์เข้าถึง Google Pay และ Wallet Console สำหรับรายละเอียดเกี่ยวกับวิธีแชร์
การเข้าถึงกับผู้อื่นของ Google Pay และ Wallet Console โปรดดูที่
ดูข้อมูลเกี่ยวกับหน้าผู้ใช้
หากต้องการยืนยันฟังก์ชันการทำงานของการติดตั้งใช้งานในระหว่างกระบวนการพัฒนา ให้ติดต่อเราโดยใช้วิดเจ็ตติดต่อทีมสนับสนุนใน Google Pay และ Wallet Console ขณะอยู่ใน เลือก Google Wallet API ในหัวข้อ แล้วเลือก Gift card sign-in หัวข้อย่อย
พัฒนาหน้าลงชื่อเข้าใช้ที่ใช้ข้อมูลผู้ใช้ Google Wallet
เมื่อผู้ใช้เลือกเพิ่มบัตรของขวัญ ระบบจะนําไปยังหน้าเว็บที่ปรับให้เหมาะกับผู้ใช้ในเว็บไซต์เพื่อดําเนินขั้นตอนการลงชื่อเข้าใช้ให้เสร็จสมบูรณ์
คุณต้องระบุ URL สำหรับการลงชื่อเข้าใช้ที่ผู้ใช้สามารถลงชื่อเข้าใช้ได้ บัญชีที่มีอยู่
หน้าลงชื่อเข้าใช้ของคุณต้องเป็นไปตามข้อกำหนดต่อไปนี้
- มอบประสบการณ์การใช้งานที่เหมาะกับอุปกรณ์เคลื่อนที่แก่ผู้ใช้
- อนุญาตให้ผู้ใช้ลงชื่อเข้าใช้ให้เสร็จสิ้นภายในหน้าเดียว
- ใช้การเข้ารหัส
HTTPSด้วยใบรับรองที่ถูกต้องเพื่อให้มั่นใจว่าข้อมูลผู้ใช้ได้รับการส่งอย่างปลอดภัย - ตรวจสอบให้แน่ใจว่าหน้าลงชื่อเข้าใช้ของคุณมีระยะเวลาทำงานอย่างน้อย 99.9%
เมื่อแสดงหน้าลงชื่อเข้าใช้ Google Wallet จะสร้าง WebView ของ Android และส่งคําขอ POST ไปยัง URL ที่คุณระบุ มีการระบุข้อมูลผู้ใช้ในพารามิเตอร์ SharedDataType
ซึ่งรวมอยู่ในคำขอ POST โดยใช้
ประเภทเนื้อหาของแอปพลิเคชัน/x-www-form-urlencrypted และ
การเข้ารหัส UTF-8 ค่าของพารามิเตอร์ SharedDataType
คือออบเจ็กต์ JSON ที่เข้ารหัส Base64
ส่งบัตรของขวัญคืนไปยัง Google Wallet ทันที
เมื่อตรวจสอบสิทธิ์ (ลงชื่อเข้าใช้แล้ว) หน้าเว็บของคุณ ควรส่งบัตรของขวัญของผู้ใช้กลับไปที่ Google Wallet ทันที
คุณสามารถส่งบัตรของขวัญกลับไปยัง Google Wallet ได้โดยเปลี่ยนเส้นทางไปยังลิงก์ที่เป็นไปตามโครงสร้าง
https://pay.google.com/gp/v/save/{jwt_generated}ความยาวที่ปลอดภัยสำหรับ URL คือ 2,000 อักขระ ลิงก์ของคุณควรอยู่ภายใต้ขีดจำกัดนี้ ออบเจ็กต์ที่เข้ารหัสใน JWT ควรมีขนาดเล็กและมีเฉพาะข้อมูลที่เจาะจงสำหรับผู้ใช้ พยายามเก็บข้อมูลส่วนใหญ่ไว้ในคลาสของออบเจ็กต์ โดยสร้างคลาสนั้นก่อนสร้าง JWT สำหรับวัตถุขนาดใหญ่ที่ไม่เกินขีดจำกัด โปรดพิจารณา สร้างออบเจ็กต์ใน Google Wallet API และส่งเฉพาะรหัสออบเจ็กต์ใน JWT
ขั้นตอนการติดต่อสื่อสารโดยทั่วไป
ช่องทางการสื่อสารสำหรับผู้ใช้ที่ลงชื่อเข้าใช้เสร็จสมบูรณ์แสดงอยู่ใน รูปภาพต่อไปนี้ การดำเนินการทั้งหมดระหว่าง "เซิร์ฟเวอร์ของคุณ" เป็นความรับผิดชอบของคุณในการดำเนินการ
ขอการยืนยันและเปิดใช้งาน
หลังจากพัฒนาและทดสอบขั้นตอนการลงชื่อเข้าใช้เสร็จแล้ว ให้ส่งคำขอ ผ่านทาง Google Pay และ Wallet Console ติดต่อทีมสนับสนุน วิดเจ็ต
หลังจากการตรวจสอบการติดตั้งใช้งานอย่างเต็มรูปแบบซึ่งยืนยันว่าฟีเจอร์ทำงานได้อย่างถูกต้องเมื่อใช้ร่วมกับแอป Google Wallet แล้ว เราจะเปิดตัวฟีเจอร์ลงชื่อเข้าใช้บัตรของขวัญสำหรับโปรแกรมบัตรของขวัญของคุณต่อสาธารณะ ซึ่งจะช่วยให้ผู้ใช้ทุกคนเห็น โปรแกรมและใช้ประโยชน์จากฟีเจอร์นี้
เพื่อให้มั่นใจว่าผู้ใช้จะได้รับประสบการณ์การใช้งานที่ดีที่สุด เราจึงตรวจสอบการลงชื่อเข้าใช้เป็นประจำ จะมีการดำเนินการเพื่อให้เป็นไปตามข้อกำหนดเกี่ยวกับฟีเจอร์อย่างต่อเนื่อง คุณจะได้รับการแจ้งเตือนในกรณีที่มีความคลาดเคลื่อนและฟีเจอร์การลงชื่อเข้าใช้ อาจถูกปิดใช้จนกว่าปัญหาจะได้รับการแก้ไข
คำถามที่พบบ่อย
- มีข้อกำหนดสำหรับรูปภาพที่ใช้ในโปรแกรมบัตรของขวัญไหม
- ใช่ รูปภาพควรโฮสต์อยู่ในตำแหน่ง
HTTPSเนื่องจากไม่เช่นนั้นรูปภาพจะไม่ปรากฏใน Google Wallet
- ใช่ รูปภาพควรโฮสต์อยู่ในตำแหน่ง
- มีเครื่องมือที่ช่วยให้การติดตั้งใช้งานและการแก้ไขข้อบกพร่องของ JWT ง่ายขึ้นไหม
- ใช่ แพลตฟอร์มต่างๆ เช่น www.jwt.io ให้คุณถอดรหัส และแก้ไขข้อบกพร่องของโทเค็นในระหว่างกระบวนการพัฒนา ซึ่งคุณจะสามารถยืนยัน เนื้อหาที่คุณได้ส่ง โปรดทราบว่า Google ไม่มีความเกี่ยวข้องทางธุรกิจและไม่ได้ ขอแนะนำบุคคลที่สามดังกล่าวเป็นพิเศษ
- เราจะจัดการข้อมูล SharedDataType ที่เข้ารหัส Base64 อย่างถูกต้องได้อย่างไร
- ตรวจสอบว่าคุณใช้การเข้ารหัส UTF-8 ตลอดทั้งกระบวนการ สตริง JSON ได้รับการเข้ารหัส UTF-8 ก่อน จากนั้นจึงเข้ารหัสโดยใช้ android.util.Base64 พร้อมตัวเลือก NO_WRAP และ URL_SAFE ซึ่งสอดคล้องกับส่วนที่ 4 ของ RFC 3548