Back to Details

heap

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Heap Skill

Heap Skill

Track user behavior automatically with Heap's auto-capture analytics platform.
借助Heap的自动捕获分析平台，自动追踪用户行为。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/heap/install.sh | bash
Or manually:
bash
cp -r skills/heap ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/heap/install.sh | bash
或手动安装：
bash
cp -r skills/heap ~/.canifi/skills/

Setup

设置

Configure via canifi-env:
bash
undefined
通过canifi-env进行配置：
bash
undefined

First, ensure canifi-env is installed:

首先，确保已安装canifi-env：

curl -sSL https://canifi.com/install.sh | bash

curl -sSL https://canifi.com/install.sh | bash

canifi-env set HEAP_APP_ID "your_app_id" canifi-env set HEAP_API_KEY "your_api_key"
undefined
canifi-env set HEAP_APP_ID "your_app_id" canifi-env set HEAP_API_KEY "your_api_key"
undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
你的凭证，由你掌控。 Canifi LifeOS尊重你的隐私。

Option 1: Manual Browser Login (Recommended)

选项1：手动浏览器登录（推荐）

If you prefer not to share credentials with Claude Code:
  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password
如果你不想与Claude Code共享凭证：
  1. 使用CDP模式完成浏览器自动化设置
  2. 在Playwright控制的Chrome窗口中手动登录服务
  3. Claude将使用你的已认证会话，全程不会获取你的密码

Option 2: Environment Variables

选项2：环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果你愿意共享凭证，可以将其存储在本地：
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意：存储在canifi-env中的凭证仅能在你的本地设备访问，绝不会被传输。

Capabilities

功能特性

  1. Auto-capture: Automatically track all user interactions
  2. Retroactive Analysis: Analyze events retroactively without code
  3. Funnel Analysis: Build conversion funnels from captured data
  4. Session Replay: Watch user session recordings
  5. User Segments: Create and analyze user segments
  1. 自动捕获：自动追踪所有用户交互
  2. 回溯分析：无需代码即可回溯分析事件
  3. 漏斗分析：基于捕获的数据构建转化漏斗
  4. 会话重放：查看用户会话录制内容
  5. 用户分群：创建并分析用户分群

Usage Examples

使用示例

Define Event

定义事件

User: "Create a virtual event for button clicks on the pricing page"
Assistant: Creates event definition from auto-captured data
用户：“为定价页面上的按钮点击创建一个虚拟事件”
助手：从自动捕获的数据中创建事件定义

Analyze Funnel

分析漏斗

User: "Show conversion from homepage to signup"
Assistant: Returns funnel analysis with drop-off points
用户：“展示从首页到注册的转化情况”
助手：返回包含流失节点的漏斗分析结果

View Session

查看会话

User: "Show me sessions where users abandoned checkout"
Assistant: Returns relevant session recordings
用户：“展示用户放弃结账的会话内容”
助手：返回相关的会话录制内容

Create Segment

创建分群

User: "Create a segment of power users"
Assistant: Creates user segment with criteria
用户：“创建一个核心用户分群”
助手：根据条件创建用户分群

Authentication Flow

认证流程

  1. Get App ID from Heap project settings
  2. Get API key for data access
  3. App ID for tracking script
  4. API key for data queries
  1. 从Heap项目设置中获取App ID
  2. 获取用于数据访问的API密钥
  3. App ID用于追踪脚本
  4. API密钥用于数据查询

Error Handling

错误处理

ErrorCauseSolution
401 UnauthorizedInvalid API keyVerify credentials
403 ForbiddenNo project accessCheck permissions
400 Bad RequestInvalid queryFix query format
429 Rate LimitedToo many requestsImplement backoff
错误原因解决方案
401 未授权API密钥无效验证凭证
403 禁止访问无项目访问权限检查权限设置
400 请求错误查询格式无效修正查询格式
429 请求受限请求次数过多实现退避机制

Notes

注意事项

  • Auto-captures all interactions
  • Retroactive event definition
  • No code changes needed
  • Session replay included
  • Free tier available
  • Point-and-click analysis
  • 自动捕获所有交互
  • 支持回溯定义事件
  • 无需修改代码
  • 包含会话重放功能
  • 提供免费层级
  • 支持点击式分析