# @happyvertical/smrt-marketing 中文文档

规范地址：https://npmcn.com/package/%40happyvertical/smrt-marketing/

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:56:37.111Z
中文译文更新时间：2026-11-17T10:28:26.040Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40happyvertical/smrt-marketing
原文对照：https://npmcn.com/package/%40happyvertical/smrt-marketing/?lang=original
项目主页：https://github.com/happyvertical/smrt#readme
源码仓库：https://github.com/happyvertical/smrt

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：495 kB，74 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：svelte ^5\.57\.0
- 首次发布：2026-07-14T21:57:14.281Z
- 最新版本发布：2026-11-17T07:56:36.346Z
- 近 30 天下载量：14234（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：279（近 12 个月 279 个）

## 中文简介

跨渠道的竞选协调、不可改变的业绩证据、预算进度以及SMRT可重复使用的Svelte营销表面

## 安装

```sh
npm install @happyvertical/smrt-marketing
```

也可以使用：`pnpm add @happyvertical/smrt-marketing`、`yarn add @happyvertical/smrt-marketing`、`bun add @happyvertical/smrt-marketing`

## README

# @happyvertical/ smrt- 市场营销

跨频道运动模型、不可改变的性能快照、计算 s-m-r-t的可重用Svelte营销表面.

```bash
pnpm add @happyvertical/smrt-marketing
```

```ts
import {
  BudgetPacingService,
  CampaignChannelCollection,
  CampaignCollection,
  MetricIngestionService,
} from '@happyvertical/smrt-marketing';

const campaigns = await CampaignCollection.create({ db });
const channels = await CampaignChannelCollection.create({ db });
const campaign = await campaigns.create({
  tenantId,
  customerId,
  campaignKey: 'summer-demand-2026',
  name: 'Summer demand 2026',
  objective: 'demand_generation',
  budgetCents: 200_000,
  currency: 'CAD',
});
if (!campaign.id) throw new Error('Campaign did not persist');

const adGroup = await channels.create({
  tenantId,
  campaignId: campaign.id,
  channelKind: 'ad_group',
  channelRef: 'ad-group-42',
  allocatedBudgetCents: 150_000,
});
if (!adGroup.id) throw new Error('Campaign channel did not persist');

const ingestion = await MetricIngestionService.create({ db });
await ingestion.ingest({
  tenantId,
  campaignId: campaign.id,
  campaignChannelId: adGroup.id,
  periodStart: new Date('2026-07-01T00:00:00Z'),
  periodEnd: new Date('2026-07-01T23:59:59Z'),
  spendCents: 12_500,
  impressions: 25_000,
  clicks: 800,
  conversions: 35,
  leads: 20,
  source: 'ad-platform',
  // Unique per tenant: (tenant_id, dedupe_key). A replay by the same owner
  // returns the original snapshot unchanged.
  dedupeKey: 'summer-demand-2026:ad-group-42:2026-07-01',
});

// Channel-scoped evidence is accepted only when the channel belongs to the
// supplied campaign. Reporting periods are required valid date-like values.

const pacing = await BudgetPacingService.create({ db });
console.log(await pacing.getCampaignPacing(campaign.id));
```

## 客户范围运动读取

`Campaign.customerId` 是本地的UUID关系 `@happyvertical/smrt-commerce:Customer`运动及其客户必须 完全相同的租户, 顾客范围阅读要求租户 明确(`null` 选择全球/全球范围)。 相关运动储蓄 验证并持续一项交易;客户范围为验证和 在一个交易中查询。 客户失踪和交叉租户失败 `CampaignCustomerScopeError` 但不透露发生什么情况.

```ts
const firstPage = await campaigns.listByCustomer(tenantId, customerId, {
  limit: 50,
});
const secondPage = firstPage.nextCursor
  ? await campaigns.listByCustomer(tenantId, customerId, {
      limit: 50,
      after: firstPage.nextCursor,
    })
  : null;

const summaries = await campaigns.summarizeByCustomers(tenantId, customerIds);
// [{ customerId, totalCount, activeCount, latestStartAt }]

const reporting = await campaigns.listReportingByCustomer(
  tenantId,
  customerId,
  {
    limit: 50,
    after: firstPage.nextCursor ?? undefined,
    at: new Date('2026-08-15T00:00:00Z'),
  },
);
// reporting.items keeps the same newest-first page order. Every item contains:
// { campaign, channelCount, channelMix, metricTotals, pacing }
```

页数、报告页数和摘要批次上限为100个项目并拒绝 更大的投入。 贴子是最新的第一 `startAt`,然后UUID;运动 没有开始时间 遵循预定的运动. `listReportingByCustomer()` 验证客户范围并在一次交易中读取页面,然后执行 一个被分组的频道读取,一个被分组的不可改变证据读取,无论 页面大小. `metricTotals` 使用与 `BudgetPacingService`:每个具体时期,一次竞选活动将取代其 频道快照, 而频道只保留时段 . `pacing` 因此为 等值为 `getCampaignPacing()` 没有每个阵营的回调或懒惰 负载。 摘要解析同样使用受约束的分组查询,而不是 装入租户活动或每个客户发出一个查询.

### 移动基于元数据的协会

1.  应用生成的添加无效本地- UUID 的图案迁移 `campaigns.customer_id` 编辑 `(tenant_id, customer_id, start_at, id)` 指数.
2.  在操作员拥有的数据迁移中 提取旧的元数据客户代号, 证实它存在于商业中 并且完全一样 `tenant_id`,则 写入 `customer_id`。停止查找缺失、畸形或不匹配的值.
3.  通过 `listByCustomer()` 或者说 `summarizeByCustomers()`,然后更新消费者使用这些API.
4.  校验后删除旧的元数据密钥 。 市场从来没有读过 兼容性回落,所以没有全租户的JSON或原始SQL路径 保持同步.

从 `@happyvertical/smrt-marketing/svelte`。 。 。 . 它们具有展示性,并接受平面视图模型;消费者仍留在 控制取取和变异.

见 [一般事务人员(其他职等)](https://npmcn.com/package/%40happyvertical/smrt-marketing/AGENTS.md) 寿命周期、证据和包件边界 变化无常.

## 常见问题

### @happyvertical/smrt-marketing 是什么？

跨渠道的竞选协调、不可改变的业绩证据、预算进度以及SMRT可重复使用的Svelte营销表面

### 如何安装 @happyvertical/smrt-marketing？

在项目目录运行 npm install @happyvertical/smrt-marketing，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：svelte（^5\.57\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @happyvertical/smrt-marketing 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @happyvertical/smrt-marketing 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @happyvertical/smrt-marketing 可以商用吗？

@happyvertical/smrt-marketing 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @happyvertical/smrt-marketing 的下载量有多少？

根据 npm 官方下载统计，@happyvertical/smrt-marketing 在 2026/10/17 – 2026/11/15 这 30 天内被下载 14,234 次，日均约 474 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @happyvertical/smrt-marketing 还在维护吗？

最新版本 0\.62\.1 发布于 2026/11/17（今天）；至今共发布 279 个版本，其中过去 12 个月发布了 279 个；首次发布于 2026/07/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

