การเพิ่ม PostHog และ Clerk ลงในแอปใหม่เกี่ยวข้องกับการตั้งค่าระบบ 2 ระบบที่แยกกันเพื่อแก้ปัญหาที่แตกต่างกัน Clerk จะจัดการการลงชื่อเข้าใช้แอปของผู้ใช้ ในขณะที่ PostHog จะติดตามสิ่งที่ผู้ใช้ทำเมื่อเข้ามาในแอป คุณจะกำหนดค่าระบบด้วยตนเองได้ผ่านแดชบอร์ดและชุดเครื่องมือพัฒนาซอฟต์แวร์ (SDK) หรือจัดเตรียมบริการด้วย Stripe Projects ซึ่งจะดึงข้อมูลเข้าสู่ระบบของทั้ง 2 ผู้ให้บริการมาไว้ในไฟล์ .env ของโปรเจ็กต์โดยตรงโดยที่คุณไม่ต้องสลับแดชบอร์ดไปมา
มีทีมกว่า 500,000 ทีมและวิศวกรเกือบ 250,000 คนใช้งาน PostHog หลายๆ ทีมมักจะจับคู่ PostHog กับผู้ให้บริการการตรวจสอบสิทธิ์อย่าง Clerk ในท้ายที่สุด Stripe Projects จะช่วยให้การตั้งค่านั้นง่ายขึ้นโดยการจัดเตรียมบริการทั้ง 2 อย่างในเวิร์กโฟลว์เดียว
ด้านล่างนี้ เราจะอธิบายว่าผู้ให้บริการแต่ละรายทำหน้าที่อะไร ทำไมการเชื่อมโยงข้อมูลประจำตัวที่มีการตรวจสอบสิทธิ์เข้ากับเหตุการณ์การวิเคราะห์จึงช่วยให้คุณเข้าใจข้อมูลอื่นๆ นอกเหนือจากปริมาณการใช้งาน และวิธีการเพิ่ม PostHog และ Clerk อย่างรวดเร็วโดยใช้ Stripe Projects
ประเด็นสำคัญ
การเชื่อมโยงตัวระบุ (ID) ผู้ใช้ที่มีการตรวจสอบสิทธิ์ของ Clerk เข้ากับเมธอด
identify()ของ PostHog จะเปลี่ยนข้อมูลเซสชันที่ไม่ระบุชื่อให้เป็นโปรไฟล์ผู้ใช้ที่ระบุตัวตนได้โดยไม่สูญเสียประวัติเหตุการณ์ก่อนเข้าสู่ระบบStripe Projects จะจัดเตรียม PostHog และ Clerk ได้ผ่านคำสั่งอินเทอร์เฟซบรรทัดคำสั่ง (CLI) ที่จัดการการอนุมัติบัญชีและเขียนข้อมูลเข้าสู่ระบบลงในไฟล์
.envของโปรเจ็กต์โดยตรงแนวทางปฏิบัติที่ดีที่สุดสำหรับ PostHog และ Clerk รวมถึงการแยกสภาพแวดล้อมออกจากกันอย่างชัดเจนและลดการใช้ข้อมูลส่วนบุคคลในพร็อพเพอร์ตี้เหตุการณ์ให้เหลือน้อยที่สุด
PostHog และ Clerk คืออะไร
PostHog คือแพลตฟอร์มการวิเคราะห์ผลิตภัณฑ์ โดยจะติดตามเหตุการณ์ การดูหน้าเว็บ และพฤติกรรมของผู้ใช้ภายในแอป แล้วเปลี่ยนข้อมูลดังกล่าวให้เป็นช่องทาง บันทึกเซสชัน แฟล็กฟีเจอร์ และการวิเคราะห์ตามกลุ่มประชากร (Cohort Analysis) Clerk คือผู้ให้บริการการตรวจสอบสิทธิ์และการจัดการผู้ใช้ โดยจัดการตั้งแต่การลงทะเบียน การลงชื่อเข้าใช้ โทเค็นเซสชัน การตรวจสอบสิทธิ์แบบหลายปัจจัย ไปจนถึงข้อมูลโปรไฟล์ผู้ใช้
ทำไมคุณจึงควรรวมการวิเคราะห์ของ PostHog เข้ากับการตรวจสอบสิทธิ์ของ Clerk
การรวม PostHog เข้ากับ Clerk จะช่วยให้คุณได้รับการวิเคราะห์เกี่ยวกับปริมาณการใช้งานในส่วนต้นของช่องทาง เช่น การคาดการณ์การเลิกใช้งาน การวิเคราะห์กระบวนการเริ่มต้นใช้งาน หรือการนำฟีเจอร์ไปใช้ ซึ่งแบ่งตามระดับบัญชี PostHog จะติดตามผู้ใช้ผ่าน ID ที่ไม่ซ้ำกัน ซึ่งจะเริ่มต้นจากการเป็นตัวระบุที่สุ่มสร้างขึ้นโดยไม่ระบุชื่อและเชื่อมโยงกับเบราว์เซอร์หรืออุปกรณ์ เมื่อผู้ใช้ลงชื่อเข้าใช้ผ่าน Clerk คุณจะเรียกใช้เมธอด identify() ของ PostHog และส่ง ID ผู้ใช้ของ Clerk เป็น ID ใหม่ที่ไม่ซ้ำกันได้ จากนั้น PostHog จะรวมประวัติเซสชันที่ไม่ระบุชื่อเข้ากับโปรไฟล์ที่ระบุตัวตนได้ โดยเชื่อมโยงเหตุการณ์ที่ติดตามก่อนการลงชื่อเข้าใช้ เช่น การดูหน้าเว็บ การคลิกปุ่ม และการโต้ตอบกับฟีเจอร์เข้ากับผู้ใช้รายนั้น
โปรดให้ความสำคัญกับรายละเอียดต่อไปนี้
ความสม่ำเสมอในการตั้งชื่อเหตุการณ์: กำหนดไว้แต่เนิ่นๆ ว่าเหตุการณ์จะเป็นแบบ Snake Case (เช่น ไม่มีช่องว่าง) หรือ Title Case และจะเป็นการอธิบายการกระทำอย่างเช่น
signed_upหรือวัตถุอย่างเช่นsignup_completedการผสมรูปแบบการตั้งชื่ออาจทำให้แดชบอร์ด PostHog ของคุณอ่านยากผู้ใช้ที่ไม่ระบุชื่อกับผู้ใช้ที่ระบุตัวตนได้: หากคุณเรียกใช้
identify()ในทุกๆ การโหลดหน้าเว็บ คุณจะพบกับเหตุการณ์การรวมที่ซ้ำกันมากมายในบันทึกกิจกรรมของ PostHog ให้เรียกใช้เพียงครั้งเดียวหลังจากที่ Clerk ยืนยันเซสชันแล้ว นอกจากนี้ คุณยังระงับการเรียกใช้ไว้ก่อนเพื่อตรวจสอบว่ามีการระบุตัวตนของผู้ใช้ในเซสชันปัจจุบันแล้วหรือไม่ก็ได้ความเป็นส่วนตัวและความยินยอม: ในเขตอำนาจศาลที่มีข้อกำหนดด้านความยินยอมสำหรับการติดตาม เช่น ภายใต้ GDPR ในสหภาพยุโรป ให้ขอความยินยอมก่อนที่จะระบุตัวตนของผู้ใช้หรือแนบข้อมูลส่วนบุคคลลงในพร็อพเพอร์ตี้เหตุการณ์ อีเมลหรือชื่อในทุกเหตุการณ์การวิเคราะห์มักจะไม่จำเป็นและยังเป็นการขยายขอบเขตการปฏิบัติตามข้อกำหนดของคุณอีกด้วย
เวลาที่ควรเชื่อมโยงทั้ง 2 ระบบ: หากแอปของคุณเป็นหน้าการตลาดก่อนการลงทะเบียนเป็นหลัก การติดตามแบบไม่ระบุชื่อก็ถือว่าครอบคลุมแล้ว ให้เชื่อมโยงเหตุการณ์ของ Clerk และ PostHog เมื่อคุณมีขั้นตอนที่ผ่านการตรวจสอบสิทธิ์และมีประโยชน์ในการวัดผล เช่น คอนเวอร์ชันจากการทดลองใช้เป็นการชำระเงิน
วิธีการกำหนดค่า PostHog และ Clerk ด้วยตนเอง
คุณจะต้องกำหนดค่าผู้ให้บริการทั้ง 2 รายด้วยตนเองใน 4 ระบบ ได้แก่ แดชบอร์ด 2 รายการและ SDK 2 รายการ
วิธีการทำงานมีดังนี้
1. สร้างโปรเจ็กต์ PostHog
ลงทะเบียนที่ PostHog และสร้างโปรเจ็กต์ การดำเนินการนี้จะให้คีย์อินเทอร์เฟซการเขียนโปรแกรมแอปพลิเคชัน (API) และ URL โฮสต์ของโปรเจ็กต์ คุณจะต้องใช้ทั้ง 2 ค่านี้สำหรับ SDK
2. สร้างแอปพลิเคชัน Clerk
ในแดชบอร์ด Clerk ให้สร้างแอปพลิเคชันและเลือกวิธีการลงชื่อเข้าใช้ เช่น อีเมล, Google OAuth หรือพาสคีย์
3. ติดตั้ง SDK
เรียกใช้ npm install posthog-js และ npm install @clerk/nextjs สำหรับแอป Next.js โดย PostHog จะเริ่มต้นฝั่งไคลเอ็นต์ผ่าน posthog.init() ในขณะที่ Clerk จะครอบแอปของคุณไว้ใน \<ClerkProvider\> และกำหนดให้ต้องมีมิดเดิลแวร์เพื่อจัดการการปกป้องเส้นทาง
4. ตั้งค่าตัวแปรสภาพแวดล้อม
เพิ่มค่า 4-6 ค่าลงในไฟล์ .env.local ของคุณ
5. ทดสอบการตั้งค่า
ยืนยันว่าขั้นตอนการลงชื่อเข้าใช้ของ Clerk สร้างเซสชันได้สำเร็จ จากนั้นให้ตรวจสอบมุมมองเหตุการณ์แบบสดของ PostHog เพื่อยืนยันว่ามีเหตุการณ์เข้ามา และตรวจสอบว่า identify() เริ่มทำงานเพียงครั้งเดียวต่อเซสชันหลังจากที่การตรวจสอบสิทธิ์เสร็จสมบูรณ์
วิธีการเรียกดูผู้ให้บริการการวิเคราะห์ด้วย Stripe Projects
Stripe Projects คือฟีเจอร์ Stripe CLI สำหรับการจัดเตรียมบริการโครงสร้างพื้นฐานของบริษัทอื่น รวมถึงฐานข้อมูล การวิเคราะห์ และผู้ให้บริการ AI โดยตรงจากบรรทัดคำสั่ง แทนที่จะเปิดแดชบอร์ดแยกต่างหากสำหรับแต่ละบริการ คุณจะเรียกดูและจัดเตรียมบริการได้จากอินเทอร์เฟซเดียวที่เชื่อมโยงกับโปรเจ็กต์ของคุณ
ใช้ Stripe Projects เพื่อเรียกดูตัวเลือกผู้ให้บริการสำหรับการวิเคราะห์โดยการเรียกใช้จากไดเรกทอรีโปรเจ็กต์ของคุณเพื่อแสดงรายชื่อผู้ให้บริการที่มี ซึ่งจัดเรียงตามหมวดหมู่และระดับบริการ คุณสามารถจำกัดขอบเขตการค้นหาด้วย stripe projects catalog \<provider\> หรือ stripe projects catalog \<category\> หรือค้นหาโดยตรงด้วย stripe projects search \<keyword\> หากคุณกำลังมองหาการวิเคราะห์โดยเฉพาะ คุณจะเห็น PostHog ควบคู่ไปกับผู้ให้บริการรายอื่นๆ ที่รองรับ ทำให้ไม่จำเป็นต้องออกจากเทอร์มินัลหรือสลับไปใช้เบราว์เซอร์
วิธีการเพิ่ม PostHog และ Clerk ด้วย Stripe Projects
หลังจากที่คุณเลือก PostHog และ Clerk แล้ว คุณจะต้องใช้เพียง 2 คำสั่งเพื่อจัดเตรียมบริการทั้ง 2 จากโปรเจ็กต์ที่เริ่มต้นด้วย Stripe CLI ไว้แล้ว หากต้องการเพิ่ม PostHog ให้เรียกใช้ stripe projects add posthog/analytics เพื่อเริ่มขั้นตอนการจัดเตรียม Stripe Projects จะจัดการขั้นตอนการอนุมัติบัญชีที่ปกติแล้วกำหนดให้คุณต้องเข้าสู่ระบบ PostHog โดยตรงและคัดลอกคีย์ด้วยตนเอง จากนั้นระบบจะเขียนคีย์ API และ URL โฮสต์ที่ได้ลงในไฟล์ .env ของโปรเจ็กต์ การเรียกใช้ stripe projects add clerk/auth ก็จะดำเนินการแบบเดียวกันกับ Clerk โดยจะจัดการขั้นตอนการอนุมัติ รวมถึงดึงข้อมูลคีย์ที่เผยแพร่ได้และคีย์ลับ ข้อมูลดังกล่าวจะเขียนลงใน .env ควบคู่ไปกับสิ่งที่ PostHog เพิ่งเพิ่มเข้าไป
ความแตกต่างในทางปฏิบัติระหว่างการตั้งค่าด้วย Stripe Projects กับการตั้งค่าด้วยตนเองคือแหล่งที่มาของข้อมูลเข้าสู่ระบบ แทนที่จะคัดลอกคีย์จาก 2 แดชบอร์ดแล้ววางลงใน .env.local Stripe Projects จะดึงข้อมูลและเขียนคีย์ให้โดยตรง แม้ว่าคุณ (หรือตัวแทนเขียนโค้ดของคุณ) จะยังคงต้องเขียนโค้ดเริ่มต้นของ SDK และวางตรรกะแอปของคุณเองก็ตาม
คุณอาจต้องการซิงค์คีย์อยู่เสมอ หากคุณกำลังตั้งค่าโปรเจ็กต์ในเครื่องใหม่เป็นครั้งแรก stripe projects pull \<projectID\> จะโคลนโปรเจ็กต์ที่มีอยู่ลงในไดเรกทอรีว่างและเขียนไฟล์ .env ของคุณ ซึ่งจะเชื่อมต่อกับบริการที่มีอยู่ของโปรเจ็กต์แทนการจัดเตรียมบริการใหม่ หากคุณอยู่ในไดเรกทอรีของโปรเจ็กต์อยู่แล้วและจำเป็นต้องรีเฟรช .env ในเครื่องของคุณหลังจากที่เพื่อนร่วมทีมเพิ่มหรือหมุนเวียนผู้ให้บริการ ให้เรียกใช้ stripe projects pull env \--pull แทน
แนวทางปฏิบัติที่ดีที่สุดสำหรับ PostHog และ Clerk มีอะไรบ้าง
มี 2-3 สิ่งที่ควรทำให้ถูกต้องก่อนที่คุณจะเปิดใช้งานการผสานการทำงานนี้
นี่คือสิ่งที่ควรรู้
แยกสภาพแวดล้อมออกจากกันอย่างชัดเจน: ใช้โปรเจ็กต์ PostHog และแอปพลิเคชัน Clerk ที่แตกต่างกันสำหรับการพัฒนาและการใช้งานจริง การผสมรวมการลงทะเบียนทดสอบเข้ากับข้อมูลผู้ใช้จริงจะทำให้การวิเคราะห์ไม่น่าเชื่อถือและทำให้รายชื่อผู้ใช้ Clerk ของคุณเต็มไปด้วยบัญชีแบบใช้ทิ้ง
อย่าเปิดเผยคีย์ลับของ Clerk ในฝั่งไคลเอ็นต์โดยเด็ดขาด: คีย์ลับควรอยู่ในตัวแปรสภาพแวดล้อมฝั่งเซิร์ฟเวอร์เท่านั้น คีย์ที่เผยแพร่ได้นั้นปลอดภัยสำหรับเบราว์เซอร์ แต่คีย์ลับนั้นไม่ปลอดภัย
ลดการใช้ข้อมูลส่วนบุคคลในพร็อพเพอร์ตี้เหตุการณ์ให้เหลือน้อยที่สุด: ให้ส่ง ID ผู้ใช้แทนที่อยู่อีเมล เนื่องจาก ID เพียงอย่างเดียวก็ช่วยให้คุณรวมข้อมูลกลับไปยังตารางผู้ใช้ของ Clerk ในภายหลังได้หากต้องการ
เคารพความยินยอมก่อนระบุตัวตนของผู้ใช้: หากเขตอำนาจศาลของคุณกำหนดให้ต้องมีความยินยอมในการติดตาม ให้ระงับการเรียกใช้
identify()ไว้จนกว่าจะได้รับความยินยอมดังกล่าวทดสอบพฤติกรรมการรวมอย่างชัดเจน: ลงทะเบียนเป็นผู้ใช้ที่ไม่ระบุชื่อ สร้างเหตุการณ์ 2-3 รายการ จากนั้นลงชื่อเข้าใช้และยืนยันว่า PostHog รวมประวัติดังกล่าวไว้ภายใต้โปรไฟล์ที่ระบุตัวตนได้แทนที่จะเริ่มโปรไฟล์ใหม่ที่ไม่ได้เชื่อมต่อกัน
จัดทำเอกสารสคีมาเหตุการณ์ของคุณ: ข้อมูลอ้างอิงที่ใช้ร่วมกันสำหรับชื่อเหตุการณ์และพร็อพเพอร์ตี้จะช่วยป้องกันไม่ให้ส่วนต่างๆ ในทีมของคุณติดตามการกระทำเดียวกันภายใต้ชื่อที่แตกต่างกัน 3 ชื่อ
Stripe Projects ช่วยคุณได้อย่างไร
Stripe Projects ช่วยให้นักพัฒนาและตัวแทน AI เพิ่มบริการ สร้างข้อมูลเข้าสู่ระบบ และจัดการการเรียกเก็บเงินได้จากอินเทอร์เฟซบรรทัดคำสั่ง (CLI)
Stripe Projects ช่วยคุณได้ ดังนี้
จัดเตรียมบริการของบริษัทอื่นจากบรรทัดคำสั่ง: ใช้เวิร์กโฟลว์เดียวเพื่อเพิ่มบริการ จัดการข้อมูลเข้าสู่ระบบ และอัปเกรดแพ็กเกจ แทนที่จะใช้เครื่องมือและเวิร์กโฟลว์ที่แตกต่างกันสำหรับผู้ให้บริการทุกราย จัดการโฮสติ้ง ฐานข้อมูล การตรวจสอบสิทธิ์ AI และอื่นๆ อีกมากมายโดยไม่ต้องใช้แดชบอร์ด ไฟล์การกำหนดค่า หรือโค้ดโครงสร้างพื้นฐาน
ซิงค์ข้อมูลเข้าสู่ระบบโดยอัตโนมัติ: ทำให้ตัวแปรสภาพแวดล้อมสามารถพกพาไปใช้ในการตั้งค่าในเครื่อง เครื่องคอมพิวเตอร์ เพื่อนร่วมทีม และตัวแทนต่างๆ ได้ โดยไม่ต้องคัดลอกและวางคีย์อินเทอร์เฟซการเขียนโปรแกรมแอปพลิเคชัน (API)
จัดการการเรียกเก็บเงินจาก CLI หรือตัวแทนเขียนโค้ดของคุณ: ตั้งค่ารายละเอียดการเรียกเก็บเงินเพียงครั้งเดียวและแชร์กับบริการของบริษัทอื่นได้อย่างปลอดภัย อัปเกรดและดาวน์เกรดระดับ ตรวจสอบการใช้งาน และจัดการการสมัครรับข้อมูลจาก CLI
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ Stripe Projects ช่วยให้การจัดเตรียมแอปง่ายขึ้น หรือคัดลอกและวางคำสั่งนี้ลงในเทอร์มินัลของคุณเพื่อเริ่มต้นใช้งานวันนี้:
เนื้อหาในบทความนี้มีไว้เพื่อให้ข้อมูลทั่วไปและมีจุดประสงค์เพื่อการศึกษาเท่านั้น ไม่ควรใช้เป็นคําแนะนําทางกฎหมายหรือภาษี Stripe ไม่รับรองหรือรับประกันความถูกต้อง ความสมบูรณ์ ความเพียงพอ หรือความเป็นปัจจุบันของข้อมูลในบทความ คุณควรขอคําแนะนําจากทนายความที่มีอํานาจหรือนักบัญชีที่ได้รับใบอนุญาตให้ประกอบกิจการในเขตอํานาจศาลเพื่อรับคําแนะนําที่ตรงกับสถานการณ์ของคุณ