# @aglyn/plugins-marketing 中文文档

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

版本：1\.19\.0
npm 元数据更新时间：2026-11-07T13:59:32.279Z
中文译文更新时间：2026-11-05T23:05:19.147Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：4.7 MB，372 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：16 个
- peer 依赖：next ^16\.3\.3，react ^19\.2\.8，firebase ^13\.0\.0，@mui/material ^9\.3\.1，firebase-admin ^14\.3\.0，@mui/x-data-grid ^9\.12\.0
- 首次发布：2026-09-20T23:53:34.983Z
- 最新版本发布：2026-11-07T13:59:31.959Z
- 近 30 天下载量：9944（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：162（近 12 个月 162 个）

## 中文简介

Aglyn的市场营销插件:公告栏和弹出(重叠),A/B实验,以及电子邮件活动,由管理它们的控制台部分,运行时间在已公布的网站上显示,以及两者背后的服务器路线. 安装它,如果yo

## 安装

```sh
npm install @aglyn/plugins-marketing
```

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

## README

# @aglyn/plugins-市场营销

Aglyn的市场营销插件:公告栏和弹出(重叠),A/B实验,以及电子邮件活动,由管理它们的控制台部分,运行时间在已公布的网站上显示,以及两者背后的服务器路线. 如果您运行 Aglyn 控制台和租户运行时间并想要这些功能, 请安装它; 它是一个第一党的插件, 不是一个独立的库 .

> 从Aglyn monorepo出版到npm. 随后的版本 [语义版本](https://semver.org/)。 。 。 .

## 安装

```
npm install @aglyn/plugins-marketing
```

同伴依赖性 : `react`, (中文(简体) ), `next`, (中文(简体) ), `@mui/material`, (中文(简体) ), `@mui/x-data-grid`, (中文(简体) ), `firebase`,以及 `firebase-admin` 用于服务器条目.

## 里面有什么东西

插件宣布四个注册员在 `plugins.config.json`外加一个 `site` 模块,这样一个已出版的页面就可以单独装入网站的一半.

**在一个公开的网站上** (单位:千美元)`registerMarketingPlugin`,则 `site` 登记员,出口自 `@aglyn/plugins-marketing/site`) (中文(简体) ). 它登记了一个网站运行时间, `marketing-site-runtime`,与 `registerSiteRuntime`。运行时间不是一个画布元素:租户页面使其通用化,它会绘制活跃的公告条和弹出条,应用实验变体,并从服务器丰富者所写的数据运行页面的客户端自动化. 在编辑器的"预览"中,在没有浓缩器运行的地方,它通过延迟导入重建客户端的数据.

**分析标记** (单位:千美元)`analyticsProvider`从 `@aglyn/plugins-marketing/analytics-provider`) (中文(简体) ). 核心分析提供者合同背后的Google标签适配器:Google分析师4对和Google标签管理员对一对在其分析环境中的站点配置(A`gaMeasurementId`, (中文(简体) ), `gtmContainerId`),在每种模式前面默认使用“同意模式”; 居民的Google标签是如何被告知访客的答案被改变的(该标签是: `ga-disable-<id>` 旗帜和同意 `update`以及一个事件是如何达到它的。 已宣布为 `analyticsProvider` 内 `plugins.config.json`,因此核心知道哪些设置可以不加载就配置标签,而只能由已发布的页面加载,该页面的站点配置一个,并由控制台加载,它自己的标签是同意控制的答复.

**控制台** (单位:千美元)`registerMarketingConsole`,则 `console` 登记员:

-   A 类 `Marketing` 导航项目于 `/marketing` 包括概览、运动、转换、重叠和A/B测试。 每节为路由;页面为码分.
-   组织一级的同一页, `/[orgSlug]/marketing`,在 `orgNavItems` 与站台部分按站台顺序排列. 运动及其寄信属于本组织(第12条)`orgs/{orgId}/emailCampaigns`, (中文(简体) ), `orgs/{orgId}/campaigns`: 兽人中心站列出每个站点,在每个站点或选定的站点进行活动(`visibleTo`并询问在写邮件之前发送了哪个网站的电子邮件;一个网站的中枢列出了在该网站上开展的运动。 重叠,A/B测试和转换是每个站点的,因此,Org中枢每个站点读取并被限定: 概览将矿石发送和每个站点的重叠和测试数字汇总为服务器总数,以表示一个上限站点的数量; 重叠和A/B测试列表 每一个站点,一个站点的一页,切换一个上上下上下下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下上下下下下下下下下下下下下下上下下下下下下下下下下下下下下下下下下下下下下上下下下下下下下下下下下下下上下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下下 重叠和A/B测试在Org部分会标出他们的计划旗,因此一个没有计划的组织每个站点不会读出任何内容. 两个级别共同分担 `release_marketing` 旗帜。 该组织的信息是它的电子邮件页面 `/[orgSlug]/marketing/emails/…` 地址重定向到那里(`apps/console/next.config.js`) (中文(简体) ).
-   运动结束。 该插件拥有竞选作曲,测试发送,调度,报告和收件人. 个人信件在电子邮件页面上列出,但该页属于电子邮件插件,该插件主机为 `emailMessages` 区域;此插件将填充信件列表,一个信件的页面及其作曲者。 也充满了 `emailTemplateReport` (从模板中创建的信号)和 `emailTemplateRecipients` (谁收到他们). 运动的模型——它的容器,一个发送的报告,消息记录和一个设计的报告——就是这个插件的(A`src/lib/model/`);每个批量发送者除以的速率数学是 `@aglyn/shared-ui-email-campaigns`。 。 。 .
-   其他主机插槽中的部件:站点仪表板上"最后的竞选"卡(英语:`hostDashboard`),收件箱中的竞选卡(`inboxCampaigns`),记录页面上的竞选归属(`crmRecordAttribution`, (中文(简体) ), `inboxRecordAttribution`)),并网站的分科实验,向标本员互动科报告`besignerInteractions`),它用它的实验标记一个元素并开始一个页面元素的草稿.
-   区域此插件主机用于其他要填充的插件, 注册到 `registerPluginZone`:A/B测试卡上2个(除变体外,并低于一个测试结果),以及竞选作曲和信件页面中5个赤色区域,其中任意一个插件保存邮件本身:主题拾取器,主题选项,添加-a-sender编辑器,设计创造者和发送-设计预览. 重叠部分还有两个裸区: `hostOverlays`,除新栏和新弹出外,其部件手向列表推荐副本,该列表写上封面关闭 `overlayEditor`,在覆盖编辑器的字段中,其部件填充了未保存的字段。 一个赤裸的 `hostCampaigns` creative Campaign在“运动”部分、一个网站或该组织的;它的部件是交给网站的(或者,在该组织的枢纽上,一个活动可以放在网站),没有通过清单写作。 一个赤裸的 `marketingInsights` 字段位于转换部分和竞选报告的标题;其部件交给了网站,数字是一个站点,只通过插件注册的图读取器读取(`marketing.campaigns`, (中文(简体) ), `marketing.experiments`, (中文(简体) ), `marketing.conversions`, (中文(简体) ), `marketing.revenue`) (中文(简体) ).
-   记录路线 `campaign`,在网站和组织层面,因此另一个插件可以链接到一个运动而不知道这个插件的URL.
-   记录列表来源 `overlay` (单位:千美元)`plugin-record-lists`:一个站点的公告栏和弹出,命名为另一个插件的拾取器——自动化编辑器"Show overlay"步骤——在不读这个插件的收藏的情况下列出.

**服务器**从 `@aglyn/plugins-marketing/server`数字 :

-   `registerMarketingApi` (单位:千美元) `tenantApi` 登记员: `experiments/track` 信标,该信标对运行中的实验进行曝光和转换进行计算,并能够完成符合自动胜规则的测试,以及一个网站页面更丰富(`registerSitePageEnricher`),将叠加,自动化和实验添加到一页的数据.
-   从它的服务器声明,网站收集器 `overlay` 信标( a)`registerPluginSiteBeacon`:每起栏和弹出事件,站点运行时间报告被算入站点的日文文档和上覆自有的柜台,取自收藏者主机和被锁的出站门后.
-   从其服务器声明来看,该平台的转换债权人(`registerPluginConversionCreditor`, (中文(简体) ), `plugin-conversion-credit`:每个产生结果的门——表格提交,预订,会员注册,通讯选择录入,联系人和领跑录制系统文件,命令及其退款,以及序列邮件导致的结果——问其访客从哪里来,以及哪些活动获得信用. 它以最后的触摸方式在访客的UTM标签和他们点击的竞选邮件上加入来回答`server/campaign-conversion-attribution.ts`),订单收入相加(`server/email-revenue-attribution.ts`,),每个站点点击的触碰保留在该人的送达文件上(`server/email-campaign-touch.ts`),在一次运动中计算出的顺序结果,以及个人对全部的去除.
-   从它的服务器声明中,发送点算网站未订阅的页面显示接收者何时从活动发送的邮件中离开(`registerPluginSendTally`, (中文(简体) ), `plugin-send-tallies`这取决于发送.
-   从它的服务器声明 `emailSend` 记录索引(`plugin-record-index`:组织发送,命名,CRM将竞选邮件命名在一个人的时长上.
-   `registerMarketingConsoleApi` (单位:千美元) `consoleApi` 登记员: `campaigns/send`, (中文(简体) ), `campaigns/manage`, (中文(简体) ), `campaigns/recipients`, (中文(简体) ), `campaigns/process-scheduled`, (中文(简体) ), `lists/materialize`,以及传送活动网点 `email/events`它还对核心资源草案的起草者进行了登记 `campaign`, (中文(简体) ), `overlay` (已注销)和 `experiment` (书面停止,其变体为草稿)——AI建立能力 `overlay` 财务报告和审定财务报表 `experiment` 最后两个名字(`server/marketing-ai-capabilities.ts`),以及运动、实验、转换和收入结果的数字读者.

**从 `.`**

-   `registerMarketingConsole`, (中文(简体) ), `registerMarketingPlugin`, (中文(简体) ), `BUNDLE_ID`。 。 。 .
-   重叠 : `HostOverlay`, (中文(简体) ), `resolveActiveOverlays`, (中文(简体) ), `overlayMatchesPath`, (中文(简体) ), `overlayActiveAt`, (中文(简体) ), `overlayStatus`, (中文(简体) ), `compareOverlayPrecedence`, (中文(简体) ), `popupSuppressed`。 。 。 .
-   实验: `HostExperiment`, (中文(简体) ), `ExperimentVariant`, (中文(简体) ), `assignExperimentVariant`, (中文(简体) ), `validateExperiment`, (中文(简体) ), `compareVariants`, (中文(简体) ), `evaluateAutoWinner`, (中文(简体) ), `experimentResultRows`, (中文(简体) ), `describeVariantComparison`。 。 。 .
-   工地合同类型`AnnouncementBarData`, (中文(简体) ), `PopupData`, (中文(简体) ), `ScreenExperiment`, (中文(简体) ), `ClientAutomation`, (中文(简体) ), `compileClientAutomations`,以及运动的帮助者(`campaignFormsRollup`, (中文(简体) ), `campaignFormTotals`) (中文(简体) ).

## 使用量

插件通过 Aglyn 的插件管理器加载: 生成的加载器会导入包, 并调用在 `plugins.config.json`,而一个已出版的页面只装入网站运行该功能的地方的一半。 启动时, 有线插件用手拨打一次的应用程序 :

```ts
// published site, client side: the site half alone
import { registerMarketingPlugin } from '@aglyn/plugins-marketing/site'
registerMarketingPlugin()

// console, client side
import { registerMarketingConsole } from '@aglyn/plugins-marketing'
registerMarketingConsole()

// server side: tenant runtime and console
import {
  registerMarketingApi,
  registerMarketingConsoleApi,
} from '@aglyn/plugins-marketing/server'
```

从网站导入一半 `./site`,而不是从根:根条目还载有控制台登记员及其页面.

## 怎样才合适

一个插件软件包( E)`scope:plugin`) (中文(简体) ). 取决于核心`@aglyn/aglyn`(a) 租户包(`@aglyn/tenant-runtime`, (中文(简体) ), `@aglyn/tenant-data-admin`, (中文(简体) ), `@aglyn/tenant-feature-instance`)和通用软件 `@aglyn/shared-*` 软件包。 它没有导入其他插件 。 它与电子邮件,CRM,Inbox,商业和AI插件共享的一切通过核心接合:控制台区和插槽,记录路线,资源草稿和数字阅读器. 核心从未导入此套件 .

## 许可证

阿帕奇2.0 (英语). 资料来源: [https://github.com/aglyn/aglyn/tree/main/libs/plugins/市场营销](https://github.com/aglyn/aglyn/tree/main/libs/plugins/marketing)

## 常见问题

### @aglyn/plugins-marketing 是什么？

Aglyn的市场营销插件:公告栏和弹出\(重叠\),A/B实验,以及电子邮件活动,由管理它们的控制台部分,运行时间在已公布的网站上显示,以及两者背后的服务器路线\. 安装它,如果yo

### 如何安装 @aglyn/plugins-marketing？

在项目目录运行 npm install @aglyn/plugins-marketing，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：next（^16\.3\.3）、react（^19\.2\.8）、firebase（^13\.0\.0）、@mui/material（^9\.3\.1）、firebase-admin（^14\.3\.0）、@mui/x-data-grid（^9\.12\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aglyn/plugins-marketing 支持 TypeScript 吗？

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

### @aglyn/plugins-marketing 支持 ESM 还是 CommonJS？

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

### @aglyn/plugins-marketing 可以商用吗？

@aglyn/plugins-marketing 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aglyn/plugins-marketing 的下载量有多少？

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

### @aglyn/plugins-marketing 还在维护吗？

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