promo-tracker 0.0.1 → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +34 -6
- package/dist/index.d.ts +3 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/promo-params.d.ts +12 -0
- package/dist/promo-params.d.ts.map +1 -0
- package/dist/promo-tracker.d.ts +3 -11
- package/dist/promo-tracker.d.ts.map +1 -1
- package/dist/promo-tracker.js +91 -71
- package/dist/promo-tracker.js.map +1 -1
- package/dist/promo-tracker.umd.cjs +1 -1
- package/dist/promo-tracker.umd.cjs.map +1 -1
- package/package.json +5 -1
package/README.md
CHANGED
|
@@ -20,6 +20,11 @@ npm install tldts@^7.5.4 @fingerprintjs/fingerprintjs@^5.3.0
|
|
|
20
20
|
| `getCookie` | 按名称读取并解码 Cookie |
|
|
21
21
|
| `getVisitorId` | 获取浏览器 visitorId,成功后仅缓存在内存中 |
|
|
22
22
|
| `createPromoTracker` | 创建推广落地追踪实例 |
|
|
23
|
+
| `getTraceId` | 独立读取已保存的 traceId,无需创建实例 |
|
|
24
|
+
| `saveTraceId` | 独立保存 traceId 到内存、localStorage 和 Cookie |
|
|
25
|
+
| `getPromoParams` | 从当前 URL 读取推广参数,也可通过追踪实例调用 |
|
|
26
|
+
| `getPersistedPromoParams` | 从 Cookie 读取已保存的推广参数 |
|
|
27
|
+
| `persistPromoParams` | 独立保存推广参数到 Cookie |
|
|
23
28
|
| `PromoParams` | 推广参数类型 |
|
|
24
29
|
| `ReportOptions` | 包含可选 `utmSource` 的类型,当前追踪实例没有接收此类型的方法 |
|
|
25
30
|
| `PromoTrackerOptions` | 推广追踪实例配置类型 |
|
|
@@ -99,7 +104,7 @@ try {
|
|
|
99
104
|
## 推广落地追踪
|
|
100
105
|
|
|
101
106
|
```ts
|
|
102
|
-
import { createPromoTracker } from 'promo-tracker'
|
|
107
|
+
import { createPromoTracker, getTraceId, getPersistedPromoParams, persistPromoParams } from 'promo-tracker'
|
|
103
108
|
import type { PromoTrackerOptions } from 'promo-tracker'
|
|
104
109
|
|
|
105
110
|
const options: PromoTrackerOptions = {
|
|
@@ -112,10 +117,11 @@ const tracker = createPromoTracker(options)
|
|
|
112
117
|
const params = tracker.getPromoParams()
|
|
113
118
|
const utmSource = tracker.getUtmSource()
|
|
114
119
|
const traceId = await tracker.trackLanding()
|
|
115
|
-
const savedTraceId =
|
|
120
|
+
const savedTraceId = getTraceId()
|
|
116
121
|
|
|
117
122
|
// 也可在不触发上报时,显式保存推广参数。
|
|
118
|
-
|
|
123
|
+
persistPromoParams(params)
|
|
124
|
+
const savedParams = getPersistedPromoParams()
|
|
119
125
|
```
|
|
120
126
|
|
|
121
127
|
创建实例不会自动发请求,建议每个页面复用一个实例。
|
|
@@ -133,13 +139,35 @@ tracker.persistPromoParams(params)
|
|
|
133
139
|
| 方法 | 返回值 | 行为 |
|
|
134
140
|
| --- | --- | --- |
|
|
135
141
|
| `trackLanding()` | `Promise<string \| null>` | 上报推广落地事件,返回 traceId;跳过或失败时返回 `null` |
|
|
136
|
-
| `getTraceId()` | `string \| null` | 优先从 localStorage 或实例内存读取 traceId,再尝试 Cookie |
|
|
137
142
|
| `getPromoParams()` | `PromoParams` | 从当前 URL 读取非空的推广参数 |
|
|
138
143
|
| `getUtmSource()` | `string \| undefined` | 返回当前 URL 中非空的 `utm_source` |
|
|
139
|
-
| `persistPromoParams(params?)` | `void` | 保存非空推广参数到 Cookie,默认使用当前 URL 的参数 |
|
|
140
144
|
|
|
141
145
|
`PromoParams` 包含三个可选字符串字段:`promoLinkId`、`inviteCode`、`utm_source`。
|
|
142
146
|
|
|
147
|
+
### 独立参数方法
|
|
148
|
+
|
|
149
|
+
`getTraceId(): string | null` 优先从 localStorage 读取 traceId,再尝试当前浏览器上下文的内存缓存和 Cookie。缺失或非浏览器环境返回 `null`。直接从包导入调用,不再通过实例调用;浏览器存储不可用时,仍可读取当前上下文中上报成功后缓存的 traceId。
|
|
150
|
+
|
|
151
|
+
`saveTraceId(id: string, cookieMaxAge?: number): void` 与 `getTraceId` 配对,统一写入内存、localStorage 和 Cookie。Cookie 有效期默认 30 天,单位为秒;空 ID 或非浏览器环境跳过。落地上报也通过此方法保存,并传入实例配置的有效期。此方法仅保存 traceId,不修改落地归因记录。
|
|
152
|
+
|
|
153
|
+
```ts
|
|
154
|
+
import { getTraceId, saveTraceId } from 'promo-tracker'
|
|
155
|
+
|
|
156
|
+
saveTraceId('trace-123', 7 * 24 * 60 * 60)
|
|
157
|
+
const traceId = getTraceId()
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
`getPromoParams(): PromoParams` 从当前 URL 读取非空推广参数,与实例上的同名方法一致。
|
|
161
|
+
|
|
162
|
+
`persistPromoParams(params?, cookieMaxAge?): void` 将非空推广参数保存到 `_tracker_promo_query` Cookie,默认读取当前 URL,有效期默认 30 天(单位为秒)。没有非空参数时保留已有 Cookie;无需创建追踪实例。
|
|
163
|
+
|
|
164
|
+
`getPersistedPromoParams(cookies?): PromoParams` 默认读取 `document.cookie`,也可传入 Cookie 字符串。仅返回已知的非空推广字段;Cookie 缺失、解码失败、JSON 无效或已知字段不是字符串时返回 `{}`。
|
|
165
|
+
|
|
166
|
+
```ts
|
|
167
|
+
persistPromoParams(undefined, 7 * 24 * 60 * 60)
|
|
168
|
+
const savedParams = getPersistedPromoParams()
|
|
169
|
+
```
|
|
170
|
+
|
|
143
171
|
### 落地上报规则
|
|
144
172
|
|
|
145
173
|
`trackLanding()` 在 URL 包含非空 `inviteCode` 时,向 `{baseURL}/{apiPath}/track` 发送 JSON POST。`promoLinkId` 缺失或无法转换为有限数字时使用 `1`。
|
|
@@ -166,7 +194,7 @@ HTTP 响应必须成功,业务响应格式需为:
|
|
|
166
194
|
| Cookie | `_tracker_promo_trace_id` | traceId |
|
|
167
195
|
| Cookie | `_tracker_promo_query` | 非空推广参数的 JSON 对象 |
|
|
168
196
|
|
|
169
|
-
|
|
197
|
+
落地上报写入的两个推广 Cookie 的有效期由实例配置 `cookieMaxAge` 控制;独立调用 `persistPromoParams` 时由其第二个参数控制。localStorage 不设置过期时间。localStorage 不可用时,在当前实例的内存中保留状态,刷新页面后可能重新上报。
|
|
170
198
|
|
|
171
199
|
非浏览器环境可安全创建实例:`trackLanding()` 和 `getTraceId()` 返回 `null`,`getPromoParams()` 返回 `{}`,`getUtmSource()` 返回 `undefined`,保存操作跳过。
|
|
172
200
|
|
package/dist/index.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
export { getGclid, getGoogleAdsParams, persistGoogleAdsParams, } from './google-ads';
|
|
2
2
|
export { getCookie } from './utils/cookie';
|
|
3
3
|
export { getVisitorId } from './utils/visitor-id';
|
|
4
|
-
export { createPromoTracker } from './promo-tracker';
|
|
5
|
-
export
|
|
4
|
+
export { createPromoTracker, getTraceId } from './promo-tracker';
|
|
5
|
+
export { getPersistedPromoParams } from './promo-params';
|
|
6
|
+
export type { PromoParams, PromoTrackerOptions, PromoTracker } from './promo-tracker';
|
|
6
7
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACxD,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export interface PromoParams {
|
|
2
|
+
promoLinkId?: string;
|
|
3
|
+
inviteCode?: string;
|
|
4
|
+
utm_source?: string;
|
|
5
|
+
}
|
|
6
|
+
/** 从当前 URL 读取非空推广参数。 */
|
|
7
|
+
export declare function getPromoParams(): PromoParams;
|
|
8
|
+
/** 读取 Cookie 中保存的推广参数;缺失或格式无效时返回空对象。 */
|
|
9
|
+
export declare function getPersistedPromoParams(cookies?: string): PromoParams;
|
|
10
|
+
/** 保存非空推广参数;默认读取当前 URL,有效期为 30 天。 */
|
|
11
|
+
export declare function persistPromoParams(params?: PromoParams, cookieMaxAge?: number): void;
|
|
12
|
+
//# sourceMappingURL=promo-params.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"promo-params.d.ts","sourceRoot":"","sources":["../src/promo-params.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAwB;AACxB,wBAAgB,cAAc,IAAI,WAAW,CAS5C;AAED,wCAAwC;AACxC,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,MAA4B,GAAG,WAAW,CAe1F;AAED,qCAAqC;AACrC,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,WAA8B,EACtC,YAAY,GAAE,MAAuB,GACpC,IAAI,CAKN"}
|
package/dist/promo-tracker.d.ts
CHANGED
|
@@ -1,11 +1,6 @@
|
|
|
1
|
-
export
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
utm_source?: string;
|
|
5
|
-
}
|
|
6
|
-
export interface ReportOptions {
|
|
7
|
-
utmSource?: string;
|
|
8
|
-
}
|
|
1
|
+
export type { PromoParams } from './promo-params';
|
|
2
|
+
/** 读取已保存的 traceId,无需创建追踪实例。 */
|
|
3
|
+
export declare function getTraceId(): string | null;
|
|
9
4
|
export interface PromoTrackerOptions {
|
|
10
5
|
/** Cookie 有效期,单位为秒;默认 30 天。 */
|
|
11
6
|
cookieMaxAge?: number;
|
|
@@ -17,9 +12,6 @@ export interface PromoTrackerOptions {
|
|
|
17
12
|
/** 创建独立的推广追踪实例,无 Nuxt/Vue 依赖;初始化不触发请求。 */
|
|
18
13
|
export declare function createPromoTracker(options?: PromoTrackerOptions): {
|
|
19
14
|
trackLanding: () => Promise<string | null>;
|
|
20
|
-
getTraceId: () => string | null;
|
|
21
|
-
getPromoParams: () => PromoParams;
|
|
22
|
-
getUtmSource: () => string | undefined;
|
|
23
15
|
};
|
|
24
16
|
export type PromoTracker = ReturnType<typeof createPromoTracker>;
|
|
25
17
|
//# sourceMappingURL=promo-tracker.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"promo-tracker.d.ts","sourceRoot":"","sources":["../src/promo-tracker.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"promo-tracker.d.ts","sourceRoot":"","sources":["../src/promo-tracker.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AASjD,+BAA+B;AAC/B,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAS1C;AAcD,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAoBD,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB;wBAsDnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;EA0DtD;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA"}
|
package/dist/promo-tracker.js
CHANGED
|
@@ -69,126 +69,146 @@ async function p() {
|
|
|
69
69
|
throw f = void 0, e;
|
|
70
70
|
}), f);
|
|
71
71
|
}
|
|
72
|
-
// src/promo-
|
|
73
|
-
var m = "
|
|
72
|
+
// src/promo-params.ts
|
|
73
|
+
var m = "_tracker_promo_query", h = [
|
|
74
74
|
"promoLinkId",
|
|
75
75
|
"inviteCode",
|
|
76
76
|
"utm_source"
|
|
77
|
-
];
|
|
78
|
-
function
|
|
77
|
+
], g = 2592e3;
|
|
78
|
+
function _() {
|
|
79
|
+
let e = {};
|
|
80
|
+
if (typeof window > "u") return e;
|
|
81
|
+
let t = new URL(window.location.href).searchParams;
|
|
82
|
+
for (let n of h) {
|
|
83
|
+
let r = t.get(n);
|
|
84
|
+
r && (e[n] = r);
|
|
85
|
+
}
|
|
86
|
+
return e;
|
|
87
|
+
}
|
|
88
|
+
function v(e = n()) {
|
|
89
|
+
try {
|
|
90
|
+
let t = JSON.parse(r(m, e));
|
|
91
|
+
if (typeof t != "object" || !t || Array.isArray(t)) return {};
|
|
92
|
+
let n = {};
|
|
93
|
+
for (let e of h) {
|
|
94
|
+
if (!(e in t)) continue;
|
|
95
|
+
let r = t[e];
|
|
96
|
+
if (typeof r != "string") return {};
|
|
97
|
+
r && (n[e] = r);
|
|
98
|
+
}
|
|
99
|
+
return n;
|
|
100
|
+
} catch {
|
|
101
|
+
return {};
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
function y(e = _(), t = g) {
|
|
105
|
+
let n = h.flatMap((t) => e[t] ? [[t, e[t]]] : []);
|
|
106
|
+
n.length && i(m, JSON.stringify(Object.fromEntries(n)), { maxAge: t });
|
|
107
|
+
}
|
|
108
|
+
// src/promo-tracker.ts
|
|
109
|
+
var b = "/web-api/zw/promo-event", x = "_tracker", S = `${x}_promo_device_id`, C = `${x}_promo_trace_id`, w = `${x}_promo_attribution`, T = /* @__PURE__ */ new WeakMap();
|
|
110
|
+
function E() {
|
|
111
|
+
if (typeof window > "u" || typeof document > "u") return null;
|
|
112
|
+
let e = null;
|
|
113
|
+
try {
|
|
114
|
+
e = window.localStorage.getItem(C);
|
|
115
|
+
} catch {}
|
|
116
|
+
return e || T.get(window) || r(C) || null;
|
|
117
|
+
}
|
|
118
|
+
function D(e, t = 2592e3) {
|
|
119
|
+
if (typeof window < "u" && typeof document < "u" && e) {
|
|
120
|
+
T.set(window, e);
|
|
121
|
+
try {
|
|
122
|
+
window.localStorage.setItem(C, e);
|
|
123
|
+
} catch {}
|
|
124
|
+
i(C, e, { maxAge: t });
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
function O(e, t) {
|
|
79
128
|
return `${e.replace(/\/+$/, "")}/${t.replace(/^\/+/, "")}`;
|
|
80
129
|
}
|
|
81
|
-
function
|
|
130
|
+
function k() {
|
|
82
131
|
if (typeof crypto.randomUUID == "function") return crypto.randomUUID();
|
|
83
132
|
let e = crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(16));
|
|
84
133
|
e[6] = e[6] & 15 | 64, e[8] = e[8] & 63 | 128;
|
|
85
134
|
let t = Array.from(e, (e) => e.toString(16).padStart(2, "0")).join("");
|
|
86
135
|
return `${t.slice(0, 8)}-${t.slice(8, 12)}-${t.slice(12, 16)}-${t.slice(16, 20)}-${t.slice(20)}`;
|
|
87
136
|
}
|
|
88
|
-
function
|
|
89
|
-
let t = e.cookieMaxAge ?? 2592e3, n =
|
|
90
|
-
function
|
|
137
|
+
function A(e = {}) {
|
|
138
|
+
let t = e.cookieMaxAge ?? 2592e3, n = O(e.baseURL ?? "", e.apiPath ?? b).replace(/\/+$/, ""), r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), a = 0, o;
|
|
139
|
+
function s() {
|
|
91
140
|
return typeof window < "u" && typeof document < "u";
|
|
92
141
|
}
|
|
93
|
-
function
|
|
142
|
+
function c(e) {
|
|
94
143
|
try {
|
|
95
|
-
return window.localStorage.getItem(e) ??
|
|
144
|
+
return window.localStorage.getItem(e) ?? r.get(e) ?? null;
|
|
96
145
|
} catch {
|
|
97
|
-
return
|
|
146
|
+
return r.get(e) ?? null;
|
|
98
147
|
}
|
|
99
148
|
}
|
|
100
|
-
function
|
|
101
|
-
|
|
149
|
+
function l(e, t) {
|
|
150
|
+
r.set(e, t);
|
|
102
151
|
try {
|
|
103
152
|
window.localStorage.setItem(e, t);
|
|
104
153
|
} catch {}
|
|
105
154
|
}
|
|
106
|
-
async function
|
|
107
|
-
return
|
|
155
|
+
async function u() {
|
|
156
|
+
return s() ? c(S) || (o ||= (async () => {
|
|
108
157
|
let e;
|
|
109
158
|
try {
|
|
110
159
|
e = await p();
|
|
111
160
|
} catch {
|
|
112
|
-
e =
|
|
161
|
+
e = k();
|
|
113
162
|
}
|
|
114
|
-
return
|
|
115
|
-
})(),
|
|
116
|
-
}
|
|
117
|
-
function h() {
|
|
118
|
-
return l() && (u(_) || r(_)) || null;
|
|
119
|
-
}
|
|
120
|
-
function C(e) {
|
|
121
|
-
l() && e && (d(_, e), i(_, e, { maxAge: t }));
|
|
163
|
+
return l(S, e), e;
|
|
164
|
+
})(), o) : "";
|
|
122
165
|
}
|
|
123
|
-
function
|
|
124
|
-
let e = {};
|
|
125
|
-
if (!l()) return e;
|
|
126
|
-
let t = new URL(window.location.href).searchParams;
|
|
127
|
-
for (let n of b) {
|
|
128
|
-
let r = t.get(n);
|
|
129
|
-
r && (e[n] = r);
|
|
130
|
-
}
|
|
131
|
-
return e;
|
|
132
|
-
}
|
|
133
|
-
function T() {
|
|
134
|
-
return w().utm_source;
|
|
135
|
-
}
|
|
136
|
-
function E(e = w()) {
|
|
137
|
-
if (!l()) return;
|
|
138
|
-
let n = b.flatMap((t) => e[t] ? [[t, e[t]]] : []);
|
|
139
|
-
n.length && i(y, JSON.stringify(Object.fromEntries(n)), { maxAge: t });
|
|
140
|
-
}
|
|
141
|
-
function D(e) {
|
|
166
|
+
function d(e) {
|
|
142
167
|
return JSON.stringify([e.promoLinkId || "", e.inviteCode || ""]);
|
|
143
168
|
}
|
|
144
|
-
async function
|
|
145
|
-
if (!
|
|
146
|
-
let e =
|
|
169
|
+
async function f() {
|
|
170
|
+
if (!s()) return null;
|
|
171
|
+
let e = _();
|
|
147
172
|
if (!e.inviteCode) return null;
|
|
148
|
-
let
|
|
149
|
-
if (
|
|
150
|
-
let
|
|
151
|
-
if (
|
|
152
|
-
let
|
|
173
|
+
let r = d(e), o = E();
|
|
174
|
+
if (o && c(w) === JSON.stringify([r, o])) return o;
|
|
175
|
+
let f = i.get(r);
|
|
176
|
+
if (f) return f;
|
|
177
|
+
let p = ++a, m = window.location.href, h = document.referrer || void 0, g = (async () => {
|
|
153
178
|
try {
|
|
154
|
-
|
|
155
|
-
let
|
|
179
|
+
y(e, t);
|
|
180
|
+
let i = Number(e.promoLinkId || 1), o = await fetch(`${n}/track`, {
|
|
156
181
|
method: "POST",
|
|
157
182
|
headers: { "Content-Type": "application/json" },
|
|
158
183
|
body: JSON.stringify({
|
|
159
|
-
eventId:
|
|
160
|
-
deviceId: await
|
|
184
|
+
eventId: k(),
|
|
185
|
+
deviceId: await u(),
|
|
161
186
|
inviteCode: e.inviteCode,
|
|
162
187
|
utmSource: e.utm_source,
|
|
163
|
-
promoLinkId: Number.isFinite(
|
|
188
|
+
promoLinkId: Number.isFinite(i) ? i : 1,
|
|
164
189
|
eventType: "landing",
|
|
165
190
|
eventTarget: "promo_landing",
|
|
166
|
-
referrer:
|
|
167
|
-
pageUrl:
|
|
191
|
+
referrer: h,
|
|
192
|
+
pageUrl: m,
|
|
168
193
|
clientTime: Date.now()
|
|
169
194
|
})
|
|
170
195
|
});
|
|
171
|
-
if (!
|
|
172
|
-
let
|
|
173
|
-
return
|
|
196
|
+
if (!o.ok) return null;
|
|
197
|
+
let s = await o.json(), c = s?.data?.promoTraceId;
|
|
198
|
+
return s?.code !== 0 || typeof c != "string" || !c ? null : (p === a && (D(c, t), l(w, JSON.stringify([r, c]))), c);
|
|
174
199
|
} catch {
|
|
175
200
|
return null;
|
|
176
201
|
}
|
|
177
202
|
})();
|
|
178
|
-
|
|
203
|
+
i.set(r, g);
|
|
179
204
|
try {
|
|
180
|
-
return await
|
|
205
|
+
return await g;
|
|
181
206
|
} finally {
|
|
182
|
-
|
|
207
|
+
i.delete(r);
|
|
183
208
|
}
|
|
184
209
|
}
|
|
185
|
-
return {
|
|
186
|
-
trackLanding: O,
|
|
187
|
-
getTraceId: h,
|
|
188
|
-
getPromoParams: w,
|
|
189
|
-
getUtmSource: T
|
|
190
|
-
};
|
|
210
|
+
return { trackLanding: f };
|
|
191
211
|
}
|
|
192
|
-
export {
|
|
212
|
+
export { A as createPromoTracker, r as getCookie, l as getGclid, u as getGoogleAdsParams, v as getPersistedPromoParams, E as getTraceId, p as getVisitorId, d as persistGoogleAdsParams };
|
|
193
213
|
|
|
194
214
|
//# sourceMappingURL=promo-tracker.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"promo-tracker.js","names":["FingerprintJS","getBrowserCookies","getCookie","prefix","name","entry","cookies","cookie","setCookie","store","options","url","domain","getDomain","value","COOKIE_NAMESPACE","GCLID_COOKIE_NAME","GOOGLE_ADS_QUERY_COOKIE_NAME","GOOGLE_ADS_COOKIE_MAX_AGE","getGclid","getGoogleAdsParams","queryParams","params","persistGoogleAdsParams","gclid","cookieMaxAge","visitorIdPromise","getVisitorId","visitorId","error","PROMO_API_PATH","STORAGE_NAMESPACE","DEVICE_ID","TRACE_ID","ATTRIBUTION","COOKIE_PARAMS","PROMO_PARAM_KEYS","joinPath","base","path","createId","bytes","hex","byte","createPromoTracker","apiBase","memory","pending","latestRequest","deviceIdPromise","isClient","readStorage","key","writeStorage","getDeviceId","id","getTraceId","saveTraceId","getPromoParams","search","getUtmSource","persistPromoParams","entries","attributionKey","trackLanding","traceId","existing","requestId","pageUrl","referrer","request","linkId","response","result"],"sources":["../src/utils/cookie.ts","../src/google-ads.ts","../src/utils/visitor-id.ts","../src/promo-tracker.ts"],"sourcesContent":["import { getDomain } from 'tldts'\n\ninterface CookieOptions {\n /** Cookie 有效期,单位为秒。 */\n maxAge: number\n url?: URL\n store?: Pick<Document, 'cookie'>\n}\n\nexport function getBrowserCookies(): string {\n try {\n return typeof document === 'undefined' ? '' : document.cookie\n } catch {\n return ''\n }\n}\n\nexport function getCookie(name: string, cookies: string = getBrowserCookies()): string {\n const prefix = `${name}=`\n const entry = cookies.split(';').find(cookie => cookie.trim().startsWith(prefix))\n if (!entry) return ''\n try {\n return decodeURIComponent(entry.trim().slice(prefix.length))\n } catch {\n return ''\n }\n}\n\n/** 写入父域 Cookie;缺少浏览器上下文或访问被禁止时跳过。 */\nexport function setCookie(name: string, value: string, options: CookieOptions): void {\n try {\n const store = options.store ?? (typeof document === 'undefined' ? undefined : document)\n const url = options.url ?? (typeof window === 'undefined' ? undefined : new URL(window.location.href))\n if (!store || !url) return\n\n const domain = getDomain(url.hostname, { allowPrivateDomains: true })\n store.cookie = [\n `${name}=${encodeURIComponent(value)}`,\n ...(domain ? [`Domain=${domain}`] : []),\n 'Path=/',\n `Max-Age=${options.maxAge}`,\n 'SameSite=Lax',\n ...(url.protocol === 'https:' ? ['Secure'] : []),\n ].join('; ')\n } catch {\n // Cookie 被禁用时不影响业务逻辑。\n }\n}\n","import { getBrowserCookies, getCookie, setCookie } from './utils/cookie'\n\nconst COOKIE_NAMESPACE = '_tracker'\nconst GCLID_COOKIE_NAME = `${COOKIE_NAMESPACE}_gclid`\nconst GOOGLE_ADS_QUERY_COOKIE_NAME = `${COOKIE_NAMESPACE}_google_ads_query`\nconst GOOGLE_ADS_COOKIE_MAX_AGE = 90 * 24 * 60 * 60\n\nexport function getGclid(\n cookies: string = getBrowserCookies(),\n): string {\n return getCookie(GCLID_COOKIE_NAME, cookies)\n}\n\nexport function getGoogleAdsParams(\n cookies: string = getBrowserCookies(),\n): Record<string, string> {\n const queryParams = getCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, cookies)\n if (!queryParams) return {}\n try {\n const params: unknown = JSON.parse(queryParams)\n if (typeof params !== 'object' || params === null || Array.isArray(params)) return {}\n if (!Object.values(params).every(value => typeof value === 'string')) return {}\n return params as Record<string, string>\n } catch {\n return {}\n }\n}\n\nexport function persistGoogleAdsParams(\n url: URL | undefined = typeof location === 'undefined' ? undefined : new URL(location.href),\n store: Pick<Document, 'cookie'> | undefined = typeof document === 'undefined' ? undefined : document,\n /** Cookie 有效期,单位为秒;默认 90 天。 */\n cookieMaxAge: number = GOOGLE_ADS_COOKIE_MAX_AGE,\n): void {\n if (!url || !store) return\n\n const gclid = url.searchParams.get('gclid')\n if (!gclid) return\n\n const options = { url, store, maxAge: cookieMaxAge }\n const queryParams = JSON.stringify(Object.fromEntries(url.searchParams))\n setCookie(GCLID_COOKIE_NAME, gclid, options)\n setCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, queryParams, options)\n}\n","import FingerprintJS from '@fingerprintjs/fingerprintjs'\n\nlet visitorIdPromise: Promise<string> | undefined\n\n/** 成功获取后始终复用缓存;失败不缓存,下次调用可重试。SSR 返回空字符串。 */\nexport async function getVisitorId(): Promise<string> {\n if (typeof window === 'undefined' || typeof document === 'undefined') return ''\n if (!visitorIdPromise) {\n visitorIdPromise = (async () => {\n const agent = await FingerprintJS.load({ monitoring: false })\n const { visitorId } = await agent.get()\n if (!visitorId) throw new Error('FingerprintJS returned an empty visitorId')\n return visitorId\n })().catch(error => {\n visitorIdPromise = undefined\n throw error\n })\n }\n return visitorIdPromise\n}\n","import { getCookie, setCookie } from './utils/cookie'\nimport { getVisitorId } from './utils/visitor-id'\n\nconst PROMO_API_PATH = '/web-api/zw/promo-event'\nconst STORAGE_NAMESPACE = '_tracker'\nconst DEVICE_ID = `${STORAGE_NAMESPACE}_promo_device_id`\nconst TRACE_ID = `${STORAGE_NAMESPACE}_promo_trace_id`\nconst ATTRIBUTION = `${STORAGE_NAMESPACE}_promo_attribution`\nconst COOKIE_PARAMS = `${STORAGE_NAMESPACE}_promo_query`\nconst PROMO_PARAM_KEYS = ['promoLinkId', 'inviteCode', 'utm_source'] as const\n\nexport interface PromoParams {\n promoLinkId?: string\n inviteCode?: string\n utm_source?: string\n}\n\nexport interface ReportOptions {\n utmSource?: string\n}\n\nexport interface PromoTrackerOptions {\n /** Cookie 有效期,单位为秒;默认 30 天。 */\n cookieMaxAge?: number\n /** API 和产品页面的基础地址;默认当前站点,支持相对路径。 */\n baseURL?: string\n /** 相对 baseURL 的上报路径。 */\n apiPath?: string\n}\n\ninterface TrackResponse {\n code: number\n data?: { promoTraceId?: string } | null\n}\n\nfunction joinPath(base: string, path: string): string {\n return `${base.replace(/\\/+$/, '')}/${path.replace(/^\\/+/, '')}`\n}\n\nfunction createId(): string {\n if (typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n const bytes = crypto.getRandomValues(new Uint8Array(16))\n bytes[6] = (bytes[6] & 0x0f) | 0x40\n bytes[8] = (bytes[8] & 0x3f) | 0x80\n const hex = Array.from(bytes, byte => byte.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n\n/** 创建独立的推广追踪实例,无 Nuxt/Vue 依赖;初始化不触发请求。 */\nexport function createPromoTracker(options: PromoTrackerOptions = {}) {\n const cookieMaxAge = options.cookieMaxAge ?? 30 * 24 * 60 * 60\n const baseURL = options.baseURL ?? ''\n const apiBase = joinPath(baseURL, options.apiPath ?? PROMO_API_PATH).replace(/\\/+$/, '')\n const memory = new Map<string, string>()\n const pending = new Map<string, Promise<string | null>>()\n let latestRequest = 0\n let deviceIdPromise: Promise<string> | undefined\n\n function isClient(): boolean {\n return typeof window !== 'undefined' && typeof document !== 'undefined'\n }\n\n function readStorage(key: string): string | null {\n try {\n return window.localStorage.getItem(key) ?? memory.get(key) ?? null\n } catch {\n return memory.get(key) ?? null\n }\n }\n\n function writeStorage(key: string, value: string): void {\n memory.set(key, value)\n try {\n window.localStorage.setItem(key, value)\n } catch {\n // 存储被禁用时,在当前实例内保留状态。\n }\n }\n\n /** 优先复用已保存的 ID,否则生成浏览器指纹;失败时回退到 UUID。 */\n async function getDeviceId(): Promise<string> {\n if (!isClient()) return ''\n const existing = readStorage(DEVICE_ID)\n if (existing) return existing\n if (!deviceIdPromise) {\n deviceIdPromise = (async () => {\n let id: string\n try {\n id = await getVisitorId()\n } catch {\n id = createId()\n }\n writeStorage(DEVICE_ID, id)\n return id\n })()\n }\n return deviceIdPromise\n }\n\n function getTraceId(): string | null {\n if (!isClient()) return null\n return readStorage(TRACE_ID) || getCookie(TRACE_ID) || null\n }\n\n function saveTraceId(id: string): void {\n if (!isClient() || !id) return\n writeStorage(TRACE_ID, id)\n setCookie(TRACE_ID, id, { maxAge: cookieMaxAge })\n }\n\n function getPromoParams(): PromoParams {\n const params: PromoParams = {}\n if (!isClient()) return params\n const search = new URL(window.location.href).searchParams\n for (const key of PROMO_PARAM_KEYS) {\n const value = search.get(key)\n if (value) params[key] = value\n }\n return params\n }\n\n function getUtmSource(): string | undefined {\n return getPromoParams().utm_source\n }\n\n function persistPromoParams(params: PromoParams = getPromoParams()): void {\n if (!isClient()) return\n const entries = PROMO_PARAM_KEYS.flatMap(key => params[key] ? [[key, params[key]]] : [])\n if (entries.length) {\n setCookie(COOKIE_PARAMS, JSON.stringify(Object.fromEntries(entries)), { maxAge: cookieMaxAge })\n }\n }\n\n function attributionKey(params: PromoParams): string {\n return JSON.stringify([params.promoLinkId || '', params.inviteCode || ''])\n }\n\n async function trackLanding(): Promise<string | null> {\n if (!isClient()) return null\n const params = getPromoParams()\n if (!params.inviteCode) return null\n const key = attributionKey(params)\n const traceId = getTraceId()\n if (traceId && readStorage(ATTRIBUTION) === JSON.stringify([key, traceId])) return traceId\n const existing = pending.get(key)\n if (existing) return existing\n\n const requestId = ++latestRequest\n const pageUrl = window.location.href\n const referrer = document.referrer || undefined\n const request = (async (): Promise<string | null> => {\n try {\n persistPromoParams(params)\n const linkId = Number(params.promoLinkId || 1)\n const response = await fetch(`${apiBase}/track`, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n eventId: createId(),\n deviceId: await getDeviceId(),\n inviteCode: params.inviteCode,\n utmSource: params.utm_source,\n promoLinkId: Number.isFinite(linkId) ? linkId : 1,\n eventType: 'landing',\n eventTarget: 'promo_landing',\n referrer,\n pageUrl,\n clientTime: Date.now(),\n }),\n })\n if (!response.ok) return null\n const result: TrackResponse = await response.json()\n const id = result?.data?.promoTraceId\n if (result?.code !== 0 || typeof id !== 'string' || !id) return null\n // 较早请求的响应不能覆盖后来访问的推广链接。\n if (requestId === latestRequest) {\n saveTraceId(id)\n writeStorage(ATTRIBUTION, JSON.stringify([key, id]))\n }\n return id\n } catch {\n return null\n }\n })()\n pending.set(key, request)\n try {\n return await request\n } finally {\n pending.delete(key)\n }\n }\n\n return {\n trackLanding,\n getTraceId, \n getPromoParams, \n getUtmSource\n }\n}\n\nexport type PromoTracker = ReturnType<typeof createPromoTracker>\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"promo-tracker.js","names":["FingerprintJS","getBrowserCookies","getCookie","prefix","name","entry","cookies","cookie","setCookie","store","options","url","domain","getDomain","value","COOKIE_NAMESPACE","GCLID_COOKIE_NAME","GOOGLE_ADS_QUERY_COOKIE_NAME","GOOGLE_ADS_COOKIE_MAX_AGE","getGclid","getGoogleAdsParams","queryParams","params","persistGoogleAdsParams","gclid","cookieMaxAge","visitorIdPromise","getVisitorId","visitorId","error","COOKIE_PARAMS","PROMO_PARAM_KEYS","COOKIE_MAX_AGE","getPromoParams","search","key","getPersistedPromoParams","persistPromoParams","entries","PROMO_API_PATH","STORAGE_NAMESPACE","DEVICE_ID","TRACE_ID","ATTRIBUTION","traceIdMemory","getTraceId","storedId","saveTraceId","id","joinPath","base","path","createId","bytes","hex","byte","createPromoTracker","apiBase","memory","pending","latestRequest","deviceIdPromise","isClient","readStorage","writeStorage","getDeviceId","attributionKey","trackLanding","traceId","existing","requestId","pageUrl","referrer","request","linkId","response","result"],"sources":["../src/utils/cookie.ts","../src/google-ads.ts","../src/utils/visitor-id.ts","../src/promo-params.ts","../src/promo-tracker.ts"],"sourcesContent":["import { getDomain } from 'tldts'\n\ninterface CookieOptions {\n /** Cookie 有效期,单位为秒。 */\n maxAge: number\n url?: URL\n store?: Pick<Document, 'cookie'>\n}\n\nexport function getBrowserCookies(): string {\n try {\n return typeof document === 'undefined' ? '' : document.cookie\n } catch {\n return ''\n }\n}\n\nexport function getCookie(name: string, cookies: string = getBrowserCookies()): string {\n const prefix = `${name}=`\n const entry = cookies.split(';').find(cookie => cookie.trim().startsWith(prefix))\n if (!entry) return ''\n try {\n return decodeURIComponent(entry.trim().slice(prefix.length))\n } catch {\n return ''\n }\n}\n\n/** 写入父域 Cookie;缺少浏览器上下文或访问被禁止时跳过。 */\nexport function setCookie(name: string, value: string, options: CookieOptions): void {\n try {\n const store = options.store ?? (typeof document === 'undefined' ? undefined : document)\n const url = options.url ?? (typeof window === 'undefined' ? undefined : new URL(window.location.href))\n if (!store || !url) return\n\n const domain = getDomain(url.hostname, { allowPrivateDomains: true })\n store.cookie = [\n `${name}=${encodeURIComponent(value)}`,\n ...(domain ? [`Domain=${domain}`] : []),\n 'Path=/',\n `Max-Age=${options.maxAge}`,\n 'SameSite=Lax',\n ...(url.protocol === 'https:' ? ['Secure'] : []),\n ].join('; ')\n } catch {\n // Cookie 被禁用时不影响业务逻辑。\n }\n}\n","import { getBrowserCookies, getCookie, setCookie } from './utils/cookie'\n\nconst COOKIE_NAMESPACE = '_tracker'\nconst GCLID_COOKIE_NAME = `${COOKIE_NAMESPACE}_gclid`\nconst GOOGLE_ADS_QUERY_COOKIE_NAME = `${COOKIE_NAMESPACE}_google_ads_query`\nconst GOOGLE_ADS_COOKIE_MAX_AGE = 90 * 24 * 60 * 60\n\nexport function getGclid(\n cookies: string = getBrowserCookies(),\n): string {\n return getCookie(GCLID_COOKIE_NAME, cookies)\n}\n\nexport function getGoogleAdsParams(\n cookies: string = getBrowserCookies(),\n): Record<string, string> {\n const queryParams = getCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, cookies)\n if (!queryParams) return {}\n try {\n const params: unknown = JSON.parse(queryParams)\n if (typeof params !== 'object' || params === null || Array.isArray(params)) return {}\n if (!Object.values(params).every(value => typeof value === 'string')) return {}\n return params as Record<string, string>\n } catch {\n return {}\n }\n}\n\nexport function persistGoogleAdsParams(\n url: URL | undefined = typeof location === 'undefined' ? undefined : new URL(location.href),\n store: Pick<Document, 'cookie'> | undefined = typeof document === 'undefined' ? undefined : document,\n /** Cookie 有效期,单位为秒;默认 90 天。 */\n cookieMaxAge: number = GOOGLE_ADS_COOKIE_MAX_AGE,\n): void {\n if (!url || !store) return\n\n const gclid = url.searchParams.get('gclid')\n if (!gclid) return\n\n const options = { url, store, maxAge: cookieMaxAge }\n const queryParams = JSON.stringify(Object.fromEntries(url.searchParams))\n setCookie(GCLID_COOKIE_NAME, gclid, options)\n setCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, queryParams, options)\n}\n","import FingerprintJS from '@fingerprintjs/fingerprintjs'\n\nlet visitorIdPromise: Promise<string> | undefined\n\n/** 成功获取后始终复用缓存;失败不缓存,下次调用可重试。SSR 返回空字符串。 */\nexport async function getVisitorId(): Promise<string> {\n if (typeof window === 'undefined' || typeof document === 'undefined') return ''\n if (!visitorIdPromise) {\n visitorIdPromise = (async () => {\n const agent = await FingerprintJS.load({ monitoring: false })\n const { visitorId } = await agent.get()\n if (!visitorId) throw new Error('FingerprintJS returned an empty visitorId')\n return visitorId\n })().catch(error => {\n visitorIdPromise = undefined\n throw error\n })\n }\n return visitorIdPromise\n}\n","import { getBrowserCookies, getCookie, setCookie } from './utils/cookie'\n\nconst COOKIE_PARAMS = '_tracker_promo_query'\nconst PROMO_PARAM_KEYS = ['promoLinkId', 'inviteCode', 'utm_source'] as const\nconst COOKIE_MAX_AGE = 30 * 24 * 60 * 60\n\nexport interface PromoParams {\n promoLinkId?: string\n inviteCode?: string\n utm_source?: string\n}\n\n/** 从当前 URL 读取非空推广参数。 */\nexport function getPromoParams(): PromoParams {\n const params: PromoParams = {}\n if (typeof window === 'undefined') return params\n const search = new URL(window.location.href).searchParams\n for (const key of PROMO_PARAM_KEYS) {\n const value = search.get(key)\n if (value) params[key] = value\n }\n return params\n}\n\n/** 读取 Cookie 中保存的推广参数;缺失或格式无效时返回空对象。 */\nexport function getPersistedPromoParams(cookies: string = getBrowserCookies()): PromoParams {\n try {\n const value: unknown = JSON.parse(getCookie(COOKIE_PARAMS, cookies))\n if (typeof value !== 'object' || value === null || Array.isArray(value)) return {}\n const params: PromoParams = {}\n for (const key of PROMO_PARAM_KEYS) {\n if (!(key in value)) continue\n const entry = (value as Record<string, unknown>)[key]\n if (typeof entry !== 'string') return {}\n if (entry) params[key] = entry\n }\n return params\n } catch {\n return {}\n }\n}\n\n/** 保存非空推广参数;默认读取当前 URL,有效期为 30 天。 */\nexport function persistPromoParams(\n params: PromoParams = getPromoParams(),\n cookieMaxAge: number = COOKIE_MAX_AGE,\n): void {\n const entries = PROMO_PARAM_KEYS.flatMap(key => params[key] ? [[key, params[key]]] : [])\n if (entries.length) {\n setCookie(COOKIE_PARAMS, JSON.stringify(Object.fromEntries(entries)), { maxAge: cookieMaxAge })\n }\n}\n","import { getCookie, setCookie } from './utils/cookie'\nimport { getVisitorId } from './utils/visitor-id'\nimport { getPromoParams, persistPromoParams } from './promo-params'\nimport type { PromoParams } from './promo-params'\n\nexport type { PromoParams } from './promo-params'\n\nconst PROMO_API_PATH = '/web-api/zw/promo-event'\nconst STORAGE_NAMESPACE = '_tracker'\nconst DEVICE_ID = `${STORAGE_NAMESPACE}_promo_device_id`\nconst TRACE_ID = `${STORAGE_NAMESPACE}_promo_trace_id`\nconst ATTRIBUTION = `${STORAGE_NAMESPACE}_promo_attribution`\nconst traceIdMemory = new WeakMap<Window, string>()\n\n/** 读取已保存的 traceId,无需创建追踪实例。 */\nexport function getTraceId(): string | null {\n if (typeof window === 'undefined' || typeof document === 'undefined') return null\n let storedId: string | null = null\n try {\n storedId = window.localStorage.getItem(TRACE_ID)\n } catch {\n // localStorage 被禁用时继续尝试内存和 Cookie。\n }\n return storedId || traceIdMemory.get(window) || getCookie(TRACE_ID) || null\n}\n\n/** 保存 traceId 到内存、localStorage 和 Cookie;有效期单位为秒,默认 30 天。 */\nfunction saveTraceId(id: string, cookieMaxAge: number = 30 * 24 * 60 * 60): void {\n if (typeof window === 'undefined' || typeof document === 'undefined' || !id) return\n traceIdMemory.set(window, id)\n try {\n window.localStorage.setItem(TRACE_ID, id)\n } catch {\n // localStorage 被禁用时,仍保留内存状态并尝试写入 Cookie。\n }\n setCookie(TRACE_ID, id, { maxAge: cookieMaxAge })\n}\n\nexport interface PromoTrackerOptions {\n /** Cookie 有效期,单位为秒;默认 30 天。 */\n cookieMaxAge?: number\n /** API 和产品页面的基础地址;默认当前站点,支持相对路径。 */\n baseURL?: string\n /** 相对 baseURL 的上报路径。 */\n apiPath?: string\n}\n\ninterface TrackResponse {\n code: number\n data?: { promoTraceId?: string } | null\n}\n\nfunction joinPath(base: string, path: string): string {\n return `${base.replace(/\\/+$/, '')}/${path.replace(/^\\/+/, '')}`\n}\n\nfunction createId(): string {\n if (typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n const bytes = crypto.getRandomValues(new Uint8Array(16))\n bytes[6] = (bytes[6] & 0x0f) | 0x40\n bytes[8] = (bytes[8] & 0x3f) | 0x80\n const hex = Array.from(bytes, byte => byte.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n\n/** 创建独立的推广追踪实例,无 Nuxt/Vue 依赖;初始化不触发请求。 */\nexport function createPromoTracker(options: PromoTrackerOptions = {}) {\n const cookieMaxAge = options.cookieMaxAge ?? 30 * 24 * 60 * 60\n const baseURL = options.baseURL ?? ''\n const apiBase = joinPath(baseURL, options.apiPath ?? PROMO_API_PATH).replace(/\\/+$/, '')\n const memory = new Map<string, string>()\n const pending = new Map<string, Promise<string | null>>()\n let latestRequest = 0\n let deviceIdPromise: Promise<string> | undefined\n\n function isClient(): boolean {\n return typeof window !== 'undefined' && typeof document !== 'undefined'\n }\n\n function readStorage(key: string): string | null {\n try {\n return window.localStorage.getItem(key) ?? memory.get(key) ?? null\n } catch {\n return memory.get(key) ?? null\n }\n }\n\n function writeStorage(key: string, value: string): void {\n memory.set(key, value)\n try {\n window.localStorage.setItem(key, value)\n } catch {\n // 存储被禁用时,在当前实例内保留状态。\n }\n }\n\n /** 优先复用已保存的 ID,否则生成浏览器指纹;失败时回退到 UUID。 */\n async function getDeviceId(): Promise<string> {\n if (!isClient()) return ''\n const existing = readStorage(DEVICE_ID)\n if (existing) return existing\n if (!deviceIdPromise) {\n deviceIdPromise = (async () => {\n let id: string\n try {\n id = await getVisitorId()\n } catch {\n id = createId()\n }\n writeStorage(DEVICE_ID, id)\n return id\n })()\n }\n return deviceIdPromise\n }\n\n function attributionKey(params: PromoParams): string {\n return JSON.stringify([params.promoLinkId || '', params.inviteCode || ''])\n }\n\n async function trackLanding(): Promise<string | null> {\n if (!isClient()) return null\n const params = getPromoParams()\n if (!params.inviteCode) return null\n const key = attributionKey(params)\n const traceId = getTraceId()\n if (traceId && readStorage(ATTRIBUTION) === JSON.stringify([key, traceId])) return traceId\n const existing = pending.get(key)\n if (existing) return existing\n\n const requestId = ++latestRequest\n const pageUrl = window.location.href\n const referrer = document.referrer || undefined\n const request = (async (): Promise<string | null> => {\n try {\n persistPromoParams(params, cookieMaxAge)\n const linkId = Number(params.promoLinkId || 1)\n const response = await fetch(`${apiBase}/track`, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n eventId: createId(),\n deviceId: await getDeviceId(),\n inviteCode: params.inviteCode,\n utmSource: params.utm_source,\n promoLinkId: Number.isFinite(linkId) ? linkId : 1,\n eventType: 'landing',\n eventTarget: 'promo_landing',\n referrer,\n pageUrl,\n clientTime: Date.now(),\n }),\n })\n if (!response.ok) return null\n const result: TrackResponse = await response.json()\n const id = result?.data?.promoTraceId\n if (result?.code !== 0 || typeof id !== 'string' || !id) return null\n // 较早请求的响应不能覆盖后来访问的推广链接。\n if (requestId === latestRequest) {\n saveTraceId(id, cookieMaxAge)\n writeStorage(ATTRIBUTION, JSON.stringify([key, id]))\n }\n return id\n } catch {\n return null\n }\n })()\n pending.set(key, request)\n try {\n return await request\n } finally {\n pending.delete(key)\n }\n }\n\n return {\n trackLanding,\n }\n}\n\nexport type PromoTracker = ReturnType<typeof createPromoTracker>\n"],"mappings":"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"}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("tldts"),require("@fingerprintjs/fingerprintjs")):typeof define==`function`&&define.amd?define([`exports`,`tldts`,`@fingerprintjs/fingerprintjs`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.PromoTracker={},e.tldts,e.FingerprintJS))})(this,function(e,t,n){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var r=Object.create,i=Object.defineProperty,a=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,s=Object.getPrototypeOf,c=Object.prototype.hasOwnProperty,l=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var s=o(t),l=0,u=s.length,d;l<u;l++)d=s[l],!c.call(e,d)&&d!==n&&i(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(r=a(t,d))||r.enumerable});return e};n=((e,t,n)=>(n=e==null?{}:r(s(e)),l(i(n,`default`,{value:e,enumerable:!0}),e)))(n,1);function u(){try{return typeof document>`u`?``:document.cookie}catch{return``}}function d(e,t=u()){let n=`${e}=`,r=t.split(`;`).find(e=>e.trim().startsWith(n));if(!r)return``;try{return decodeURIComponent(r.trim().slice(n.length))}catch{return``}}function f(e,n,r){try{let i=r.store??(typeof document>`u`?void 0:document),a=r.url??(typeof window>`u`?void 0:new URL(window.location.href));if(!i||!a)return;let o=(0,t.getDomain)(a.hostname,{allowPrivateDomains:!0});i.cookie=[`${e}=${encodeURIComponent(n)}`,...o?[`Domain=${o}`]:[],`Path=/`,`Max-Age=${r.maxAge}`,`SameSite=Lax`,...a.protocol===`https:`?[`Secure`]:[]].join(`; `)}catch{}}var p=`_tracker`,m=`${p}_gclid`,h=`${p}_google_ads_query`,g=7776e3;function _(e=u()){return d(m,e)}function v(e=u()){let t=d(h,e);if(!t)return{};try{let e=JSON.parse(t);return typeof e!=`object`||!e||Array.isArray(e)||!Object.values(e).every(e=>typeof e==`string`)?{}:e}catch{return{}}}function y(e=typeof location>`u`?void 0:new URL(location.href),t=typeof document>`u`?void 0:document,n=g){if(!e||!t)return;let r=e.searchParams.get(`gclid`);if(!r)return;let i={url:e,store:t,maxAge:n},a=JSON.stringify(Object.fromEntries(e.searchParams));f(m,r,i),f(h,a,i)}var b;async function x(){return typeof window>`u`||typeof document>`u`?``:(b||=(async()=>{let{visitorId:e}=await(await n.default.load({monitoring:!1})).get();if(!e)throw Error(`FingerprintJS returned an empty visitorId`);return e})().catch(e=>{throw b=void 0,e}),b)}var S=`/web-api/zw/promo-event`,
|
|
1
|
+
(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("tldts"),require("@fingerprintjs/fingerprintjs")):typeof define==`function`&&define.amd?define([`exports`,`tldts`,`@fingerprintjs/fingerprintjs`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.PromoTracker={},e.tldts,e.FingerprintJS))})(this,function(e,t,n){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var r=Object.create,i=Object.defineProperty,a=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,s=Object.getPrototypeOf,c=Object.prototype.hasOwnProperty,l=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var s=o(t),l=0,u=s.length,d;l<u;l++)d=s[l],!c.call(e,d)&&d!==n&&i(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(r=a(t,d))||r.enumerable});return e};n=((e,t,n)=>(n=e==null?{}:r(s(e)),l(i(n,`default`,{value:e,enumerable:!0}),e)))(n,1);function u(){try{return typeof document>`u`?``:document.cookie}catch{return``}}function d(e,t=u()){let n=`${e}=`,r=t.split(`;`).find(e=>e.trim().startsWith(n));if(!r)return``;try{return decodeURIComponent(r.trim().slice(n.length))}catch{return``}}function f(e,n,r){try{let i=r.store??(typeof document>`u`?void 0:document),a=r.url??(typeof window>`u`?void 0:new URL(window.location.href));if(!i||!a)return;let o=(0,t.getDomain)(a.hostname,{allowPrivateDomains:!0});i.cookie=[`${e}=${encodeURIComponent(n)}`,...o?[`Domain=${o}`]:[],`Path=/`,`Max-Age=${r.maxAge}`,`SameSite=Lax`,...a.protocol===`https:`?[`Secure`]:[]].join(`; `)}catch{}}var p=`_tracker`,m=`${p}_gclid`,h=`${p}_google_ads_query`,g=7776e3;function _(e=u()){return d(m,e)}function v(e=u()){let t=d(h,e);if(!t)return{};try{let e=JSON.parse(t);return typeof e!=`object`||!e||Array.isArray(e)||!Object.values(e).every(e=>typeof e==`string`)?{}:e}catch{return{}}}function y(e=typeof location>`u`?void 0:new URL(location.href),t=typeof document>`u`?void 0:document,n=g){if(!e||!t)return;let r=e.searchParams.get(`gclid`);if(!r)return;let i={url:e,store:t,maxAge:n},a=JSON.stringify(Object.fromEntries(e.searchParams));f(m,r,i),f(h,a,i)}var b;async function x(){return typeof window>`u`||typeof document>`u`?``:(b||=(async()=>{let{visitorId:e}=await(await n.default.load({monitoring:!1})).get();if(!e)throw Error(`FingerprintJS returned an empty visitorId`);return e})().catch(e=>{throw b=void 0,e}),b)}var S=`_tracker_promo_query`,C=[`promoLinkId`,`inviteCode`,`utm_source`],w=2592e3;function T(){let e={};if(typeof window>`u`)return e;let t=new URL(window.location.href).searchParams;for(let n of C){let r=t.get(n);r&&(e[n]=r)}return e}function E(e=u()){try{let t=JSON.parse(d(S,e));if(typeof t!=`object`||!t||Array.isArray(t))return{};let n={};for(let e of C){if(!(e in t))continue;let r=t[e];if(typeof r!=`string`)return{};r&&(n[e]=r)}return n}catch{return{}}}function D(e=T(),t=w){let n=C.flatMap(t=>e[t]?[[t,e[t]]]:[]);n.length&&f(S,JSON.stringify(Object.fromEntries(n)),{maxAge:t})}var O=`/web-api/zw/promo-event`,k=`_tracker`,A=`${k}_promo_device_id`,j=`${k}_promo_trace_id`,M=`${k}_promo_attribution`,N=new WeakMap;function P(){if(typeof window>`u`||typeof document>`u`)return null;let e=null;try{e=window.localStorage.getItem(j)}catch{}return e||N.get(window)||d(j)||null}function F(e,t=2592e3){if(typeof window<`u`&&typeof document<`u`&&e){N.set(window,e);try{window.localStorage.setItem(j,e)}catch{}f(j,e,{maxAge:t})}}function I(e,t){return`${e.replace(/\/+$/,``)}/${t.replace(/^\/+/,``)}`}function L(){if(typeof crypto.randomUUID==`function`)return crypto.randomUUID();let e=crypto.getRandomValues(new Uint8Array(16));e[6]=e[6]&15|64,e[8]=e[8]&63|128;let t=Array.from(e,e=>e.toString(16).padStart(2,`0`)).join(``);return`${t.slice(0,8)}-${t.slice(8,12)}-${t.slice(12,16)}-${t.slice(16,20)}-${t.slice(20)}`}function R(e={}){let t=e.cookieMaxAge??2592e3,n=I(e.baseURL??``,e.apiPath??O).replace(/\/+$/,``),r=new Map,i=new Map,a=0,o;function s(){return typeof window<`u`&&typeof document<`u`}function c(e){try{return window.localStorage.getItem(e)??r.get(e)??null}catch{return r.get(e)??null}}function l(e,t){r.set(e,t);try{window.localStorage.setItem(e,t)}catch{}}async function u(){return s()?c(A)||(o||=(async()=>{let e;try{e=await x()}catch{e=L()}return l(A,e),e})(),o):``}function d(e){return JSON.stringify([e.promoLinkId||``,e.inviteCode||``])}async function f(){if(!s())return null;let e=T();if(!e.inviteCode)return null;let r=d(e),o=P();if(o&&c(M)===JSON.stringify([r,o]))return o;let f=i.get(r);if(f)return f;let p=++a,m=window.location.href,h=document.referrer||void 0,g=(async()=>{try{D(e,t);let i=Number(e.promoLinkId||1),o=await fetch(`${n}/track`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({eventId:L(),deviceId:await u(),inviteCode:e.inviteCode,utmSource:e.utm_source,promoLinkId:Number.isFinite(i)?i:1,eventType:`landing`,eventTarget:`promo_landing`,referrer:h,pageUrl:m,clientTime:Date.now()})});if(!o.ok)return null;let s=await o.json(),c=s?.data?.promoTraceId;return s?.code!==0||typeof c!=`string`||!c?null:(p===a&&(F(c,t),l(M,JSON.stringify([r,c]))),c)}catch{return null}})();i.set(r,g);try{return await g}finally{i.delete(r)}}return{trackLanding:f}}e.createPromoTracker=R,e.getCookie=d,e.getGclid=_,e.getGoogleAdsParams=v,e.getPersistedPromoParams=E,e.getTraceId=P,e.getVisitorId=x,e.persistGoogleAdsParams=y});
|
|
2
2
|
//# sourceMappingURL=promo-tracker.umd.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"promo-tracker.umd.cjs","names":["getDomain","FingerprintJS","factory","global","exports","__create","__defProp","__getOwnPropDesc","__getOwnPropNames","__getProtoOf","__hasOwnProp","__copyProps","from","keys","i","n","key","to","except","k","desc","mod","target","_fingerprintjs_fingerprintjs","getBrowserCookies","getCookie","prefix","name","entry","cookies","cookie","setCookie","store","options","url","domain","tldts","value","COOKIE_NAMESPACE","GCLID_COOKIE_NAME","GOOGLE_ADS_QUERY_COOKIE_NAME","GOOGLE_ADS_COOKIE_MAX_AGE","getGclid","getGoogleAdsParams","queryParams","params","persistGoogleAdsParams","gclid","cookieMaxAge","visitorIdPromise","getVisitorId","visitorId","error","PROMO_API_PATH","STORAGE_NAMESPACE","DEVICE_ID","TRACE_ID","ATTRIBUTION","COOKIE_PARAMS","PROMO_PARAM_KEYS","joinPath","base","path","createId","bytes","hex","byte","createPromoTracker","apiBase","memory","pending","latestRequest","deviceIdPromise","isClient","readStorage","writeStorage","getDeviceId","id","getTraceId","saveTraceId","getPromoParams","search","getUtmSource","persistPromoParams","entries","attributionKey","trackLanding","traceId","existing","requestId","pageUrl","referrer","request","linkId","response","result"],"sources":["../src/utils/cookie.ts","../src/google-ads.ts","../src/utils/visitor-id.ts","../src/promo-tracker.ts"],"sourcesContent":["import { getDomain } from 'tldts'\n\ninterface CookieOptions {\n /** Cookie 有效期,单位为秒。 */\n maxAge: number\n url?: URL\n store?: Pick<Document, 'cookie'>\n}\n\nexport function getBrowserCookies(): string {\n try {\n return typeof document === 'undefined' ? '' : document.cookie\n } catch {\n return ''\n }\n}\n\nexport function getCookie(name: string, cookies: string = getBrowserCookies()): string {\n const prefix = `${name}=`\n const entry = cookies.split(';').find(cookie => cookie.trim().startsWith(prefix))\n if (!entry) return ''\n try {\n return decodeURIComponent(entry.trim().slice(prefix.length))\n } catch {\n return ''\n }\n}\n\n/** 写入父域 Cookie;缺少浏览器上下文或访问被禁止时跳过。 */\nexport function setCookie(name: string, value: string, options: CookieOptions): void {\n try {\n const store = options.store ?? (typeof document === 'undefined' ? undefined : document)\n const url = options.url ?? (typeof window === 'undefined' ? undefined : new URL(window.location.href))\n if (!store || !url) return\n\n const domain = getDomain(url.hostname, { allowPrivateDomains: true })\n store.cookie = [\n `${name}=${encodeURIComponent(value)}`,\n ...(domain ? [`Domain=${domain}`] : []),\n 'Path=/',\n `Max-Age=${options.maxAge}`,\n 'SameSite=Lax',\n ...(url.protocol === 'https:' ? ['Secure'] : []),\n ].join('; ')\n } catch {\n // Cookie 被禁用时不影响业务逻辑。\n }\n}\n","import { getBrowserCookies, getCookie, setCookie } from './utils/cookie'\n\nconst COOKIE_NAMESPACE = '_tracker'\nconst GCLID_COOKIE_NAME = `${COOKIE_NAMESPACE}_gclid`\nconst GOOGLE_ADS_QUERY_COOKIE_NAME = `${COOKIE_NAMESPACE}_google_ads_query`\nconst GOOGLE_ADS_COOKIE_MAX_AGE = 90 * 24 * 60 * 60\n\nexport function getGclid(\n cookies: string = getBrowserCookies(),\n): string {\n return getCookie(GCLID_COOKIE_NAME, cookies)\n}\n\nexport function getGoogleAdsParams(\n cookies: string = getBrowserCookies(),\n): Record<string, string> {\n const queryParams = getCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, cookies)\n if (!queryParams) return {}\n try {\n const params: unknown = JSON.parse(queryParams)\n if (typeof params !== 'object' || params === null || Array.isArray(params)) return {}\n if (!Object.values(params).every(value => typeof value === 'string')) return {}\n return params as Record<string, string>\n } catch {\n return {}\n }\n}\n\nexport function persistGoogleAdsParams(\n url: URL | undefined = typeof location === 'undefined' ? undefined : new URL(location.href),\n store: Pick<Document, 'cookie'> | undefined = typeof document === 'undefined' ? undefined : document,\n /** Cookie 有效期,单位为秒;默认 90 天。 */\n cookieMaxAge: number = GOOGLE_ADS_COOKIE_MAX_AGE,\n): void {\n if (!url || !store) return\n\n const gclid = url.searchParams.get('gclid')\n if (!gclid) return\n\n const options = { url, store, maxAge: cookieMaxAge }\n const queryParams = JSON.stringify(Object.fromEntries(url.searchParams))\n setCookie(GCLID_COOKIE_NAME, gclid, options)\n setCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, queryParams, options)\n}\n","import FingerprintJS from '@fingerprintjs/fingerprintjs'\n\nlet visitorIdPromise: Promise<string> | undefined\n\n/** 成功获取后始终复用缓存;失败不缓存,下次调用可重试。SSR 返回空字符串。 */\nexport async function getVisitorId(): Promise<string> {\n if (typeof window === 'undefined' || typeof document === 'undefined') return ''\n if (!visitorIdPromise) {\n visitorIdPromise = (async () => {\n const agent = await FingerprintJS.load({ monitoring: false })\n const { visitorId } = await agent.get()\n if (!visitorId) throw new Error('FingerprintJS returned an empty visitorId')\n return visitorId\n })().catch(error => {\n visitorIdPromise = undefined\n throw error\n })\n }\n return visitorIdPromise\n}\n","import { getCookie, setCookie } from './utils/cookie'\nimport { getVisitorId } from './utils/visitor-id'\n\nconst PROMO_API_PATH = '/web-api/zw/promo-event'\nconst STORAGE_NAMESPACE = '_tracker'\nconst DEVICE_ID = `${STORAGE_NAMESPACE}_promo_device_id`\nconst TRACE_ID = `${STORAGE_NAMESPACE}_promo_trace_id`\nconst ATTRIBUTION = `${STORAGE_NAMESPACE}_promo_attribution`\nconst COOKIE_PARAMS = `${STORAGE_NAMESPACE}_promo_query`\nconst PROMO_PARAM_KEYS = ['promoLinkId', 'inviteCode', 'utm_source'] as const\n\nexport interface PromoParams {\n promoLinkId?: string\n inviteCode?: string\n utm_source?: string\n}\n\nexport interface ReportOptions {\n utmSource?: string\n}\n\nexport interface PromoTrackerOptions {\n /** Cookie 有效期,单位为秒;默认 30 天。 */\n cookieMaxAge?: number\n /** API 和产品页面的基础地址;默认当前站点,支持相对路径。 */\n baseURL?: string\n /** 相对 baseURL 的上报路径。 */\n apiPath?: string\n}\n\ninterface TrackResponse {\n code: number\n data?: { promoTraceId?: string } | null\n}\n\nfunction joinPath(base: string, path: string): string {\n return `${base.replace(/\\/+$/, '')}/${path.replace(/^\\/+/, '')}`\n}\n\nfunction createId(): string {\n if (typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n const bytes = crypto.getRandomValues(new Uint8Array(16))\n bytes[6] = (bytes[6] & 0x0f) | 0x40\n bytes[8] = (bytes[8] & 0x3f) | 0x80\n const hex = Array.from(bytes, byte => byte.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n\n/** 创建独立的推广追踪实例,无 Nuxt/Vue 依赖;初始化不触发请求。 */\nexport function createPromoTracker(options: PromoTrackerOptions = {}) {\n const cookieMaxAge = options.cookieMaxAge ?? 30 * 24 * 60 * 60\n const baseURL = options.baseURL ?? ''\n const apiBase = joinPath(baseURL, options.apiPath ?? PROMO_API_PATH).replace(/\\/+$/, '')\n const memory = new Map<string, string>()\n const pending = new Map<string, Promise<string | null>>()\n let latestRequest = 0\n let deviceIdPromise: Promise<string> | undefined\n\n function isClient(): boolean {\n return typeof window !== 'undefined' && typeof document !== 'undefined'\n }\n\n function readStorage(key: string): string | null {\n try {\n return window.localStorage.getItem(key) ?? memory.get(key) ?? null\n } catch {\n return memory.get(key) ?? null\n }\n }\n\n function writeStorage(key: string, value: string): void {\n memory.set(key, value)\n try {\n window.localStorage.setItem(key, value)\n } catch {\n // 存储被禁用时,在当前实例内保留状态。\n }\n }\n\n /** 优先复用已保存的 ID,否则生成浏览器指纹;失败时回退到 UUID。 */\n async function getDeviceId(): Promise<string> {\n if (!isClient()) return ''\n const existing = readStorage(DEVICE_ID)\n if (existing) return existing\n if (!deviceIdPromise) {\n deviceIdPromise = (async () => {\n let id: string\n try {\n id = await getVisitorId()\n } catch {\n id = createId()\n }\n writeStorage(DEVICE_ID, id)\n return id\n })()\n }\n return deviceIdPromise\n }\n\n function getTraceId(): string | null {\n if (!isClient()) return null\n return readStorage(TRACE_ID) || getCookie(TRACE_ID) || null\n }\n\n function saveTraceId(id: string): void {\n if (!isClient() || !id) return\n writeStorage(TRACE_ID, id)\n setCookie(TRACE_ID, id, { maxAge: cookieMaxAge })\n }\n\n function getPromoParams(): PromoParams {\n const params: PromoParams = {}\n if (!isClient()) return params\n const search = new URL(window.location.href).searchParams\n for (const key of PROMO_PARAM_KEYS) {\n const value = search.get(key)\n if (value) params[key] = value\n }\n return params\n }\n\n function getUtmSource(): string | undefined {\n return getPromoParams().utm_source\n }\n\n function persistPromoParams(params: PromoParams = getPromoParams()): void {\n if (!isClient()) return\n const entries = PROMO_PARAM_KEYS.flatMap(key => params[key] ? [[key, params[key]]] : [])\n if (entries.length) {\n setCookie(COOKIE_PARAMS, JSON.stringify(Object.fromEntries(entries)), { maxAge: cookieMaxAge })\n }\n }\n\n function attributionKey(params: PromoParams): string {\n return JSON.stringify([params.promoLinkId || '', params.inviteCode || ''])\n }\n\n async function trackLanding(): Promise<string | null> {\n if (!isClient()) return null\n const params = getPromoParams()\n if (!params.inviteCode) return null\n const key = attributionKey(params)\n const traceId = getTraceId()\n if (traceId && readStorage(ATTRIBUTION) === JSON.stringify([key, traceId])) return traceId\n const existing = pending.get(key)\n if (existing) return existing\n\n const requestId = ++latestRequest\n const pageUrl = window.location.href\n const referrer = document.referrer || undefined\n const request = (async (): Promise<string | null> => {\n try {\n persistPromoParams(params)\n const linkId = Number(params.promoLinkId || 1)\n const response = await fetch(`${apiBase}/track`, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n eventId: createId(),\n deviceId: await getDeviceId(),\n inviteCode: params.inviteCode,\n utmSource: params.utm_source,\n promoLinkId: Number.isFinite(linkId) ? linkId : 1,\n eventType: 'landing',\n eventTarget: 'promo_landing',\n referrer,\n pageUrl,\n clientTime: Date.now(),\n }),\n })\n if (!response.ok) return null\n const result: TrackResponse = await response.json()\n const id = result?.data?.promoTraceId\n if (result?.code !== 0 || typeof id !== 'string' || !id) return null\n // 较早请求的响应不能覆盖后来访问的推广链接。\n if (requestId === latestRequest) {\n saveTraceId(id)\n writeStorage(ATTRIBUTION, JSON.stringify([key, id]))\n }\n return id\n } catch {\n return null\n }\n })()\n pending.set(key, request)\n try {\n return await request\n } finally {\n pending.delete(key)\n }\n }\n\n return {\n trackLanding,\n getTraceId, \n getPromoParams, \n getUtmSource\n }\n}\n\nexport type PromoTracker = ReturnType<typeof createPromoTracker>\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"promo-tracker.umd.cjs","names":["getDomain","FingerprintJS","factory","global","exports","__create","__defProp","__getOwnPropDesc","__getOwnPropNames","__getProtoOf","__hasOwnProp","__copyProps","from","keys","i","n","key","to","except","k","desc","mod","target","_fingerprintjs_fingerprintjs","getBrowserCookies","getCookie","prefix","name","entry","cookies","cookie","setCookie","store","options","url","domain","tldts","value","COOKIE_NAMESPACE","GCLID_COOKIE_NAME","GOOGLE_ADS_QUERY_COOKIE_NAME","GOOGLE_ADS_COOKIE_MAX_AGE","getGclid","getGoogleAdsParams","queryParams","params","persistGoogleAdsParams","gclid","cookieMaxAge","visitorIdPromise","getVisitorId","visitorId","error","COOKIE_PARAMS","PROMO_PARAM_KEYS","COOKIE_MAX_AGE","getPromoParams","search","getPersistedPromoParams","persistPromoParams","entries","PROMO_API_PATH","STORAGE_NAMESPACE","DEVICE_ID","TRACE_ID","ATTRIBUTION","traceIdMemory","getTraceId","storedId","saveTraceId","id","joinPath","base","path","createId","bytes","hex","byte","createPromoTracker","apiBase","memory","pending","latestRequest","deviceIdPromise","isClient","readStorage","writeStorage","getDeviceId","attributionKey","trackLanding","traceId","existing","requestId","pageUrl","referrer","request","linkId","response","result"],"sources":["../src/utils/cookie.ts","../src/google-ads.ts","../src/utils/visitor-id.ts","../src/promo-params.ts","../src/promo-tracker.ts"],"sourcesContent":["import { getDomain } from 'tldts'\n\ninterface CookieOptions {\n /** Cookie 有效期,单位为秒。 */\n maxAge: number\n url?: URL\n store?: Pick<Document, 'cookie'>\n}\n\nexport function getBrowserCookies(): string {\n try {\n return typeof document === 'undefined' ? '' : document.cookie\n } catch {\n return ''\n }\n}\n\nexport function getCookie(name: string, cookies: string = getBrowserCookies()): string {\n const prefix = `${name}=`\n const entry = cookies.split(';').find(cookie => cookie.trim().startsWith(prefix))\n if (!entry) return ''\n try {\n return decodeURIComponent(entry.trim().slice(prefix.length))\n } catch {\n return ''\n }\n}\n\n/** 写入父域 Cookie;缺少浏览器上下文或访问被禁止时跳过。 */\nexport function setCookie(name: string, value: string, options: CookieOptions): void {\n try {\n const store = options.store ?? (typeof document === 'undefined' ? undefined : document)\n const url = options.url ?? (typeof window === 'undefined' ? undefined : new URL(window.location.href))\n if (!store || !url) return\n\n const domain = getDomain(url.hostname, { allowPrivateDomains: true })\n store.cookie = [\n `${name}=${encodeURIComponent(value)}`,\n ...(domain ? [`Domain=${domain}`] : []),\n 'Path=/',\n `Max-Age=${options.maxAge}`,\n 'SameSite=Lax',\n ...(url.protocol === 'https:' ? ['Secure'] : []),\n ].join('; ')\n } catch {\n // Cookie 被禁用时不影响业务逻辑。\n }\n}\n","import { getBrowserCookies, getCookie, setCookie } from './utils/cookie'\n\nconst COOKIE_NAMESPACE = '_tracker'\nconst GCLID_COOKIE_NAME = `${COOKIE_NAMESPACE}_gclid`\nconst GOOGLE_ADS_QUERY_COOKIE_NAME = `${COOKIE_NAMESPACE}_google_ads_query`\nconst GOOGLE_ADS_COOKIE_MAX_AGE = 90 * 24 * 60 * 60\n\nexport function getGclid(\n cookies: string = getBrowserCookies(),\n): string {\n return getCookie(GCLID_COOKIE_NAME, cookies)\n}\n\nexport function getGoogleAdsParams(\n cookies: string = getBrowserCookies(),\n): Record<string, string> {\n const queryParams = getCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, cookies)\n if (!queryParams) return {}\n try {\n const params: unknown = JSON.parse(queryParams)\n if (typeof params !== 'object' || params === null || Array.isArray(params)) return {}\n if (!Object.values(params).every(value => typeof value === 'string')) return {}\n return params as Record<string, string>\n } catch {\n return {}\n }\n}\n\nexport function persistGoogleAdsParams(\n url: URL | undefined = typeof location === 'undefined' ? undefined : new URL(location.href),\n store: Pick<Document, 'cookie'> | undefined = typeof document === 'undefined' ? undefined : document,\n /** Cookie 有效期,单位为秒;默认 90 天。 */\n cookieMaxAge: number = GOOGLE_ADS_COOKIE_MAX_AGE,\n): void {\n if (!url || !store) return\n\n const gclid = url.searchParams.get('gclid')\n if (!gclid) return\n\n const options = { url, store, maxAge: cookieMaxAge }\n const queryParams = JSON.stringify(Object.fromEntries(url.searchParams))\n setCookie(GCLID_COOKIE_NAME, gclid, options)\n setCookie(GOOGLE_ADS_QUERY_COOKIE_NAME, queryParams, options)\n}\n","import FingerprintJS from '@fingerprintjs/fingerprintjs'\n\nlet visitorIdPromise: Promise<string> | undefined\n\n/** 成功获取后始终复用缓存;失败不缓存,下次调用可重试。SSR 返回空字符串。 */\nexport async function getVisitorId(): Promise<string> {\n if (typeof window === 'undefined' || typeof document === 'undefined') return ''\n if (!visitorIdPromise) {\n visitorIdPromise = (async () => {\n const agent = await FingerprintJS.load({ monitoring: false })\n const { visitorId } = await agent.get()\n if (!visitorId) throw new Error('FingerprintJS returned an empty visitorId')\n return visitorId\n })().catch(error => {\n visitorIdPromise = undefined\n throw error\n })\n }\n return visitorIdPromise\n}\n","import { getBrowserCookies, getCookie, setCookie } from './utils/cookie'\n\nconst COOKIE_PARAMS = '_tracker_promo_query'\nconst PROMO_PARAM_KEYS = ['promoLinkId', 'inviteCode', 'utm_source'] as const\nconst COOKIE_MAX_AGE = 30 * 24 * 60 * 60\n\nexport interface PromoParams {\n promoLinkId?: string\n inviteCode?: string\n utm_source?: string\n}\n\n/** 从当前 URL 读取非空推广参数。 */\nexport function getPromoParams(): PromoParams {\n const params: PromoParams = {}\n if (typeof window === 'undefined') return params\n const search = new URL(window.location.href).searchParams\n for (const key of PROMO_PARAM_KEYS) {\n const value = search.get(key)\n if (value) params[key] = value\n }\n return params\n}\n\n/** 读取 Cookie 中保存的推广参数;缺失或格式无效时返回空对象。 */\nexport function getPersistedPromoParams(cookies: string = getBrowserCookies()): PromoParams {\n try {\n const value: unknown = JSON.parse(getCookie(COOKIE_PARAMS, cookies))\n if (typeof value !== 'object' || value === null || Array.isArray(value)) return {}\n const params: PromoParams = {}\n for (const key of PROMO_PARAM_KEYS) {\n if (!(key in value)) continue\n const entry = (value as Record<string, unknown>)[key]\n if (typeof entry !== 'string') return {}\n if (entry) params[key] = entry\n }\n return params\n } catch {\n return {}\n }\n}\n\n/** 保存非空推广参数;默认读取当前 URL,有效期为 30 天。 */\nexport function persistPromoParams(\n params: PromoParams = getPromoParams(),\n cookieMaxAge: number = COOKIE_MAX_AGE,\n): void {\n const entries = PROMO_PARAM_KEYS.flatMap(key => params[key] ? [[key, params[key]]] : [])\n if (entries.length) {\n setCookie(COOKIE_PARAMS, JSON.stringify(Object.fromEntries(entries)), { maxAge: cookieMaxAge })\n }\n}\n","import { getCookie, setCookie } from './utils/cookie'\nimport { getVisitorId } from './utils/visitor-id'\nimport { getPromoParams, persistPromoParams } from './promo-params'\nimport type { PromoParams } from './promo-params'\n\nexport type { PromoParams } from './promo-params'\n\nconst PROMO_API_PATH = '/web-api/zw/promo-event'\nconst STORAGE_NAMESPACE = '_tracker'\nconst DEVICE_ID = `${STORAGE_NAMESPACE}_promo_device_id`\nconst TRACE_ID = `${STORAGE_NAMESPACE}_promo_trace_id`\nconst ATTRIBUTION = `${STORAGE_NAMESPACE}_promo_attribution`\nconst traceIdMemory = new WeakMap<Window, string>()\n\n/** 读取已保存的 traceId,无需创建追踪实例。 */\nexport function getTraceId(): string | null {\n if (typeof window === 'undefined' || typeof document === 'undefined') return null\n let storedId: string | null = null\n try {\n storedId = window.localStorage.getItem(TRACE_ID)\n } catch {\n // localStorage 被禁用时继续尝试内存和 Cookie。\n }\n return storedId || traceIdMemory.get(window) || getCookie(TRACE_ID) || null\n}\n\n/** 保存 traceId 到内存、localStorage 和 Cookie;有效期单位为秒,默认 30 天。 */\nfunction saveTraceId(id: string, cookieMaxAge: number = 30 * 24 * 60 * 60): void {\n if (typeof window === 'undefined' || typeof document === 'undefined' || !id) return\n traceIdMemory.set(window, id)\n try {\n window.localStorage.setItem(TRACE_ID, id)\n } catch {\n // localStorage 被禁用时,仍保留内存状态并尝试写入 Cookie。\n }\n setCookie(TRACE_ID, id, { maxAge: cookieMaxAge })\n}\n\nexport interface PromoTrackerOptions {\n /** Cookie 有效期,单位为秒;默认 30 天。 */\n cookieMaxAge?: number\n /** API 和产品页面的基础地址;默认当前站点,支持相对路径。 */\n baseURL?: string\n /** 相对 baseURL 的上报路径。 */\n apiPath?: string\n}\n\ninterface TrackResponse {\n code: number\n data?: { promoTraceId?: string } | null\n}\n\nfunction joinPath(base: string, path: string): string {\n return `${base.replace(/\\/+$/, '')}/${path.replace(/^\\/+/, '')}`\n}\n\nfunction createId(): string {\n if (typeof crypto.randomUUID === 'function') return crypto.randomUUID()\n const bytes = crypto.getRandomValues(new Uint8Array(16))\n bytes[6] = (bytes[6] & 0x0f) | 0x40\n bytes[8] = (bytes[8] & 0x3f) | 0x80\n const hex = Array.from(bytes, byte => byte.toString(16).padStart(2, '0')).join('')\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`\n}\n\n/** 创建独立的推广追踪实例,无 Nuxt/Vue 依赖;初始化不触发请求。 */\nexport function createPromoTracker(options: PromoTrackerOptions = {}) {\n const cookieMaxAge = options.cookieMaxAge ?? 30 * 24 * 60 * 60\n const baseURL = options.baseURL ?? ''\n const apiBase = joinPath(baseURL, options.apiPath ?? PROMO_API_PATH).replace(/\\/+$/, '')\n const memory = new Map<string, string>()\n const pending = new Map<string, Promise<string | null>>()\n let latestRequest = 0\n let deviceIdPromise: Promise<string> | undefined\n\n function isClient(): boolean {\n return typeof window !== 'undefined' && typeof document !== 'undefined'\n }\n\n function readStorage(key: string): string | null {\n try {\n return window.localStorage.getItem(key) ?? memory.get(key) ?? null\n } catch {\n return memory.get(key) ?? null\n }\n }\n\n function writeStorage(key: string, value: string): void {\n memory.set(key, value)\n try {\n window.localStorage.setItem(key, value)\n } catch {\n // 存储被禁用时,在当前实例内保留状态。\n }\n }\n\n /** 优先复用已保存的 ID,否则生成浏览器指纹;失败时回退到 UUID。 */\n async function getDeviceId(): Promise<string> {\n if (!isClient()) return ''\n const existing = readStorage(DEVICE_ID)\n if (existing) return existing\n if (!deviceIdPromise) {\n deviceIdPromise = (async () => {\n let id: string\n try {\n id = await getVisitorId()\n } catch {\n id = createId()\n }\n writeStorage(DEVICE_ID, id)\n return id\n })()\n }\n return deviceIdPromise\n }\n\n function attributionKey(params: PromoParams): string {\n return JSON.stringify([params.promoLinkId || '', params.inviteCode || ''])\n }\n\n async function trackLanding(): Promise<string | null> {\n if (!isClient()) return null\n const params = getPromoParams()\n if (!params.inviteCode) return null\n const key = attributionKey(params)\n const traceId = getTraceId()\n if (traceId && readStorage(ATTRIBUTION) === JSON.stringify([key, traceId])) return traceId\n const existing = pending.get(key)\n if (existing) return existing\n\n const requestId = ++latestRequest\n const pageUrl = window.location.href\n const referrer = document.referrer || undefined\n const request = (async (): Promise<string | null> => {\n try {\n persistPromoParams(params, cookieMaxAge)\n const linkId = Number(params.promoLinkId || 1)\n const response = await fetch(`${apiBase}/track`, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n eventId: createId(),\n deviceId: await getDeviceId(),\n inviteCode: params.inviteCode,\n utmSource: params.utm_source,\n promoLinkId: Number.isFinite(linkId) ? linkId : 1,\n eventType: 'landing',\n eventTarget: 'promo_landing',\n referrer,\n pageUrl,\n clientTime: Date.now(),\n }),\n })\n if (!response.ok) return null\n const result: TrackResponse = await response.json()\n const id = result?.data?.promoTraceId\n if (result?.code !== 0 || typeof id !== 'string' || !id) return null\n // 较早请求的响应不能覆盖后来访问的推广链接。\n if (requestId === latestRequest) {\n saveTraceId(id, cookieMaxAge)\n writeStorage(ATTRIBUTION, JSON.stringify([key, id]))\n }\n return id\n } catch {\n return null\n }\n })()\n pending.set(key, request)\n try {\n return await request\n } finally {\n pending.delete(key)\n }\n }\n\n return {\n trackLanding,\n }\n}\n\nexport type PromoTracker = ReturnType<typeof createPromoTracker>\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "promo-tracker",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.3",
|
|
4
4
|
"private": false,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"files": [
|
|
@@ -20,6 +20,7 @@
|
|
|
20
20
|
"dev": "vite",
|
|
21
21
|
"typecheck": "tsc --noEmit",
|
|
22
22
|
"test": "npm run build && node --test tests/*.test.mjs",
|
|
23
|
+
"prepack": "npm run build",
|
|
23
24
|
"build": "npm run typecheck && vite build && tsc --emitDeclarationOnly",
|
|
24
25
|
"build:watch": "vite build --watch"
|
|
25
26
|
},
|
|
@@ -32,5 +33,8 @@
|
|
|
32
33
|
"peerDependencies": {
|
|
33
34
|
"@fingerprintjs/fingerprintjs": "^5.3.0",
|
|
34
35
|
"tldts": "^7.5.4"
|
|
36
|
+
},
|
|
37
|
+
"dependencies": {
|
|
38
|
+
"promo-tracker": "^0.0.2"
|
|
35
39
|
}
|
|
36
40
|
}
|