后猪分析
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 写作
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 需要 · Vendor-specific
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 读取环境变量
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# PostHog Analytics & Session Replay
## What's Already Configured
The bootstrap includes a complete PostHog setup with:
- **Session Replay** - Records user sessions with privacy protections
- **Automatic Screen Tracking** - Tracks navigation automatically via `ScreenTracker` component
- **Event Tracking** - Ready to use via `usePostHog()` hook
- **Privacy Controls** - Text inputs and images are masked by default
## Files Involved
| File | Purpose |
|------|---------|
| `lib/posthog.ts` | Configuration with session replay plugin |
| `app/_layout.tsx` | PostHogProvider wrapper and ScreenTracker component |
| `app.json` | PostHog plugin registration |
| `.env.example` | Environment variable template |
## How Session Replay Works
### What Gets Recorded
- ✅ Screen views and navigation
- ✅ Touch interactions (taps, swipes)
- ✅ UI changes and animations
- ✅ Network requests (with `captureNetworkTelemetry: true`)
- ✅ Console logs (with `captureLog: true`)
### Privacy Protections
- 🔒 **Text inputs masked** - All form inputs show as `****`
- 🔒 **Images masked** - Photos and avatars are blurred/hidden
- 🔒 **Sensitive data protected** - No actual typed content recorded
### Recording Behavior
- Starts automatically when app launches
- Continues throughout the session
- Stops when app is closed/backgrounded
- Each session is a separate replay in PostHog dashboard
- Data is compressed and sent in batches (not real-time)
### Data Usage
- ~100-500KB per minute of usage
- Throttled to 1 second intervals (`throttleDelayMs: 1000`)
- Only captures visual changes, not full video
## Configuration Options
All settings are in `lib/posthog.ts`:
| Setting | Default | Purpose |
|---------|---------|---------|
| `maskAllTextInputs` | `true` | Hide all text input content |
| `maskAllImages` | `true` | Blur/hide all images |
| `captureLog` | `true` | Include console logs in replay |
| `captureNetworkTelemetry` | `true` | Track API calls |
| `throttleDelayMs` | `1000` | Snapshot interval (milliseconds) |
| `captureNativeAppLifecycleEvents` | `true` | Track app open/close/background |
## Using PostHog in Your App
### Track Custom Events
Import the hook and use it anywhere:
```typescript
import { usePostHog } from 'posthog-react-native';
const posthog = usePostHog();
// Track an event
posthog?.capture('button_pressed', {
button_name: 'checkout',
screen: 'product_detail',
});
```
### Identify Users
Set user identity (typically after login):
```typescript
posthog?.identify(userId, {
email: user.email,
plan: 'premium',
});
```
### Reset on Logout
Clear user identity:
```typescript
posthog?.reset();
```
### Set User Properties
Update user metadata:
```typescript
posthog?.setPersonProperties({
credits: 100,
subscription_status: 'active',
});
```
## Environment Variables
Required for PostHog to work:
```env
EXPO_PUBLIC_POSTHOG_KEY=phc_your_project_key
EXPO_PUBLIC_POSTHOG_HOST=https://eu.i.posthog.com
```
If not set, PostHog is automatically disabled with a console warning.
## Rebuild Required
PostHog session replay uses native modules. After configuration changes to `app.json`, you must rebuild:
```bash
npx expo prebuild --clean
npx expo run:ios # or run:android
```
Or with EAS:
```bash
eas build --profile development-client --platform ios
```
## Viewing Data in PostHog
### Session Replays
1. Go to PostHog → Session Replay
2. Click on a session to watch the replay
3. See timeline of events, network calls, and console logs
### Events
1. Go to PostHog → Events
2. See all captured events:
- `$screen` - Automatic screen views
- `$pageview` - Navigation tracking
- Custom events you capture
### Users
1. Go to PostHog → Persons
2. See identified users with their properties
3. View their session history and events
## Common Issues
### "Waiting for events" in Dashboard
**Cause:** App hasn't been rebuilt after configuration changes
**Fix:** Run `npx expo prebuild --clean` and rebuild the app
### No Session Replay
**Cause:** Session replay requires native modules to be rebuilt
**Fix:** Clean rebuild with `npx expo prebuild --clean`
### Events Not Appearing
**Cause:** PostHog API key not set or app not rebuilt
**Fix:**
1. Verify `EXPO_PUBLIC_POSTHOG_KEY` is set in environment
2. Rebuild the app
3. Wait 1-2 minutes (there can be a delay)
### Privacy Concerns
**Cause:** Default settings mask all inputs and images
**Fix:** Adjust `maskAllTextInputs` and `maskAllImages` in `lib/posthog.ts` if you need to see more data (consider privacy implications)
## Automatic Screen Tracking
The `ScreenTracker` component in `app/_layout.tsx` automatically tracks all screen views using Expo Router's navigation hooks. No manual tracking needed for navigation.
## When to Use PostHog
- **Product Analytics** - Understand user behavior and feature usage
- **Debugging** - Watch session replays to see exactly what users experienced
- **Feature Flags** - A/B testing and gradual rollouts (requires additional setup)
- **User Feedback** - Combine with support tickets to see what happened
- **Conversion Funnels** - Track user journeys through your app
## Performance Impact
- Minimal CPU overhead (snapshots are throttled)
- Network usage: ~100-500KB per minute
- Battery impact: Negligible
- Storage: Data is sent to PostHog, not stored locally
## Best Practices
1. **Always mask sensitive data** - Keep `maskAllTextInputs: true` for production
2. **Track meaningful events** - Don't over-track; focus on key user actions
3. **Identify users after login** - Enables user-specific analysis
4. **Reset on logout** - Prevents data leakage between users
5. **Use properties** - Add context to events for better analysis
6. **Test in development** - Verify events appear before deploying
## Reference
- PostHog React Native Docs: https://posthog.com/docs/libraries/react-native
- Session Replay Docs: https://posthog.com/docs/session-replay/mobile
---
> Source: [Ampli-Group/agentic-mobile-blueprint](https://github.com/Ampli-Group/agentic-mobile-blueprint) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->
章节与文件索引
按说明文件中的顺序排列。
已经配置了什么
涉及文件
记录了什么
隐私保护
录音行为
文件/命令 -> ScreenTracker · usePostHog() · lib/posthog.ts · app/_layout.tsx · app.json · .env.example · captureNetworkTelemetry: true · captureLog: true
内容校验值 -> 15e43cfaf705
当前原文的自动摘译,尚未人工审校。
已经配置了什么
引导程序包括完整的 PostHog 设置,其中包括: 会话重播 - 记录具有隐私保护的用户会话 自动屏幕跟踪 - 通过
ScreenTracker组件自动跟踪导航 事件跟踪 - 通过usePostHog()挂钩即可使用 隐私控制 - 默认情况下屏蔽文本输入和图像涉及文件
文件 · 用途
lib/posthog.ts· 使用会话重放插件进行配置app/_layout.tsx· PostHogProvider 包装器和 ScreenTracker 组件app.json· PostHog 插件注册.env.example· 环境变量模板记录了什么
✅ 屏幕视图和导航 ✅ 触摸交互(点击、滑动) ✅ UI 更改和动画 ✅ 网络请求(使用
captureNetworkTelemetry: true) ✅ 控制台日志(使用captureLog: true)隐私保护
🔒 文本输入被屏蔽 - 所有表单输入均显示为“ 🔒 图像被屏蔽 - 照片和头像被模糊/隐藏 🔒 敏感数据受到保护 - 没有记录实际输入的内容
录音行为
应用程序启动时自动启动 在整个会话过程中持续 当应用程序关闭/后台时停止 每个会话都是 PostHog 仪表板中的单独重播 数据被压缩并批量发送(非实时)