@shware/analytics 11.9.0 → 11.11.0

package/README.md

@@ -344,7 +344,8 @@ What the SDK guarantees for this to hold:
 ## Ad performance (`@shware/analytics/ads`)
 
 Spend, impressions, clicks and the platforms' own conversions, read from the ad platforms'
-reporting APIs as typed `AdPerformanceRow`s — one per ad and hour — for a host to store next to its
+reporting APIs as typed `AdPerformanceRow`s — one per ad (or the finest level a platform reports
+hours at) and hour — for a host to store next to its
 sessions and compute ROAS, cost per session and the click → session landing rate.
 
 ```ts
@@ -386,6 +387,141 @@ const rows = await fetchMetaAdPerformance({
   day before the first hourly day stored — a day must never hold both spread and real hourly rows,
   as an hour without delivery is absent from the hourly data and its spread share would remain.
 
+### Google Ads, pushed by a script
+
+Google's reporting API needs a developer token, which needs a manager account. A
+[Google Ads script](https://developers.google.com/google-ads/scripts) needs neither: it runs inside
+the ad account (Tools → Bulk actions → Scripts) as the account's own user, reads the report and
+posts it to the host, which turns the body into rows with `parseGoogleAdsScriptReport` and upserts
+them.
+
+```ts
+import { GoogleAdsReportError, parseGoogleAdsScriptReport } from '@shware/analytics/ads';
+
+// POST, behind a bearer key only the script knows
+try {
+  await upsert(parseGoogleAdsScriptReport(await request.json()));
+} catch (error) {
+  if (error instanceof GoogleAdsReportError) return new Response(error.message, { status: 400 });
+  throw error;
+}
+```
+
+- **Ad groups, not ads.** Google reports hours down to the ad group (`segments.hour` is not
+  available per ad), and a Performance Max campaign has no ad group: `ad_id` is the ad group id, or
+  the campaign id for Performance Max. The script reads both, and logs a warning when they do not
+  add up to the account's spend.
+- **Conversions** are Google's primary conversion actions, click-based (view-through ones are
+  counted apart and have no value), so they fill the total and the click-through columns alike.
+- **Restatement.** A conversion is credited to its click's hour up to the conversion window later
+  (30 days by default). The script re-reads the last 3 days every hour and the last 30 once a day.
+- **History.** Set `SINCE` to the first day with spend, run the script once by hand, then clear
+  it; it posts 7 days per request. Hourly data reaches back at least months — compare each day's
+  sum of hours with the day in the Google Ads UI before relying on older days.
+
+Setting it up:
+
+1. Tools → Bulk actions → Scripts → **+**, paste the script, set `ENDPOINT` and `KEY`.
+2. **Authorize** it before the first run: posting to a URL needs the "connect to an external
+   service" scope, and a run without it ends at once with "Failed due to authentication errors".
+3. Backfill (`SINCE`, above), then clear `SINCE` and save.
+4. Back in the scripts list, set the **Frequency** column to Hourly — the editor has no schedule.
+   The results column reads "no changes" on every run: it counts changes to the account, and the
+   script makes none.
+
+Google Ads emails the account owner when a run throws, as on a non-2xx answer.
+
+```js
+const ENDPOINT = 'https://example.com/v1/adPerformance/google';
+const KEY = '<my_bearer_token>'; // the bearer key the endpoint checks
+const DAYS = 3; // re-read every hour
+const RESTATE_DAYS = 30; // re-read once a day, at RESTATE_HOUR in the account's time zone
+const RESTATE_HOUR = 5;
+const CHUNK_DAYS = 7; // days per request
+const SINCE = ''; // a backfill's first day, 'YYYY-MM-DD'; empty for the schedule
+
+function main() {
+  const account = AdsApp.currentAccount();
+  const timeZone = account.getTimeZone();
+  const now = new Date();
+  const today = Utilities.formatDate(now, timeZone, 'yyyy-MM-dd');
+  const hour = Number(Utilities.formatDate(now, timeZone, 'H'));
+  const since = SINCE || addDays(today, 1 - (hour === RESTATE_HOUR ? RESTATE_DAYS : DAYS));
+
+  for (let from = since; from <= today; from = addDays(from, CHUNK_DAYS)) {
+    const last = addDays(from, CHUNK_DAYS - 1);
+    const until = last < today ? last : today;
+    const range = `segments.date BETWEEN '${from}' AND '${until}'`;
+    const metrics = `segments.date, segments.hour, metrics.cost_micros, metrics.impressions,
+      metrics.clicks, metrics.conversions, metrics.conversions_value`;
+    const rows = [
+      ...read(`SELECT campaign.id, campaign.name, ad_group.id, ad_group.name, ${metrics}
+        FROM ad_group WHERE ${range} AND metrics.impressions > 0`),
+      ...read(`SELECT campaign.id, campaign.name, ${metrics} FROM campaign
+        WHERE ${range} AND metrics.impressions > 0
+          AND campaign.advertising_channel_type = 'PERFORMANCE_MAX'`),
+    ];
+    check(rows, range, from, until);
+    post({
+      account_id: account.getCustomerId(),
+      currency: account.getCurrencyCode(),
+      time_zone: timeZone,
+      rows,
+    });
+    Logger.log('%s → %s: %s rows', from, until, rows.length);
+  }
+}
+
+function read(query) {
+  const rows = [];
+  const results = AdsApp.search(query);
+  while (results.hasNext()) {
+    const r = results.next();
+    rows.push({
+      campaign_id: r.campaign.id,
+      campaign_name: r.campaign.name,
+      ad_group_id: r.adGroup ? r.adGroup.id : null,
+      ad_group_name: r.adGroup ? r.adGroup.name : null,
+      date: r.segments.date,
+      hour: r.segments.hour,
+      cost_micros: r.metrics.costMicros,
+      impressions: r.metrics.impressions,
+      clicks: r.metrics.clicks,
+      conversions: r.metrics.conversions,
+      conversion_value: r.metrics.conversionsValue,
+    });
+  }
+  return rows;
+}
+
+/** Warns when the rows miss spend: a campaign type with neither ad groups nor Performance Max. */
+function check(rows, range, from, until) {
+  let total = 0;
+  const results = AdsApp.search(`SELECT metrics.cost_micros FROM customer WHERE ${range}`);
+  while (results.hasNext()) total += Number(results.next().metrics.costMicros);
+  const got = rows.reduce((sum, row) => sum + Number(row.cost_micros), 0);
+  if (got !== total) Logger.log('WARNING %s → %s: read %s of %s micros', from, until, got, total);
+}
+
+function post(report) {
+  const response = UrlFetchApp.fetch(ENDPOINT, {
+    method: 'post',
+    contentType: 'application/json',
+    headers: { Authorization: `Bearer ${KEY}` },
+    payload: JSON.stringify(report),
+    muteHttpExceptions: true,
+  });
+  const code = response.getResponseCode();
+  if (code < 200 || code >= 300) throw new Error(`${code}: ${response.getContentText()}`);
+}
+
+function addDays(date, days) {
+  const moved = new Date(`${date}T00:00:00Z`);
+  moved.setUTCDate(moved.getUTCDate() + days);
+  return moved.toISOString().slice(0, 10);
+}
+```
+
 ## UTM params
 
 Typed as `UTMParams` (exported from `@shware/analytics`). Value unions follow the

package/dist/ads/google.cjs

@@ -0,0 +1,128 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_attribution_classify = require("../attribution/classify.cjs");
+require("../attribution/index.cjs");
+const require_ads_time = require("./time.cjs");
+let zod_mini = require("zod/mini");
+//#region src/ads/google.ts
+/**
+* Google Ads delivery pushed by a Google Ads script: the script runs inside the ad account on
+* Google's schedule, reads the hourly report with `AdsApp.search` and posts it to the host, which
+* turns it into `AdPerformanceRow`s here. No developer token, manager account or OAuth client is
+* needed — the script runs as the account's own user. The script is in the README.
+*
+* Google reports hours down to the ad group, not the ad (`segments.hour` is incompatible with
+* `ad_group_ad`), and Performance Max campaigns have no ad groups at all; so a row is an ad group's
+* hour, or a Performance Max campaign's, and `ad_id` holds that ad group or campaign id.
+*
+* https://developers.google.com/google-ads/scripts/docs/features/reports
+* https://developers.google.com/google-ads/api/fields/v21/ad_group
+*/
+/** What a Google ad click is in the attribution vocabulary: a `gclid` is `google / cpc`. */
+const CHANNEL = "google";
+const MEDIUM = "cpc";
+/** `AdsApp.search` returns int64 metrics as strings and doubles as numbers; either is taken. */
+const metric = (0, zod_mini.optional)((0, zod_mini.union)([(0, zod_mini.string)(), (0, zod_mini.number)()]));
+const reportRowSchema = (0, zod_mini.object)({
+	campaign_id: (0, zod_mini.string)(),
+	campaign_name: (0, zod_mini.optional)((0, zod_mini.nullable)((0, zod_mini.string)())),
+	/** Null for a Performance Max campaign's row. */
+	ad_group_id: (0, zod_mini.optional)((0, zod_mini.nullable)((0, zod_mini.string)())),
+	ad_group_name: (0, zod_mini.optional)((0, zod_mini.nullable)((0, zod_mini.string)())),
+	/** `segments.date`, a day in the account's time zone. */
+	date: (0, zod_mini.string)(),
+	/** `segments.hour`, 0–23, of that day. */
+	hour: (0, zod_mini.number)(),
+	cost_micros: metric,
+	impressions: metric,
+	clicks: metric,
+	conversions: metric,
+	conversion_value: metric
+});
+const reportSchema = (0, zod_mini.object)({
+	/** The customer id, digits only or as `123-456-7890`. */
+	account_id: (0, zod_mini.string)(),
+	currency: (0, zod_mini.string)(),
+	/** `AdsApp.currentAccount().getTimeZone()`, the IANA zone `date` and `hour` are in. */
+	time_zone: (0, zod_mini.string)(),
+	rows: (0, zod_mini.array)(reportRowSchema)
+});
+/** A body that is not a `GoogleAdsScriptReport`; the host answers it with a 400. */
+var GoogleAdsReportError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "GoogleAdsReportError";
+	}
+};
+const DATE = /^\d{4}-\d{2}-\d{2}$/;
+/** A metric as a number, absent as `fallback`; anything not numeric is an invalid report. */
+function numeric(value, fallback, path) {
+	if (value === void 0) return fallback;
+	const n = Number(value);
+	if (!Number.isFinite(n)) throw new GoogleAdsReportError(`${path}: not a number: ${value}`);
+	return n;
+}
+function timeZoneOf(timeZone) {
+	try {
+		new Intl.DateTimeFormat("en-US", { timeZone });
+	} catch {
+		throw new GoogleAdsReportError(`Unknown time zone: ${timeZone}`);
+	}
+	return timeZone;
+}
+/**
+* The rows of a report a Google Ads script posted, validated, one per ad group (or Performance Max
+* campaign) and hour. The hours are the account's, turned into UTC instants. Spend comes from
+* `cost_micros`. Google's `conversions` are its primary conversion actions under their own
+* attribution model, click-based (view-through conversions are counted apart, without value),
+* so they fill both the total and the click-through columns.
+*
+* Google restates the past — a conversion is credited to the hour of its click, up to the
+* conversion window (30 days by default) later — so the script re-reads a trailing window and the
+* host upserts on (`platform`, `account_id`, `ad_id`, `hour_start`).
+*
+* @throws GoogleAdsReportError when the body is not a report.
+*/
+function parseGoogleAdsScriptReport(body) {
+	const parsed = (0, zod_mini.safeParse)(reportSchema, body);
+	if (!parsed.success) {
+		const issues = parsed.error.issues;
+		const first = issues.slice(0, 3).map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ");
+		throw new GoogleAdsReportError(`Invalid Google Ads report (${issues.length} issues): ${first}${issues.length > 3 ? "; …" : ""}`);
+	}
+	const report = parsed.data;
+	const accountId = report.account_id.replaceAll("-", "");
+	const timeZone = timeZoneOf(report.time_zone);
+	return report.rows.map((row, index) => {
+		const path = `rows.${index}`;
+		if (!DATE.test(row.date) || !Number.isInteger(row.hour) || row.hour < 0 || row.hour > 23) throw new GoogleAdsReportError(`${path}: unexpected hour ${row.date} ${row.hour}`);
+		const conversions = numeric(row.conversions, null, `${path}.conversions`);
+		const value = numeric(row.conversion_value, null, `${path}.conversion_value`);
+		return {
+			platform: "google",
+			account_id: accountId,
+			campaign_id: row.campaign_id,
+			campaign_name: row.campaign_name ?? null,
+			ad_group_id: row.ad_group_id ?? null,
+			ad_group_name: row.ad_group_name ?? null,
+			ad_id: row.ad_group_id ?? row.campaign_id,
+			ad_name: null,
+			channel: CHANNEL,
+			medium: MEDIUM,
+			channel_group: require_attribution_classify.channelGroupOf(CHANNEL, MEDIUM),
+			hour_start: require_ads_time.zonedHourToUtc(row.date, row.hour, timeZone).toISOString(),
+			currency: report.currency,
+			spend: numeric(row.cost_micros, 0, `${path}.cost_micros`) / 1e6,
+			impressions: numeric(row.impressions, 0, `${path}.impressions`),
+			clicks: numeric(row.clicks, 0, `${path}.clicks`),
+			conversions,
+			conversion_value: value,
+			click_conversions: conversions,
+			click_conversion_value: value
+		};
+	});
+}
+//#endregion
+exports.GoogleAdsReportError = GoogleAdsReportError;
+exports.parseGoogleAdsScriptReport = parseGoogleAdsScriptReport;
+
+//# sourceMappingURL=google.cjs.map

package/dist/ads/google.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.cjs","names":["optional","union","string","number","object","nullable","array","safeParse","channelGroupOf","zonedHourToUtc"],"sources":["../../src/ads/google.ts"],"sourcesContent":["/**\n * Google Ads delivery pushed by a Google Ads script: the script runs inside the ad account on\n * Google's schedule, reads the hourly report with `AdsApp.search` and posts it to the host, which\n * turns it into `AdPerformanceRow`s here. No developer token, manager account or OAuth client is\n * needed — the script runs as the account's own user. The script is in the README.\n *\n * Google reports hours down to the ad group, not the ad (`segments.hour` is incompatible with\n * `ad_group_ad`), and Performance Max campaigns have no ad groups at all; so a row is an ad group's\n * hour, or a Performance Max campaign's, and `ad_id` holds that ad group or campaign id.\n *\n * https://developers.google.com/google-ads/scripts/docs/features/reports\n * https://developers.google.com/google-ads/api/fields/v21/ad_group\n */\nimport {\n  type infer as Infer,\n  array,\n  nullable,\n  number,\n  object,\n  optional,\n  safeParse,\n  string,\n  union,\n} from 'zod/mini';\nimport { channelGroupOf } from '../attribution';\nimport { zonedHourToUtc } from './time';\nimport type { AdPerformanceRow } from './types';\n\n/** What a Google ad click is in the attribution vocabulary: a `gclid` is `google / cpc`. */\nconst CHANNEL = 'google';\nconst MEDIUM = 'cpc';\n\n/** `AdsApp.search` returns int64 metrics as strings and doubles as numbers; either is taken. */\nconst metric = optional(union([string(), number()]));\n\nconst reportRowSchema = object({\n  campaign_id: string(),\n  campaign_name: optional(nullable(string())),\n  /** Null for a Performance Max campaign's row. */\n  ad_group_id: optional(nullable(string())),\n  ad_group_name: optional(nullable(string())),\n  /** `segments.date`, a day in the account's time zone. */\n  date: string(),\n  /** `segments.hour`, 0–23, of that day. */\n  hour: number(),\n  cost_micros: metric,\n  impressions: metric,\n  clicks: metric,\n  conversions: metric,\n  conversion_value: metric,\n});\n\nconst reportSchema = object({\n  /** The customer id, digits only or as `123-456-7890`. */\n  account_id: string(),\n  currency: string(),\n  /** `AdsApp.currentAccount().getTimeZone()`, the IANA zone `date` and `hour` are in. */\n  time_zone: string(),\n  rows: array(reportRowSchema),\n});\n\n/** The body the Google Ads script posts: the account and its report rows, as read. */\nexport type GoogleAdsScriptReport = Infer<typeof reportSchema>;\n\n/** A body that is not a `GoogleAdsScriptReport`; the host answers it with a 400. */\nexport class GoogleAdsReportError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'GoogleAdsReportError';\n  }\n}\n\nconst DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/** A metric as a number, absent as `fallback`; anything not numeric is an invalid report. */\nfunction numeric<T extends number | null>(\n  value: string | number | undefined,\n  fallback: T,\n  path: string\n): number | T {\n  if (value === undefined) return fallback;\n  const n = Number(value);\n  if (!Number.isFinite(n)) throw new GoogleAdsReportError(`${path}: not a number: ${value}`);\n  return n;\n}\n\nfunction timeZoneOf(timeZone: string): string {\n  try {\n    new Intl.DateTimeFormat('en-US', { timeZone });\n  } catch {\n    throw new GoogleAdsReportError(`Unknown time zone: ${timeZone}`);\n  }\n  return timeZone;\n}\n\n/**\n * The rows of a report a Google Ads script posted, validated, one per ad group (or Performance Max\n * campaign) and hour. The hours are the account's, turned into UTC instants. Spend comes from\n * `cost_micros`. Google's `conversions` are its primary conversion actions under their own\n * attribution model, click-based (view-through conversions are counted apart, without value),\n * so they fill both the total and the click-through columns.\n *\n * Google restates the past — a conversion is credited to the hour of its click, up to the\n * conversion window (30 days by default) later — so the script re-reads a trailing window and the\n * host upserts on (`platform`, `account_id`, `ad_id`, `hour_start`).\n *\n * @throws GoogleAdsReportError when the body is not a report.\n */\nexport function parseGoogleAdsScriptReport(body: unknown): AdPerformanceRow[] {\n  const parsed = safeParse(reportSchema, body);\n  if (!parsed.success) {\n    const issues = parsed.error.issues;\n    const first = issues\n      .slice(0, 3)\n      .map((issue) => `${issue.path.join('.')}: ${issue.message}`)\n      .join('; ');\n    throw new GoogleAdsReportError(\n      `Invalid Google Ads report (${issues.length} issues): ${first}${issues.length > 3 ? '; …' : ''}`\n    );\n  }\n\n  const report = parsed.data;\n  const accountId = report.account_id.replaceAll('-', '');\n  const timeZone = timeZoneOf(report.time_zone);\n  return report.rows.map((row, index) => {\n    const path = `rows.${index}`;\n    if (!DATE.test(row.date) || !Number.isInteger(row.hour) || row.hour < 0 || row.hour > 23) {\n      throw new GoogleAdsReportError(`${path}: unexpected hour ${row.date} ${row.hour}`);\n    }\n    const conversions = numeric(row.conversions, null, `${path}.conversions`);\n    const value = numeric(row.conversion_value, null, `${path}.conversion_value`);\n    return {\n      platform: 'google',\n      account_id: accountId,\n      campaign_id: row.campaign_id,\n      campaign_name: row.campaign_name ?? null,\n      ad_group_id: row.ad_group_id ?? null,\n      ad_group_name: row.ad_group_name ?? null,\n      ad_id: row.ad_group_id ?? row.campaign_id,\n      ad_name: null,\n      channel: CHANNEL,\n      medium: MEDIUM,\n      channel_group: channelGroupOf(CHANNEL, MEDIUM),\n      hour_start: zonedHourToUtc(row.date, row.hour, timeZone).toISOString(),\n      currency: report.currency,\n      spend: numeric(row.cost_micros, 0, `${path}.cost_micros`) / 1e6,\n      impressions: numeric(row.impressions, 0, `${path}.impressions`),\n      clicks: numeric(row.clicks, 0, `${path}.clicks`),\n      conversions,\n      conversion_value: value,\n      click_conversions: conversions,\n      click_conversion_value: value,\n    };\n  });\n}\n"],"mappings":"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"}

package/dist/ads/google.d.cts

@@ -0,0 +1,43 @@
+import { AdPerformanceRow } from "./types.cjs";
+import { infer as __Infer } from "zod/mini";
+//#region src/ads/google.d.ts
+declare const reportSchema: import("zod/mini").ZodMiniObject<{
+  account_id: import("zod/mini").ZodMiniString<string>;
+  currency: import("zod/mini").ZodMiniString<string>;
+  time_zone: import("zod/mini").ZodMiniString<string>;
+  rows: import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniObject<{
+    campaign_id: import("zod/mini").ZodMiniString<string>;
+    campaign_name: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniNullable<import("zod/mini").ZodMiniString<string>>>;
+    ad_group_id: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniNullable<import("zod/mini").ZodMiniString<string>>>;
+    ad_group_name: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniNullable<import("zod/mini").ZodMiniString<string>>>;
+    date: import("zod/mini").ZodMiniString<string>;
+    hour: import("zod/mini").ZodMiniNumber<number>;
+    cost_micros: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniNumber<number>]>>;
+    impressions: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniNumber<number>]>>;
+    clicks: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniNumber<number>]>>;
+    conversions: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniNumber<number>]>>;
+    conversion_value: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniNumber<number>]>>;
+  }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>;
+/** The body the Google Ads script posts: the account and its report rows, as read. */
+export type GoogleAdsScriptReport = __Infer<typeof reportSchema>;
+/** A body that is not a `GoogleAdsScriptReport`; the host answers it with a 400. */
+export declare class GoogleAdsReportError extends Error {
+  constructor(message: string);
+}
+/**
+ * The rows of a report a Google Ads script posted, validated, one per ad group (or Performance Max
+ * campaign) and hour. The hours are the account's, turned into UTC instants. Spend comes from
+ * `cost_micros`. Google's `conversions` are its primary conversion actions under their own
+ * attribution model, click-based (view-through conversions are counted apart, without value),
+ * so they fill both the total and the click-through columns.
+ *
+ * Google restates the past — a conversion is credited to the hour of its click, up to the
+ * conversion window (30 days by default) later — so the script re-reads a trailing window and the
+ * host upserts on (`platform`, `account_id`, `ad_id`, `hour_start`).
+ *
+ * @throws GoogleAdsReportError when the body is not a report.
+ */
+export declare function parseGoogleAdsScriptReport(body: unknown): AdPerformanceRow[];
+//#endregion
+//# sourceMappingURL=google.d.cts.map

package/dist/ads/google.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.cts","names":["Infer"],"sources":["../../src/ads/google.ts"],"mappings":";;;cAoDM,iCAAY;;;;;;;;;;;;;;;;;yBAOhB;;YAGU,wBAAwBA,eAAa;;qBAGpC,6BAA6B;EACxC,YAAY;;;;;;;;;;;;;;;wBA0CE,2BAA2B,gBAAgB"}

package/dist/ads/google.d.mts

@@ -0,0 +1,43 @@
+import { AdPerformanceRow } from "./types.mjs";
+import { infer as __Infer } from "zod/mini";
+//#region src/ads/google.d.ts
+declare const reportSchema: import("zod/mini").ZodMiniObject<{
+  account_id: import("zod/mini").ZodMiniString<string>;
+  currency: import("zod/mini").ZodMiniString<string>;
+  time_zone: import("zod/mini").ZodMiniString<string>;
+  rows: import("zod/mini").ZodMiniArray<import("zod/mini").ZodMiniObject<{
+    campaign_id: import("zod/mini").ZodMiniString<string>;
+    campaign_name: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniNullable<import("zod/mini").ZodMiniString<string>>>;
+    ad_group_id: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniNullable<import("zod/mini").ZodMiniString<string>>>;
+    ad_group_name: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniNullable<import("zod/mini").ZodMiniString<string>>>;
+    date: import("zod/mini").ZodMiniString<string>;
+    hour: import("zod/mini").ZodMiniNumber<number>;
+    cost_micros: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniNumber<number>]>>;
+    impressions: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniNumber<number>]>>;
+    clicks: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniNumber<number>]>>;
+    conversions: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniNumber<number>]>>;
+    conversion_value: import("zod/mini").ZodMiniOptional<import("zod/mini").ZodMiniUnion<readonly [import("zod/mini").ZodMiniString<string>, import("zod/mini").ZodMiniNumber<number>]>>;
+  }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>;
+/** The body the Google Ads script posts: the account and its report rows, as read. */
+export type GoogleAdsScriptReport = __Infer<typeof reportSchema>;
+/** A body that is not a `GoogleAdsScriptReport`; the host answers it with a 400. */
+export declare class GoogleAdsReportError extends Error {
+  constructor(message: string);
+}
+/**
+ * The rows of a report a Google Ads script posted, validated, one per ad group (or Performance Max
+ * campaign) and hour. The hours are the account's, turned into UTC instants. Spend comes from
+ * `cost_micros`. Google's `conversions` are its primary conversion actions under their own
+ * attribution model, click-based (view-through conversions are counted apart, without value),
+ * so they fill both the total and the click-through columns.
+ *
+ * Google restates the past — a conversion is credited to the hour of its click, up to the
+ * conversion window (30 days by default) later — so the script re-reads a trailing window and the
+ * host upserts on (`platform`, `account_id`, `ad_id`, `hour_start`).
+ *
+ * @throws GoogleAdsReportError when the body is not a report.
+ */
+export declare function parseGoogleAdsScriptReport(body: unknown): AdPerformanceRow[];
+//#endregion
+//# sourceMappingURL=google.d.mts.map

package/dist/ads/google.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.mts","names":["Infer"],"sources":["../../src/ads/google.ts"],"mappings":";;;cAoDM,iCAAY;;;;;;;;;;;;;;;;;yBAOhB;;YAGU,wBAAwBA,eAAa;;qBAGpC,6BAA6B;EACxC,YAAY;;;;;;;;;;;;;;;wBA0CE,2BAA2B,gBAAgB"}

package/dist/ads/google.mjs

@@ -0,0 +1,126 @@
+import { channelGroupOf } from "../attribution/classify.mjs";
+import "../attribution/index.mjs";
+import { zonedHourToUtc } from "./time.mjs";
+import { array, nullable, number, object, optional, safeParse, string, union } from "zod/mini";
+//#region src/ads/google.ts
+/**
+* Google Ads delivery pushed by a Google Ads script: the script runs inside the ad account on
+* Google's schedule, reads the hourly report with `AdsApp.search` and posts it to the host, which
+* turns it into `AdPerformanceRow`s here. No developer token, manager account or OAuth client is
+* needed — the script runs as the account's own user. The script is in the README.
+*
+* Google reports hours down to the ad group, not the ad (`segments.hour` is incompatible with
+* `ad_group_ad`), and Performance Max campaigns have no ad groups at all; so a row is an ad group's
+* hour, or a Performance Max campaign's, and `ad_id` holds that ad group or campaign id.
+*
+* https://developers.google.com/google-ads/scripts/docs/features/reports
+* https://developers.google.com/google-ads/api/fields/v21/ad_group
+*/
+/** What a Google ad click is in the attribution vocabulary: a `gclid` is `google / cpc`. */
+const CHANNEL = "google";
+const MEDIUM = "cpc";
+/** `AdsApp.search` returns int64 metrics as strings and doubles as numbers; either is taken. */
+const metric = optional(union([string(), number()]));
+const reportRowSchema = object({
+	campaign_id: string(),
+	campaign_name: optional(nullable(string())),
+	/** Null for a Performance Max campaign's row. */
+	ad_group_id: optional(nullable(string())),
+	ad_group_name: optional(nullable(string())),
+	/** `segments.date`, a day in the account's time zone. */
+	date: string(),
+	/** `segments.hour`, 0–23, of that day. */
+	hour: number(),
+	cost_micros: metric,
+	impressions: metric,
+	clicks: metric,
+	conversions: metric,
+	conversion_value: metric
+});
+const reportSchema = object({
+	/** The customer id, digits only or as `123-456-7890`. */
+	account_id: string(),
+	currency: string(),
+	/** `AdsApp.currentAccount().getTimeZone()`, the IANA zone `date` and `hour` are in. */
+	time_zone: string(),
+	rows: array(reportRowSchema)
+});
+/** A body that is not a `GoogleAdsScriptReport`; the host answers it with a 400. */
+var GoogleAdsReportError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "GoogleAdsReportError";
+	}
+};
+const DATE = /^\d{4}-\d{2}-\d{2}$/;
+/** A metric as a number, absent as `fallback`; anything not numeric is an invalid report. */
+function numeric(value, fallback, path) {
+	if (value === void 0) return fallback;
+	const n = Number(value);
+	if (!Number.isFinite(n)) throw new GoogleAdsReportError(`${path}: not a number: ${value}`);
+	return n;
+}
+function timeZoneOf(timeZone) {
+	try {
+		new Intl.DateTimeFormat("en-US", { timeZone });
+	} catch {
+		throw new GoogleAdsReportError(`Unknown time zone: ${timeZone}`);
+	}
+	return timeZone;
+}
+/**
+* The rows of a report a Google Ads script posted, validated, one per ad group (or Performance Max
+* campaign) and hour. The hours are the account's, turned into UTC instants. Spend comes from
+* `cost_micros`. Google's `conversions` are its primary conversion actions under their own
+* attribution model, click-based (view-through conversions are counted apart, without value),
+* so they fill both the total and the click-through columns.
+*
+* Google restates the past — a conversion is credited to the hour of its click, up to the
+* conversion window (30 days by default) later — so the script re-reads a trailing window and the
+* host upserts on (`platform`, `account_id`, `ad_id`, `hour_start`).
+*
+* @throws GoogleAdsReportError when the body is not a report.
+*/
+function parseGoogleAdsScriptReport(body) {
+	const parsed = safeParse(reportSchema, body);
+	if (!parsed.success) {
+		const issues = parsed.error.issues;
+		const first = issues.slice(0, 3).map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ");
+		throw new GoogleAdsReportError(`Invalid Google Ads report (${issues.length} issues): ${first}${issues.length > 3 ? "; …" : ""}`);
+	}
+	const report = parsed.data;
+	const accountId = report.account_id.replaceAll("-", "");
+	const timeZone = timeZoneOf(report.time_zone);
+	return report.rows.map((row, index) => {
+		const path = `rows.${index}`;
+		if (!DATE.test(row.date) || !Number.isInteger(row.hour) || row.hour < 0 || row.hour > 23) throw new GoogleAdsReportError(`${path}: unexpected hour ${row.date} ${row.hour}`);
+		const conversions = numeric(row.conversions, null, `${path}.conversions`);
+		const value = numeric(row.conversion_value, null, `${path}.conversion_value`);
+		return {
+			platform: "google",
+			account_id: accountId,
+			campaign_id: row.campaign_id,
+			campaign_name: row.campaign_name ?? null,
+			ad_group_id: row.ad_group_id ?? null,
+			ad_group_name: row.ad_group_name ?? null,
+			ad_id: row.ad_group_id ?? row.campaign_id,
+			ad_name: null,
+			channel: CHANNEL,
+			medium: MEDIUM,
+			channel_group: channelGroupOf(CHANNEL, MEDIUM),
+			hour_start: zonedHourToUtc(row.date, row.hour, timeZone).toISOString(),
+			currency: report.currency,
+			spend: numeric(row.cost_micros, 0, `${path}.cost_micros`) / 1e6,
+			impressions: numeric(row.impressions, 0, `${path}.impressions`),
+			clicks: numeric(row.clicks, 0, `${path}.clicks`),
+			conversions,
+			conversion_value: value,
+			click_conversions: conversions,
+			click_conversion_value: value
+		};
+	});
+}
+//#endregion
+export { GoogleAdsReportError, parseGoogleAdsScriptReport };
+
+//# sourceMappingURL=google.mjs.map

package/dist/ads/google.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.mjs","names":[],"sources":["../../src/ads/google.ts"],"sourcesContent":["/**\n * Google Ads delivery pushed by a Google Ads script: the script runs inside the ad account on\n * Google's schedule, reads the hourly report with `AdsApp.search` and posts it to the host, which\n * turns it into `AdPerformanceRow`s here. No developer token, manager account or OAuth client is\n * needed — the script runs as the account's own user. The script is in the README.\n *\n * Google reports hours down to the ad group, not the ad (`segments.hour` is incompatible with\n * `ad_group_ad`), and Performance Max campaigns have no ad groups at all; so a row is an ad group's\n * hour, or a Performance Max campaign's, and `ad_id` holds that ad group or campaign id.\n *\n * https://developers.google.com/google-ads/scripts/docs/features/reports\n * https://developers.google.com/google-ads/api/fields/v21/ad_group\n */\nimport {\n  type infer as Infer,\n  array,\n  nullable,\n  number,\n  object,\n  optional,\n  safeParse,\n  string,\n  union,\n} from 'zod/mini';\nimport { channelGroupOf } from '../attribution';\nimport { zonedHourToUtc } from './time';\nimport type { AdPerformanceRow } from './types';\n\n/** What a Google ad click is in the attribution vocabulary: a `gclid` is `google / cpc`. */\nconst CHANNEL = 'google';\nconst MEDIUM = 'cpc';\n\n/** `AdsApp.search` returns int64 metrics as strings and doubles as numbers; either is taken. */\nconst metric = optional(union([string(), number()]));\n\nconst reportRowSchema = object({\n  campaign_id: string(),\n  campaign_name: optional(nullable(string())),\n  /** Null for a Performance Max campaign's row. */\n  ad_group_id: optional(nullable(string())),\n  ad_group_name: optional(nullable(string())),\n  /** `segments.date`, a day in the account's time zone. */\n  date: string(),\n  /** `segments.hour`, 0–23, of that day. */\n  hour: number(),\n  cost_micros: metric,\n  impressions: metric,\n  clicks: metric,\n  conversions: metric,\n  conversion_value: metric,\n});\n\nconst reportSchema = object({\n  /** The customer id, digits only or as `123-456-7890`. */\n  account_id: string(),\n  currency: string(),\n  /** `AdsApp.currentAccount().getTimeZone()`, the IANA zone `date` and `hour` are in. */\n  time_zone: string(),\n  rows: array(reportRowSchema),\n});\n\n/** The body the Google Ads script posts: the account and its report rows, as read. */\nexport type GoogleAdsScriptReport = Infer<typeof reportSchema>;\n\n/** A body that is not a `GoogleAdsScriptReport`; the host answers it with a 400. */\nexport class GoogleAdsReportError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'GoogleAdsReportError';\n  }\n}\n\nconst DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/** A metric as a number, absent as `fallback`; anything not numeric is an invalid report. */\nfunction numeric<T extends number | null>(\n  value: string | number | undefined,\n  fallback: T,\n  path: string\n): number | T {\n  if (value === undefined) return fallback;\n  const n = Number(value);\n  if (!Number.isFinite(n)) throw new GoogleAdsReportError(`${path}: not a number: ${value}`);\n  return n;\n}\n\nfunction timeZoneOf(timeZone: string): string {\n  try {\n    new Intl.DateTimeFormat('en-US', { timeZone });\n  } catch {\n    throw new GoogleAdsReportError(`Unknown time zone: ${timeZone}`);\n  }\n  return timeZone;\n}\n\n/**\n * The rows of a report a Google Ads script posted, validated, one per ad group (or Performance Max\n * campaign) and hour. The hours are the account's, turned into UTC instants. Spend comes from\n * `cost_micros`. Google's `conversions` are its primary conversion actions under their own\n * attribution model, click-based (view-through conversions are counted apart, without value),\n * so they fill both the total and the click-through columns.\n *\n * Google restates the past — a conversion is credited to the hour of its click, up to the\n * conversion window (30 days by default) later — so the script re-reads a trailing window and the\n * host upserts on (`platform`, `account_id`, `ad_id`, `hour_start`).\n *\n * @throws GoogleAdsReportError when the body is not a report.\n */\nexport function parseGoogleAdsScriptReport(body: unknown): AdPerformanceRow[] {\n  const parsed = safeParse(reportSchema, body);\n  if (!parsed.success) {\n    const issues = parsed.error.issues;\n    const first = issues\n      .slice(0, 3)\n      .map((issue) => `${issue.path.join('.')}: ${issue.message}`)\n      .join('; ');\n    throw new GoogleAdsReportError(\n      `Invalid Google Ads report (${issues.length} issues): ${first}${issues.length > 3 ? '; …' : ''}`\n    );\n  }\n\n  const report = parsed.data;\n  const accountId = report.account_id.replaceAll('-', '');\n  const timeZone = timeZoneOf(report.time_zone);\n  return report.rows.map((row, index) => {\n    const path = `rows.${index}`;\n    if (!DATE.test(row.date) || !Number.isInteger(row.hour) || row.hour < 0 || row.hour > 23) {\n      throw new GoogleAdsReportError(`${path}: unexpected hour ${row.date} ${row.hour}`);\n    }\n    const conversions = numeric(row.conversions, null, `${path}.conversions`);\n    const value = numeric(row.conversion_value, null, `${path}.conversion_value`);\n    return {\n      platform: 'google',\n      account_id: accountId,\n      campaign_id: row.campaign_id,\n      campaign_name: row.campaign_name ?? null,\n      ad_group_id: row.ad_group_id ?? null,\n      ad_group_name: row.ad_group_name ?? null,\n      ad_id: row.ad_group_id ?? row.campaign_id,\n      ad_name: null,\n      channel: CHANNEL,\n      medium: MEDIUM,\n      channel_group: channelGroupOf(CHANNEL, MEDIUM),\n      hour_start: zonedHourToUtc(row.date, row.hour, timeZone).toISOString(),\n      currency: report.currency,\n      spend: numeric(row.cost_micros, 0, `${path}.cost_micros`) / 1e6,\n      impressions: numeric(row.impressions, 0, `${path}.impressions`),\n      clicks: numeric(row.clicks, 0, `${path}.clicks`),\n      conversions,\n      conversion_value: value,\n      click_conversions: conversions,\n      click_conversion_value: value,\n    };\n  });\n}\n"],"mappings":"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"}

package/dist/ads/index.cjs

@@ -1,11 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_ads_time = require("./time.cjs");
+const require_ads_google = require("./google.cjs");
 const require_ads_meta = require("./meta.cjs");
+exports.GoogleAdsReportError = require_ads_google.GoogleAdsReportError;
 exports.MetaAdsApiError = require_ads_meta.MetaAdsApiError;
 exports.addDays = require_ads_time.addDays;
 exports.addMonths = require_ads_time.addMonths;
 exports.fetchMetaAdPerformance = require_ads_meta.fetchMetaAdPerformance;
 exports.fetchMetaAdPerformanceHistory = require_ads_meta.fetchMetaAdPerformanceHistory;
+exports.parseGoogleAdsScriptReport = require_ads_google.parseGoogleAdsScriptReport;
 exports.spread = require_ads_meta.spread;
 exports.todayIn = require_ads_time.todayIn;
 exports.zonedHourToUtc = require_ads_time.zonedHourToUtc;

package/dist/ads/index.d.cts

@@ -1,4 +1,5 @@
 import { AdPerformanceRow, AdPlatform, ReportDate } from "./types.cjs";
+import { GoogleAdsReportError, GoogleAdsScriptReport, parseGoogleAdsScriptReport } from "./google.cjs";
 import { MetaAdPerformanceOptions, MetaAdsApiError, fetchMetaAdPerformance, fetchMetaAdPerformanceHistory, spread } from "./meta.cjs";
 import { addDays, addMonths, todayIn, zonedHourToUtc } from "./time.cjs";
-export { type AdPerformanceRow, type AdPlatform, MetaAdPerformanceOptions, MetaAdsApiError, type ReportDate, addDays, addMonths, fetchMetaAdPerformance, fetchMetaAdPerformanceHistory, spread, todayIn, zonedHourToUtc };
+export { type AdPerformanceRow, type AdPlatform, GoogleAdsReportError, GoogleAdsScriptReport, MetaAdPerformanceOptions, MetaAdsApiError, type ReportDate, addDays, addMonths, fetchMetaAdPerformance, fetchMetaAdPerformanceHistory, parseGoogleAdsScriptReport, spread, todayIn, zonedHourToUtc };

package/dist/ads/index.d.mts

@@ -1,4 +1,5 @@
 import { AdPerformanceRow, AdPlatform, ReportDate } from "./types.mjs";
+import { GoogleAdsReportError, GoogleAdsScriptReport, parseGoogleAdsScriptReport } from "./google.mjs";
 import { MetaAdPerformanceOptions, MetaAdsApiError, fetchMetaAdPerformance, fetchMetaAdPerformanceHistory, spread } from "./meta.mjs";
 import { addDays, addMonths, todayIn, zonedHourToUtc } from "./time.mjs";
-export { type AdPerformanceRow, type AdPlatform, MetaAdPerformanceOptions, MetaAdsApiError, type ReportDate, addDays, addMonths, fetchMetaAdPerformance, fetchMetaAdPerformanceHistory, spread, todayIn, zonedHourToUtc };
+export { type AdPerformanceRow, type AdPlatform, GoogleAdsReportError, GoogleAdsScriptReport, MetaAdPerformanceOptions, MetaAdsApiError, type ReportDate, addDays, addMonths, fetchMetaAdPerformance, fetchMetaAdPerformanceHistory, parseGoogleAdsScriptReport, spread, todayIn, zonedHourToUtc };

package/dist/ads/index.mjs

@@ -1,3 +1,4 @@
 import { addDays, addMonths, todayIn, zonedHourToUtc } from "./time.mjs";
+import { GoogleAdsReportError, parseGoogleAdsScriptReport } from "./google.mjs";
 import { MetaAdsApiError, fetchMetaAdPerformance, fetchMetaAdPerformanceHistory, spread } from "./meta.mjs";
-export { MetaAdsApiError, addDays, addMonths, fetchMetaAdPerformance, fetchMetaAdPerformanceHistory, spread, todayIn, zonedHourToUtc };
+export { GoogleAdsReportError, MetaAdsApiError, addDays, addMonths, fetchMetaAdPerformance, fetchMetaAdPerformanceHistory, parseGoogleAdsScriptReport, spread, todayIn, zonedHourToUtc };

package/dist/ads/types.d.cts

@@ -1,7 +1,7 @@
 import { ChannelGroup } from "../attribution/vocabulary.cjs";
 //#region src/ads/types.d.ts
 /** The ad platforms whose reporting APIs this module reads. */
-export type AdPlatform = 'meta';
+export type AdPlatform = 'meta' | 'google';
 /**
  * One row of ad delivery: one ad over one hour. The row a host stores in its `ad_performance`
  * table, unique on (`platform`, `account_id`, `ad_id`, `hour_start`).
@@ -18,13 +18,17 @@ export type AdPlatform = 'meta';
 export interface AdPerformanceRow {
   /** The reporting API the row came from; `channel` is what it joins attribution on. */
   platform: AdPlatform;
-  /** The platform's account id, without a prefix (Meta's `act_` is stripped). */
+  /** The platform's account id, without a prefix or dashes (Meta's `act_`, Google's `123-`). */
   account_id: string;
   campaign_id: string;
   campaign_name: string | null;
-  /** The level between campaign and ad: Meta's ad set. */
+  /** The level between campaign and ad: Meta's ad set, Google's ad group. */
   ad_group_id: string | null;
   ad_group_name: string | null;
+  /**
+   * The finest level the platform reports hours at: the ad on Meta; on Google the ad group, or the
+   * campaign for Performance Max, which has none.
+   */
   ad_id: string;
   ad_name: string | null;
   channel: string;

package/dist/ads/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/ads/types.ts"],"mappings":";;;YAGY;;;;;;;;;;;;;;iBAeK;;EAEf,UAAU;;EAEV;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA,eAAe;;EAEf;;EAEA;EACA;EACA;;;;;EAKA;;;;;EAKA;EACA;;EAEA;EACA;;;YAIU"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/ads/types.ts"],"mappings":";;;YAGY;;;;;;;;;;;;;;iBAeK;;EAEf,UAAU;;EAEV;EACA;EACA;;EAEA;EACA;;;;;EAKA;EACA;EACA;EACA;EACA,eAAe;;EAEf;;EAEA;EACA;EACA;;;;;EAKA;;;;;EAKA;EACA;;EAEA;EACA;;;YAIU"}

package/dist/ads/types.d.mts

@@ -1,7 +1,7 @@
 import { ChannelGroup } from "../attribution/vocabulary.mjs";
 //#region src/ads/types.d.ts
 /** The ad platforms whose reporting APIs this module reads. */
-export type AdPlatform = 'meta';
+export type AdPlatform = 'meta' | 'google';
 /**
  * One row of ad delivery: one ad over one hour. The row a host stores in its `ad_performance`
  * table, unique on (`platform`, `account_id`, `ad_id`, `hour_start`).
@@ -18,13 +18,17 @@ export type AdPlatform = 'meta';
 export interface AdPerformanceRow {
   /** The reporting API the row came from; `channel` is what it joins attribution on. */
   platform: AdPlatform;
-  /** The platform's account id, without a prefix (Meta's `act_` is stripped). */
+  /** The platform's account id, without a prefix or dashes (Meta's `act_`, Google's `123-`). */
   account_id: string;
   campaign_id: string;
   campaign_name: string | null;
-  /** The level between campaign and ad: Meta's ad set. */
+  /** The level between campaign and ad: Meta's ad set, Google's ad group. */
   ad_group_id: string | null;
   ad_group_name: string | null;
+  /**
+   * The finest level the platform reports hours at: the ad on Meta; on Google the ad group, or the
+   * campaign for Performance Max, which has none.
+   */
   ad_id: string;
   ad_name: string | null;
   channel: string;

package/dist/ads/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/ads/types.ts"],"mappings":";;;YAGY;;;;;;;;;;;;;;iBAeK;;EAEf,UAAU;;EAEV;EACA;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA,eAAe;;EAEf;;EAEA;EACA;EACA;;;;;EAKA;;;;;EAKA;EACA;;EAEA;EACA;;;YAIU"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/ads/types.ts"],"mappings":";;;YAGY;;;;;;;;;;;;;;iBAeK;;EAEf,UAAU;;EAEV;EACA;EACA;;EAEA;EACA;;;;;EAKA;EACA;EACA;EACA;EACA,eAAe;;EAEf;;EAEA;EACA;EACA;;;;;EAKA;;;;;EAKA;EACA;;EAEA;EACA;;;YAIU"}

package/dist/attribution/classify.cjs

@@ -82,15 +82,10 @@ function productTouch(tags, rules) {
 	return null;
 }
 /**
-* 5. The referrer's host: a known search engine or social network folded to its channel, any
-* other site kept as its host, and null for no referrer or one that is no touch. An Android app's
-* referrer (`android-app://<package>`) is read as the site it stands for (`ANDROID_APP_HOSTS`).
+* A referring site's host as a touch: a known search engine or social network folded to its
+* channel, any other site kept as its host, and null for a host that is no touch.
 */
-function referrer(tags, ownHosts) {
-	const url = text(tags, "page_referrer");
-	const app = url ? androidAppOf.exec(url)?.[1]?.toLowerCase() : void 0;
-	const host = app ? require_attribution_vocabulary.ANDROID_APP_HOSTS[app] ?? app : url ? referrerHostOf.exec(url)?.[1]?.toLowerCase() : void 0;
-	if (!host) return null;
+function siteTouch(host, ownHosts) {
 	if (require_attribution_vocabulary.REFERRERS_NOT_A_TOUCH.some((pattern) => pattern.test(host))) return null;
 	if (ownHosts.some((pattern) => pattern.test(host))) return null;
 	const site = require_attribution_vocabulary.REFERRER_SITES.find(([, , pattern]) => pattern.test(host));
@@ -103,6 +98,47 @@ function referrer(tags, ownHosts) {
 	};
 }
 /**
+* 5. The referrer's host, read as `siteTouch`; null for no referrer. An Android app's referrer
+* (`android-app://<package>`) is read as the site it stands for (`ANDROID_APP_HOSTS`).
+*/
+function referrer(tags, ownHosts) {
+	const url = text(tags, "page_referrer");
+	const app = url ? androidAppOf.exec(url)?.[1]?.toLowerCase() : void 0;
+	const host = app ? require_attribution_vocabulary.ANDROID_APP_HOSTS[app] ?? app : url ? referrerHostOf.exec(url)?.[1]?.toLowerCase() : void 0;
+	return host ? siteTouch(host, ownHosts) : null;
+}
+/**
+* 6. The `ref` parameter of the landing page, when the session has no referrer at all: the
+* convention of sites that link out — Product Hunt's `?ref=producthunt`, newsletters,
+* directories, "built with" badges. It names the site when the browser does not: a click from a
+* mail client, an in-app browser or a page under `no-referrer`. With a referrer it is not read —
+* the referrer is where the click happened, and the `ref` only where the link was first written:
+* a search engine indexes the URL with its `?ref=`, another directory copies the link, and the
+* `ref` would credit the first site with the visit the second one sent; an internal link's
+* `?ref=header` would credit the page's own nav. A site's name (`producthunt`) is kept as the
+* channel, with the `utm_source` aliases folded; a host or URL (`producthunt.com`,
+* `https://news.ycombinator.com/`) is read as a referrer's host, so the same site lands on the
+* same channel either way. Ranks with the referrer: nobody paid for that link.
+*/
+function refParam(tags, ownHosts) {
+	const location = text(tags, "page_location");
+	if (!location || text(tags, "page_referrer")) return null;
+	let value;
+	try {
+		value = new URL(location, "https://localhost").searchParams.get("ref");
+	} catch {
+		return null;
+	}
+	const ref = value?.trim().toLowerCase().split(/[?&#]/)[0]?.replace(/\/+$/, "");
+	if (!ref) return null;
+	const host = referrerHostOf.exec(ref)?.[1] ?? (ref.includes(".") ? ref.split(/[/:]/)[0] : void 0);
+	if (host) return siteTouch(host, ownHosts);
+	return {
+		channel: require_attribution_vocabulary.SOURCE_ALIASES[ref] ?? ref,
+		medium: "referral"
+	};
+}
+/**
 * GA4's default channel group of a (channel, medium) pair, with GA4's rule that the source
 * decides too: `linkedin / (not set)` is Organic Social and `email / promo` is Email, because
 * GA4 matches its site lists on the source, not only the medium. Two additions to GA4: Meta's
@@ -134,19 +170,20 @@ function channelGroupOf(channel, medium) {
 * Reads the tags a session arrived with (its `session_start` tags) as one touch. Run once, when
 * the session is written; the result is stored, and the views only read it.
 *
-* The rules, in order, the first that says something naming the channel: an explicit
-* `utm_source`, a click id, an ad landing page, the product's own rules, the referrer's host;
-* `(direct)` when none does. `medium` is `utm_medium` as declared (lower-cased), else what that
-* rule implies: `(not set)` for a utm_source alone, `cpc` for a bare click id or ad landing page,
-* the product rule's own, `organic` / `social` / `video` / `referral` for a referrer, `(none)`
+* The rules, in order, the first that says something naming the channel: an explicit `utm_source`,
+* a click id, an ad landing page, the product's own rules, the referrer's host, the landing page's
+* `?ref=` when there is no referrer; `(direct)` when none does. `medium` is `utm_medium` as
+* declared (lower-cased), else what that rule implies: `(not set)` for a utm_source alone, `cpc`
+* for a bare click id or ad landing page, the product rule's own, `referral` for a `?ref=` site
+* name, `organic` / `social` / `video` / `referral` for a referrer (or a host in `?ref=`), `(none)`
 * for direct. An ad-only click id of the channel itself (`'ads'` in `CLICK_ID_CHANNELS`) or its ad
 * landing page makes it `cpc` when the medium was left out or puts the touch in an organic group:
 * the click was paid whatever the tag said — a Reddit ad tagged `utm_medium=social`, a ChatGPT ad
-* keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else what a
-* product rule captured — even when the utm named the channel, so a tagged referral link keeps
-* its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):
-* campaign touches, then the product's own as they declare, then the referrer — except that a
-* campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,
+* keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else
+* what a product rule captured — even when the utm named the channel, so a tagged referral link
+* keeps its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):
+* campaign touches, then the product's own as they declare, then the referrer and `?ref=` — except
+* that a campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,
 * `utm_medium=organic`) or email ranks with a referrer: nobody paid for that click, and it should
 * not take the credit from an ad clicked earlier in the attribution window. When a product rule
 * matched too, the stronger of the two tiers holds.
@@ -156,7 +193,8 @@ function classifyTouch(tags, options = {}) {
 	const click = clickChannel(tags);
 	const landing = landingChannel(tags);
 	const product = productTouch(tags, options.rules ?? []);
-	const referred = referrer(tags, options.ownHosts ?? []);
+	const ownHosts = options.ownHosts ?? [];
+	const referred = referrer(tags, ownHosts) ?? refParam(tags, ownHosts);
 	const channel = utm ?? click ?? landing ?? product?.channel ?? referred?.channel ?? "(direct)";
 	const namedMedium = text(tags, "utm_medium")?.toLowerCase() ?? null ?? (utm ? "(not set)" : click || landing ? "cpc" : product?.medium ?? referred?.medium ?? "(none)");
 	const medium = (adClickChannel(tags) === channel || landing === channel) && (namedMedium === "(not set)" || ORGANIC_GROUPS.has(channelGroupOf(channel, namedMedium))) ? "cpc" : namedMedium;

package/dist/attribution/classify.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"classify.cjs","names":["META_PLACEMENTS","REFERRER_SITES","SOURCE_ALIASES","CLICK_ID_CHANNELS","AD_LANDING_PAGE","ANDROID_APP_HOSTS","REFERRERS_NOT_A_TOUCH","DISPLAY_MEDIUMS","PAID_MEDIUM","EMAIL_MEDIUM","EMAIL_MEDIUMS","PUSH_MEDIUM","TOUCH_PRIORITY"],"sources":["../../src/attribution/classify.ts"],"sourcesContent":["import type { TrackTags } from '../track/types';\nimport {\n  AD_LANDING_PAGE,\n  ANDROID_APP_HOSTS,\n  CLICK_ID_CHANNELS,\n  type ChannelGroup,\n  DIRECT_CHANNEL,\n  DISPLAY_MEDIUMS,\n  EMAIL_MEDIUM,\n  EMAIL_MEDIUMS,\n  MEDIUM_NOT_SET,\n  META_PLACEMENTS,\n  NO_MEDIUM,\n  PAID_MEDIUM,\n  PUSH_MEDIUM,\n  REFERRERS_NOT_A_TOUCH,\n  REFERRER_SITES,\n  SOURCE_ALIASES,\n  TOUCH_PRIORITY,\n} from './vocabulary';\n\n/** What a session's tags say about how it arrived: the touch, as the session row stores it. */\nexport interface Touch {\n  /** The source, as GA calls it: a `Channel`, a `utm_source` outside the list, a referring host, or `(direct)`. */\n  channel: string;\n  /** How, as GA calls it: `utm_medium` as declared, else what the rule that named the channel implies; `(none)` for direct. */\n  medium: string;\n  /** GA4's default channel group of the two. */\n  channel_group: ChannelGroup;\n  /** `utm_campaign`, else what a product rule captured (a referral code); null when neither. */\n  campaign: string | null;\n  /** `TOUCH_PRIORITY` of the rule that named the channel; null for direct, which is no touch. */\n  priority: number | null;\n}\n\n/** What a product rule names, when it recognises the session; the channel group is derived. */\nexport type ProductTouch = Omit<Touch, 'channel_group'>;\n\n/**\n * A product's own rule: a landing page convention, a code in the URL. Tried after the campaign\n * rules (utm, click id, ad landing page) and before the referrer, so a link shared on Facebook\n * or WhatsApp is credited to what the product recognises, not to the site it was shared on.\n * Returns null when the session is not one of its.\n */\nexport type TouchRule = (tags: TrackTags) => ProductTouch | null;\n\nexport interface ClassifyOptions {\n  /**\n   * The product's own hosts, as patterns over the lower-cased referrer host: a session that\n   * starts from an internal link after the session timeout refers to them, which is navigation,\n   * not acquisition. The SDK adds the payment and sign-in providers (`REFERRERS_NOT_A_TOUCH`).\n   */\n  ownHosts?: readonly RegExp[];\n  /** The product's rules, in order; the first that names the session wins. */\n  rules?: readonly TouchRule[];\n}\n\nconst metaPlacements = new Set<string>(META_PLACEMENTS);\n/** The groups no one paid for: a campaign rule landing in one of them ranks with a referrer. */\nconst ORGANIC_GROUPS = new Set<ChannelGroup>([\n  'organic_search',\n  'organic_social',\n  'organic_video',\n  'organic_ai',\n  'referral',\n]);\n/**\n * The groups a campaign rule ranks with a referrer in: the organic ones, and the messages we send\n * — email, SMS, push. They reach people we already know — often because an ad brought them — and\n * their links (a welcome mail, a trial reminder) come between that ad and the purchase, so they\n * must not take the ad's credit. With no ad in the window they still win as the latest touch.\n */\nconst REFERRER_TIER_GROUPS = new Set<ChannelGroup>([\n  ...ORGANIC_GROUPS,\n  'email',\n  'sms',\n  'mobile_push',\n]);\nconst referrerHostOf = /^https?:\\/\\/([^/:?#]+)/i;\nconst androidAppOf = /^android-app:\\/\\/([^/?#]+)/i;\nconst channelsBy = (medium: string) =>\n  new Set<string>(REFERRER_SITES.filter(([, m]) => m === medium).map(([channel]) => channel));\nconst searchChannels = channelsBy('organic');\nconst socialChannels = channelsBy('social');\nconst videoChannels = channelsBy('video');\nconst aiChannels = channelsBy('ai');\n\n/**\n * A tag as text; absent when missing, empty, or the strings a broken template writes (`undefined`,\n * `null`). A macro the ad platform did not expand (`{{campaign_name}}`, `__CAMPAIGN_NAME__`) is\n * kept as written, so the misspelt template shows in the reports and gets fixed.\n */\nfunction text(tags: TrackTags, key: string): string | null {\n  const value = tags[key];\n  if (value === undefined || value === null) return null;\n  const s = String(value);\n  return s === '' || s === 'undefined' || s === 'null' ? null : s;\n}\n\n/**\n * 1. What the campaign said: `utm_source`, with the aliases folded. It comes before the click\n * ids — unlike GA4, where a usable `gclid` always wins over the utm (Universal Analytics' \"manual\n * tagging overrides auto-tagging\" has no GA4 counterpart): a utm is written for this link by whoever placed it, while a click id\n * can be added by someone else — Meta puts `fbclid` on organic links too, and a shared or\n * forwarded ad link keeps the click id of the ad. When the two disagree, the utm is the one that\n * was right: an Instagram profile link carrying `fbclid`, a newsletter link copied from an ad.\n * The one exception is an ad-only click id of the utm's own channel, see `classifyTouch`.\n */\nfunction utmChannel(tags: TrackTags): string | null {\n  // A source with the rest of the query glued on (`email&utm_medium=promo`, `toolify/`,\n  // `x?utm_source=x`): a link built by hand or double-encoded. Keep the source.\n  const source = text(tags, 'utm_source')?.toLowerCase().split(/[?&#]/)[0]?.replace(/\\/+$/, '');\n  if (!source) return null;\n  return (SOURCE_ALIASES as Record<string, string>)[source] ?? source;\n}\n\n/**\n * 2. A click id in this page's URL — the tags never fill one from the cookie an earlier click\n * left (that is `_gcl_aw`, `_fbc`, …). Only a value counts, not the key: clients before mid-2025\n * wrote `fbclid: null` (`URLSearchParams.get` of a missing parameter) into every page's tags, and\n * reading the key alone named those sessions Meta clicks — Google ad clicks among them, as `fbclid`\n * is listed first. A platform always puts a value on its click.\n */\nfunction clickChannel(tags: TrackTags): string | null {\n  return CLICK_ID_CHANNELS.find(([key]) => text(tags, key) !== null)?.[1] ?? null;\n}\n\n/** The channel of the first click id in the tags that its platform puts on ad clicks only. */\nfunction adClickChannel(tags: TrackTags): string | null {\n  return (\n    CLICK_ID_CHANNELS.find(([key, , on]) => on === 'ads' && text(tags, key) !== null)?.[1] ?? null\n  );\n}\n\n/** 3. A landing page reserved for one channel's ads. */\nfunction landingChannel(tags: TrackTags): string | null {\n  const location = text(tags, 'page_location');\n  return location ? (AD_LANDING_PAGE.exec(location)?.[1] ?? null) : null;\n}\n\n/** 4. The product's rules, in order. */\nfunction productTouch(tags: TrackTags, rules: readonly TouchRule[]): ProductTouch | null {\n  for (const rule of rules) {\n    const touch = rule(tags);\n    if (touch) return touch;\n  }\n  return null;\n}\n\n/**\n * 5. The referrer's host: a known search engine or social network folded to its channel, any\n * other site kept as its host, and null for no referrer or one that is no touch. An Android app's\n * referrer (`android-app://<package>`) is read as the site it stands for (`ANDROID_APP_HOSTS`).\n */\nfunction referrer(\n  tags: TrackTags,\n  ownHosts: readonly RegExp[]\n): { channel: string; medium: string } | null {\n  const url = text(tags, 'page_referrer');\n  const app = url ? androidAppOf.exec(url)?.[1]?.toLowerCase() : undefined;\n  const host = app\n    ? (ANDROID_APP_HOSTS[app] ?? app)\n    : url\n      ? referrerHostOf.exec(url)?.[1]?.toLowerCase()\n      : undefined;\n  if (!host) return null;\n  if (REFERRERS_NOT_A_TOUCH.some((pattern) => pattern.test(host))) return null;\n  if (ownHosts.some((pattern) => pattern.test(host))) return null;\n  const site = REFERRER_SITES.find(([, , pattern]) => pattern.test(host));\n  return site ? { channel: site[0], medium: site[1] } : { channel: host, medium: 'referral' };\n}\n\n/**\n * GA4's default channel group of a (channel, medium) pair, with GA4's rule that the source\n * decides too: `linkedin / (not set)` is Organic Social and `email / promo` is Email, because\n * GA4 matches its site lists on the source, not only the medium. Two additions to GA4: Meta's\n * placement names as a medium are a paid Meta click (see `META_PLACEMENTS`), and the AI\n * assistants have `organic_ai`. Checked in GA4's order — paid before organic, the organic groups before\n * email, then referral, SMS and push — so a pair that fits two rules lands where GA4 would put it.\n */\nexport function channelGroupOf(channel: string, medium: string): ChannelGroup {\n  if (channel === DIRECT_CHANNEL) return 'direct';\n  if ((DISPLAY_MEDIUMS as readonly string[]).includes(medium)) return 'display';\n  // A Meta placement as the medium is a Meta ad whatever the source was tagged as.\n  if (metaPlacements.has(medium)) return 'paid_social';\n  if (PAID_MEDIUM.test(medium)) {\n    if (socialChannels.has(channel) || videoChannels.has(channel)) return 'paid_social';\n    if (searchChannels.has(channel)) return 'paid_search';\n    return 'paid_other';\n  }\n  if (medium === 'social' || socialChannels.has(channel)) return 'organic_social';\n  if (medium === 'video' || videoChannels.has(channel)) return 'organic_video';\n  if (medium === 'ai' || aiChannels.has(channel)) return 'organic_ai';\n  if (medium === 'organic' || searchChannels.has(channel)) return 'organic_search';\n  if (EMAIL_MEDIUM.test(medium) || (EMAIL_MEDIUMS as readonly string[]).includes(channel))\n    return 'email';\n  if (medium === 'affiliate') return 'affiliate';\n  if (medium === 'referral') return 'referral';\n  if (medium === 'sms' || channel === 'sms') return 'sms';\n  if (PUSH_MEDIUM.test(medium) || channel === 'firebase') return 'mobile_push';\n  return 'unassigned';\n}\n\n/**\n * Reads the tags a session arrived with (its `session_start` tags) as one touch. Run once, when\n * the session is written; the result is stored, and the views only read it.\n *\n * The rules, in order, the first that says something naming the channel: an explicit\n * `utm_source`, a click id, an ad landing page, the product's own rules, the referrer's host;\n * `(direct)` when none does. `medium` is `utm_medium` as declared (lower-cased), else what that\n * rule implies: `(not set)` for a utm_source alone, `cpc` for a bare click id or ad landing page,\n * the product rule's own, `organic` / `social` / `video` / `referral` for a referrer, `(none)`\n * for direct. An ad-only click id of the channel itself (`'ads'` in `CLICK_ID_CHANNELS`) or its ad\n * landing page makes it `cpc` when the medium was left out or puts the touch in an organic group:\n * the click was paid whatever the tag said — a Reddit ad tagged `utm_medium=social`, a ChatGPT ad\n * keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else what a\n * product rule captured — even when the utm named the channel, so a tagged referral link keeps\n * its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):\n * campaign touches, then the product's own as they declare, then the referrer — except that a\n * campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,\n * `utm_medium=organic`) or email ranks with a referrer: nobody paid for that click, and it should\n * not take the credit from an ad clicked earlier in the attribution window. When a product rule\n * matched too, the stronger of the two tiers holds.\n */\nexport function classifyTouch(tags: TrackTags, options: ClassifyOptions = {}): Touch {\n  const utm = utmChannel(tags);\n  const click = clickChannel(tags);\n  const landing = landingChannel(tags);\n  const product = productTouch(tags, options.rules ?? []);\n  const referred = referrer(tags, options.ownHosts ?? []);\n\n  const channel =\n    utm ?? click ?? landing ?? product?.channel ?? referred?.channel ?? DIRECT_CHANNEL;\n  const declaredMedium = text(tags, 'utm_medium')?.toLowerCase() ?? null;\n  const namedMedium =\n    declaredMedium ??\n    (utm\n      ? MEDIUM_NOT_SET\n      : click || landing\n        ? 'cpc'\n        : (product?.medium ?? referred?.medium ?? NO_MEDIUM));\n  // What proves a paid click on this channel: an ad-only click id of it, or its ad landing page.\n  // Another channel's says nothing about this one (an ad link copied and shared under a utm of\n  // its own), and `fbclid` is on organic Meta links too, so neither counts here.\n  const paid = adClickChannel(tags) === channel || landing === channel;\n  const medium =\n    paid &&\n    (namedMedium === MEDIUM_NOT_SET || ORGANIC_GROUPS.has(channelGroupOf(channel, namedMedium)))\n      ? 'cpc'\n      : namedMedium;\n  const channelGroup = channelGroupOf(channel, medium);\n  const campaign = text(tags, 'utm_campaign') ?? product?.campaign ?? null;\n  const campaignTier =\n    utm || click || landing\n      ? REFERRER_TIER_GROUPS.has(channelGroup)\n        ? TOUCH_PRIORITY.referrer\n        : TOUCH_PRIORITY.campaign\n      : null;\n  // The stronger of the campaign rule's tier and the product rule's own: a referral link shared\n  // under `utm_source=whatsapp` is named by the utm, and still ranks as the programme declares.\n  const ranked = [campaignTier, product?.priority ?? null].filter((tier) => tier !== null);\n  const priority =\n    ranked.length > 0 ? Math.min(...ranked) : referred ? TOUCH_PRIORITY.referrer : null;\n\n  return { channel, medium, channel_group: channelGroup, campaign, priority };\n}\n"],"mappings":";;;AAyDA,MAAM,iBAAiB,IAAI,IAAYA,+BAAAA,eAAe;;AAEtD,MAAM,iCAAiB,IAAI,IAAkB;CAC3C;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;AAOD,MAAM,uCAAuB,IAAI,IAAkB;CACjD,GAAG;CACH;CACA;CACA;AACF,CAAC;AACD,MAAM,iBAAiB;AACvB,MAAM,eAAe;AACrB,MAAM,cAAc,WAClB,IAAI,IAAYC,+BAAAA,eAAe,QAAQ,GAAG,OAAO,MAAM,MAAM,CAAC,CAAC,KAAK,CAAC,aAAa,OAAO,CAAC;AAC5F,MAAM,iBAAiB,WAAW,SAAS;AAC3C,MAAM,iBAAiB,WAAW,QAAQ;AAC1C,MAAM,gBAAgB,WAAW,OAAO;AACxC,MAAM,aAAa,WAAW,IAAI;;;;;;AAOlC,SAAS,KAAK,MAAiB,KAA4B;CACzD,MAAM,QAAQ,KAAK;CACnB,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO;CAClD,MAAM,IAAI,OAAO,KAAK;CACtB,OAAO,MAAM,MAAM,MAAM,eAAe,MAAM,SAAS,OAAO;AAChE;;;;;;;;;;AAWA,SAAS,WAAW,MAAgC;CAGlD,MAAM,SAAS,KAAK,MAAM,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,EAAE,EAAE,QAAQ,QAAQ,EAAE;CAC5F,IAAI,CAAC,QAAQ,OAAO;CACpB,OAAQC,+BAAAA,eAA0C,WAAW;AAC/D;;;;;;;;AASA,SAAS,aAAa,MAAgC;CACpD,OAAOC,+BAAAA,kBAAkB,MAAM,CAAC,SAAS,KAAK,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,MAAM;AAC7E;;AAGA,SAAS,eAAe,MAAgC;CACtD,OACEA,+BAAAA,kBAAkB,MAAM,CAAC,OAAO,QAAQ,OAAO,SAAS,KAAK,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,MAAM;AAE9F;;AAGA,SAAS,eAAe,MAAgC;CACtD,MAAM,WAAW,KAAK,MAAM,eAAe;CAC3C,OAAO,WAAYC,+BAAAA,gBAAgB,KAAK,QAAQ,CAAC,GAAG,MAAM,OAAQ;AACpE;;AAGA,SAAS,aAAa,MAAiB,OAAkD;CACvF,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,QAAQ,KAAK,IAAI;EACvB,IAAI,OAAO,OAAO;CACpB;CACA,OAAO;AACT;;;;;;AAOA,SAAS,SACP,MACA,UAC4C;CAC5C,MAAM,MAAM,KAAK,MAAM,eAAe;CACtC,MAAM,MAAM,MAAM,aAAa,KAAK,GAAG,CAAC,GAAG,EAAE,EAAE,YAAY,IAAI,KAAA;CAC/D,MAAM,OAAO,MACRC,+BAAAA,kBAAkB,QAAQ,MAC3B,MACE,eAAe,KAAK,GAAG,CAAC,GAAG,EAAE,EAAE,YAAY,IAC3C,KAAA;CACN,IAAI,CAAC,MAAM,OAAO;CAClB,IAAIC,+BAAAA,sBAAsB,MAAM,YAAY,QAAQ,KAAK,IAAI,CAAC,GAAG,OAAO;CACxE,IAAI,SAAS,MAAM,YAAY,QAAQ,KAAK,IAAI,CAAC,GAAG,OAAO;CAC3D,MAAM,OAAOL,+BAAAA,eAAe,MAAM,KAAK,aAAa,QAAQ,KAAK,IAAI,CAAC;CACtE,OAAO,OAAO;EAAE,SAAS,KAAK;EAAI,QAAQ,KAAK;CAAG,IAAI;EAAE,SAAS;EAAM,QAAQ;CAAW;AAC5F;;;;;;;;;AAUA,SAAgB,eAAe,SAAiB,QAA8B;CAC5E,IAAI,YAAA,YAA4B,OAAO;CACvC,IAAKM,+BAAAA,gBAAsC,SAAS,MAAM,GAAG,OAAO;CAEpE,IAAI,eAAe,IAAI,MAAM,GAAG,OAAO;CACvC,IAAIC,+BAAAA,YAAY,KAAK,MAAM,GAAG;EAC5B,IAAI,eAAe,IAAI,OAAO,KAAK,cAAc,IAAI,OAAO,GAAG,OAAO;EACtE,IAAI,eAAe,IAAI,OAAO,GAAG,OAAO;EACxC,OAAO;CACT;CACA,IAAI,WAAW,YAAY,eAAe,IAAI,OAAO,GAAG,OAAO;CAC/D,IAAI,WAAW,WAAW,cAAc,IAAI,OAAO,GAAG,OAAO;CAC7D,IAAI,WAAW,QAAQ,WAAW,IAAI,OAAO,GAAG,OAAO;CACvD,IAAI,WAAW,aAAa,eAAe,IAAI,OAAO,GAAG,OAAO;CAChE,IAAIC,+BAAAA,aAAa,KAAK,MAAM,KAAMC,+BAAAA,cAAoC,SAAS,OAAO,GACpF,OAAO;CACT,IAAI,WAAW,aAAa,OAAO;CACnC,IAAI,WAAW,YAAY,OAAO;CAClC,IAAI,WAAW,SAAS,YAAY,OAAO,OAAO;CAClD,IAAIC,+BAAAA,YAAY,KAAK,MAAM,KAAK,YAAY,YAAY,OAAO;CAC/D,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,cAAc,MAAiB,UAA2B,CAAC,GAAU;CACnF,MAAM,MAAM,WAAW,IAAI;CAC3B,MAAM,QAAQ,aAAa,IAAI;CAC/B,MAAM,UAAU,eAAe,IAAI;CACnC,MAAM,UAAU,aAAa,MAAM,QAAQ,SAAS,CAAC,CAAC;CACtD,MAAM,WAAW,SAAS,MAAM,QAAQ,YAAY,CAAC,CAAC;CAEtD,MAAM,UACJ,OAAO,SAAS,WAAW,SAAS,WAAW,UAAU,WAAA;CAE3D,MAAM,cADiB,KAAK,MAAM,YAAY,CAAC,EAAE,YAAY,KAAK,SAG/D,MAAA,cAEG,SAAS,UACP,QACC,SAAS,UAAU,UAAU,UAAA;CAKtC,MAAM,UADO,eAAe,IAAI,MAAM,WAAW,YAAY,aAG1D,gBAAA,eAAkC,eAAe,IAAI,eAAe,SAAS,WAAW,CAAC,KACtF,QACA;CACN,MAAM,eAAe,eAAe,SAAS,MAAM;CACnD,MAAM,WAAW,KAAK,MAAM,cAAc,KAAK,SAAS,YAAY;CASpE,MAAM,SAAS,CAPb,OAAO,SAAS,UACZ,qBAAqB,IAAI,YAAY,IACnCC,+BAAAA,eAAe,WACfA,+BAAAA,eAAe,WACjB,MAGwB,SAAS,YAAY,IAAI,CAAC,CAAC,QAAQ,SAAS,SAAS,IAAI;CAIvF,OAAO;EAAE;EAAS;EAAQ,eAAe;EAAc;EAAU,UAF/D,OAAO,SAAS,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI,WAAWA,+BAAAA,eAAe,WAAW;CAEP;AAC5E"}
+{"version":3,"file":"classify.cjs","names":["META_PLACEMENTS","REFERRER_SITES","SOURCE_ALIASES","CLICK_ID_CHANNELS","AD_LANDING_PAGE","REFERRERS_NOT_A_TOUCH","ANDROID_APP_HOSTS","DISPLAY_MEDIUMS","PAID_MEDIUM","EMAIL_MEDIUM","EMAIL_MEDIUMS","PUSH_MEDIUM","TOUCH_PRIORITY"],"sources":["../../src/attribution/classify.ts"],"sourcesContent":["import type { TrackTags } from '../track/types';\nimport {\n  AD_LANDING_PAGE,\n  ANDROID_APP_HOSTS,\n  CLICK_ID_CHANNELS,\n  type ChannelGroup,\n  DIRECT_CHANNEL,\n  DISPLAY_MEDIUMS,\n  EMAIL_MEDIUM,\n  EMAIL_MEDIUMS,\n  MEDIUM_NOT_SET,\n  META_PLACEMENTS,\n  NO_MEDIUM,\n  PAID_MEDIUM,\n  PUSH_MEDIUM,\n  REFERRERS_NOT_A_TOUCH,\n  REFERRER_SITES,\n  SOURCE_ALIASES,\n  TOUCH_PRIORITY,\n} from './vocabulary';\n\n/** What a session's tags say about how it arrived: the touch, as the session row stores it. */\nexport interface Touch {\n  /** The source, as GA calls it: a `Channel`, a `utm_source` outside the list, a referring host, or `(direct)`. */\n  channel: string;\n  /** How, as GA calls it: `utm_medium` as declared, else what the rule that named the channel implies; `(none)` for direct. */\n  medium: string;\n  /** GA4's default channel group of the two. */\n  channel_group: ChannelGroup;\n  /** `utm_campaign`, else what a product rule captured (a referral code); null when neither. */\n  campaign: string | null;\n  /** `TOUCH_PRIORITY` of the rule that named the channel; null for direct, which is no touch. */\n  priority: number | null;\n}\n\n/** What a product rule names, when it recognises the session; the channel group is derived. */\nexport type ProductTouch = Omit<Touch, 'channel_group'>;\n\n/**\n * A product's own rule: a landing page convention, a code in the URL. Tried after the campaign\n * rules (utm, click id, ad landing page) and before the referrer and `?ref=`, so a link shared on\n * Facebook or WhatsApp is credited to what the product recognises, not to the site it was shared\n * on — and a product whose `?ref=` carries a referral code, not a site, claims it here first.\n * Returns null when the session is not one of its.\n */\nexport type TouchRule = (tags: TrackTags) => ProductTouch | null;\n\nexport interface ClassifyOptions {\n  /**\n   * The product's own hosts, as patterns over the lower-cased referrer host: a session that\n   * starts from an internal link after the session timeout refers to them, which is navigation,\n   * not acquisition. The SDK adds the payment and sign-in providers (`REFERRERS_NOT_A_TOUCH`).\n   */\n  ownHosts?: readonly RegExp[];\n  /** The product's rules, in order; the first that names the session wins. */\n  rules?: readonly TouchRule[];\n}\n\n/** What a site names, from the referrer or `?ref=`: no campaign, and the referrer's tier. */\ntype SiteTouch = Pick<Touch, 'channel' | 'medium'>;\n\nconst metaPlacements = new Set<string>(META_PLACEMENTS);\n/** The groups no one paid for: a campaign rule landing in one of them ranks with a referrer. */\nconst ORGANIC_GROUPS = new Set<ChannelGroup>([\n  'organic_search',\n  'organic_social',\n  'organic_video',\n  'organic_ai',\n  'referral',\n]);\n/**\n * The groups a campaign rule ranks with a referrer in: the organic ones, and the messages we send\n * — email, SMS, push. They reach people we already know — often because an ad brought them — and\n * their links (a welcome mail, a trial reminder) come between that ad and the purchase, so they\n * must not take the ad's credit. With no ad in the window they still win as the latest touch.\n */\nconst REFERRER_TIER_GROUPS = new Set<ChannelGroup>([\n  ...ORGANIC_GROUPS,\n  'email',\n  'sms',\n  'mobile_push',\n]);\nconst referrerHostOf = /^https?:\\/\\/([^/:?#]+)/i;\nconst androidAppOf = /^android-app:\\/\\/([^/?#]+)/i;\nconst channelsBy = (medium: string) =>\n  new Set<string>(REFERRER_SITES.filter(([, m]) => m === medium).map(([channel]) => channel));\nconst searchChannels = channelsBy('organic');\nconst socialChannels = channelsBy('social');\nconst videoChannels = channelsBy('video');\nconst aiChannels = channelsBy('ai');\n\n/**\n * A tag as text; absent when missing, empty, or the strings a broken template writes (`undefined`,\n * `null`). A macro the ad platform did not expand (`{{campaign_name}}`, `__CAMPAIGN_NAME__`) is\n * kept as written, so the misspelt template shows in the reports and gets fixed.\n */\nfunction text(tags: TrackTags, key: string): string | null {\n  const value = tags[key];\n  if (value === undefined || value === null) return null;\n  const s = String(value);\n  return s === '' || s === 'undefined' || s === 'null' ? null : s;\n}\n\n/**\n * 1. What the campaign said: `utm_source`, with the aliases folded. It comes before the click\n * ids — unlike GA4, where a usable `gclid` always wins over the utm (Universal Analytics' \"manual\n * tagging overrides auto-tagging\" has no GA4 counterpart): a utm is written for this link by whoever placed it, while a click id\n * can be added by someone else — Meta puts `fbclid` on organic links too, and a shared or\n * forwarded ad link keeps the click id of the ad. When the two disagree, the utm is the one that\n * was right: an Instagram profile link carrying `fbclid`, a newsletter link copied from an ad.\n * The one exception is an ad-only click id of the utm's own channel, see `classifyTouch`.\n */\nfunction utmChannel(tags: TrackTags): string | null {\n  // A source with the rest of the query glued on (`email&utm_medium=promo`, `toolify/`,\n  // `x?utm_source=x`): a link built by hand or double-encoded. Keep the source.\n  const source = text(tags, 'utm_source')?.toLowerCase().split(/[?&#]/)[0]?.replace(/\\/+$/, '');\n  if (!source) return null;\n  return (SOURCE_ALIASES as Record<string, string>)[source] ?? source;\n}\n\n/**\n * 2. A click id in this page's URL — the tags never fill one from the cookie an earlier click\n * left (that is `_gcl_aw`, `_fbc`, …). Only a value counts, not the key: clients before mid-2025\n * wrote `fbclid: null` (`URLSearchParams.get` of a missing parameter) into every page's tags, and\n * reading the key alone named those sessions Meta clicks — Google ad clicks among them, as `fbclid`\n * is listed first. A platform always puts a value on its click.\n */\nfunction clickChannel(tags: TrackTags): string | null {\n  return CLICK_ID_CHANNELS.find(([key]) => text(tags, key) !== null)?.[1] ?? null;\n}\n\n/** The channel of the first click id in the tags that its platform puts on ad clicks only. */\nfunction adClickChannel(tags: TrackTags): string | null {\n  return (\n    CLICK_ID_CHANNELS.find(([key, , on]) => on === 'ads' && text(tags, key) !== null)?.[1] ?? null\n  );\n}\n\n/** 3. A landing page reserved for one channel's ads. */\nfunction landingChannel(tags: TrackTags): string | null {\n  const location = text(tags, 'page_location');\n  return location ? (AD_LANDING_PAGE.exec(location)?.[1] ?? null) : null;\n}\n\n/** 4. The product's rules, in order. */\nfunction productTouch(tags: TrackTags, rules: readonly TouchRule[]): ProductTouch | null {\n  for (const rule of rules) {\n    const touch = rule(tags);\n    if (touch) return touch;\n  }\n  return null;\n}\n\n/**\n * A referring site's host as a touch: a known search engine or social network folded to its\n * channel, any other site kept as its host, and null for a host that is no touch.\n */\nfunction siteTouch(host: string, ownHosts: readonly RegExp[]): SiteTouch | null {\n  if (REFERRERS_NOT_A_TOUCH.some((pattern) => pattern.test(host))) return null;\n  if (ownHosts.some((pattern) => pattern.test(host))) return null;\n  const site = REFERRER_SITES.find(([, , pattern]) => pattern.test(host));\n  return site ? { channel: site[0], medium: site[1] } : { channel: host, medium: 'referral' };\n}\n\n/**\n * 5. The referrer's host, read as `siteTouch`; null for no referrer. An Android app's referrer\n * (`android-app://<package>`) is read as the site it stands for (`ANDROID_APP_HOSTS`).\n */\nfunction referrer(tags: TrackTags, ownHosts: readonly RegExp[]): SiteTouch | null {\n  const url = text(tags, 'page_referrer');\n  const app = url ? androidAppOf.exec(url)?.[1]?.toLowerCase() : undefined;\n  const host = app\n    ? (ANDROID_APP_HOSTS[app] ?? app)\n    : url\n      ? referrerHostOf.exec(url)?.[1]?.toLowerCase()\n      : undefined;\n  return host ? siteTouch(host, ownHosts) : null;\n}\n\n/**\n * 6. The `ref` parameter of the landing page, when the session has no referrer at all: the\n * convention of sites that link out — Product Hunt's `?ref=producthunt`, newsletters,\n * directories, \"built with\" badges. It names the site when the browser does not: a click from a\n * mail client, an in-app browser or a page under `no-referrer`. With a referrer it is not read —\n * the referrer is where the click happened, and the `ref` only where the link was first written:\n * a search engine indexes the URL with its `?ref=`, another directory copies the link, and the\n * `ref` would credit the first site with the visit the second one sent; an internal link's\n * `?ref=header` would credit the page's own nav. A site's name (`producthunt`) is kept as the\n * channel, with the `utm_source` aliases folded; a host or URL (`producthunt.com`,\n * `https://news.ycombinator.com/`) is read as a referrer's host, so the same site lands on the\n * same channel either way. Ranks with the referrer: nobody paid for that link.\n */\nfunction refParam(tags: TrackTags, ownHosts: readonly RegExp[]): SiteTouch | null {\n  const location = text(tags, 'page_location');\n  if (!location || text(tags, 'page_referrer')) return null;\n  let value: string | null;\n  try {\n    value = new URL(location, 'https://localhost').searchParams.get('ref');\n  } catch {\n    return null;\n  }\n  // A value with the rest of the query glued on (`producthunt?utm_source=x`), as `utmChannel`\n  // keeps the source of one; a bare host loses its port and path, as the referrer's does.\n  const ref = value?.trim().toLowerCase().split(/[?&#]/)[0]?.replace(/\\/+$/, '');\n  if (!ref) return null;\n  const host =\n    referrerHostOf.exec(ref)?.[1] ?? (ref.includes('.') ? ref.split(/[/:]/)[0] : undefined);\n  if (host) return siteTouch(host, ownHosts);\n  return {\n    channel: (SOURCE_ALIASES as Record<string, string>)[ref] ?? ref,\n    medium: 'referral',\n  };\n}\n\n/**\n * GA4's default channel group of a (channel, medium) pair, with GA4's rule that the source\n * decides too: `linkedin / (not set)` is Organic Social and `email / promo` is Email, because\n * GA4 matches its site lists on the source, not only the medium. Two additions to GA4: Meta's\n * placement names as a medium are a paid Meta click (see `META_PLACEMENTS`), and the AI\n * assistants have `organic_ai`. Checked in GA4's order — paid before organic, the organic groups before\n * email, then referral, SMS and push — so a pair that fits two rules lands where GA4 would put it.\n */\nexport function channelGroupOf(channel: string, medium: string): ChannelGroup {\n  if (channel === DIRECT_CHANNEL) return 'direct';\n  if ((DISPLAY_MEDIUMS as readonly string[]).includes(medium)) return 'display';\n  // A Meta placement as the medium is a Meta ad whatever the source was tagged as.\n  if (metaPlacements.has(medium)) return 'paid_social';\n  if (PAID_MEDIUM.test(medium)) {\n    if (socialChannels.has(channel) || videoChannels.has(channel)) return 'paid_social';\n    if (searchChannels.has(channel)) return 'paid_search';\n    return 'paid_other';\n  }\n  if (medium === 'social' || socialChannels.has(channel)) return 'organic_social';\n  if (medium === 'video' || videoChannels.has(channel)) return 'organic_video';\n  if (medium === 'ai' || aiChannels.has(channel)) return 'organic_ai';\n  if (medium === 'organic' || searchChannels.has(channel)) return 'organic_search';\n  if (EMAIL_MEDIUM.test(medium) || (EMAIL_MEDIUMS as readonly string[]).includes(channel))\n    return 'email';\n  if (medium === 'affiliate') return 'affiliate';\n  if (medium === 'referral') return 'referral';\n  if (medium === 'sms' || channel === 'sms') return 'sms';\n  if (PUSH_MEDIUM.test(medium) || channel === 'firebase') return 'mobile_push';\n  return 'unassigned';\n}\n\n/**\n * Reads the tags a session arrived with (its `session_start` tags) as one touch. Run once, when\n * the session is written; the result is stored, and the views only read it.\n *\n * The rules, in order, the first that says something naming the channel: an explicit `utm_source`,\n * a click id, an ad landing page, the product's own rules, the referrer's host, the landing page's\n * `?ref=` when there is no referrer; `(direct)` when none does. `medium` is `utm_medium` as\n * declared (lower-cased), else what that rule implies: `(not set)` for a utm_source alone, `cpc`\n * for a bare click id or ad landing page, the product rule's own, `referral` for a `?ref=` site\n * name, `organic` / `social` / `video` / `referral` for a referrer (or a host in `?ref=`), `(none)`\n * for direct. An ad-only click id of the channel itself (`'ads'` in `CLICK_ID_CHANNELS`) or its ad\n * landing page makes it `cpc` when the medium was left out or puts the touch in an organic group:\n * the click was paid whatever the tag said — a Reddit ad tagged `utm_medium=social`, a ChatGPT ad\n * keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else\n * what a product rule captured — even when the utm named the channel, so a tagged referral link\n * keeps its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):\n * campaign touches, then the product's own as they declare, then the referrer and `?ref=` — except\n * that a campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,\n * `utm_medium=organic`) or email ranks with a referrer: nobody paid for that click, and it should\n * not take the credit from an ad clicked earlier in the attribution window. When a product rule\n * matched too, the stronger of the two tiers holds.\n */\nexport function classifyTouch(tags: TrackTags, options: ClassifyOptions = {}): Touch {\n  const utm = utmChannel(tags);\n  const click = clickChannel(tags);\n  const landing = landingChannel(tags);\n  const product = productTouch(tags, options.rules ?? []);\n  const ownHosts = options.ownHosts ?? [];\n  const referred = referrer(tags, ownHosts) ?? refParam(tags, ownHosts);\n\n  const channel =\n    utm ?? click ?? landing ?? product?.channel ?? referred?.channel ?? DIRECT_CHANNEL;\n  const declaredMedium = text(tags, 'utm_medium')?.toLowerCase() ?? null;\n  const namedMedium =\n    declaredMedium ??\n    (utm\n      ? MEDIUM_NOT_SET\n      : click || landing\n        ? 'cpc'\n        : (product?.medium ?? referred?.medium ?? NO_MEDIUM));\n  // What proves a paid click on this channel: an ad-only click id of it, or its ad landing page.\n  // Another channel's says nothing about this one (an ad link copied and shared under a utm of\n  // its own), and `fbclid` is on organic Meta links too, so neither counts here.\n  const paid = adClickChannel(tags) === channel || landing === channel;\n  const medium =\n    paid &&\n    (namedMedium === MEDIUM_NOT_SET || ORGANIC_GROUPS.has(channelGroupOf(channel, namedMedium)))\n      ? 'cpc'\n      : namedMedium;\n  const channelGroup = channelGroupOf(channel, medium);\n  const campaign = text(tags, 'utm_campaign') ?? product?.campaign ?? null;\n  const campaignTier =\n    utm || click || landing\n      ? REFERRER_TIER_GROUPS.has(channelGroup)\n        ? TOUCH_PRIORITY.referrer\n        : TOUCH_PRIORITY.campaign\n      : null;\n  // The stronger of the campaign rule's tier and the product rule's own: a referral link shared\n  // under `utm_source=whatsapp` is named by the utm, and still ranks as the programme declares.\n  const ranked = [campaignTier, product?.priority ?? null].filter((tier) => tier !== null);\n  const priority =\n    ranked.length > 0 ? Math.min(...ranked) : referred ? TOUCH_PRIORITY.referrer : null;\n\n  return { channel, medium, channel_group: channelGroup, campaign, priority };\n}\n"],"mappings":"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"}

package/dist/attribution/classify.d.cts

@@ -18,8 +18,9 @@ export interface Touch {
 export type ProductTouch = Omit<Touch, 'channel_group'>;
 /**
  * A product's own rule: a landing page convention, a code in the URL. Tried after the campaign
- * rules (utm, click id, ad landing page) and before the referrer, so a link shared on Facebook
- * or WhatsApp is credited to what the product recognises, not to the site it was shared on.
+ * rules (utm, click id, ad landing page) and before the referrer and `?ref=`, so a link shared on
+ * Facebook or WhatsApp is credited to what the product recognises, not to the site it was shared
+ * on — and a product whose `?ref=` carries a referral code, not a site, claims it here first.
  * Returns null when the session is not one of its.
  */
 export type TouchRule = (tags: TrackTags) => ProductTouch | null;
@@ -46,19 +47,20 @@ export declare function channelGroupOf(channel: string, medium: string): Channel
  * Reads the tags a session arrived with (its `session_start` tags) as one touch. Run once, when
  * the session is written; the result is stored, and the views only read it.
  *
- * The rules, in order, the first that says something naming the channel: an explicit
- * `utm_source`, a click id, an ad landing page, the product's own rules, the referrer's host;
- * `(direct)` when none does. `medium` is `utm_medium` as declared (lower-cased), else what that
- * rule implies: `(not set)` for a utm_source alone, `cpc` for a bare click id or ad landing page,
- * the product rule's own, `organic` / `social` / `video` / `referral` for a referrer, `(none)`
+ * The rules, in order, the first that says something naming the channel: an explicit `utm_source`,
+ * a click id, an ad landing page, the product's own rules, the referrer's host, the landing page's
+ * `?ref=` when there is no referrer; `(direct)` when none does. `medium` is `utm_medium` as
+ * declared (lower-cased), else what that rule implies: `(not set)` for a utm_source alone, `cpc`
+ * for a bare click id or ad landing page, the product rule's own, `referral` for a `?ref=` site
+ * name, `organic` / `social` / `video` / `referral` for a referrer (or a host in `?ref=`), `(none)`
  * for direct. An ad-only click id of the channel itself (`'ads'` in `CLICK_ID_CHANNELS`) or its ad
  * landing page makes it `cpc` when the medium was left out or puts the touch in an organic group:
  * the click was paid whatever the tag said — a Reddit ad tagged `utm_medium=social`, a ChatGPT ad
- * keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else what a
- * product rule captured — even when the utm named the channel, so a tagged referral link keeps
- * its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):
- * campaign touches, then the product's own as they declare, then the referrer — except that a
- * campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,
+ * keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else
+ * what a product rule captured — even when the utm named the channel, so a tagged referral link
+ * keeps its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):
+ * campaign touches, then the product's own as they declare, then the referrer and `?ref=` — except
+ * that a campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,
  * `utm_medium=organic`) or email ranks with a referrer: nobody paid for that click, and it should
  * not take the credit from an ad clicked earlier in the attribution window. When a product rule
  * matched too, the stronger of the two tiers holds.

package/dist/attribution/classify.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"classify.d.cts","names":[],"sources":["../../src/attribution/classify.ts"],"mappings":";;;;iBAsBiB;;EAEf;;EAEA;;EAEA,eAAe;;EAEf;;EAEA;;;YAIU,eAAe,KAAK;;;;;;;YAQpB,aAAa,MAAM,cAAc;iBAE5B;;;;;;EAMf,oBAAoB;;EAEpB,iBAAiB;;;;;;;;;;wBA8HH,eAAe,iBAAiB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;wBA4CjD,cAAc,MAAM,WAAW,UAAS,kBAAuB"}
+{"version":3,"file":"classify.d.cts","names":[],"sources":["../../src/attribution/classify.ts"],"mappings":";;;;iBAsBiB;;EAEf;;EAEA;;EAEA,eAAe;;EAEf;;EAEA;;;YAIU,eAAe,KAAK;;;;;;;;YASpB,aAAa,MAAM,cAAc;iBAE5B;;;;;;EAMf,oBAAoB;;EAEpB,iBAAiB;;;;;;;;;;wBAuKH,eAAe,iBAAiB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;wBA6CjD,cAAc,MAAM,WAAW,UAAS,kBAAuB"}

package/dist/attribution/classify.d.mts

@@ -18,8 +18,9 @@ export interface Touch {
 export type ProductTouch = Omit<Touch, 'channel_group'>;
 /**
  * A product's own rule: a landing page convention, a code in the URL. Tried after the campaign
- * rules (utm, click id, ad landing page) and before the referrer, so a link shared on Facebook
- * or WhatsApp is credited to what the product recognises, not to the site it was shared on.
+ * rules (utm, click id, ad landing page) and before the referrer and `?ref=`, so a link shared on
+ * Facebook or WhatsApp is credited to what the product recognises, not to the site it was shared
+ * on — and a product whose `?ref=` carries a referral code, not a site, claims it here first.
  * Returns null when the session is not one of its.
  */
 export type TouchRule = (tags: TrackTags) => ProductTouch | null;
@@ -46,19 +47,20 @@ export declare function channelGroupOf(channel: string, medium: string): Channel
  * Reads the tags a session arrived with (its `session_start` tags) as one touch. Run once, when
  * the session is written; the result is stored, and the views only read it.
  *
- * The rules, in order, the first that says something naming the channel: an explicit
- * `utm_source`, a click id, an ad landing page, the product's own rules, the referrer's host;
- * `(direct)` when none does. `medium` is `utm_medium` as declared (lower-cased), else what that
- * rule implies: `(not set)` for a utm_source alone, `cpc` for a bare click id or ad landing page,
- * the product rule's own, `organic` / `social` / `video` / `referral` for a referrer, `(none)`
+ * The rules, in order, the first that says something naming the channel: an explicit `utm_source`,
+ * a click id, an ad landing page, the product's own rules, the referrer's host, the landing page's
+ * `?ref=` when there is no referrer; `(direct)` when none does. `medium` is `utm_medium` as
+ * declared (lower-cased), else what that rule implies: `(not set)` for a utm_source alone, `cpc`
+ * for a bare click id or ad landing page, the product rule's own, `referral` for a `?ref=` site
+ * name, `organic` / `social` / `video` / `referral` for a referrer (or a host in `?ref=`), `(none)`
  * for direct. An ad-only click id of the channel itself (`'ads'` in `CLICK_ID_CHANNELS`) or its ad
  * landing page makes it `cpc` when the medium was left out or puts the touch in an organic group:
  * the click was paid whatever the tag said — a Reddit ad tagged `utm_medium=social`, a ChatGPT ad
- * keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else what a
- * product rule captured — even when the utm named the channel, so a tagged referral link keeps
- * its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):
- * campaign touches, then the product's own as they declare, then the referrer — except that a
- * campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,
+ * keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else
+ * what a product rule captured — even when the utm named the channel, so a tagged referral link
+ * keeps its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):
+ * campaign touches, then the product's own as they declare, then the referrer and `?ref=` — except
+ * that a campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,
  * `utm_medium=organic`) or email ranks with a referrer: nobody paid for that click, and it should
  * not take the credit from an ad clicked earlier in the attribution window. When a product rule
  * matched too, the stronger of the two tiers holds.

package/dist/attribution/classify.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"classify.d.mts","names":[],"sources":["../../src/attribution/classify.ts"],"mappings":";;;;iBAsBiB;;EAEf;;EAEA;;EAEA,eAAe;;EAEf;;EAEA;;;YAIU,eAAe,KAAK;;;;;;;YAQpB,aAAa,MAAM,cAAc;iBAE5B;;;;;;EAMf,oBAAoB;;EAEpB,iBAAiB;;;;;;;;;;wBA8HH,eAAe,iBAAiB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;wBA4CjD,cAAc,MAAM,WAAW,UAAS,kBAAuB"}
+{"version":3,"file":"classify.d.mts","names":[],"sources":["../../src/attribution/classify.ts"],"mappings":";;;;iBAsBiB;;EAEf;;EAEA;;EAEA,eAAe;;EAEf;;EAEA;;;YAIU,eAAe,KAAK;;;;;;;;YASpB,aAAa,MAAM,cAAc;iBAE5B;;;;;;EAMf,oBAAoB;;EAEpB,iBAAiB;;;;;;;;;;wBAuKH,eAAe,iBAAiB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;wBA6CjD,cAAc,MAAM,WAAW,UAAS,kBAAuB"}

package/dist/attribution/classify.mjs

@@ -81,15 +81,10 @@ function productTouch(tags, rules) {
 	return null;
 }
 /**
-* 5. The referrer's host: a known search engine or social network folded to its channel, any
-* other site kept as its host, and null for no referrer or one that is no touch. An Android app's
-* referrer (`android-app://<package>`) is read as the site it stands for (`ANDROID_APP_HOSTS`).
+* A referring site's host as a touch: a known search engine or social network folded to its
+* channel, any other site kept as its host, and null for a host that is no touch.
 */
-function referrer(tags, ownHosts) {
-	const url = text(tags, "page_referrer");
-	const app = url ? androidAppOf.exec(url)?.[1]?.toLowerCase() : void 0;
-	const host = app ? ANDROID_APP_HOSTS[app] ?? app : url ? referrerHostOf.exec(url)?.[1]?.toLowerCase() : void 0;
-	if (!host) return null;
+function siteTouch(host, ownHosts) {
 	if (REFERRERS_NOT_A_TOUCH.some((pattern) => pattern.test(host))) return null;
 	if (ownHosts.some((pattern) => pattern.test(host))) return null;
 	const site = REFERRER_SITES.find(([, , pattern]) => pattern.test(host));
@@ -102,6 +97,47 @@ function referrer(tags, ownHosts) {
 	};
 }
 /**
+* 5. The referrer's host, read as `siteTouch`; null for no referrer. An Android app's referrer
+* (`android-app://<package>`) is read as the site it stands for (`ANDROID_APP_HOSTS`).
+*/
+function referrer(tags, ownHosts) {
+	const url = text(tags, "page_referrer");
+	const app = url ? androidAppOf.exec(url)?.[1]?.toLowerCase() : void 0;
+	const host = app ? ANDROID_APP_HOSTS[app] ?? app : url ? referrerHostOf.exec(url)?.[1]?.toLowerCase() : void 0;
+	return host ? siteTouch(host, ownHosts) : null;
+}
+/**
+* 6. The `ref` parameter of the landing page, when the session has no referrer at all: the
+* convention of sites that link out — Product Hunt's `?ref=producthunt`, newsletters,
+* directories, "built with" badges. It names the site when the browser does not: a click from a
+* mail client, an in-app browser or a page under `no-referrer`. With a referrer it is not read —
+* the referrer is where the click happened, and the `ref` only where the link was first written:
+* a search engine indexes the URL with its `?ref=`, another directory copies the link, and the
+* `ref` would credit the first site with the visit the second one sent; an internal link's
+* `?ref=header` would credit the page's own nav. A site's name (`producthunt`) is kept as the
+* channel, with the `utm_source` aliases folded; a host or URL (`producthunt.com`,
+* `https://news.ycombinator.com/`) is read as a referrer's host, so the same site lands on the
+* same channel either way. Ranks with the referrer: nobody paid for that link.
+*/
+function refParam(tags, ownHosts) {
+	const location = text(tags, "page_location");
+	if (!location || text(tags, "page_referrer")) return null;
+	let value;
+	try {
+		value = new URL(location, "https://localhost").searchParams.get("ref");
+	} catch {
+		return null;
+	}
+	const ref = value?.trim().toLowerCase().split(/[?&#]/)[0]?.replace(/\/+$/, "");
+	if (!ref) return null;
+	const host = referrerHostOf.exec(ref)?.[1] ?? (ref.includes(".") ? ref.split(/[/:]/)[0] : void 0);
+	if (host) return siteTouch(host, ownHosts);
+	return {
+		channel: SOURCE_ALIASES[ref] ?? ref,
+		medium: "referral"
+	};
+}
+/**
 * GA4's default channel group of a (channel, medium) pair, with GA4's rule that the source
 * decides too: `linkedin / (not set)` is Organic Social and `email / promo` is Email, because
 * GA4 matches its site lists on the source, not only the medium. Two additions to GA4: Meta's
@@ -133,19 +169,20 @@ function channelGroupOf(channel, medium) {
 * Reads the tags a session arrived with (its `session_start` tags) as one touch. Run once, when
 * the session is written; the result is stored, and the views only read it.
 *
-* The rules, in order, the first that says something naming the channel: an explicit
-* `utm_source`, a click id, an ad landing page, the product's own rules, the referrer's host;
-* `(direct)` when none does. `medium` is `utm_medium` as declared (lower-cased), else what that
-* rule implies: `(not set)` for a utm_source alone, `cpc` for a bare click id or ad landing page,
-* the product rule's own, `organic` / `social` / `video` / `referral` for a referrer, `(none)`
+* The rules, in order, the first that says something naming the channel: an explicit `utm_source`,
+* a click id, an ad landing page, the product's own rules, the referrer's host, the landing page's
+* `?ref=` when there is no referrer; `(direct)` when none does. `medium` is `utm_medium` as
+* declared (lower-cased), else what that rule implies: `(not set)` for a utm_source alone, `cpc`
+* for a bare click id or ad landing page, the product rule's own, `referral` for a `?ref=` site
+* name, `organic` / `social` / `video` / `referral` for a referrer (or a host in `?ref=`), `(none)`
 * for direct. An ad-only click id of the channel itself (`'ads'` in `CLICK_ID_CHANNELS`) or its ad
 * landing page makes it `cpc` when the medium was left out or puts the touch in an organic group:
 * the click was paid whatever the tag said — a Reddit ad tagged `utm_medium=social`, a ChatGPT ad
-* keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else what a
-* product rule captured — even when the utm named the channel, so a tagged referral link keeps
-* its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):
-* campaign touches, then the product's own as they declare, then the referrer — except that a
-* campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,
+* keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else
+* what a product rule captured — even when the utm named the channel, so a tagged referral link
+* keeps its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):
+* campaign touches, then the product's own as they declare, then the referrer and `?ref=` — except
+* that a campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,
 * `utm_medium=organic`) or email ranks with a referrer: nobody paid for that click, and it should
 * not take the credit from an ad clicked earlier in the attribution window. When a product rule
 * matched too, the stronger of the two tiers holds.
@@ -155,7 +192,8 @@ function classifyTouch(tags, options = {}) {
 	const click = clickChannel(tags);
 	const landing = landingChannel(tags);
 	const product = productTouch(tags, options.rules ?? []);
-	const referred = referrer(tags, options.ownHosts ?? []);
+	const ownHosts = options.ownHosts ?? [];
+	const referred = referrer(tags, ownHosts) ?? refParam(tags, ownHosts);
 	const channel = utm ?? click ?? landing ?? product?.channel ?? referred?.channel ?? "(direct)";
 	const namedMedium = text(tags, "utm_medium")?.toLowerCase() ?? null ?? (utm ? "(not set)" : click || landing ? "cpc" : product?.medium ?? referred?.medium ?? "(none)");
 	const medium = (adClickChannel(tags) === channel || landing === channel) && (namedMedium === "(not set)" || ORGANIC_GROUPS.has(channelGroupOf(channel, namedMedium))) ? "cpc" : namedMedium;

package/dist/attribution/classify.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"classify.mjs","names":[],"sources":["../../src/attribution/classify.ts"],"sourcesContent":["import type { TrackTags } from '../track/types';\nimport {\n  AD_LANDING_PAGE,\n  ANDROID_APP_HOSTS,\n  CLICK_ID_CHANNELS,\n  type ChannelGroup,\n  DIRECT_CHANNEL,\n  DISPLAY_MEDIUMS,\n  EMAIL_MEDIUM,\n  EMAIL_MEDIUMS,\n  MEDIUM_NOT_SET,\n  META_PLACEMENTS,\n  NO_MEDIUM,\n  PAID_MEDIUM,\n  PUSH_MEDIUM,\n  REFERRERS_NOT_A_TOUCH,\n  REFERRER_SITES,\n  SOURCE_ALIASES,\n  TOUCH_PRIORITY,\n} from './vocabulary';\n\n/** What a session's tags say about how it arrived: the touch, as the session row stores it. */\nexport interface Touch {\n  /** The source, as GA calls it: a `Channel`, a `utm_source` outside the list, a referring host, or `(direct)`. */\n  channel: string;\n  /** How, as GA calls it: `utm_medium` as declared, else what the rule that named the channel implies; `(none)` for direct. */\n  medium: string;\n  /** GA4's default channel group of the two. */\n  channel_group: ChannelGroup;\n  /** `utm_campaign`, else what a product rule captured (a referral code); null when neither. */\n  campaign: string | null;\n  /** `TOUCH_PRIORITY` of the rule that named the channel; null for direct, which is no touch. */\n  priority: number | null;\n}\n\n/** What a product rule names, when it recognises the session; the channel group is derived. */\nexport type ProductTouch = Omit<Touch, 'channel_group'>;\n\n/**\n * A product's own rule: a landing page convention, a code in the URL. Tried after the campaign\n * rules (utm, click id, ad landing page) and before the referrer, so a link shared on Facebook\n * or WhatsApp is credited to what the product recognises, not to the site it was shared on.\n * Returns null when the session is not one of its.\n */\nexport type TouchRule = (tags: TrackTags) => ProductTouch | null;\n\nexport interface ClassifyOptions {\n  /**\n   * The product's own hosts, as patterns over the lower-cased referrer host: a session that\n   * starts from an internal link after the session timeout refers to them, which is navigation,\n   * not acquisition. The SDK adds the payment and sign-in providers (`REFERRERS_NOT_A_TOUCH`).\n   */\n  ownHosts?: readonly RegExp[];\n  /** The product's rules, in order; the first that names the session wins. */\n  rules?: readonly TouchRule[];\n}\n\nconst metaPlacements = new Set<string>(META_PLACEMENTS);\n/** The groups no one paid for: a campaign rule landing in one of them ranks with a referrer. */\nconst ORGANIC_GROUPS = new Set<ChannelGroup>([\n  'organic_search',\n  'organic_social',\n  'organic_video',\n  'organic_ai',\n  'referral',\n]);\n/**\n * The groups a campaign rule ranks with a referrer in: the organic ones, and the messages we send\n * — email, SMS, push. They reach people we already know — often because an ad brought them — and\n * their links (a welcome mail, a trial reminder) come between that ad and the purchase, so they\n * must not take the ad's credit. With no ad in the window they still win as the latest touch.\n */\nconst REFERRER_TIER_GROUPS = new Set<ChannelGroup>([\n  ...ORGANIC_GROUPS,\n  'email',\n  'sms',\n  'mobile_push',\n]);\nconst referrerHostOf = /^https?:\\/\\/([^/:?#]+)/i;\nconst androidAppOf = /^android-app:\\/\\/([^/?#]+)/i;\nconst channelsBy = (medium: string) =>\n  new Set<string>(REFERRER_SITES.filter(([, m]) => m === medium).map(([channel]) => channel));\nconst searchChannels = channelsBy('organic');\nconst socialChannels = channelsBy('social');\nconst videoChannels = channelsBy('video');\nconst aiChannels = channelsBy('ai');\n\n/**\n * A tag as text; absent when missing, empty, or the strings a broken template writes (`undefined`,\n * `null`). A macro the ad platform did not expand (`{{campaign_name}}`, `__CAMPAIGN_NAME__`) is\n * kept as written, so the misspelt template shows in the reports and gets fixed.\n */\nfunction text(tags: TrackTags, key: string): string | null {\n  const value = tags[key];\n  if (value === undefined || value === null) return null;\n  const s = String(value);\n  return s === '' || s === 'undefined' || s === 'null' ? null : s;\n}\n\n/**\n * 1. What the campaign said: `utm_source`, with the aliases folded. It comes before the click\n * ids — unlike GA4, where a usable `gclid` always wins over the utm (Universal Analytics' \"manual\n * tagging overrides auto-tagging\" has no GA4 counterpart): a utm is written for this link by whoever placed it, while a click id\n * can be added by someone else — Meta puts `fbclid` on organic links too, and a shared or\n * forwarded ad link keeps the click id of the ad. When the two disagree, the utm is the one that\n * was right: an Instagram profile link carrying `fbclid`, a newsletter link copied from an ad.\n * The one exception is an ad-only click id of the utm's own channel, see `classifyTouch`.\n */\nfunction utmChannel(tags: TrackTags): string | null {\n  // A source with the rest of the query glued on (`email&utm_medium=promo`, `toolify/`,\n  // `x?utm_source=x`): a link built by hand or double-encoded. Keep the source.\n  const source = text(tags, 'utm_source')?.toLowerCase().split(/[?&#]/)[0]?.replace(/\\/+$/, '');\n  if (!source) return null;\n  return (SOURCE_ALIASES as Record<string, string>)[source] ?? source;\n}\n\n/**\n * 2. A click id in this page's URL — the tags never fill one from the cookie an earlier click\n * left (that is `_gcl_aw`, `_fbc`, …). Only a value counts, not the key: clients before mid-2025\n * wrote `fbclid: null` (`URLSearchParams.get` of a missing parameter) into every page's tags, and\n * reading the key alone named those sessions Meta clicks — Google ad clicks among them, as `fbclid`\n * is listed first. A platform always puts a value on its click.\n */\nfunction clickChannel(tags: TrackTags): string | null {\n  return CLICK_ID_CHANNELS.find(([key]) => text(tags, key) !== null)?.[1] ?? null;\n}\n\n/** The channel of the first click id in the tags that its platform puts on ad clicks only. */\nfunction adClickChannel(tags: TrackTags): string | null {\n  return (\n    CLICK_ID_CHANNELS.find(([key, , on]) => on === 'ads' && text(tags, key) !== null)?.[1] ?? null\n  );\n}\n\n/** 3. A landing page reserved for one channel's ads. */\nfunction landingChannel(tags: TrackTags): string | null {\n  const location = text(tags, 'page_location');\n  return location ? (AD_LANDING_PAGE.exec(location)?.[1] ?? null) : null;\n}\n\n/** 4. The product's rules, in order. */\nfunction productTouch(tags: TrackTags, rules: readonly TouchRule[]): ProductTouch | null {\n  for (const rule of rules) {\n    const touch = rule(tags);\n    if (touch) return touch;\n  }\n  return null;\n}\n\n/**\n * 5. The referrer's host: a known search engine or social network folded to its channel, any\n * other site kept as its host, and null for no referrer or one that is no touch. An Android app's\n * referrer (`android-app://<package>`) is read as the site it stands for (`ANDROID_APP_HOSTS`).\n */\nfunction referrer(\n  tags: TrackTags,\n  ownHosts: readonly RegExp[]\n): { channel: string; medium: string } | null {\n  const url = text(tags, 'page_referrer');\n  const app = url ? androidAppOf.exec(url)?.[1]?.toLowerCase() : undefined;\n  const host = app\n    ? (ANDROID_APP_HOSTS[app] ?? app)\n    : url\n      ? referrerHostOf.exec(url)?.[1]?.toLowerCase()\n      : undefined;\n  if (!host) return null;\n  if (REFERRERS_NOT_A_TOUCH.some((pattern) => pattern.test(host))) return null;\n  if (ownHosts.some((pattern) => pattern.test(host))) return null;\n  const site = REFERRER_SITES.find(([, , pattern]) => pattern.test(host));\n  return site ? { channel: site[0], medium: site[1] } : { channel: host, medium: 'referral' };\n}\n\n/**\n * GA4's default channel group of a (channel, medium) pair, with GA4's rule that the source\n * decides too: `linkedin / (not set)` is Organic Social and `email / promo` is Email, because\n * GA4 matches its site lists on the source, not only the medium. Two additions to GA4: Meta's\n * placement names as a medium are a paid Meta click (see `META_PLACEMENTS`), and the AI\n * assistants have `organic_ai`. Checked in GA4's order — paid before organic, the organic groups before\n * email, then referral, SMS and push — so a pair that fits two rules lands where GA4 would put it.\n */\nexport function channelGroupOf(channel: string, medium: string): ChannelGroup {\n  if (channel === DIRECT_CHANNEL) return 'direct';\n  if ((DISPLAY_MEDIUMS as readonly string[]).includes(medium)) return 'display';\n  // A Meta placement as the medium is a Meta ad whatever the source was tagged as.\n  if (metaPlacements.has(medium)) return 'paid_social';\n  if (PAID_MEDIUM.test(medium)) {\n    if (socialChannels.has(channel) || videoChannels.has(channel)) return 'paid_social';\n    if (searchChannels.has(channel)) return 'paid_search';\n    return 'paid_other';\n  }\n  if (medium === 'social' || socialChannels.has(channel)) return 'organic_social';\n  if (medium === 'video' || videoChannels.has(channel)) return 'organic_video';\n  if (medium === 'ai' || aiChannels.has(channel)) return 'organic_ai';\n  if (medium === 'organic' || searchChannels.has(channel)) return 'organic_search';\n  if (EMAIL_MEDIUM.test(medium) || (EMAIL_MEDIUMS as readonly string[]).includes(channel))\n    return 'email';\n  if (medium === 'affiliate') return 'affiliate';\n  if (medium === 'referral') return 'referral';\n  if (medium === 'sms' || channel === 'sms') return 'sms';\n  if (PUSH_MEDIUM.test(medium) || channel === 'firebase') return 'mobile_push';\n  return 'unassigned';\n}\n\n/**\n * Reads the tags a session arrived with (its `session_start` tags) as one touch. Run once, when\n * the session is written; the result is stored, and the views only read it.\n *\n * The rules, in order, the first that says something naming the channel: an explicit\n * `utm_source`, a click id, an ad landing page, the product's own rules, the referrer's host;\n * `(direct)` when none does. `medium` is `utm_medium` as declared (lower-cased), else what that\n * rule implies: `(not set)` for a utm_source alone, `cpc` for a bare click id or ad landing page,\n * the product rule's own, `organic` / `social` / `video` / `referral` for a referrer, `(none)`\n * for direct. An ad-only click id of the channel itself (`'ads'` in `CLICK_ID_CHANNELS`) or its ad\n * landing page makes it `cpc` when the medium was left out or puts the touch in an organic group:\n * the click was paid whatever the tag said — a Reddit ad tagged `utm_medium=social`, a ChatGPT ad\n * keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else what a\n * product rule captured — even when the utm named the channel, so a tagged referral link keeps\n * its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):\n * campaign touches, then the product's own as they declare, then the referrer — except that a\n * campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,\n * `utm_medium=organic`) or email ranks with a referrer: nobody paid for that click, and it should\n * not take the credit from an ad clicked earlier in the attribution window. When a product rule\n * matched too, the stronger of the two tiers holds.\n */\nexport function classifyTouch(tags: TrackTags, options: ClassifyOptions = {}): Touch {\n  const utm = utmChannel(tags);\n  const click = clickChannel(tags);\n  const landing = landingChannel(tags);\n  const product = productTouch(tags, options.rules ?? []);\n  const referred = referrer(tags, options.ownHosts ?? []);\n\n  const channel =\n    utm ?? click ?? landing ?? product?.channel ?? referred?.channel ?? DIRECT_CHANNEL;\n  const declaredMedium = text(tags, 'utm_medium')?.toLowerCase() ?? null;\n  const namedMedium =\n    declaredMedium ??\n    (utm\n      ? MEDIUM_NOT_SET\n      : click || landing\n        ? 'cpc'\n        : (product?.medium ?? referred?.medium ?? NO_MEDIUM));\n  // What proves a paid click on this channel: an ad-only click id of it, or its ad landing page.\n  // Another channel's says nothing about this one (an ad link copied and shared under a utm of\n  // its own), and `fbclid` is on organic Meta links too, so neither counts here.\n  const paid = adClickChannel(tags) === channel || landing === channel;\n  const medium =\n    paid &&\n    (namedMedium === MEDIUM_NOT_SET || ORGANIC_GROUPS.has(channelGroupOf(channel, namedMedium)))\n      ? 'cpc'\n      : namedMedium;\n  const channelGroup = channelGroupOf(channel, medium);\n  const campaign = text(tags, 'utm_campaign') ?? product?.campaign ?? null;\n  const campaignTier =\n    utm || click || landing\n      ? REFERRER_TIER_GROUPS.has(channelGroup)\n        ? TOUCH_PRIORITY.referrer\n        : TOUCH_PRIORITY.campaign\n      : null;\n  // The stronger of the campaign rule's tier and the product rule's own: a referral link shared\n  // under `utm_source=whatsapp` is named by the utm, and still ranks as the programme declares.\n  const ranked = [campaignTier, product?.priority ?? null].filter((tier) => tier !== null);\n  const priority =\n    ranked.length > 0 ? Math.min(...ranked) : referred ? TOUCH_PRIORITY.referrer : null;\n\n  return { channel, medium, channel_group: channelGroup, campaign, priority };\n}\n"],"mappings":"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"}
+{"version":3,"file":"classify.mjs","names":[],"sources":["../../src/attribution/classify.ts"],"sourcesContent":["import type { TrackTags } from '../track/types';\nimport {\n  AD_LANDING_PAGE,\n  ANDROID_APP_HOSTS,\n  CLICK_ID_CHANNELS,\n  type ChannelGroup,\n  DIRECT_CHANNEL,\n  DISPLAY_MEDIUMS,\n  EMAIL_MEDIUM,\n  EMAIL_MEDIUMS,\n  MEDIUM_NOT_SET,\n  META_PLACEMENTS,\n  NO_MEDIUM,\n  PAID_MEDIUM,\n  PUSH_MEDIUM,\n  REFERRERS_NOT_A_TOUCH,\n  REFERRER_SITES,\n  SOURCE_ALIASES,\n  TOUCH_PRIORITY,\n} from './vocabulary';\n\n/** What a session's tags say about how it arrived: the touch, as the session row stores it. */\nexport interface Touch {\n  /** The source, as GA calls it: a `Channel`, a `utm_source` outside the list, a referring host, or `(direct)`. */\n  channel: string;\n  /** How, as GA calls it: `utm_medium` as declared, else what the rule that named the channel implies; `(none)` for direct. */\n  medium: string;\n  /** GA4's default channel group of the two. */\n  channel_group: ChannelGroup;\n  /** `utm_campaign`, else what a product rule captured (a referral code); null when neither. */\n  campaign: string | null;\n  /** `TOUCH_PRIORITY` of the rule that named the channel; null for direct, which is no touch. */\n  priority: number | null;\n}\n\n/** What a product rule names, when it recognises the session; the channel group is derived. */\nexport type ProductTouch = Omit<Touch, 'channel_group'>;\n\n/**\n * A product's own rule: a landing page convention, a code in the URL. Tried after the campaign\n * rules (utm, click id, ad landing page) and before the referrer and `?ref=`, so a link shared on\n * Facebook or WhatsApp is credited to what the product recognises, not to the site it was shared\n * on — and a product whose `?ref=` carries a referral code, not a site, claims it here first.\n * Returns null when the session is not one of its.\n */\nexport type TouchRule = (tags: TrackTags) => ProductTouch | null;\n\nexport interface ClassifyOptions {\n  /**\n   * The product's own hosts, as patterns over the lower-cased referrer host: a session that\n   * starts from an internal link after the session timeout refers to them, which is navigation,\n   * not acquisition. The SDK adds the payment and sign-in providers (`REFERRERS_NOT_A_TOUCH`).\n   */\n  ownHosts?: readonly RegExp[];\n  /** The product's rules, in order; the first that names the session wins. */\n  rules?: readonly TouchRule[];\n}\n\n/** What a site names, from the referrer or `?ref=`: no campaign, and the referrer's tier. */\ntype SiteTouch = Pick<Touch, 'channel' | 'medium'>;\n\nconst metaPlacements = new Set<string>(META_PLACEMENTS);\n/** The groups no one paid for: a campaign rule landing in one of them ranks with a referrer. */\nconst ORGANIC_GROUPS = new Set<ChannelGroup>([\n  'organic_search',\n  'organic_social',\n  'organic_video',\n  'organic_ai',\n  'referral',\n]);\n/**\n * The groups a campaign rule ranks with a referrer in: the organic ones, and the messages we send\n * — email, SMS, push. They reach people we already know — often because an ad brought them — and\n * their links (a welcome mail, a trial reminder) come between that ad and the purchase, so they\n * must not take the ad's credit. With no ad in the window they still win as the latest touch.\n */\nconst REFERRER_TIER_GROUPS = new Set<ChannelGroup>([\n  ...ORGANIC_GROUPS,\n  'email',\n  'sms',\n  'mobile_push',\n]);\nconst referrerHostOf = /^https?:\\/\\/([^/:?#]+)/i;\nconst androidAppOf = /^android-app:\\/\\/([^/?#]+)/i;\nconst channelsBy = (medium: string) =>\n  new Set<string>(REFERRER_SITES.filter(([, m]) => m === medium).map(([channel]) => channel));\nconst searchChannels = channelsBy('organic');\nconst socialChannels = channelsBy('social');\nconst videoChannels = channelsBy('video');\nconst aiChannels = channelsBy('ai');\n\n/**\n * A tag as text; absent when missing, empty, or the strings a broken template writes (`undefined`,\n * `null`). A macro the ad platform did not expand (`{{campaign_name}}`, `__CAMPAIGN_NAME__`) is\n * kept as written, so the misspelt template shows in the reports and gets fixed.\n */\nfunction text(tags: TrackTags, key: string): string | null {\n  const value = tags[key];\n  if (value === undefined || value === null) return null;\n  const s = String(value);\n  return s === '' || s === 'undefined' || s === 'null' ? null : s;\n}\n\n/**\n * 1. What the campaign said: `utm_source`, with the aliases folded. It comes before the click\n * ids — unlike GA4, where a usable `gclid` always wins over the utm (Universal Analytics' \"manual\n * tagging overrides auto-tagging\" has no GA4 counterpart): a utm is written for this link by whoever placed it, while a click id\n * can be added by someone else — Meta puts `fbclid` on organic links too, and a shared or\n * forwarded ad link keeps the click id of the ad. When the two disagree, the utm is the one that\n * was right: an Instagram profile link carrying `fbclid`, a newsletter link copied from an ad.\n * The one exception is an ad-only click id of the utm's own channel, see `classifyTouch`.\n */\nfunction utmChannel(tags: TrackTags): string | null {\n  // A source with the rest of the query glued on (`email&utm_medium=promo`, `toolify/`,\n  // `x?utm_source=x`): a link built by hand or double-encoded. Keep the source.\n  const source = text(tags, 'utm_source')?.toLowerCase().split(/[?&#]/)[0]?.replace(/\\/+$/, '');\n  if (!source) return null;\n  return (SOURCE_ALIASES as Record<string, string>)[source] ?? source;\n}\n\n/**\n * 2. A click id in this page's URL — the tags never fill one from the cookie an earlier click\n * left (that is `_gcl_aw`, `_fbc`, …). Only a value counts, not the key: clients before mid-2025\n * wrote `fbclid: null` (`URLSearchParams.get` of a missing parameter) into every page's tags, and\n * reading the key alone named those sessions Meta clicks — Google ad clicks among them, as `fbclid`\n * is listed first. A platform always puts a value on its click.\n */\nfunction clickChannel(tags: TrackTags): string | null {\n  return CLICK_ID_CHANNELS.find(([key]) => text(tags, key) !== null)?.[1] ?? null;\n}\n\n/** The channel of the first click id in the tags that its platform puts on ad clicks only. */\nfunction adClickChannel(tags: TrackTags): string | null {\n  return (\n    CLICK_ID_CHANNELS.find(([key, , on]) => on === 'ads' && text(tags, key) !== null)?.[1] ?? null\n  );\n}\n\n/** 3. A landing page reserved for one channel's ads. */\nfunction landingChannel(tags: TrackTags): string | null {\n  const location = text(tags, 'page_location');\n  return location ? (AD_LANDING_PAGE.exec(location)?.[1] ?? null) : null;\n}\n\n/** 4. The product's rules, in order. */\nfunction productTouch(tags: TrackTags, rules: readonly TouchRule[]): ProductTouch | null {\n  for (const rule of rules) {\n    const touch = rule(tags);\n    if (touch) return touch;\n  }\n  return null;\n}\n\n/**\n * A referring site's host as a touch: a known search engine or social network folded to its\n * channel, any other site kept as its host, and null for a host that is no touch.\n */\nfunction siteTouch(host: string, ownHosts: readonly RegExp[]): SiteTouch | null {\n  if (REFERRERS_NOT_A_TOUCH.some((pattern) => pattern.test(host))) return null;\n  if (ownHosts.some((pattern) => pattern.test(host))) return null;\n  const site = REFERRER_SITES.find(([, , pattern]) => pattern.test(host));\n  return site ? { channel: site[0], medium: site[1] } : { channel: host, medium: 'referral' };\n}\n\n/**\n * 5. The referrer's host, read as `siteTouch`; null for no referrer. An Android app's referrer\n * (`android-app://<package>`) is read as the site it stands for (`ANDROID_APP_HOSTS`).\n */\nfunction referrer(tags: TrackTags, ownHosts: readonly RegExp[]): SiteTouch | null {\n  const url = text(tags, 'page_referrer');\n  const app = url ? androidAppOf.exec(url)?.[1]?.toLowerCase() : undefined;\n  const host = app\n    ? (ANDROID_APP_HOSTS[app] ?? app)\n    : url\n      ? referrerHostOf.exec(url)?.[1]?.toLowerCase()\n      : undefined;\n  return host ? siteTouch(host, ownHosts) : null;\n}\n\n/**\n * 6. The `ref` parameter of the landing page, when the session has no referrer at all: the\n * convention of sites that link out — Product Hunt's `?ref=producthunt`, newsletters,\n * directories, \"built with\" badges. It names the site when the browser does not: a click from a\n * mail client, an in-app browser or a page under `no-referrer`. With a referrer it is not read —\n * the referrer is where the click happened, and the `ref` only where the link was first written:\n * a search engine indexes the URL with its `?ref=`, another directory copies the link, and the\n * `ref` would credit the first site with the visit the second one sent; an internal link's\n * `?ref=header` would credit the page's own nav. A site's name (`producthunt`) is kept as the\n * channel, with the `utm_source` aliases folded; a host or URL (`producthunt.com`,\n * `https://news.ycombinator.com/`) is read as a referrer's host, so the same site lands on the\n * same channel either way. Ranks with the referrer: nobody paid for that link.\n */\nfunction refParam(tags: TrackTags, ownHosts: readonly RegExp[]): SiteTouch | null {\n  const location = text(tags, 'page_location');\n  if (!location || text(tags, 'page_referrer')) return null;\n  let value: string | null;\n  try {\n    value = new URL(location, 'https://localhost').searchParams.get('ref');\n  } catch {\n    return null;\n  }\n  // A value with the rest of the query glued on (`producthunt?utm_source=x`), as `utmChannel`\n  // keeps the source of one; a bare host loses its port and path, as the referrer's does.\n  const ref = value?.trim().toLowerCase().split(/[?&#]/)[0]?.replace(/\\/+$/, '');\n  if (!ref) return null;\n  const host =\n    referrerHostOf.exec(ref)?.[1] ?? (ref.includes('.') ? ref.split(/[/:]/)[0] : undefined);\n  if (host) return siteTouch(host, ownHosts);\n  return {\n    channel: (SOURCE_ALIASES as Record<string, string>)[ref] ?? ref,\n    medium: 'referral',\n  };\n}\n\n/**\n * GA4's default channel group of a (channel, medium) pair, with GA4's rule that the source\n * decides too: `linkedin / (not set)` is Organic Social and `email / promo` is Email, because\n * GA4 matches its site lists on the source, not only the medium. Two additions to GA4: Meta's\n * placement names as a medium are a paid Meta click (see `META_PLACEMENTS`), and the AI\n * assistants have `organic_ai`. Checked in GA4's order — paid before organic, the organic groups before\n * email, then referral, SMS and push — so a pair that fits two rules lands where GA4 would put it.\n */\nexport function channelGroupOf(channel: string, medium: string): ChannelGroup {\n  if (channel === DIRECT_CHANNEL) return 'direct';\n  if ((DISPLAY_MEDIUMS as readonly string[]).includes(medium)) return 'display';\n  // A Meta placement as the medium is a Meta ad whatever the source was tagged as.\n  if (metaPlacements.has(medium)) return 'paid_social';\n  if (PAID_MEDIUM.test(medium)) {\n    if (socialChannels.has(channel) || videoChannels.has(channel)) return 'paid_social';\n    if (searchChannels.has(channel)) return 'paid_search';\n    return 'paid_other';\n  }\n  if (medium === 'social' || socialChannels.has(channel)) return 'organic_social';\n  if (medium === 'video' || videoChannels.has(channel)) return 'organic_video';\n  if (medium === 'ai' || aiChannels.has(channel)) return 'organic_ai';\n  if (medium === 'organic' || searchChannels.has(channel)) return 'organic_search';\n  if (EMAIL_MEDIUM.test(medium) || (EMAIL_MEDIUMS as readonly string[]).includes(channel))\n    return 'email';\n  if (medium === 'affiliate') return 'affiliate';\n  if (medium === 'referral') return 'referral';\n  if (medium === 'sms' || channel === 'sms') return 'sms';\n  if (PUSH_MEDIUM.test(medium) || channel === 'firebase') return 'mobile_push';\n  return 'unassigned';\n}\n\n/**\n * Reads the tags a session arrived with (its `session_start` tags) as one touch. Run once, when\n * the session is written; the result is stored, and the views only read it.\n *\n * The rules, in order, the first that says something naming the channel: an explicit `utm_source`,\n * a click id, an ad landing page, the product's own rules, the referrer's host, the landing page's\n * `?ref=` when there is no referrer; `(direct)` when none does. `medium` is `utm_medium` as\n * declared (lower-cased), else what that rule implies: `(not set)` for a utm_source alone, `cpc`\n * for a bare click id or ad landing page, the product rule's own, `referral` for a `?ref=` site\n * name, `organic` / `social` / `video` / `referral` for a referrer (or a host in `?ref=`), `(none)`\n * for direct. An ad-only click id of the channel itself (`'ads'` in `CLICK_ID_CHANNELS`) or its ad\n * landing page makes it `cpc` when the medium was left out or puts the touch in an organic group:\n * the click was paid whatever the tag said — a Reddit ad tagged `utm_medium=social`, a ChatGPT ad\n * keeping the `utm_source=chatgpt.com` of its organic links. `campaign` is `utm_campaign`, else\n * what a product rule captured — even when the utm named the channel, so a tagged referral link\n * keeps its code. `priority` is the tier of the rule that named the channel (`TOUCH_PRIORITY`):\n * campaign touches, then the product's own as they declare, then the referrer and `?ref=` — except\n * that a campaign rule whose touch lands in an organic group, referral (`utm_source=chatgpt.com`,\n * `utm_medium=organic`) or email ranks with a referrer: nobody paid for that click, and it should\n * not take the credit from an ad clicked earlier in the attribution window. When a product rule\n * matched too, the stronger of the two tiers holds.\n */\nexport function classifyTouch(tags: TrackTags, options: ClassifyOptions = {}): Touch {\n  const utm = utmChannel(tags);\n  const click = clickChannel(tags);\n  const landing = landingChannel(tags);\n  const product = productTouch(tags, options.rules ?? []);\n  const ownHosts = options.ownHosts ?? [];\n  const referred = referrer(tags, ownHosts) ?? refParam(tags, ownHosts);\n\n  const channel =\n    utm ?? click ?? landing ?? product?.channel ?? referred?.channel ?? DIRECT_CHANNEL;\n  const declaredMedium = text(tags, 'utm_medium')?.toLowerCase() ?? null;\n  const namedMedium =\n    declaredMedium ??\n    (utm\n      ? MEDIUM_NOT_SET\n      : click || landing\n        ? 'cpc'\n        : (product?.medium ?? referred?.medium ?? NO_MEDIUM));\n  // What proves a paid click on this channel: an ad-only click id of it, or its ad landing page.\n  // Another channel's says nothing about this one (an ad link copied and shared under a utm of\n  // its own), and `fbclid` is on organic Meta links too, so neither counts here.\n  const paid = adClickChannel(tags) === channel || landing === channel;\n  const medium =\n    paid &&\n    (namedMedium === MEDIUM_NOT_SET || ORGANIC_GROUPS.has(channelGroupOf(channel, namedMedium)))\n      ? 'cpc'\n      : namedMedium;\n  const channelGroup = channelGroupOf(channel, medium);\n  const campaign = text(tags, 'utm_campaign') ?? product?.campaign ?? null;\n  const campaignTier =\n    utm || click || landing\n      ? REFERRER_TIER_GROUPS.has(channelGroup)\n        ? TOUCH_PRIORITY.referrer\n        : TOUCH_PRIORITY.campaign\n      : null;\n  // The stronger of the campaign rule's tier and the product rule's own: a referral link shared\n  // under `utm_source=whatsapp` is named by the utm, and still ranks as the programme declares.\n  const ranked = [campaignTier, product?.priority ?? null].filter((tier) => tier !== null);\n  const priority =\n    ranked.length > 0 ? Math.min(...ranked) : referred ? TOUCH_PRIORITY.referrer : null;\n\n  return { channel, medium, channel_group: channelGroup, campaign, priority };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shware/analytics",
-  "version": "11.9.0",
+  "version": "11.11.0",
   "private": false,
   "repository": {
     "type": "git",