# 使用 ManyMoney AI 进行故障排除

本指南解释了如何对 [ManyMoney AI](/zh/product/pushwoosh-ai/ai-assistant/) 的问题进行故障排除。当您在提示中提供结构化信息时，ManyMoney AI 可以更快地诊断问题并提出更精确的修复建议。

<Aside type="tip">
如果您需要人工支持，可以向 Pushwoosh 支持团队 [提交工单](https://help.pushwoosh.com/hc/en-us/requests/new)。
</Aside>

## ManyMoney AI 可以检查什么

ManyMoney AI 使用 Pushwoosh API 来检查：

| 类别 <div style="width:160px"></div> | 检查内容 <div style="width:320px"></div> |
| --- | --- |
| Journey | 配置和验证、按 Journey 节点统计的数据、特定用户的用户流程 |
| 消息投递 | 投递状态和错误代码的跟踪日志、消息和营销活动统计、投递和错误报告 |
| 用户和设备 | 设备注册和状态、用户标签、[细分](/zh/product/audience-data-and-segmentation/segmentation/) 的编译和规模 |
| 配置 | 应用程序和平台设置、预设（推送、电子邮件等）、细分和事件逻辑 |


## ManyMoney AI 如何诊断问题

当您描述一个问题时，ManyMoney AI 会：

1. 使用 Pushwoosh API 和您的项目数据收集诊断信息。
2. 检查多个故障点（Journey 配置、预设、细分、平台设置）。
3. 从数据模式中识别根本原因。
4. 提出分步解决方案，并解释问题发生的原因，以便您将来可以避免。

### 对 ManyMoney AI 诊断的期望

在您收到的回复中：

*   主要问题和您项目的当前状态
*   为什么它不工作以及修复选项（附带优缺点）
*   发现的任何其他问题
*   对于会更改您账户的操作，ManyMoney AI 会在继续之前请求明确确认

**响应时间：**通常一次完整诊断需要 10-30 秒。


## 使用 ManyMoney AI 进行故障排除时的注意事项

在您的提示中包含正确的细节，以便 ManyMoney AI 能够有效诊断。您的提示越准确、越完整，您就能越快地找到解决方案。

| 应做 <div style="width:280px"></div> | 不应做 <div style="width:280px"></div> |
| --- | --- |
| **复制确切的错误消息**，而不是转述。 | 转述错误（例如，“它说了一些关于无效的内容”）。 |
| 包含 **Journey URL**（当 Journey 或资源打开时从浏览器复制），以便从中获取 [Journey ID](/zh/developer/api-reference/api-identifiers/#journey-id) 和名称。 | 假设 ManyMoney AI 了解您的设置（“通常的配置”）。 |
| 当问题涉及时间或调度时，指定**时区**（例如 UTC, Europe/Moscow）。 | 省略平台（iOS、Android、Web 等）。 |
| 分享**相关日期**（例如，“周一开始”或“自 1 月 15 日我们更新以来”）。 | 只说“它不工作”，而不描述预期行为与实际行为。 |
| 提及**您已经尝试过的方法**，以便可以跳过重复的步骤。 | 在一个提示中混合多个不相关的问题。 |

<Aside type="tip" title="在同一次对话中跟进">
有些问题需要多轮沟通。保持在同一次对话中，并添加每一个新发现，以便 ManyMoney AI 可以在此基础上继续。
</Aside>

## 按问题类型划分的提示模板

使用下面的模板作为清单，以确保您的提示包含了 ManyMoney AI 诊断所需的一切。要查找标识符，请参阅 [关键 API 标识符](/zh/developer/api-reference/api-identifiers/)。



### 推送通知投递

**使用场景：**推送通知在 iOS、Android 或 Web 上未投递。

在给 ManyMoney AI 的提示中包含以下细节：

| 在提示中包含 <div style="width:180px"></div> | 示例或格式 <div style="width:200px"></div> |
| --- | --- |
| 平台 | iOS、Android 或 Web |
| Journey | [Journey ID](/zh/developer/api-reference/api-identifiers/#journey-id) 或完整的 Control Panel URL（如果适用） |
| 开始时间 | 日期和时间，或“从未工作过” |
| 错误 | 确切的消息（如果有） |
| 测试设备 | [硬件 ID](/zh/developer/api-reference/api-identifiers/#hardware-id) (HWID)（如果在特定设备上测试） |
| 预期行为 | 应该发生什么 |
| 实际行为 | 实际发生了什么 |

<Aside type="tip" title="提示示例">
iOS 的推送通知在 "Welcome Flow" Journey 中没有投递。

* Journey：`https://app.pushwoosh.com/journeys/{APP_CODE}/{STATUS}/{JOURNEY_UUID}`
* 开始时间：昨天下午 2 点
* 错误：用户出现在 Journey 统计中，但没有收到推送
* 测试设备 HWID：test-iphone-12-hwid
* 预期行为：用户注册后立即发送推送
* 实际行为：用户进入 Journey，但没有通知出现
</Aside>

### 电子邮件投递

**使用场景：**电子邮件未投递或被退回。

在给 ManyMoney AI 的提示中包含以下细节：

| 在提示中包含 <div style="width:180px"></div> | 示例或格式 <div style="width:200px"></div> |
| --- | --- |
| 营销活动或 Journey | 名称或 [UUID](/zh/developer/api-reference/api-identifiers/#journey-id) |
| 电子邮件模板 | 名称或 [电子邮件内容代码](/zh/developer/api-reference/api-identifiers/#email-content-code) |
| 发件人地址 | sender@yourdomain.com |
| 域名验证 | 已验证、未验证或未知 |
| 受影响者 | 所有用户、一个[细分](/zh/product/audience-data-and-segmentation/segmentation/)或仅测试邮件 |
| 退信类型 | 硬退信、软退信、投诉或未知 |
| 开始时间 | 日期或“从未工作过” |
| 测试邮件 | test@example.com（如果正在测试） |

<Aside type="tip" title="提示示例">
电子邮件在 "Abandoned Cart" Journey 中没有被投递。

* Journey：`https://app.pushwoosh.com/journeys/{APP_CODE}/{STATUS}/{JOURNEY_UUID}`
* 电子邮件模板："Cart Reminder Day 1"
* 发件人：noreply@mystore.com
* 域名验证：显示“未就绪”
* 收件人：所有用户
* 开始时间：今天 Journey 启动时
</Aside>

### Customer Journey 不工作

**使用场景：**一个 Journey 没有显示活动或显示了意外的活动。

在给 ManyMoney AI 的提示中包含以下细节：

| 在提示中包含 <div style="width:180px"></div> | 示例或格式 <div style="width:200px"></div> |
| --- | --- |
| Journey 名称、URL 或 UUID | 完整的 URL 或 [Journey ID](/zh/developer/api-reference/api-identifiers/#journey-id) |
| 状态 | 草稿、非活动、活动、暂停或已归档 |
| 进入类型 | [基于触发器](/zh/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/)、[基于受众](/zh/product/customer-journey/journey-elements/entry-elements/audience-based-entry/)或 [基于 API](/zh/product/customer-journey/journey-elements/entry-elements/api-based-entry/) |
| 进入事件或细分 | [事件名称](/zh/developer/api-reference/api-identifiers/#event-name) 或 [细分名称](/zh/developer/api-reference/api-identifiers/#segment-filter-name) |
| 预期用户数 | 大约数量或“应该已经进入” |
| 日期范围 | 您在统计数据中查看的时间段 |
| 最后更改 | 如果您最近更改了某些内容 |

<Aside type="tip" title="提示示例">
Customer Journey 没有显示活动。

* Journey："Black Friday 2024 Campaign"
* URL：`https://app.pushwoosh.com/journeys/{APP_CODE}/{STATUS}/{JOURNEY_UUID}`
* 状态：活动（2 天前开始）
* 进入类型：基于触发器
* 进入事件："AddToCart"
* 预期：至少应有 100 个用户进入
* 日期范围：过去 7 天
* 最后修改：昨天更改了发送时间
</Aside>

### 细分问题

**使用场景：**一个细分与预期的用户不匹配。

在给 ManyMoney AI 的提示中包含以下细节：

| 在提示中包含 <div style="width:180px"></div> | 示例或格式 <div style="width:200px"></div> |
| --- | --- |
| 细分名称 | 在 Control Panel 中显示的细分名称（例如，“高价值客户”） |
| 细分标准 | 筛选条件的描述 |
| 预期规模 | 您预期的大约用户数量 |
| 实际规模 | 在 Control Panel 中显示的细分规模，如果失败则为“错误” |
| 标签或事件 | 细分中使用的[标签](/zh/developer/api-reference/api-identifiers/#tag)和[事件](/zh/developer/api-reference/api-identifiers/#event-name)名称 |
| 错误消息 | 如果细分创建或编译失败，则提供确切的消息 |
| 使用案例 | 您试图定位的目标（例如，VIP 优惠、重新激活） |

<Aside type="tip" title="提示示例">
细分与预期用户不匹配。

* 细分：“高价值客户”
* 筛选条件：过去 90 天内“总购买额”大于 500 美元的用户
* 预期：约 1,000 个用户
* 实际：0 个用户
* 使用的标签：“总购买额”（应为 PRICE 类型）
* 错误：筛选器编译成功但没有返回任何匹配项
* 使用案例：为 VIP 客户定位独家优惠
</Aside>

### 集成和 SDK 问题

**使用场景：**在您的应用中，注册、标签、事件或推送接收失败。

在给 ManyMoney AI 的提示中包含以下细节：

| 在提示中包含 <div style="width:180px"></div> | 示例或格式 <div style="width:200px"></div> |
| --- | --- |
| 平台 | iOS、Android、Web、React Native 或 Flutter |
| SDK 版本 | 版本号 |
| 框架 | Swift、Objective-C、Kotlin、Java、JavaScript 等 |
| 问题 | 具体问题 |
| 正常工作的部分 | 成功的步骤 |
| 失败的部分 | 失败的步骤 |
| 错误日志 | 完整的错误文本 |
| 代码片段 | 相关代码（如果有用） |
| 测试环境 | 设备、模拟器或生产环境 |

<Aside type="tip" title="提示示例">
iOS 上的 SDK 集成问题。

* 平台：iOS 16+
* SDK 版本：Pushwoosh 6.5.2
* 框架：Swift
* 问题：设备已注册但标签未保存
* 正常工作：推送令牌注册、接收通知
* 失败：`sendTags()` 调用似乎被忽略
* 错误日志：无，但标签未出现在 Control Panel 中
* 代码：`pushwoosh.sendTags(["userId": "12345", "premium": true])`
* 测试环境：iPhone 14 Pro 模拟器和实体设备
</Aside>

### 分析和报告

**使用场景：**您需要理解一个指标或报告。

在给 ManyMoney AI 的提示中包含以下细节：

| 在提示中包含 <div style="width:180px"></div> | 示例或格式 <div style="width:200px"></div> |
| --- | --- |
| 指标或报告 | 指标或报告的名称（例如，投递率、Journey 退出） |
| 时间段 | 日期范围（例如，过去 7 天、2024 年 1 月） |
| 筛选器 | [Journey](/zh/product/customer-journey/pushwoosh-journey-overview/)、[细分](/zh/product/audience-data-and-segmentation/segmentation/)或平台 |
| 当前值 | 您在 Control Panel 中看到的值或消息 |
| 预期 | 您预期的或“需要理解”的内容 |
| 决策影响 | 您将如何使用这些数据 |

### 性能和速度

**使用场景：**某个操作缓慢或超时。

在给 ManyMoney AI 的提示中包含以下细节：

| 在提示中包含 <div style="width:180px"></div> | 示例或格式 <div style="width:200px"></div> |
| --- | --- |
| 操作 | 缓慢的操作（例如，细分编译） |
| 时间 | 总是、高峰时段或针对特定操作 |
| 体量 | 受影响的用户或消息数量 |
| 耗时 | 实际耗时与您的预期 |
| 影响 | 业务影响 |
| 最近的更改 | 问题开始前是否有任何更改 |

## 主动检查

您可以要求 ManyMoney AI 进行主动审计。您可以使用以下提示示例：

*   **Journey**：“审计我的 Journey 配置以发现潜在问题。Journey：`名称或 UUID`。关注点：`投递`、`性能`、`用户体验`或`全部`。”
*   **电子邮件**：“检查我的电子邮件设置是否存在投递能力问题。应用程序：[应用程序代码](/zh/developer/api-reference/api-identifiers/#application-code)。我从：`您的发件人地址，例如 noreply@mystore.com` 发送。最近：`例如，过去 2 周内有退信，或没有问题`。”
*   **营销活动**：“分析营销活动表现并提出改进建议。Journey 或营销活动：`名称或 UUID`。当前指标：`您看到的数据`。目标：`您想要实现的目标`。”