后猪分析

写作 社区

技能解读

当前原文的自动摘译,尚未人工审校。

已经配置了什么

引导程序包括完整的 PostHog 设置,其中包括: 会话重播 - 记录具有隐私保护的用户会话 自动屏幕跟踪 - 通过 ScreenTracker 组件自动跟踪导航 事件跟踪 - 通过 usePostHog() 挂钩即可使用 隐私控制 - 默认情况下屏蔽文本输入和图像

涉及文件

文件 · 用途 lib/posthog.ts · 使用会话重放插件进行配置 app/_layout.tsx · PostHogProvider 包装器和 ScreenTracker 组件 app.json · PostHog 插件注册 .env.example · 环境变量模板

记录了什么

✅ 屏幕视图和导航 ✅ 触摸交互(点击、滑动) ✅ UI 更改和动画 ✅ 网络请求(使用 captureNetworkTelemetry: true) ✅ 控制台日志(使用 captureLog: true)

隐私保护

🔒 文本输入被屏蔽 - 所有表单输入均显示为“ 🔒 图像被屏蔽 - 照片和头像被模糊/隐藏 🔒 敏感数据受到保护 - 没有记录实际输入的内容

录音行为

应用程序启动时自动启动 在整个会话过程中持续 当应用程序关闭/后台时停止 每个会话都是 PostHog 仪表板中的单独重播 数据被压缩并批量发送(非实时)

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
写作
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
需要 · Vendor-specific
兼容的系统
macOS · Linux · Windows
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# 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 -->

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。