การจัดสรรบัญชีที่ควบคุมโดยผู้ใช้ – คู่มือนักพัฒนา API

เอกสารนี้จะอธิบายแนวคิดที่สำคัญเกี่ยวกับการใช้ API การจัดเตรียมข้อมูลเพื่อสร้างบัญชี Google Analytics ใหม่

เกริ่นนำ

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

ก่อนที่คุณจะเริ่มต้น

Google Analytics API ทั้งหมดจะมีการเข้าถึงในลักษณะเดียวกัน ก่อนที่จะเริ่มใช้ API การจัดเตรียมข้อมูล คุณควรดำเนินการดังนี้

  • อ่านหน้าไลบรารีของไคลเอ็นต์เพื่อดูรายการไลบรารีไคลเอ็นต์ทั้งหมดของภาษาโปรแกรมที่ใช้งานร่วมกับ API ได้
  • อ่านคู่มืออ้างอิงเพื่อเรียนรู้เกี่ยวกับอินเทอร์เฟซ API และวิธีเข้าถึงข้อมูลโดยไม่มีไลบรารีของไคลเอ็นต์

ไลบรารีของไคลเอ็นต์แต่ละรายการจะมีออบเจ็กต์บริการการวิเคราะห์รายการเดียวเพื่อเข้าถึง API การจัดสรร โดยทั่วไปแล้ว คุณต้องทำตามขั้นตอนต่อไปนี้เพื่อสร้างออบเจ็กต์บริการ

  1. ลงทะเบียนแอปพลิเคชันของคุณในคอนโซล Google API
  2. ให้สิทธิ์สร้างบัญชี Google Analytics ใหม่
  3. สร้างออบเจ็กต์บริการ Analytics

หากคุณยังไม่ได้ทําขั้นตอนเหล่านี้ โปรดหยุดและอ่านบทแนะนำ สวัสดี Google Analytics API บทแนะนำนี้จะแนะนำคุณตลอดขั้นตอนเบื้องต้นในการสร้างแอปพลิเคชัน Google Analytics API เมื่อเสร็จแล้ว คุณจะเข้าใจวิธีเข้าถึง API ของ Google Analytics เพื่อทำงานจริง

ภาพรวม

เมื่อสร้างบัญชี Google Analytics โดยใช้ API การจัดเตรียมข้อมูล มีขั้นตอนที่ 2 ที่คุณควรพิจารณา ได้แก่

  • ขั้นตอนทางเทคนิค: ขั้นตอนตั้งแต่ต้นจนจบในการจัดสรรบัญชี Google Analytics สำหรับผู้ใช้แบบเป็นโปรแกรม
  • โฟลว์ผู้ใช้: ข้อควรพิจารณาในการใช้งานที่คุณควรพิจารณาสำหรับขั้นตอนการสร้างบัญชีจากมุมมองของผู้ใช้

เอกสารนี้จะอธิบายขั้นตอนและข้อกำหนดระดับสูงสำหรับแต่ละขั้นตอน

กระบวนการทางเทคนิค

ขั้นตอนระดับสูงในการใช้ API การจัดสรรเพื่อสร้างบัญชีใหม่และผสานรวมกับ Google Analytics มีดังนี้

  1. แจ้งให้ผู้ใช้ตรวจสอบสิทธิ์และให้สิทธิ์แอปพลิเคชัน/บริการโดยใช้ OAuth 2.0
  2. สร้างตั๋วบัญชีโดยใช้ API การจัดสรร
  3. เปลี่ยนเส้นทางผู้ใช้เพื่อยอมรับข้อกำหนดในการให้บริการ (TOS) ของ Google Analytics และจัดการการตอบสนอง
  4. (ไม่บังคับ) กำหนดค่าบัญชีและ โอกาสในการผสานรวม

หากขั้นตอนเหล่านี้ทั้งหมดเสร็จสมบูรณ์ ระบบจะสร้างบัญชี Google Analytics ให้กับผู้ใช้ และคุณจะมีรหัสบัญชี รหัสพร็อพเพอร์ตี้ และรหัสข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) สำหรับบัญชีใหม่

สำหรับแต่ละขั้นตอนด้านล่างนี้จะมีข้อกำหนดในการทำขั้นตอนดังกล่าว ผลลัพธ์ของขั้นตอน และคำอธิบายขั้นตอนทางเทคนิคสำหรับขั้นตอนนั้นๆ

1. การตรวจสอบสิทธิ์และการให้สิทธิ์

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

สิ่งที่ต้องมีสำหรับขั้นตอนนี้

  • รหัสไคลเอ็นต์ - Client ID ของโปรเจ็กต์ที่คุณจะใช้ ดาวน์โหลดได้ที่ Google Developers Console โปรดอ่านขั้นตอนเว็บเซิร์ฟเวอร์ OAuth 2.0 เพื่อดูข้อมูลเพิ่มเติม
  • URI การเปลี่ยนเส้นทาง - นี่คือที่ที่ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปและส่งการตอบกลับ OAuth 2.0
    • กำหนดค่า Redirect URIs และรับ Client ID สำหรับโปรเจ็กต์โดยใช้ Google Developers Console
    • ค่าของพารามิเตอร์นี้ต้องตรงกับค่าใดค่าหนึ่งที่ลงทะเบียนไว้ใน Google Developers Console (รวมถึงรูปแบบ http หรือ https ตัวพิมพ์ และเครื่องหมาย "/") ต่อท้าย)
  • ขอบเขตการตรวจสอบสิทธิ์สำหรับ API การจัดสรรของ Google Analytics

ผลลัพธ์ของขั้นตอนนี้

เมื่อขั้นตอน OAuth 2.0 เสร็จสมบูรณ์แล้ว ผู้ใช้จะให้สิทธิ์แอปพลิเคชันของคุณในการจัดสรรบัญชีในนามของตนเองและคุณจะได้รับโทเค็นเพื่อการเข้าถึงให้กับผู้ใช้

หมายเหตุเกี่ยวกับโทเค็นและขอบเขต

  • หากต้องการส่งคำขอเพิ่มเติมสำหรับการกำหนดค่าบัญชีของผู้ใช้ หรือข้อมูลการรายงานหลังจากสร้างบัญชีแล้ว คุณอาจให้สิทธิ์ขอบเขตเพิ่มเติมในขั้นตอนนี้ได้ด้วย เช่น ขอบเขต readonly หรือ edit
  • โทเค็นเพื่อการเข้าถึงมีอายุการใช้งานที่จำกัด หากแอปพลิเคชันต้องการสิทธิ์เข้าถึง Google Analytics API เมื่อพ้นอายุการใช้งานของโทเค็นเพื่อการเข้าถึงรายการเดียว คุณจะขอโทเค็นการรีเฟรชได้โดยตั้งค่า access_type=offline ควรบันทึกโทเค็นการรีเฟรชไว้ในพื้นที่เก็บข้อมูลระยะยาวที่ปลอดภัยสำหรับผู้ใช้แต่ละราย เนื่องจากจะช่วยให้แอปพลิเคชันรับโทเค็นเพื่อการเข้าถึงใหม่ได้ ดูรายละเอียดเพิ่มเติมได้ที่การเข้าถึงแบบออฟไลน์

ขั้นตอนทางเทคนิคสำหรับขั้นตอนนี้

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

สร้าง URL ของ OAuth 2.0 เพื่อให้ผู้ใช้เข้าชม

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

https://accounts.google.com/o/oauth2/auth?
  scope=https://www.googleapis.com/auth/analytics.provision
  &redirect_uri={YOUR REDIRECT URI for OAUTH}
  &response_type=code
  &client_id={YOUR CLIENT ID}
จัดการการตอบกลับจากบริการบัญชี Google

เมื่อผู้ใช้ตัดสินใจที่จะให้สิทธิ์เข้าถึงแอปพลิเคชันของคุณ ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยัง redirect_uri ตามที่ระบุไว้ใน URL ที่คุณจัดรูปแบบด้วยพารามิเตอร์การค้นหาที่มีรหัสการให้สิทธิ์ หากผู้ใช้อนุมัติคำขอ ระบบจะใช้การตอบกลับรหัสการให้สิทธิ์เพื่อแลกเปลี่ยนรหัสการให้สิทธิ์สําหรับโทเค็นเพื่อการเข้าถึงด้วยการส่งคําขอ POST ไปยัง Google Accounts API

บันทึกโทเค็นการรีเฟรช (หากมี)

เราจะใช้โทเค็นเพื่อการเข้าถึงในขั้นตอนถัดไปเพื่อให้คุณจัดเก็บได้ชั่วคราว หากคุณขอโทเค็นการรีเฟรชให้กับผู้ใช้ด้วย คุณควรจัดเก็บโทเค็นนี้ไว้อย่างปลอดภัยสำหรับการใช้งานระยะยาว โทเค็นการรีเฟรชมีอายุใช้งานยาวนานและสามารถใช้เพื่อออกโทเค็นเพื่อการเข้าถึงใหม่ได้

2. สร้างตั๋วบัญชีโดยใช้ API การจัดสรร

เมื่อมีโทเค็นเพื่อการเข้าถึงสำหรับผู้ใช้ที่ได้รับอนุญาตแล้ว คุณจะใช้โทเค็นนี้เพื่อส่งคำขอไปยัง API การจัดสรรเพื่อสร้างตั๋วบัญชีสำหรับผู้ใช้ได้ ตั๋วบัญชีคือขั้นตอนแรกในการสร้างบัญชีให้กับผู้ใช้

สิ่งที่ต้องมีสำหรับขั้นตอนนี้

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

  • URI การเปลี่ยนเส้นทาง
    • กำหนดว่าจะเปลี่ยนเส้นทางผู้ใช้ไปที่ใดหลังจากหน้าข้อกำหนดในการให้บริการ (TOS) ของ Google Analytics ซึ่งอาจแตกต่างจาก URI การเปลี่ยนเส้นทางที่ระบุในระหว่างขั้นตอนการให้สิทธิ์ OAuth 2.0
    • ค่าของพารามิเตอร์ URI การเปลี่ยนเส้นทางต้องตรงกับค่าใดค่าหนึ่งที่ลงทะเบียนไว้ใน Google Developers Console ทุกประการ (รวมถึงรูปแบบ http หรือ https, ตัวพิมพ์ และเครื่องหมาย "/") ต่อท้าย)
  • ช่องบัญชี
    • คุณต้องระบุพร็อพเพอร์ตี้ name สำหรับบัญชีนี้
  • ช่องพร็อพเพอร์ตี้เว็บ
    • คุณต้องระบุพร็อพเพอร์ตี้ name สำหรับพร็อพเพอร์ตี้ดังกล่าว
    • ต้องระบุ websiteUrl
  • ช่องโปรไฟล์
    • ต้องระบุพร็อพเพอร์ตี้ name สำหรับโปรไฟล์
    • คุณจะระบุ timezone หรือไม่ก็ได้ ค่าเริ่มต้นคือ America/Los_Angeles

เมื่อสร้างตั๋วบัญชี คุณจะตั้งค่าได้เฉพาะช่องพื้นฐานที่ระบุไว้ข้างต้นเท่านั้น เมื่อสร้างบัญชีแล้ว คุณจะเปลี่ยนแปลงการกำหนดค่าเพิ่มเติมในพร็อพเพอร์ตี้หรือข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ได้โดยใช้ Management API

ดูการอ้างอิง API สำหรับบัญชี พร็อพเพอร์ตี้ และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับช่องเหล่านี้

ผลลัพธ์ของขั้นตอนนี้

หลังจากส่งคำขอไปยัง API การจัดสรรสำเร็จแล้ว คุณจะมีตั๋วบัญชีที่ใช้งานได้ชั่วคราวสำหรับผู้ใช้ ระบบจะใช้รหัสตั๋วของบัญชีในขั้นตอนสุดท้ายเพื่อให้ผู้ใช้ยอมรับข้อกำหนดในการให้บริการ (TOS) และเปิดใช้งานบัญชี บัญชีจะไม่สามารถใช้ได้จนกว่าจะยอมรับข้อกำหนดในการให้บริการ

ขั้นตอนทางเทคนิคสำหรับขั้นตอนนี้

ระบบจะส่งคำขอ HTTP POST ไปยัง API การจัดสรรเมื่อใช้โทเค็นการเข้าถึงสำหรับผู้ใช้ที่ได้รับในระหว่างการตรวจสอบสิทธิ์และการให้สิทธิ์

คำขอ API การจัดสรรเพื่อสร้าง ตั๋วบัญชี

อ่านเมธอด createAccountTicket ในข้อมูลอ้างอิงของ API การจัดสรรเพื่อดูรายละเอียดเกี่ยวกับวิธีส่งคำขอ

การตอบกลับจาก API การจัดสรร

คำขอที่สำเร็จจะแสดงการตอบกลับ 200 ส่วนการตอบกลับจะมีตั๋วบัญชี ซึ่งมีอายุสั้น ตั๋วบัญชีประกอบด้วยรหัสและ รายละเอียดสำหรับโครงสร้างบัญชีใหม่

โปรดอ่านรายละเอียดเกี่ยวกับการตอบกลับที่ Account Ticket resource ในข้อมูลอ้างอิงของ API การจัดสรร

แอปพลิเคชันจะต้องจัดการการตอบสนองต่อข้อผิดพลาดด้วย

3. ผู้ใช้ยอมรับข้อกำหนดในการให้บริการของ Google Analytics (TOS)

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

สิ่งที่ต้องมีสำหรับขั้นตอนนี้

รหัสตั๋วในบัญชีของผู้ใช้ที่ได้รับอนุญาต

ผลลัพธ์ของขั้นตอนนี้

หลังจากดำเนินการตามขั้นตอนข้อกำหนดในการให้บริการโดยใช้รหัสตั๋วบัญชีเรียบร้อยแล้ว ระบบจะสร้างบัญชี พร็อพเพอร์ตี้ และข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์) ตอนนี้ผู้ใช้จะมีบัญชี ที่ใช้งานอยู่แล้ว การตอบกลับจากหน้า TOS จะมีรหัสบัญชี รหัสพร็อพเพอร์ตี้ และรหัสข้อมูลพร็อพเพอร์ตี้ (โปรไฟล์)

ขั้นตอนทางเทคนิคสำหรับขั้นตอนนี้

ใช้รหัสตั๋วของบัญชีเพื่อเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าข้อกำหนดในการให้บริการของ Google Analytics ซึ่งผู้ใช้จะยอมรับข้อกำหนดในการให้บริการ จากนั้นคุณก็ต้องจัดการกับการตอบกลับจาก API

สร้าง URL ข้อกำหนดในการให้บริการเพื่อให้ผู้ใช้เข้าชม

เปลี่ยนเส้นทางผู้ใช้ไปยังหน้า TOS และใส่รหัสตั๋วของบัญชีเป็นส่วนหนึ่งของ URL ดังนี้

https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/{account_ticket_id}
จัดการการตอบกลับข้อกำหนดในการให้บริการ

หลังจากที่ผู้ใช้ดำเนินการบางอย่างในหน้าข้อกำหนดในการให้บริการแล้ว ระบบจะเปลี่ยนเส้นทางผู้ใช้กลับไปที่ redirectUri ที่ระบุไว้ในระหว่างการสร้างตั๋วบัญชี การตอบกลับจากหน้าข้อกำหนดในการให้บริการจะรวมอยู่ในสตริงการค้นหา

การตอบกลับที่สำเร็จจะแสดงข้อมูลเกี่ยวกับโครงสร้างบัญชีที่สร้างขึ้นใหม่ รวมถึง accountTicketId เดิม ดังนี้

https://{YOUR REDIRECT URI for TOS}?
  accountId={accountId}
  &webPropertyId={webPropertyId}
  &profileId={profileId}
  &accountTicketId={accountTicketId}

เช่น หากเครื่องจัดการ TOS สำหรับแอปพลิเคชันอยู่ที่ http://www.your-app.com/gaTOS คุณควรตั้งค่านี้เป็น redirectUri เมื่อสร้างตั๋วบัญชี เครื่องจัดการ TOS ของแอปพลิเคชันควรคาดว่าจะจัดการคำขอ HTTP GET ที่มีพารามิเตอร์การค้นหา accountId, webPropertyId, profileId และ accountTicketId ได้อย่างถูกต้องในกรณีที่ตั๋วบัญชีถูกต้องและผู้ใช้ได้ยอมรับข้อกำหนดในการให้บริการแล้ว

การตอบกลับที่ไม่สำเร็จจะรวมการตอบกลับข้อผิดพลาดด้วย ดังนี้

https://{YOUR REDIRECT URI for TOS}?
  error={error_code}
  &accountTicketId={accountTicketId}

เครื่องจัดการ TOS ควรจัดการคำขอ HTTP GET ที่มีพารามิเตอร์การค้นหา error อย่างเหมาะสมด้วย ซึ่งหมายความว่ามีบางอย่างที่ไม่ถูกต้อง สามารถใช้ค่าพารามิเตอร์การค้นหาเพื่อดำเนินการเพิ่มเติม หรือแสดงข้อความต่อผู้ใช้

  • error=user_cancel - ผู้ใช้ไม่ได้ยอมรับข้อกำหนดในการให้บริการ
  • error=max_accounts_reached - ผู้ใช้มีบัญชี Google Analytics ถึงขีดจำกัดแล้ว
  • error=backend_error - ข้อผิดพลาดทั่วไป เซิร์ฟเวอร์แสดงข้อผิดพลาดที่ไม่อยู่ในหมวดหมู่ข้างต้น

4. (ไม่บังคับ) โอกาสในการผสานรวม

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

  • แทรกข้อมูลการติดตามของ Google Analytics มาตรฐานด้วยรหัสพร็อพเพอร์ตี้ของบัญชีที่สร้างขึ้นใหม่สำหรับแต่ละหน้าในเว็บไซต์ของผู้ใช้ (หากมี) โดยอัตโนมัติ
  • กำหนดค่าพร็อพเพอร์ตี้ของผู้ใช้โดยอัตโนมัติด้วย Management API
  • ส่งรายงานสำหรับผู้ใช้ภายในผลิตภัณฑ์ (เช่น ในแผงผู้ดูแลระบบ) โดยใช้ embed API หรือ Core Reporting API

โฟลว์ผู้ใช้

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

ขั้นตอนนี้จะเริ่มต้นเมื่อผู้ใช้เสนอ 2 ตัวเลือกดังต่อไปนี้เพื่อเปิดใช้ข้อมูลวิเคราะห์สำหรับพร็อพเพอร์ตี้

  1. สร้างบัญชี Google Analytics
  2. ใช้บัญชี Google Analytics ที่มีอยู่ (หมายเหตุ: เอกสารนี้ไม่รวมอยู่ในเอกสารนี้ ดูรายละเอียดเกี่ยวกับวิธีเข้าถึงข้อมูลการกำหนดค่า Google Analytics ของผู้ใช้ได้ใน Management API

เมื่อสร้างบัญชี Google Analytics ใหม่ คุณจะต้องส่งข้อมูลไปกับคำขอการจัดสรร เช่น ชื่อบัญชี ชื่อพร็อพเพอร์ตี้ ฯลฯ ทั้งนี้ ขึ้นอยู่กับข้อมูลเกี่ยวกับผู้ใช้และขั้นตอนที่ต้องการแสดง โดยมี 3 ตัวเลือกหลักในการเริ่มต้นโฟลว์ผู้ใช้หลังจากที่ผู้ใช้คลิก "สร้างบัญชี" ดังต่อไปนี้

ขอรายละเอียดบัญชีหลังจากการให้สิทธิ์

ในกรณีนี้ ระบบจะขอรายละเอียดบัญชีจากผู้ใช้ในระหว่างกระบวนการ โดยขั้นตอนจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

  1. ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังบริการของบัญชี Google สำหรับขั้นตอน OAuth 2.0 หากผู้ใช้ไม่มีบัญชี Google หรือไม่ได้ลงชื่อเข้าใช้ ระบบจะขอให้ผู้ใช้สร้างบัญชี Google หรือลงชื่อเข้าใช้
  2. ผู้ใช้จะได้รับการแจ้งเตือนให้ให้สิทธิ์แอปพลิเคชันในการ "สร้างบัญชี Google Analytics"
  3. ผู้ใช้ยอมรับคำขอสิทธิ์สำหรับแอปพลิเคชัน
  4. ผู้ใช้ถูกเปลี่ยนเส้นทางไปยังผู้ให้บริการ โปรดทราบว่าหากผู้ใช้ปฏิเสธการให้สิทธิ์ ระบบจะยังเปลี่ยนเส้นทางกลับไปยังผู้ให้บริการ
  5. แบบฟอร์มจะปรากฏต่อผู้ใช้เพื่อรวบรวมรายละเอียดเกี่ยวกับบัญชีที่จะสร้างขึ้น (เช่น ชื่อบัญชี ชื่อพร็อพเพอร์ตี้ ชื่อโปรไฟล์ เขตเวลา URL ของเว็บไซต์ ฯลฯ)
  6. ผู้ใช้กรอกและส่งแบบฟอร์ม และระบบจะเปลี่ยนเส้นทางไปยัง Google/แสดงข้อกำหนดในการให้บริการของ Google Analytics (TOS)
  7. ผู้ใช้ยอมรับข้อกำหนดในการให้บริการ
  8. ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังผู้ให้บริการและเห็นข้อความแสดงความสำเร็จว่าได้สร้างบัญชี Google Analytics เรียบร้อยแล้ว โดยมีรายละเอียดเกี่ยวกับบัญชีและวิธีเข้าถึงบัญชี โปรดทราบว่าหากผู้ใช้ไม่ยอมรับข้อกำหนดในการให้บริการ ระบบจะยังเปลี่ยนเส้นทางกลับไปยังผู้ให้บริการ

ขอรายละเอียดบัญชีก่อนการให้สิทธิ์

ในกรณีนี้ ระบบจะถามผู้ใช้ล่วงหน้าสำหรับรายละเอียดการกำหนดค่าของบัญชีที่กำลังจะสร้าง โดยขั้นตอนจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

  1. ในเว็บไซต์ของผู้ให้บริการ จะมีแบบฟอร์มแสดงให้ผู้ใช้เห็นเพื่อรวบรวมรายละเอียดเกี่ยวกับบัญชี (เช่น ชื่อบัญชี ชื่อพร็อพเพอร์ตี้ ชื่อโปรไฟล์ เขตเวลา URL ของเว็บไซต์)
  2. ผู้ใช้กรอกแบบฟอร์ม คลิกส่ง แล้วระบบจะเปลี่ยนเส้นทางไปยังบริการของบัญชี Google สำหรับขั้นตอน OAuth 2.0 หากผู้ใช้ไม่มีบัญชี Google หรือไม่ได้ลงชื่อเข้าใช้ ระบบจะขอให้ผู้ใช้สร้างบัญชี Google หรือลงชื่อเข้าใช้
  3. ผู้ใช้จะได้รับการแจ้งเตือนให้ให้สิทธิ์แอปพลิเคชันในการ "สร้างบัญชี Google Analytics"
  4. ผู้ใช้ยอมรับสิทธิ์ที่ขอสำหรับแอปพลิเคชัน
  5. ผู้ใช้ถูกเปลี่ยนเส้นทางไปยังผู้ให้บริการ
  6. ระบบเปลี่ยนเส้นทางผู้ใช้ไปยัง Google/แสดงข้อกำหนดในการให้บริการ (TOS) ของ Google Analytics
  7. ผู้ใช้ยอมรับข้อกำหนดในการให้บริการ
  8. ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังผู้ให้บริการและเห็นข้อความแสดงความสำเร็จว่าได้สร้างบัญชี Google Analytics เรียบร้อยแล้ว โดยมีรายละเอียดเกี่ยวกับบัญชีและวิธีเข้าถึงบัญชี

กรอกรายละเอียดบัญชีล่วงหน้าหรือข้ามแบบฟอร์ม

หากมีข้อมูลเกี่ยวกับบัญชีผู้ใช้อยู่แล้ว (เช่น URL ของเว็บไซต์ ชื่อเว็บไซต์ เขตเวลา ฯลฯ) ตัวเลือกทั้ง 2 ข้างต้นเข้าใจได้ง่ายมากขึ้นดังนี้

  • กรอกแบบฟอร์มล่วงหน้าและอนุญาตให้ผู้ใช้แก้ไขได้ หากต้องการ
  • ข้ามขั้นตอนทั้งหมดในแบบฟอร์มและสร้างบัญชีโดยอัตโนมัติโดยใช้ข้อมูลที่มีอยู่