# @fayz-ai/plugin-marketing 中文文档

规范地址：https://npmcn.com/package/%40fayz-ai/plugin-marketing/

版本：0\.14\.13
npm 元数据更新时间：2026-11-11T14:53:35.237Z
中文译文更新时间：2026-11-14T12:10:13.059Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fayz-ai/plugin-marketing
原文对照：https://npmcn.com/package/%40fayz-ai/plugin-marketing/?lang=original

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

- 包体积（解压后）：1.3 MB，129 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，zustand ^4\.5\.0 \|\| ^5\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0，lucide-react \>=0\.400\.0 \<1\.0\.0
- 首次发布：2026-06-17T23:02:14.473Z
- 最新版本发布：2026-11-11T14:53:34.845Z
- 近 30 天下载量：8950（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：98（近 12 个月 98 个）

## 中文简介

Fayz SDK — 营销活动和广播插件

## 安装

```sh
npm install @fayz-ai/plugin-marketing
```

也可以使用：`pnpm add @fayz-ai/plugin-marketing`、`yarn add @fayz-ai/plugin-marketing`、`bun add @fayz-ai/plugin-marketing`

## README

# @fayz-ai/插图营销

> 一个收购和转换引擎——每个通道,每个垂直.

[![npm](https://img.shields.io/npm/v/@fayz-ai/plugin-marketing.svg)](https://www.npmjs.com/package/@fayz-ai/plugin-marketing) [![license](https://img.shields.io/npm/l/@fayz-ai/plugin-marketing.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)

**状态 :** β-前1.0 (中文(简体) ). 核心表面稳定;一些后端侧面(见 `PLUGIN_PATTERNS.md`)仍在着陆. API在1.0前可能会有变化.

营销分析学的形状总是一样的——渠道,运动,漏斗,登陆页 CVR——但算作每个业务的"转换"变化. 沙龙会转换预订,商店会转换订单,代理会转换线索. `plugin-marketing` 是一个适应全部的插件: 选择一个 `domain` 预设(或通过一个明确的转换模型+通道)和漏斗,信道性能,以及成本/购置额均在外加上通用计算.

它今天载着一个垂直口味的模拟器 所以表面是真实的 从第一个安装。 真正的归属通过干净的DI接合到达——a `AttributionBridge` 读取客户关系管理/议程/命令的转换,a `SitesPerformanceBridge` 从您的站点读取登陆页的号码 —— 所以你不重写插件就给现实线。 运动和频道是一流的,整件事暴露出AI工具,让你的助手可以回答"哪个频道转换得最好",大声出道.

## 里面的东西

-   A 类 `/marketing` 工作空间:概览、频道(列表+细节)、活动(列表+作曲)、漏斗和登陆页
-   `domain` 设置转换模式 + 获取通道的预设(默认为 `agency`(中文(简体) )
-   通用信道性能(访问、转换、CVR、花用、CPA)、漏斗和运动CVR
-   编译: `attributionBridge` 财务报告和审定财务报表 `sitesBridge` 准备时输入真实数据
-   域事件 : `marketing.conversion.tracked`, (中文(简体) ), `campaign.created`, (中文(简体) ), `campaign.updated`, (中文(简体) ), `channel.synced`
-   AI 工具 : `channelPerformance`, (中文(简体) ), `topChannels`, (中文(简体) ), `campaignCvr`,以及 `createCampaign`
-   Dashboard 部件、 中央设置标签、 货币格式化和完整的 i18n
-   导出 `MARKETING_PRESETS` 以及当地发展的模拟提供者

## 安装

```bash
npm install @fayz-ai/plugin-marketing
```

端点 : `@fayz-ai/core`, (中文(简体) ), `@fayz-ai/ui`, (中文(简体) ), `@fayz-ai/admin`附加时 `react` 编号 : `react-dom`。 。 。 .

## 使用量

```tsx
import { defineSaas } from '@fayz-ai/admin'
import { createMarketingPlugin } from '@fayz-ai/plugin-marketing'

export const app = defineSaas({
  // ...
  plugins: [
    createMarketingPlugin({
      domain: 'beauty',            // conversion model + channels from the preset
      currency: { code: 'BRL' },
      // attributionBridge / sitesBridge wire real data in later
    }),
  ],
})
```

## 费兹SDK的一部分

获得增长之半. 与 `plugin-crm` (线索和交易), `plugin-conversations` (收件箱中的广播答复)和 `plugin-reputation` (社会证明能解除CVR).

## 路线图贡献( I)

建设并不断发展于开阔. 见 [费兹SDK路线图](https://npmcn.com/package/docs/platform/ROADMAP.md#plugin-marketing) 对于当前空白,缺失的特征,以及良好的第一问题.

## 常见问题

### @fayz-ai/plugin-marketing 是什么？

Fayz SDK — 营销活动和广播插件

### 如何安装 @fayz-ai/plugin-marketing？

在项目目录运行 npm install @fayz-ai/plugin-marketing，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0\.0 \|\| ^19\.0\.0）、zustand（^4\.5\.0 \|\| ^5\.0\.0）、react-dom（^18\.0\.0 \|\| ^19\.0\.0）、lucide-react（\>=0\.400\.0 \<1\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fayz-ai/plugin-marketing 支持 TypeScript 吗？

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

### @fayz-ai/plugin-marketing 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @fayz-ai/plugin-marketing 可以商用吗？

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

### @fayz-ai/plugin-marketing 的下载量有多少？

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

### @fayz-ai/plugin-marketing 还在维护吗？

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