sales-iterable

Iterable 平台帮助

帮助用户解答 Iterable 平台相关问题——涵盖 Studio 旅程创建和营销活动配置，以及渠道设置（电子邮件、SMS、推送、应用内消息、网页推送、WhatsApp）、AI 功能、数据集成、实验和 API 使用。

步骤 1 — 收集背景信息

如果存在 references/learnings.md，请先阅读，了解积累的知识。

询问用户：

1. 您需要哪方面的帮助？

   • A) Studio — 旅程工作流、图块、分支、延迟
   • B) 营销活动 — 单次发送或触发式消息
   • C) 电子邮件 — 模板、动态内容、编辑器
   • D) SMS/MMS — 设置、双向通信、媒体消息
   • E) 推送通知 — iOS、Android、网页推送
   • F) 应用内消息 — 模态框、横幅、Mobile Inbox、嵌入式消息
   • G) WhatsApp — 模板设置、消息类型
   • H) 实验 — A/B 测试、多变量测试
   • I) AI 功能 — Brand Affinity、STO、Frequency Optimization、Journey Assist
   • J) 数据 — Smart Ingest、Snowflake、Catalog、用户档案、事件
   • K) 细分 — 受众、筛选条件、动态列表
   • L) 集成 — Webhook、API、Zapier、第三方服务
   • M) 分析与报告 — 营销活动表现、互动情况
   • N) 其他 — 请描述

2. 您的角色是什么？

   • A) 营销人员 / 营销活动经理
   • B) 开发人员 / 工程师
   • C) 数据 / 分析
   • D) 营销运营 / 管理员

3. 您的目标是什么？

   • A) 首次设置某项功能
   • B) 优化或改进现有设置
   • C) 排查问题
   • D) 了解某项功能的工作原理

如果用户的请求已经提供了大部分背景信息，请直接跳转到相关步骤。 根据合理假设（并明确说明这些假设）先尽力回答，然后只在最后询问最关键的 1–2 个澄清问题。

步骤 2 — 转交或直接回答

如果问题涉及一般策略，而非 Iterable 专属配置，请转交给相应技能：

问题类型	转交方式
电子邮件营销策略（非 Iterable 专属）	“这是一个电子邮件营销策略问题——运行：/sales-email-marketing {your question}”
跨工具的推送通知策略	“这是一个推送通知策略问题——运行：/sales-push-notification {your question}”
跨工具的应用内消息策略	“这是一个应用内消息策略问题——运行：/sales-in-app-messaging {your question}”
事务性电子邮件服务提供商比较	“这是一个事务性电子邮件问题——运行：/sales-transactional-email {your question}”
跨工具配置 SPF/DKIM/DMARC	“这是一个电子邮件送达率问题——运行：/sales-deliverability {your question}”
通过 Zapier/Make 将 Iterable 连接到 CRM	“这是一个工具集成问题——运行：/sales-integration {your question}”

否则，请根据以下 Iterable 专属指南直接回答。

步骤 3 — Iterable 平台参考资料

阅读 references/platform-guide.md，了解详细的模块文档、定价、集成和数据模型。

无需再查阅平台指南的详细信息——请专注于用户的具体情况。

步骤 4 — 提供可执行的指导

入门清单

1. 设置数据中心 — 为项目确认使用美国还是欧盟数据中心（会影响 API 基础 URL 和数据驻留）
2. 配置渠道 — 验证发件域名（电子邮件），设置 FCM/APNs（推送），申请 SMS 号码，配置 Web 推送
3. 集成 SDK — 安装 iOS/Android/Web SDK，以实现推送、应用内消息、Mobile Inbox、Embedded Messages 和事件跟踪
4. 导入用户 — 通过 CSV、API（/api/users/bulkUpdate）或从数据仓库使用 Smart Ingest 批量上传
5. 定义事件 — 映射关键用户操作（注册、购买、使用功能、购物车放弃），并通过 SDK 或 API 实现跟踪
6. 构建细分受众 — 为关键受众（活跃用户、流失用户、高价值用户、新用户）创建动态列表
7. 创建模板 — 使用动态 Handlebars 内容设计电子邮件、推送、SMS 和应用内模板
8. 构建首个旅程 — 在 Studio 中从欢迎旅程开始：注册事件触发 → 电子邮件 → 延迟 → 推送 → 根据互动情况分支
9. 设置实验 — 在首个营销活动中对主题行和发送时间进行 A/B 测试
10. 启用 AI — 积累 30 天以上的互动数据后，启用 Brand Affinity、STO 和 Frequency Optimization
11. 配置 Webhook — 设置系统 Webhook，以监控送达情况并同步 CRM
12. 连接数据仓库 — 设置 Snowflake Secure Data Sharing 或 Smart Ingest，实现双向数据流

需要跟踪的关键指标

指标	Iterable 中的位置	基准
电子邮件打开率	营销活动分析	20-25%
电子邮件点击率	营销活动分析	2-5%
推送打开率	营销活动分析	5-15%
应用内点击率	营销活动分析	15-30%
SMS 送达率	营销活动分析	> 95%
旅程完成率	Studio 分析	因旅程而异
Brand Affinity 分布	AI > Brand Affinity	健康：多数为 Positive/Loyal
实验显著性	实验结果	等待达到 95% 置信度

注意事项

根据调研整理，尽力而为 — 请核查以下内容，尤其是有关受计划限制的功能和可能已过时的集成注意事项。

1. 一个营销活动只能使用一个渠道。 与 Braze（Canvas 可同时发送电子邮件、推送和应用内消息）不同，Iterable 营销活动仅面向一个消息渠道。要跨多个渠道发送消息，请使用包含多个 Send 磁贴的 Studio 旅程，不要尝试将单个营销活动设置为多渠道。
2. Brand Affinity 需要数据。 在营销活动积累 30 天以上的互动数据之前，Brand Affinity 标签不会准确。首月不要使用 Brand Affinity 进行受众细分，否则大多数标签会是“Neutral”和“Never Engaged”。
3. API 速率限制因端点而异，并按项目计算。 批量跟踪事件的限制为 10 req/s，导出的限制为 4 req/min。同一项目中的多个 API 消费者共用项目级速率限制。请针对 429 响应实现指数退避。
4. Smart Ingest 同步并非实时。 Smart Ingest 最快每 15 分钟同步一次。如需实时数据，请改用 REST API（/api/users/update、/api/events/track）。Smart Ingest 最适合定期同步数据仓库，不适合事件流。
5. 应用内消息需要集成 SDK。 与电子邮件或推送不同，应用内消息、Mobile Inbox 和 Embedded Messages 都需要在应用中安装 Iterable SDK。如果仅使用 REST API 进行服务器端消息发送，这些功能将无法使用。

• 持续改进：如果发现此处未涵盖的内容，请将其附加到 references/learnings.md，并注明今天的日期。

相关技能

• /sales-email-marketing — 跨平台电子邮件营销策略（不限于 Iterable）
• /sales-push-notification — 推送通知策略（跨工具的选择加入、富媒体推送、频率限制）
• /sales-in-app-messaging — 应用内消息策略（跨工具的消息类型、触发器设计、引导流程）
• /sales-transactional-email — 事务性电子邮件投递（服务商比较、API 集成）
• /sales-deliverability — 电子邮件送达率（SPF/DKIM/DMARC、预热、发件人信誉）
• /sales-integration — 将 Iterable 连接到 CRM、数据仓库及其他工具
• /sales-braze — Braze 平台帮助（主要竞争对手——适用于 Braze 专属问题）
• /sales-customerio — Customer.io 平台帮助（另一个跨渠道平台）
• /sales-klaviyo — Klaviyo 平台帮助（专注于电商互动）
• /sales-do — 不确定该使用哪项技能？路由器会将任何销售目标匹配到合适的技能。安装：npx skills add sales-skills/sales --skill sales-do

示例

示例 1：在 Studio 中构建欢迎旅程

用户说：“如何在 Iterable 中为新用户创建多步骤欢迎旅程？” 技能操作：逐步讲解如何创建 Studio 旅程：以“signup”自定义事件作为入口触发器 → 发送电子邮件（欢迎内容 + 价值主张）→ 延迟 1 天 → 筛选（是否打开了欢迎邮件？）→ 是分支：发送推送通知（功能亮点）→ 延迟 2 天 → 发送应用内消息（引导提示）。否分支：发送电子邮件（重新互动）。退出条件：用户完成引导流程事件。还会提供模板建议，并建议在后续阶段使用 Brand Affinity 筛选。 结果：完整的 Studio 旅程，包含多渠道引导流程

示例 2：设置实验

用户说：“如何在 Iterable 中对电子邮件主题行进行 A/B 测试？” 技能操作：介绍两种方法：1）营销活动级实验——创建群发营销活动，添加实验并设置 2-4 个主题行变体，设定获胜指标（打开率）、样本量（20%）和自动发送获胜版本的时间。2）旅程实验——在 Studio 中添加 Experiment 磁贴，将流量分配到主题不同的两个电子邮件发送磁贴。建议每个变体至少包含 1,000 位收件人，以确保统计显著性。 结果：已配置 A/B 测试，并设置适当的样本量和获胜标准

示例 3：通过 Smart Ingest 与 Snowflake 集成

用户说：“如何将我们的用户数据从 Snowflake 同步到 Iterable？” 技能操作：逐步讲解 Smart Ingest 设置：Integrations > Smart Ingest > Create Connection > Select Snowflake > Configure credentials（账户、仓库、数据库、架构）> Map sync type（Users）> Map fields（email → email，custom attributes → dataFields）> Set sync frequency（每 15 分钟或每小时）> Test and activate。还会介绍用于反向同步（Iterable → Snowflake）的 Snowflake Secure Data Sharing。 结果：已配置 Snowflake 与 Iterable 之间的双向数据管道

故障排除

iOS 上无法投递推送通知

症状：推送营销活动显示已发送，但 iOS 设备上没有送达 原因：APNs 证书已过期、沙盒与生产环境不匹配，或 SDK 未正确初始化 解决方案：1）在 Iterable Settings > Mobile Apps 中检查 APNs 证书是否过期。2）确认使用了正确的 APNs 环境（TestFlight 使用沙盒环境，App Store 使用生产环境）。3）确认 Iterable SDK 使用了正确的 API 密钥进行初始化，且推送注册调用了 registerForRemoteNotifications()。4）检查设备令牌是否通过 setDeviceToken() 发送到了 Iterable。5）通过全新安装应用进行测试，以生成新的令牌。

Smart Ingest 同步失败

症状：Smart Ingest 连接显示错误或没有同步数据 原因：凭据问题、查询超时或字段映射不匹配 解决方案：1) 确认 Snowflake/BigQuery 凭据仍然有效，并且拥有源表的 SELECT 权限。2) 检查源查询是否返回数据（直接在数据仓库中运行）。3) 确认字段映射正确 — 必须映射 email 或 userId 才能识别用户。4) 检查数据类型是否不匹配（例如，将字符串字段映射为数字）。5) 查看 Iterable 中的 Smart Ingest 日志，查找具体错误消息。

Brand Affinity 准确度低

症状：Brand Affinity 中的大多数用户显示为“中立”或“从未互动” 原因：互动数据不足 — Brand Affinity 需要历史跨渠道互动数据才能生成有意义的评分 解决方案：1) 确保已在多个渠道上发送营销活动 30 天以上。2) 确认已为电子邮件营销活动启用打开/点击跟踪。3) 检查推送通知打开跟踪是否正常工作（SDK 配置正确）。4) Brand Affinity 会定期重新计算 — 添加更多互动数据后，等待下一次刷新周期。5) 在此期间，请使用传统的基于互动的细分（过去 30 天内打开过），而不是 Brand Affinity 标签。