用途:帮助 Portaly 创作者完成 GA4 安装与 Portaly 数据连接,覆盖网站埋点、事件跟踪和仪表盘查看分析数据。
主要能力:
- 安装 GA4:引导创建 GA4 媒体资源、获取 Measurement ID(G-XXXXXXX,格式固定),并按技术栈安装 gtag.js(Next.js App Router 用 layout.tsx + next/script;Pages Router 用 _app.js;React SPA 用 index.html;原生 HTML 用 head 标签)。
- 事件跟踪:依据标准事件契约配置 portaly_checkout_start、portaly_checkout_complete、portaly_subscription_cancel、portaly_page_view、portaly_product_view,并映射到 GA4 电商事件 begin_checkout、purchase;可选增强电商事件 view_item、begin_checkout、purchase。
- 连接 Portaly:在 Portaly Vibe Dashboard(https://portaly.ai/dashboard/analytics)的數據分析中点击「連結 Google Analytics」,使用拥有 GA4 媒体资源的 Google 账号授权只读权限(analytics.readonly),选择媒体资源即可查看会话、页面浏览、流量来源及 Portaly 事件数据。
使用方式:先确认用户目标(仅安装 GA4、仅连接仪表盘或两者)、技术栈与是否已有 GA4 媒体资源;将 Measurement ID 存入 .env 并确认 .gitignore 包含 .env(如 NEXT_PUBLIC_GA_MEASUREMENT_ID=G-XXXXXXX);按编号步骤给出可直接复制的配置与 JavaScript/TypeScript 代码;最后在 GA4 实时报告中验证页面浏览与事件是否出现。
适用场景:Portaly 创作者为自有网站接入 GA4 并希望统一查看分析数据。
限制:GA4 数据有 24–48 小时处理延迟;广告拦截器会导致统计偏低,不保证 100% 跟踪准确;如需 Cookie 同意(如 GDPR)需另行配置同意模式;若应用跳转至 portaly.ai 结账并返回,建议配置跨域跟踪;UA-XXXXX 为旧版 Universal Analytics ID,需改用 GA4;未提及收费、价格与具体套餐信息,暂未提供。