ภาพรวม

OAuth-based App Flip Linking (App Flip) allows your users to easily and quickly link their accounts in your authentication system to their Google accounts. If your app is installed on your user’s phone when they initiate the account linking process, they are seamlessly flipped to your app to obtain user authorization.

This approach provides a faster and easier linking process since the user does not have to re-enter their username and password to authenticate; instead, App Flip leverages the credentials from the user's account on your app. Once a user has linked their Google account with your app, they can take advantage of any integrations that you have developed.

You can set up App Flip for both iOS and Android apps.

This figure shows the steps for a user to link their Google account to your authentication system. The first screenshot shows how a user can select your app if their Google account is linked to your app. The second screenshot shows the confirmation for linking their Google account with your app. The third screenshot shows a successfully linked user account in the Google app.
Figure 1. Account linking on a user's phone with App Flip.

Requirements

To implement App Flip, you must fulfill the following requirements:

  • You must have an Android or iOS app.
  • You must own, manage and maintain an OAuth 2.0 server which supports the OAuth 2.0 authorization code flow.

ดูข้อมูลเพิ่มเติมเกี่ยวกับขั้นตอนรหัสการให้สิทธิ์การลิงก์ OAuth ได้ที่ใช้งานเซิร์ฟเวอร์ OAuth

หลักเกณฑ์การออกแบบ

ส่วนนี้จะอธิบายข้อกำหนดในการออกแบบและคำแนะนำสำหรับหน้าจอคำยินยอมการลิงก์บัญชีแอปพลิกบัญชี หลังจาก Google เรียกแอปของคุณแล้ว แอปจะแสดงหน้าจอขอความยินยอมต่อผู้ใช้

ข้อกำหนด

  1. คุณต้องสื่อสารว่าบัญชีของผู้ใช้ลิงก์กับ Google ไม่ใช่กับผลิตภัณฑ์บางอย่างของ Google เช่น Google Home หรือ Google Assistant

คำแนะนำ

เราขอแนะนำให้คุณทำดังนี้

  1. แสดงนโยบายความเป็นส่วนตัวของ Google ใส่ลิงก์ไปยังนโยบายความเป็นส่วนตัวของ Google ในหน้าจอขอความยินยอม

  2. ข้อมูลที่แชร์ ใช้ภาษาที่ชัดเจนและกระชับเพื่อบอกให้ผู้ใช้ทราบว่า Google ต้องการข้อมูลใดและเพราะเหตุใด

  3. คำกระตุ้นให้ดำเนินการที่ชัดเจน ระบุคำกระตุ้นให้ดำเนินการ (Call-To-Action) ที่ชัดเจนในหน้าจอขอความยินยอม เช่น "ตกลงและลิงก์" เนื่องจากผู้ใช้ต้องเข้าใจว่าต้องแชร์ข้อมูลใดกับ Google เพื่อลิงก์บัญชี

  4. ความสามารถในการยกเลิก ระบุวิธีให้ผู้ใช้ย้อนกลับหรือยกเลิก หากผู้ใช้เลือกที่จะไม่ลิงก์

  5. ความสามารถในการยกเลิกการลิงก์ เสนอกลไกให้ผู้ใช้ยกเลิกการลิงก์ เช่น URL ไปยังการตั้งค่าบัญชีบนแพลตฟอร์ม หรือจะรวมลิงก์ไปยังบัญชี Google ที่ผู้ใช้สามารถจัดการบัญชีที่ลิงก์ของตนก็ได้

  6. ความสามารถในการเปลี่ยนบัญชีผู้ใช้ แนะนำวิธีการให้ผู้ใช้เปลี่ยนบัญชี ซึ่งจะเป็นประโยชน์อย่างยิ่งหากผู้ใช้มีแนวโน้มที่จะมีบัญชีหลายบัญชี

    • หากผู้ใช้ต้องปิดหน้าจอขอความยินยอมเพื่อเปลี่ยนบัญชี ให้ส่งข้อผิดพลาดที่แก้ไขได้ไปยัง Google เพื่อให้ผู้ใช้ลงชื่อเข้าใช้บัญชีที่ต้องการได้โดยใช้การลิงก์ OAuth และขั้นตอนโดยนัย

  7. ใส่โลโก้ของคุณ แสดงโลโก้บริษัทในหน้าจอขอความยินยอม ใช้หลักเกณฑ์การจัดรูปแบบในการวางโลโก้ หากต้องการแสดงโลโก้ของ Google ด้วย โปรดดูโลโก้และเครื่องหมายการค้า

รูปภาพนี้แสดงตัวอย่างหน้าจอขอความยินยอมพร้อมข้อความไฮไลต์ถึงข้อกําหนดและคําแนะนําแต่ละข้อที่ควรปฏิบัติตามเมื่อออกแบบหน้าจอขอความยินยอมของผู้ใช้
รูปที่ 2 หลักเกณฑ์การออกแบบหน้าจอขอความยินยอมสำหรับการลิงก์บัญชี

ตั้งค่าสำหรับ App Flip ที่ใช้ OAuth

ส่วนต่อไปนี้จะอธิบายข้อกำหนดเบื้องต้นสำหรับ App Flip ที่ใช้ OAuth และวิธีกำหนดค่าโปรเจ็กต์ App Flip ในคอนโซลการดำเนินการ

สร้าง การดำเนินการ และตั้งค่าเซิร์ฟเวอร์ OAuth 2.0

ก่อนที่จะกำหนดค่า App Flip ได้ คุณต้องทำสิ่งต่อไปนี้

  • สร้างการดำเนินการ หากต้องการสร้างการดำเนินการ ให้ทำตามวิธีการในส่วนสร้างโปรเจ็กต์
  • ตั้งค่าเซิร์ฟเวอร์ OAuth 2.0 ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าเซิร์ฟเวอร์ OAuth ได้ที่ใช้การลิงก์บัญชี OAuth

กำหนดค่า App Flip ในคอนโซล Actions

หัวข้อต่อไปนี้อธิบายวิธีกำหนดค่า App Flip ในคอนโซล Actions

  1. คลิกพัฒนาในการนำทางด้านบน จากนั้นคลิกการลิงก์บัญชีในการนําทางด้านซ้าย
  2. เปิดสวิตช์ข้างการลิงก์บัญชี
  3. ในส่วนการสร้างบัญชี ให้เลือกไม่ ฉันต้องการอนุญาตให้ สร้างบัญชีบนเว็บไซต์เท่านั้น
  4. คลิกถัดไป
  5. ในส่วนประเภทการลิงก์ ให้เลือก OAuth และรหัสการให้สิทธิ์จากเมนูแบบเลื่อนลง
  6. คลิกถัดไป
  7. กรอกข้อมูลในช่องทั้งหมดในส่วนข้อมูลไคลเอ็นต์ OAuth (หากระบบไม่รองรับ App Flip ระบบจะใช้ OAuth ปกติเป็นโฆษณาสำรอง)
  8. คลิกถัดไป
  9. ในส่วนใช้แอปเพื่อการลิงก์บัญชี (ไม่บังคับ) ให้เลือกเปิดใช้สำหรับ iOS
  10. กรอกข้อมูลในช่องลิงก์สากล ดูข้อมูลเพิ่มเติมเกี่ยวกับลิงก์สากลได้ที่การอนุญาตให้แอปและเว็บไซต์ลิงก์กับเนื้อหาของคุณ
  11. หากต้องการกำหนดค่าไคลเอ็นต์หรือไม่ก็ได้ ให้เพิ่มขอบเขตแล้วคลิกเพิ่มขอบเขตในส่วนกำหนดค่าไคลเอ็นต์ (ไม่บังคับ) หากไม่ ให้คลิกถัดไป
  12. ในส่วนวิธีการทดสอบ ให้พิมพ์ test (หรือสตริงอื่นๆ) เป็นตัวยึดตำแหน่ง (การกรอกข้อมูลในช่องนี้ด้วยบัญชีทดสอบจะจําเป็นเฉพาะในกรณีที่ส่งการดําเนินการเพื่อเผยแพร่จริงๆ เท่านั้น)
  13. คลิกบันทึก

ตอนนี้คุณไปยังส่วนถัดไปเพื่อใช้งาน App Flip ในแอป iOS หรือ Android ได้แล้ว

ใช้ App Flip ในแอปที่มาพร้อมเครื่อง

หากต้องการใช้ App Flip คุณต้องแก้ไขรหัสการให้สิทธิ์ของผู้ใช้ในแอปเพื่อยอมรับ Deep Link จาก Google

ทดสอบ App Flip ในอุปกรณ์

ตอนนี้คุณได้สร้างการดำเนินการและกำหนดค่า App Flip บนคอนโซลและในแอปแล้ว คุณสามารถทดสอบ App Flip บนอุปกรณ์เคลื่อนที่ได้ คุณใช้ แอป Google Assistant เพื่อทดสอบ App Flip ได้

หากต้องการทดสอบ App Flip จากแอป Assistant ให้ทำตามขั้นตอนต่อไปนี้

  1. ไปที่คอนโซล Actions แล้วเลือกโปรเจ็กต์
  2. คลิกทดสอบในการนําทางด้านบน
  3. เรียกใช้ขั้นตอนการลิงก์บัญชีจากแอป Assistant
    1. เปิดแอป Google Assistant
    2. คลิกการตั้งค่า
    3. ในแท็บ Assistant ให้คลิกระบบควบคุมอุปกรณ์ในบ้าน
    4. คลิกเพิ่ม(+)
    5. เลือกการดำเนินการจากรายชื่อผู้ให้บริการ ซึ่งจะขึ้นต้นด้วย “[test]” ในรายการ เมื่อเลือกการดำเนินการ [ทดสอบ] จาก รายการ ระบบจะเปิดแอปของคุณ
    6. ยืนยันว่าแอปเปิดใช้งานแล้วและเริ่มทดสอบขั้นตอนการให้สิทธิ์