@funnelsgrove/分析
公共漏斗共享分析包.
在编辑分析码前读取此文件. 更深的运行时间 SDK 文件居住
docs/funnel-sdk/analytics-sdk.md。 。 。 .
拥有事件身份和交付
@funnelsgrove/analytics 拥有浏览器身份,事件形状,以及公共漏斗分析的交付合同. 漏斗码可能决定何时发生商务事件,但这个包决定了该事件如何成为SDK/PostHog/partner有效载荷的正态.
使用此软件包
- 浏览器用户编号持久性
- 用于公共漏斗身份的 SDK 用户拖带
- 公共分析活动分批和运输
- 识别、跟踪、步骤生命周期和退出事件助手
- 支付元数据到达API前花纹购买元数据塑造
- Google 标记和 Meta 像素事件适配器
- 未配置真正可公布的密钥时, 仅本地禁用行为
不使用此软件包
- 步骤路由
- 显示逻辑
- 退出协调
- 收费计划决议
- 条条检出 UI
- 漏斗特定步骤组件或副本
公众表面
publicAnalyticsSdk:用于识别,跟踪,生命周期,取出以及冲号的Canonic浏览器SDK.bootstrapPublicAnalyticsUser: 公共SDK身份靴子助手.sdk-user-id.storage: 共享浏览器用户代号存储合同.buildStripePurchaseMetadata并购买属性助手:用于支付交接的安全元数据.trackStripePaymentCheckoutReturn: 解析和去重复 Stree浏览器-回回诊断,而不主张购买转换.google-tag.service财务报告和审定财务报表meta-pixel.service:伙伴活动适配器.experiment-result-metrics.service: 共享实验结果度量助手.
工程规则
- 在此保留运输细节; 不重复漏斗中的事件批量 .
- 保持提供者适配器哑:它们映射出犬科事件,而不是漏斗业务流量.
- 不从此软件包导入付款 UI 或运行时间路由 .
- 敏感值必须在元数据到达Frede或伙伴工具之前被过滤.
- 条纹浏览器返回仅是诊断状态 。 使用
trackStripePaymentCheckoutReturn; 绝不将查询参数变为checkout_completed或信赖purchase_completed。 。 。 .
谷歌标签配置
NEXT_PUBLIC_GOOGLE_ANALYTICS_ID 财务报告和审定财务报表 NEXT_PUBLIC_GOOGLE_TAG_MANAGER_ID
配置 Google 标签装入 。 谷歌 广告转换动作也需要
满 send_to 目的地,例如: AW-123456789/ConversionLabel。 。 。 .
NEXT_PUBLIC_GOOGLE_TAG_LEAD_SEND_TO发送广告conversion当 SDK记录一个铅/电子邮件捕获.NEXT_PUBLIC_GOOGLE_TAG_LEAD_VALUE设置铅Ads的数值 转换。 空值或无效值默认为0。 。 。 .NEXT_PUBLIC_GOOGLE_TAG_PURCHASE_SEND_TO发送广告conversion当 sDK记录了一个付费的结账.
指定转换值仅在 NEXT_PUBLIC_GOOGLE_TAG_ENABLED=true。 。 。 .
这个 AW-... 前缀用于加载和配置 gtag.js; 全文
AW-.../... 在转换事件上发送值.
构建、测试、发布
npm run test:run --workspace @funnelsgrove/analytics
npm run build --workspace @funnelsgrove/analytics
npm publish --workspace @funnelsgrove/analytics --access public
该建筑使产生的相对无害环境管理进口商品正常化,使之明确 .js 用于已发布的软件包消费者的文件.