ฟีเจอร์การลงทะเบียนบัตรของขวัญ (ลงชื่อเข้าใช้) ช่วยให้ผู้ใช้ค้นหา แล้วเพิ่มลงใน Google Wallet ระบบจะนำผู้ใช้ไปยังเว็บไซต์ที่เหมาะกับอุปกรณ์เคลื่อนที่เพื่อดำเนินการ หลังจากนั้น ลูกค้าจะเพิ่มบัตรลงใน Google Wallet ได้
คู่มือนี้จะให้ภาพรวมของขั้นตอนการติดตั้งใช้งานที่จําเป็น เพื่อเปิดใช้โปรแกรมบัตรของขวัญสำหรับฟีเจอร์นี้
ภาพรวม
หากต้องการเริ่มต้นใช้งาน ให้ตรวจสอบว่าคุณได้ตั้งค่าโปรเจ็กต์ไว้ก่อนหน้านี้และมีสิทธิ์เข้าถึง API ของ Google Wallet
คุณต้องทำตาม 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 จะสร้าง
มี Android WebView และมีการส่งคำขอ 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 ซึ่งสอดคล้องกับ RFC 3548 ส่วนที่ 4