integration-android

Android 向け PostHog 統合

このスキルでは、Android アプリケーションに PostHog アナリティクスを追加する方法を説明します。

ワークフロー

統合を完了するには、次の手順を順番に実行してください。

1. basic-integration-1.0-begin.md - PostHog のセットアップ - 開始 ← ここから開始
2. basic-integration-1.1-edit.md - PostHog のセットアップ - 編集
3. basic-integration-1.2-revise.md - PostHog のセットアップ - 修正
4. basic-integration-1.3-conclude.md - PostHog のセットアップ - 完了

参照ファイル

• references/EXAMPLE.md - Android のサンプルプロジェクトのコード
• references/android.md - Android - ドキュメント
• references/identify-users.md - ユーザーの識別 - ドキュメント
• references/basic-integration-1.0-begin.md - PostHog のセットアップ - 開始
• references/basic-integration-1.1-edit.md - PostHog のセットアップ - 編集
• references/basic-integration-1.2-revise.md - PostHog のセットアップ - 修正
• references/basic-integration-1.3-conclude.md - PostHog のセットアップ - 完了

サンプルプロジェクトでは、目標とする実装パターンを示しています。API の詳細については、ドキュメントを参照してください。

主な原則

• 環境変数：PostHog のキーには、必ず環境変数を使用してください。ハードコードしないでください。
• 変更は最小限に：既存の統合に PostHog のコードを追加してください。既存のコードを置き換えたり、再構成したりしないでください。
• サンプルに合わせる：実装では、サンプルプロジェクトのパターンにできる限り沿ってください。

フレームワークのガイドライン

• プロジェクトの Gradle バージョンに応じて、依存関係の設定を適切な build.gradle(.kts) ファイルに合わせてください。
• PostHogAndroid.setup() は Application クラスの onCreate() メソッド内で一度だけ呼び出し、できるだけ早く、かつ一度だけ初期化されるようにしてください。
• PostHog は Application クラスの onCreate() メソッド内で初期化してください。
• 画面ビューを正確に追跡できるよう、すべてのアクティビティに android:label が設定されていることを確認してください。

ユーザーの識別

ログインイベントとサインアップイベントの際にユーザーを識別してください。このフレームワークに適した識別パターンについては、サンプルコードとドキュメントを参照してください。フロントエンドとバックエンドの両方のコードがある場合は、相関関係を維持するため、クライアント側のセッション ID と distinct ID を X-POSTHOG-DISTINCT-ID ヘッダーおよび X-POSTHOG-SESSION-ID ヘッダーで渡してください。

エラートラッキング

関連するファイルに PostHog のエラートラッキングを追加してください。特に、重要なユーザーフローや API 境界付近に追加してください。