新しいアプリに PostHog と Clerk を追加するには、異なる問題を解決する 2 つの個別のシステムをセットアップする必要があります。Clerk はアプリへのユーザーのサインインを処理し、PostHog はログインしたユーザーの行動をトラッキングします。これらは、ダッシュボードとソフトウェア開発キット (SDK) を通じて手動で設定するか、Stripe Projects を使用してプロビジョニングできます。Stripe Projects を使用すると、ダッシュボードを行き来することなく、両方のプロバイダーの認証情報をプロジェクトの .env ファイルに直接取り込むことができます。
PostHog は、500,000 以上のチームと 250,000 人近くのエンジニアに使用されています。多くのチームは最終的に、PostHog を Clerk などの認証プロバイダーと連携させます。Stripe Projects により、両方のサービスが単一のワークフローでプロビジョニングされるため、このセットアップが簡素化されます。
以下では、各プロバイダーの役割、認証された ID をアナリティクスイベントに関連付けることでトラフィック以上の情報を把握できるようになる理由、および Stripe Projects を使用して PostHog と Clerk をすばやく追加する方法について説明します。
この記事でわかること
Clerk の認証済みユーザー識別子 (ID) を PostHog の
identify()メソッドに関連付けると、ログイン前のイベント履歴を失うことなく、匿名のセッションデータが識別済みのユーザープロファイルに変換されます。Stripe Projects では、アカウント認証を処理し、プロジェクトの
.envファイルに認証情報を直接書き込むコマンドラインインターフェイス (CLI) コマンドを介して、PostHog と Clerk をプロビジョニングできます。PostHog と Clerk のベストプラクティスには、環境を明確に分離することや、イベントプロパティに含まれる個人データを最小限に抑えることなどがあります。
PostHog および Clerk とは
PostHog はプロダクトアナリティクスプラットフォームです。アプリ内のイベント、ページビュー、ユーザーの行動をトラッキングし、そのデータをファネル、セッション録画、機能フラグ、コホート分析に変換します。Clerk は認証およびユーザー管理プロバイダーです。サインアップ、サインイン、セッショントークン、多要素認証、およびユーザープロファイルデータを処理します。
PostHog アナリティクスを Clerk の認証と組み合わせる理由
PostHog を Clerk と組み合わせることで、アカウントの階層別に分類された、チャーン予測、オンボーディング分析、機能の採用状況など、ファネル上部のトラフィックに関するアナリティクスを取得できます。PostHog は個別の ID を使用してユーザーをトラッキングします。この ID は最初、ブラウザーやデバイスに関連付けられた、ランダムに生成される匿名の識別子として機能します。ユーザーが Clerk を介してサインインした際に、PostHog の identify() メソッドを呼び出して、Clerk のユーザー ID を新しい個別の ID として渡すことができます。その後 PostHog により、匿名のセッション履歴と識別済みのプロファイルがマージされ、ページビュー、ボタンのクリック、機能の操作といったサインイン前にトラッキングされたイベントが、そのユーザーに関連付けられます。
以下の詳細事項に注意してください:
イベントの命名規則の一貫性: イベントをスネークケース (例: スペースなし) とタイトルケースのどちらにするか、また
signed\_upのようなアクションを記述するか、signup\_completedのようなオブジェクトを記述するかを早期に決定します。規則を混在させると、PostHog ダッシュボードが読みにくくなります。匿名ユーザーと識別済みユーザー: ページを読み込むたびに
identify()を呼び出すと、PostHog のアクティビティログに重複したマージイベントが蓄積されます。Clerk がセッションを確認した直後に 1 回だけ呼び出します。ユーザーが現在のセッションですでに識別されているかどうかを確認し、その条件を満たす場合のみ呼び出しを行うよう制御することもできます。プライバシーと同意: EU の GDPR など、トラッキングに同意要件がある管轄区域では、ユーザーを識別したり、イベントプロパティに個人データを添付したりする前に、同意を取得します。すべてのアナリティクスイベントにメールアドレスや名前を含める必要はほとんどなく、含めた場合はコンプライアンスの対応範囲が広がることになります。
2 つを関連付けるタイミング: アプリが主にサインアップ前のマーケティングページである場合は、匿名トラッキングで十分に対応できます。トライアルから有料プランへのコンバージョンなど、測定する価値のある認証済みのフローが用意できたら、Clerk と PostHog のイベントを関連付けます。
PostHog と Clerk を手動で設定する方法
2 つのダッシュボードと 2 つの SDK という 4 つのシステムにわたって、両方のプロバイダーを手動で設定します。
仕組みは以下のとおりです。
1. PostHog プロジェクトを作成する
PostHog にサインアップしてプロジェクトを作成します。これにより、プロジェクトの アプリケーションプログラミングインターフェイス (API) キーとホスト URL が提供されます。SDK にはこれらの両方の値が必要になります。
2. Clerk アプリケーションを作成する
Clerk ダッシュボードでアプリケーションを作成し、メール、Google OAuth、パスキーなどのサインイン方法を選択します。
3. SDK をインストールする
Next.js アプリの場合、npm install posthog-js と npm install @clerk/nextjs を実行します。PostHog は posthog.init() を使用してクライアント側で初期化されます。一方、Clerk はアプリを \<ClerkProvider\> でラップし、ルート保護を処理するミドルウェアを必要とします。
4. 環境変数を設定する
.env.local ファイルに 4 ~ 6 個の値を追加します。
5. セットアップをテストする
Clerk のサインインフローによってセッションが生成されることを確認してから、PostHog のライブイベントビューをチェックして、イベントが受信されていることを確認します。認証が完了した直後に、セッションごとに identify() が 1 回だけ実行されることを確認します。
Stripe Projects でアナリティクスプロバイダーを参照する方法
Stripe Projects は、データベース、アナリティクス、AI プロバイダーを含むサードパーティ製インフラストラクチャーサービスを、コマンドラインから直接プロビジョニングするための Stripe CLI 機能です。サービスごとに個別のダッシュボードを開く代わりに、プロジェクトに関連付けられた単一のインターフェイスからこれらのサービスを参照し、プロビジョニングを行うことができます。
アナリティクスのプロバイダーオプションを参照するには、プロジェクトディレクトリから Stripe Projects を実行し、カテゴリーとサービス階層ごとに整理された利用可能なプロバイダーを一覧表示します。stripe projects catalog \<provider\> や stripe projects catalog \<category\> を使用して絞り込んだり、stripe projects search \<keyword\> を使用して直接検索したりすることができます。特にアナリティクスを探している場合は、サポートされている他のプロバイダーとともに PostHog が表示されるため、ターミナルを離れたりブラウザーに切り替えたりする必要はありません。
Stripe Projects で PostHog と Clerk を追加する方法
PostHog と Clerk を選択したら、Stripe CLI で初期化済みのプロジェクトから両方をプロビジョニングするには、2 つのコマンドを実行します。PostHog を追加するには、stripe projects add posthog/analytics を実行してプロビジョニングフローを開始します。Stripe Projects により、通常は PostHog に直接ログインして手動でキーをコピーする必要があるアカウント認証ステップが処理されます。その後、生成された API キーとホスト URL がプロジェクトの .env ファイルに書き込まれます。stripe projects add clerk/auth を実行すると、Clerk に対しても同様の処理が行われます。つまり、認証フローが管理され、公開可能キーとシークレットキーが取得されます。これらのキーは、先ほど PostHog が追加した内容と一緒に .env ファイルに書き込まれます。
Stripe Projects を使用したセットアップと手動でのセットアップの実質的な違いは、認証情報の取得元です。キーを 2 つのダッシュボードからコピーして .env.local に貼り付ける代わりに、Stripe Projects により直接取得および書き込みが行われます。ただし、SDK の初期化コードの記述やアプリのロジックの構築は、引き続き自身 (またはコーディングエージェント) で行う必要があります。
キーの同期も維持する必要があります。新しいマシンで初めてプロジェクトをセットアップする場合、stripe projects pull \<projectID\> を実行することで既存のプロジェクトが空のディレクトリにクローンされ、.env ファイルが書き込まれます。これにより、新しいサービスをプロビジョニングするのではなく、プロジェクトの既存のサービスに接続されます。すでにプロジェクトディレクトリにいて、チームメイトがプロバイダーを追加またはローテーションした後にローカルの .env を更新する必要がある場合は、代わりに stripe projects pull env \--pull を実行します。
PostHog と Clerk のベストプラクティス
この実装をリリースする前に、いくつか確認しておくべき事項があります。
覚えておくべきポイントは以下の通りです:
環境を明確に分離する: 開発と本番環境には別の PostHog プロジェクトと Clerk アプリケーションを使用します。テストサインアップを実際のユーザーデータと混在させると、アナリティクスの信頼性が損なわれ、Clerk のユーザーリストが使い捨てのアカウントで乱雑になります。
Clerk のシークレットキーをクライアント側に公開しない: これはサーバー側の環境変数にのみ設定する必要があります。公開可能キーはブラウザーに対して安全ですが、シークレットキーは安全ではありません。
イベントプロパティの個人データを最小限に抑える: メールアドレスではなくユーザー ID を送信します。必要に応じて、後で ID だけでデータを Clerk のユーザーテーブルに結合できるためです。
ユーザーを識別する前に同意を尊重する: 管轄区域でトラッキングの同意が必要な場合は、その同意が得られた後にのみ
identify()呼び出しを実行するように制御します。マージの挙動を明確にテストする: 匿名ユーザーとしてサインアップしていくつかのイベントを生成し、サインインした後に、PostHog により履歴が関連性のない新しいプロファイルとして開始されるのではなく、識別済みのプロファイルの下にマージされることを確認します。
イベントスキーマを文書化する: イベント名とプロパティの共通の参照を用意することで、チーム内の異なる担当者が同じアクションを 3 種類の異なる名前でトラッキングする事態を防ぎます。
Stripe Projects の活用方法
Stripe Projects を使用すると、開発者や AI エージェントは、コマンドラインインターフェイス (CLI) からサービスを追加し、認証情報を生成し、請求を管理することができます。
Stripe Projects のメリット
コマンドラインからのサードパーティ製サービスのプロビジョニング: プロバイダーごとに個別のツールやワークフローを使用するのではなく、単一のワークフローでサービスの追加、認証情報の管理、プランのアップグレードを行うことができます。ダッシュボード、設定ファイル、またはインフラストラクチャーコードを必要とせずに、ホスティング、データベース、認証、AI などを管理できます。
認証情報の自動同期: ローカルのセットアップ、マシン、チームメイト、エージェント間で環境変数のポータビリティを維持します。アプリケーションプログラミングインターフェイス (API) キーをコピーして貼り付ける必要はありません。
CLI またはコーディングエージェントからの請求管理: 請求の詳細を一度設定するだけで、サードパーティ製サービスと安全に共有できます。CLI から、プラン階層のアップグレードとダウングレード、使用状況の監視、サブスクリプションの管理を行うことができます。
Stripe Projects によりアプリのプロビジョニングがどのように簡素化されるかの詳細を確認するか、このコマンドをターミナルにコピーアンドペーストして、今すぐご利用を開始してください:
この記事の内容は、一般的な情報および教育のみを目的としており、法律上または税務上のアドバイスとして解釈されるべきではありません。Stripe は、記事内の情報の正確性、完全性、妥当性、または最新性を保証または請け合うものではありません。特定の状況については、管轄区域で活動する資格のある有能な弁護士または会計士に助言を求める必要があります。