sales-braze

Braze 平台帮助

帮助用户解答 Braze 平台相关问题，涵盖 Canvas Flow 旅程编排、跨渠道营销活动、BrazeAI、Braze Data Platform、细分受众、Catalogs、Feature Flags 和 REST API 集成。

第 1 步 — 收集背景信息

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

询问用户：

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

   • A) Canvas Flow — 旅程编排、多步骤跨渠道流程
   • B) 营销活动 — 单次发送或由 API 触发的消息
   • C) 电子邮件 — 模板、拖放式编辑器、Liquid、Connected Content
   • D) 推送通知 — iOS、Android、Web 推送、富媒体推送（如需跨平台策略，请转交：/sales-push-notification {your question}）
   • E) 应用内消息 / Content Cards — 模态窗口、滑出式消息、常驻卡片（如需跨平台策略，请转交：/sales-in-app-messaging {your question}）
   • F) SMS / MMS / RCS / WhatsApp / LINE — 移动消息渠道
   • G) BrazeAI — 预测模型、生成式内容、AI Agent、Decisioning Studio
   • H) 细分受众 — 实时细分受众、SQL 细分受众、CDI Segments、筛选条件
   • I) Braze Data Platform — Cloud Data Ingestion、Currents 流式传输、数据转换
   • J) Catalogs — 产品数据、位置数据、动态个性化
   • K) Feature Flags — 受控发布、功能 A/B 测试
   • L) 事务性电子邮件 — 用于时效性 1:1 消息的专用 API（如需跨平台支持，请转交：/sales-transactional-email {your question}）
   • M) 可送达性 — 域名身份验证、IP 预热、发件人信誉（如需跨平台支持，请转交：/sales-deliverability {your question}）
   • N) REST API — 端点、身份验证、速率限制、SDK
   • O) 集成 — Braze Alloys、CDP 连接器、数据仓库同步
   • P) Liquid 模板 / Connected Content — 动态个性化
   • Q) 管理 — 工作区、API 密钥、SCIM、权限、账单
   • R) 从 Appboy 或其他平台迁移
   • S) 其他 — 请描述具体需求

2. 您的角色是什么？

   • A) 营销 / CRM / 生命周期营销人员
   • B) 增长 / 产品经理
   • C) 开发人员 / 工程师
   • D) 数据 / 分析
   • E) 管理员 / 运维
   • F) 其他

3. 您想要实现什么目标？（请描述您的具体目标或问题）

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

第 2 步 — 转交或直接回答

如果请求符合某个专门技能的范围，请转交：

• 推送通知策略 → /sales-push-notification
• 应用内消息策略 → /sales-in-app-messaging
• 电子邮件营销策略（选择加入）→ /sales-email-marketing
• 事务性电子邮件架构 → /sales-transactional-email
• 跨平台可送达性 → /sales-deliverability
• 工具集成架构 → /sales-integration
• 潜在客户评分模型 → /sales-lead-score
• 实时聊天 / 聊天机器人 → /sales-live-chat
• 忠诚度计划 → /sales-loyalty

否则，根据下文的参考资料直接使用平台知识回答。

第 3 步 — Braze 平台参考资料

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

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

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

根据用户的需求，提供：

1. 分步说明 — 准确的 Braze 界面路径或 API 调用
2. 配置建议 — 设置、计划考量和注意事项
3. 验证步骤 — 如何确认设置正常运行
4. 后续步骤 — 当前任务完成后要做什么

常见设置工作流

首次设置清单：

1. 配置 SDK 集成（iOS/Android/Web）——安装 SDK，设置 API 密钥和端点
2. 设置用户识别——使用 external_id 调用 changeUser()
3. 跟踪自定义事件和属性——定义事件分类
4. 设置电子邮件域名身份验证（SPF/DKIM/DMARC）
5. 配置推送凭据（APNs 证书、FCM 密钥）
6. 根据用户行为创建第一个细分受众
7. 构建一个简单的营销活动，测试各个渠道
8. 设置 Currents 以导出数据（如有需要）

Canvas Flow 快速入门：

1. Dashboard → Messaging → Canvas → Create Canvas
2. 设置进入计划（基于操作、按计划或由 API 触发）
3. 添加进入受众（细分受众或筛选条件）
4. 构建流程：添加消息步骤、延迟和决策分支
5. 如有需要，添加变体以进行 A/B 测试
6. 设置转化事件以跟踪成效
7. 检查并使用内部用户进行测试，然后启动

API 密钥设置：

1. Dashboard → Settings → APIs and Identifiers
2. 创建 New API Key——为其取一个描述性名称
3. 仅选择此密钥所需的权限（最小权限原则）
4. 记录你的 REST 端点（实例专属 URL）
5. 测试：curl -H "Authorization: Bearer YOUR_KEY" https://rest.{instance}.braze.com/users/export/ids -d '{"external_ids": ["test_user"]}'

注意事项

根据调研整理的最佳实践——请检查以下内容，尤其是与套餐限制功能和集成注意事项有关且可能已过时的条目。

1. 实例专属端点：Braze 有许多区域实例（US-01 至 US-08 和 US-10——没有 US-09——以及 EU-01/02、AU-01、ID-01、JP-01、KR-01）。**US 和 APAC 实例使用 .braze.com；EU 实例使用 .braze.eu。**API 调用使用错误的实例 URL（或 EU 实例使用错误的域名）会导致调用悄无声息地失败。请务必前往 Settings → APIs and Identifiers 检查正确的 REST 端点。
2. 混淆 Canvas 和 Campaign：Braze 同时提供“Campaigns”（单步骤）和“Canvas”（多步骤）。用户询问“序列”或“旅程”时，指的是 Canvas，而不是 Campaign。用户询问“大量群发”或“一次性发送”时，指的是 Campaign。
3. 基于 MAU 的定价可能会意外飙升：Braze 按月活跃用户数收费，而非按联系人收费。如果你开展重新激活营销活动，让不活跃用户重新活跃起来，MAU 数量（和账单）就会上升。设计挽回营销活动时，请提醒用户注意这一点。
4. Liquid 与 Handlebars：Braze 使用 Liquid 模板（类似 Shopify），而不是 Handlebars（类似 SendGrid/Postmark）。语法是 {{${first_name}}}，而不是 {{first_name}}。双美元符号包裹是 Braze 专用的 Liquid 语法。
5. Connected Content 速率限制：Connected Content API 调用会在发送时执行。如果你向 100 万用户发送消息，并且每条消息都调用一个外部 API，就会向你的服务器发出 100 万次 API 调用。请实施缓存（{% connected_content ... :cache_max_age 300 %}），并确保你的 API 能够承受相应负载。

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

第 5 步——相关技能

• /sales-push-notification — 跨平台推送通知策略
• /sales-in-app-messaging — 跨平台应用内消息和内容卡片策略
• /sales-email-marketing — 跨平台选择加入式电子邮件营销策略
• /sales-transactional-email — 事务性/触发式电子邮件发送策略
• /sales-deliverability — 跨平台电子邮件送达能力（SPF/DKIM/DMARC、预热、信誉）
• /sales-integration — 将 Braze 与数据仓库、CDP 和其他工具连接起来
• /sales-live-chat — 在线聊天和聊天机器人策略
• /sales-loyalty — 客户忠诚度计划设计
• /sales-lead-score — 潜在客户/互动评分模型
• /sales-do — 不确定该使用哪项技能？路由器会将任何销售目标匹配到相应技能。安装：npx skills add sales-skills/sales --skill sales-do

示例

示例 1：构建 Canvas 入门引导

用户说：“如何在 Braze 中为新应用用户创建为期 7 天的入门引导旅程？” 技能执行：引导用户创建 Canvas，使用基于操作的入口（会话开始，首次使用 = true）→ 第 0 天发送欢迎推送通知和应用内消息 → 第 1 天发送包含入门指南的电子邮件 → 第 3 天进行决策分流（已完成设置？是 → 发送突出显示功能的 Content Card，否 → 发送提醒推送通知）→ 第 7 天发送应用内调查消息。包括设置转化事件和 A/B 变体。 结果：完整的入门引导 Canvas，包含分支、多渠道消息和成功指标

示例 2：设置 Currents 数据导出

用户说：“我需要将 Braze 互动事件流式传输到我们的 Snowflake 数据仓库。” 技能执行：引导用户依次进入 Dashboard → Data Settings → Currents → Create New Current → Snowflake → 配置连接凭据、选择要传输的事件（电子邮件打开、推送点击、应用内展示、购买）并设置数据格式。说明 Snowflake Data Sharing 这一零 ETL 访问替代方案。 结果：互动数据从 Braze 实时流向 Snowflake

示例 3：使用 Connected Content 提供个性化推荐

用户说：“如何在发送时将我们 API 中的产品推荐提取到 Braze 电子邮件中？” 技能执行：展示 Connected Content 语法：{% connected_content https://api.example.com/recs/{{${user_id}}} :save recs :cache_max_age 900 %} → 使用 {% for item in recs.products %} 迭代 → 在电子邮件中构建产品卡片。涵盖错误处理（{% if connected_content_status == 200 %}）、缓存和负载测试。 结果：从外部 API 动态提取内容并实现个性化的产品推荐电子邮件

故障排除

Canvas 未向预期受众发送

症状：Canvas 显示进入人数为 0，或远少于预期用户 原因：入口受众筛选条件过于严格、速率限制过于激进、未启用重新进入，或入口计划与预期触发条件不符 解决方案：1) 检查入口受众 — 预览细分受众的规模。2) 确认触发事件确实已触发（检查用户资料中的事件日志）。3) 检查速率限制设置。4) 如果用户应能多次进入，请确保已启用重新进入。5) 对于 API 触发的 Canvas，请确认 API 调用包含正确的 canvas_id。

推送通知未送达

症状：推送营销活动显示已发送，但送达量很低或为 0 原因：推送令牌无效、APNs 证书过期、FCM 密钥不正确，或用户已取消订阅 解决方案：1) 在用户资料中检查推送令牌是否有效。2) 在 Dashboard → Settings → App Settings 中验证 APNs 证书或 FCM 密钥。3) 检查推送订阅状态 — 按“Push Enabled”筛选细分受众。4) 对于 iOS，请确保已显示推送引导提示，且用户已接受。5) 先使用已知正常的设备进行测试。

Connected Content 返回错误

症状：电子邮件渲染时个性化内容为空，或显示错误回退内容 原因：发送时无法访问外部 API、请求受到速率限制，或返回了意外格式 解决方案：1) 使用示例 user_id 手动测试 API URL。2) 添加错误处理：{% if connected_content_status == 200 %}。3) 添加缓存：:cache_max_age 300，以减少 API 调用。4) 确保 API 能够处理发送量（每位收件人调用 1 次）。5) 添加回退内容：{% else %}Default content here{% endif %}。