# OneSignal: Chinese 用户指南

> OneSignal is a platform for sending push notifications, emails, in-app messages, and SMS campaigns via a single API, Journey Builder, and a dashboard.

## 用户指南

### 开始使用和设置

- [快速入门指南](https://documentation.onesignal.com/docs/cn/quickstart-guide.md): 设置您的 OneSignal 账户、配置消息渠道、管理用户，并发送您的第一条消息。
- [迁移到 OneSignal](https://documentation.onesignal.com/docs/cn/migrating-to-onesignal.md): 从其他消息提供商迁移到 OneSignal，包含 SDK 集成、用户导入、分阶段推出和测试指导。

#### OneSignal 仪表板

- [应用、组织和账户](https://documentation.onesignal.com/docs/cn/apps-organizations.md): 添加、重命名、移动和删除 OneSignal 应用和组织。了解账户、应用和组织之间的关系。
- [团队成员](https://documentation.onesignal.com/docs/cn/manage-team-members.md): 通过在应用或组织级别添加、删除或更新团队成员角色来管理 OneSignal 用户访问权限。了解角色权限和计划可用性。
- [密钥和 ID](https://documentation.onesignal.com/docs/cn/keys-and-ids.md): 查找和管理您的 OneSignal App ID、Organization ID 和 API 密钥。了解如何创建、轮换、保护和安全迁移密钥。
- [审计日志](https://documentation.onesignal.com/docs/cn/audit-logs.md): 跟踪并审查整个 OneSignal 组织的用户操作：通过登录活动、IP 地址和会话调查安全事件，为 SOC 2、HIPAA 等合规审计提供不可变的只读记录，追踪模板、Journey 和通知的变更，并支持导出为 JSONL 文件或通过 REST API 查询，保留期限因套餐而异。
- [使用量与计费](https://documentation.onesignal.com/docs/cn/billing-faq.md): OneSignal 计费问题解答：MAU 如何计数、Free 计划限制、发票费用、支付方式以及降低使用成本的方法。
- [已禁用的应用和组织](https://documentation.onesignal.com/docs/cn/disabled-apps.md): 了解您的 OneSignal 应用或组织可能被禁用的原因、受影响的功能，以及如何恢复访问或防止未来被禁用。

### 消息渠道

- [渠道设置](https://documentation.onesignal.com/docs/cn/channel-setup.md): 在 OneSignal 中设置推送通知、应用内消息、电子邮件、短信、RCS 和 Live Activities，跨所有渠道触达用户。

#### 推送通知

- [推送概览](https://documentation.onesignal.com/docs/cn/push.md): 通过 OneSignal 仪表板或 API 发送和管理移动端与网页推送通知：涵盖 iOS、Android 和 Web 的平台设置指南、权限提示、受众定向、消息个性化、智能投递时间优化与计划发送等功能，通过及时的个性化内容跨设备重新吸引未活跃的用户，提升留存与转化。

##### 移动推送通知

- [移动推送设置](https://documentation.onesignal.com/docs/cn/mobile-push-setup.md): 按照端到端清单在 iOS、Android、Huawei 和 Amazon 平台上设置 OneSignal 移动推送通知，涵盖 SDK 集成、权限提示策略、包含图像、按钮和声音的通知设计、投递行为配置与深度链接，帮助您在用户未主动使用应用时通过丰富内容重新吸引他们。
- [提示推送权限](https://documentation.onesignal.com/docs/cn/prompt-for-push-permissions.md): 通过策略性时机、应用内软提示以及 iOS 临时通知，提高 iOS、Android 和华为设备上的推送通知选择加入率。
- [iOS 临时推送通知](https://documentation.onesignal.com/docs/cn/ios-provisional-push-notifications.md): iOS 上的临时推送通知允许您的应用在无需事先提示权限的情况下发送通知，但可见性有所降低。
- [Android 通知类别](https://documentation.onesignal.com/docs/cn/android-notification-categories.md): 在 OneSignal 仪表板中创建和管理 Android 通知类别（通知渠道），按通知类型控制声音、振动、重要性和锁屏可见性，涵盖 Android 8.0+ 渠道机制与默认类别，适用于 Google Android、华为 Android 和 Amazon FireOS 设备。
- [数据和后台通知](https://documentation.onesignal.com/docs/cn/data-notifications.md): 在 iOS 和 Android 上发送静默推送通知，以同步数据或触发后台任务，而不显示可见消息。
- [VoIP 推送通知](https://documentation.onesignal.com/docs/cn/voip-notifications.md): 使用 OneSignal 在 iOS 上通过 PushKit 令牌注册和 VoIP 证书发送 VoIP 推送通知，以及 Android 上模拟通话行为的替代方案。

##### 网络推送通知

- [网页推送设置](https://documentation.onesignal.com/docs/cn/web-push-setup.md): 使用 OneSignal 设置网页推送通知，在 Chrome、Firefox、Safari 和 Edge 浏览器上重新吸引离开网站的用户，涵盖 HTTPS 与 SSL 证书要求、集成类型选择、权限提示策略、Service Worker 配置以及包含图像和操作按钮的通知设计。
- [网页权限提示](https://documentation.onesignal.com/docs/cn/permission-requests.md): 配置 OneSignal 的网页推送权限提示以最大化选择加入。涵盖滑动提示、原生浏览器提示、类别选择、邮箱/电话收集、订阅铃铛和自定义链接提示。
- [网页推送常见问题](https://documentation.onesignal.com/docs/cn/web-push-setup-faq.md): OneSignal 网页推送通知设置、要求、浏览器兼容性、域名更改以及为开发者和网站所有者排查常见问题的完整指南。
- [Web 推送浏览器行为](https://documentation.onesignal.com/docs/cn/browser-behavior-and-unsubscribes.md): 了解如何取消订阅通知并理解浏览器如何处理 Web 推送订阅。
- [用于网页推送的 OneSignal WordPress 插件设置](https://documentation.onesignal.com/docs/cn/wordpress.md): 安装并配置 OneSignal WordPress 插件 v3+，在您的 WordPress 网站上实现网页推送通知，涵盖 OneSignal 仪表板站点设置、权限提示配置、发布文章时自动发送通知、按文章选择受众分段、移动应用深度链接，以及从旧版 2.x 插件迁移的注意事项。
- [WordPress 故障排除](https://documentation.onesignal.com/docs/cn/troubleshooting-wordpress-web-push.md): 在 WordPress 上排查 OneSignal Web Push 通知常见设置问题的综合指南，包括浏览器兼容性（Chrome、Firefox、Safari）、插件集成以及解决 CDN 或缓存冲突。
- [Shopify 网页推送集成](https://documentation.onesignal.com/docs/cn/shopify.md): 通过 Vendo 集成将 Shopify 店铺连接到 OneSignal：无需手动编辑主题代码即可一键部署 Web 推送 SDK，将客户标签、客户端浏览事件和服务端商务事件同步到 OneSignal，并基于真实购买行为构建细分受众、触发废弃购物车提醒等推送营销活动。

##### 推送通知功能

- [通知图标](https://documentation.onesignal.com/docs/cn/notification-icons.md): 在 Android、iOS 和 Web 上设置默认与按消息的推送通知图标，涵盖小图标与大图标的尺寸要求、防止出现白色方块的透明度规则、ic_stat_onesignal_default 资源命名规范，以及 Android 17 启动器图标变更对通知显示的影响。
- [通知图像和富媒体](https://documentation.onesignal.com/docs/cn/rich-media.md): 了解如何使用 OneSignal 仪表板和 API 向移动推送通知添加图像、GIF 和多媒体附件，涵盖推荐的文件格式与尺寸限制、iOS 与 Android 设备的特定显示行为、通知服务扩展要求，以及 iOS 通知内容扩展等富通知布局的自定义选项与技术限制，帮助打造更吸引人的通知。
- [通知声音](https://documentation.onesignal.com/docs/cn/notification-sounds.md): 为 iOS、Android、Huawei 和 Amazon 应用添加自定义通知声音——包括文件格式、SDK 设置和 API 参数。
- [通知徽章](https://documentation.onesignal.com/docs/cn/badges.md): 管理 iOS、Android 和华为设备上推送通知的应用图标徽章计数，涵盖 ios_badgeType 递增与设置模式、App Group 配置要求、自动徽章清除、原生徽章逻辑、华为徽章参数，以及徽章计数不递增或未清除等常见问题的排查，并说明 Web 推送徽章的区别。
- [推送通知操作按钮](https://documentation.onesignal.com/docs/cn/action-buttons.md): 在iOS、Android和网页的推送通知中添加交互式操作按钮。学习通过控制台和API进行设置、支持的平台、点击处理、图标和事件跟踪。
- [推送频率限制](https://documentation.onesignal.com/docs/cn/frequency-capping.md): 使用推送频率限制功能控制单个用户在滚动的分钟、小时、天或周时间窗口内接收的推送通知数量，避免多个团队、Journeys 或自动触发器同时发送造成的消息过载，减少退订、取消互动和不佳的用户体验，本文涵盖设置步骤、工作原理与注意事项。该频率限制功能仅在精选付费计划中提供。
- [推送限流](https://documentation.onesignal.com/docs/cn/throttling.md): 推送限流控制 OneSignal 投递推送通知的速率，帮助您管理服务器负载并避免高容量发送期间的性能问题。
- [iOS：专注模式和中断级别](https://documentation.onesignal.com/docs/cn/ios-focus-modes-and-interruption-levels.md): 了解 iOS 专注模式和四种中断级别（被动、活跃、时效性、关键警报）如何影响推送通知的投递与显示行为，以及如何在 OneSignal 仪表板或 API 中为通知设置中断级别，包括向 Apple 申请并配置关键警报权限，以支持账户安全或紧急警报等重要用例，确保重要通知及时送达。
- [iOS：相关性评分](https://documentation.onesignal.com/docs/cn/ios-relevance-score.md): 设置 Apple 相关性评分以指示每条推送通知或实时活动更新的重要性，控制推送在 iOS 通知摘要中的显示优先级，以及实时活动在动态岛和锁屏上的展示效果，涵盖在 OneSignal 仪表板与 API 中配置评分的具体方法、取值范围和使用建议，帮助重要通知获得更高曝光。

##### 推送通知分析和故障排除

- [推送消息报告](https://documentation.onesignal.com/docs/cn/push-notification-message-reports.md): 推送消息报告显示投递结果、确认投递、故障诊断、点击率以及每次推送发送的每订阅受众活动。
- [确认送达](https://documentation.onesignal.com/docs/cn/confirmed-delivery.md): 确认送达跟踪设备接收到通过OneSignal发送的推送通知的时间。涵盖iOS、Android、Huawei和Web的要求、平台限制和故障排除。
- [通知点击率](https://documentation.onesignal.com/docs/cn/notification-ctr.md): 排查并提升 OneSignal 推送通知点击率（CTR）：了解 CTR 的计算方式（点击数除以送达数）、不计入统计的滑动关闭与清除操作、点击率下降的常见原因和各平台的报告方法，以及通过发送时机、个性化和内容优化提升用户参与度的最佳实践策略，帮助您诊断并改善通知整体表现。
- [移动推送：通知未显示或延迟](https://documentation.onesignal.com/docs/cn/notifications-show-successful-but-are-not-being-shown.md): 排查在 OneSignal 中显示为已送达但未出现或延迟的移动推送通知——适用于 Android 和 iOS 设备。
- [网页推送：通知未显示](https://documentation.onesignal.com/docs/cn/notifications-not-shown-web-push.md): 排查在 OneSignal 中显示为 已送达 但未出现在订阅者设备上的网页推送通知。
- [通知图片未显示](https://documentation.onesignal.com/docs/cn/notification-images-not-showing.md): 通知图片未出现。
- [重复通知](https://documentation.onesignal.com/docs/cn/duplicated-notifications.md): 排查由 SDK 冲突、服务器端重试、多应用环境和平台特定错误导致的重复推送通知问题。
- [FCM 过期令牌常见问题](https://documentation.onesignal.com/docs/cn/fcm-expired-token-faq.md): 了解 Android 设备和 Chrome 浏览器推送订阅为何会因 Firebase Cloud Messaging 令牌过期（超过 270 天不活跃）和 Google 垃圾信息抑制而被退订，为什么这不影响实际点击量与会话，以及如何排查退订量突然激增的问题并了解更准确分析等好处。

#### 应用内消息

- [应用内消息概览](https://documentation.onesignal.com/docs/cn/in-app-messages-setup.md): 在移动应用内展示有针对性的可自定义应用内消息（IAM），以提升参与度、收集用户反馈并引导推送订阅、位置更新等操作。本概览介绍应用内消息的功能、无需编码的设置要求与消息创建流程，帮助您快速上手 OneSignal 应用内消息并发送第一条消息，无需应用更新即可上线。
- [应用内触发器](https://documentation.onesignal.com/docs/cn/iam-triggers.md): 向用户显示应用内消息的选项。
- [应用内点击操作](https://documentation.onesignal.com/docs/cn/iam-click-actions.md): 在应用内消息元素上配置点击操作，以打开 URL、请求推送或位置权限、跟踪结果、为用户打标签或触发自定义逻辑。
- [应用内消息报告](https://documentation.onesignal.com/docs/cn/in-app-message-reports.md): OneSignal 应用内消息投放和统计
- [应用内消息故障排除](https://documentation.onesignal.com/docs/cn/in-app-message-troubleshooting.md): 关于应用内消息的常见问题和故障排除步骤。

##### 应用内消息设计

- [使用拖放设计应用内消息](https://documentation.onesignal.com/docs/cn/design-your-in-app-message.md): 使用 OneSignal 的可视化编辑器构建高转化率的应用内消息，包括块、布局、轮播图和个性化功能。
- [使用 HTML 设计应用内消息](https://documentation.onesignal.com/docs/cn/design-your-in-app-message-with-html.md): 使用 OneSignal 的 HTML 编辑器设计和自定义应用内消息，实现最大的灵活性、响应式设计和品牌化效果。
- [应用内消息模板与快速入门](https://documentation.onesignal.com/docs/cn/in-app-html-templates.md): 为 OneSignal 应用内消息提供可复制粘贴的 HTML 模板与快速入门设计，使用 HTML、CSS 和 JavaScript 完全自定义消息的布局和行为，涵盖所需设置、通过应用内消息 JS API 处理关闭与点击操作，以及 webview 中的常见注意事项。
- [应用内消息 JavaScript API 参考](https://documentation.onesignal.com/docs/cn/in-app-message-api.md): OneSignal 中交互式 HTML 应用内消息的 JavaScript 方法。

#### 电子邮件

- [邮件概述](https://documentation.onesignal.com/docs/cn/email-messaging.md): 使用 OneSignal 通过仪表板、Journeys 或 API 发送营销和事务性邮件——内置个性化、分析和送达率工具。

##### 电子邮件设置

- [邮件设置](https://documentation.onesignal.com/docs/cn/email-setup.md): 通过选择提供商、创建发送者、配置 DNS 身份验证和验证账户，完成 OneSignal 邮件设置。
- [邮件 DNS 配置](https://documentation.onesignal.com/docs/cn/email-dns-configuration.md): 手动添加 DNS 记录（SPF、DKIM、DMARC、CNAME、MX）以验证 OneSignal 邮件发送的发送域。本指南以 Cloudflare 为例说明各类记录的添加方法，适用于无法从 OneSignal 仪表板自动配置 DNS、需要在您的域名提供商处手动创建记录的情况。
- [发送者](https://documentation.onesignal.com/docs/cn/senders.md): 了解如何管理发送者身份和域名以提高邮件可投递性并维护良好的发送者声誉。
- [事务性电子邮件](https://documentation.onesignal.com/docs/cn/setup-transactional-emails.md): 通过 OneSignal 发送购买确认、密码重置和欢迎邮件等事务性电子邮件，并与推送通知和营销邮件一起在控制台跟踪投递、点击和打开统计信息，涵盖发送前的设置要求、发送方式与最佳实践，帮助您快速开始使用 OneSignal 的电子邮件消息传递，适合作为邮件渠道的起步方式。
- [创建自定义偏好或取消订阅页面](https://documentation.onesignal.com/docs/cn/create-custom-unsubscribe-page.md): 学习如何用品牌化、多语言和个性化的邮件偏好页面替换OneSignal的默认取消订阅链接，同时保持合规性和跟踪功能。

##### 电子邮件可投递性

- [邮件消息报告](https://documentation.onesignal.com/docs/cn/email-message-reports.md): 在 OneSignal 邮件消息报告中跟踪邮件投递、打开率、点击率、退信、抑制和垃圾邮件报告。
- [邮件可交付性](https://documentation.onesignal.com/docs/cn/email-deliverability.md): 通过管理发件人声誉、减少退信和垃圾邮件投诉以及遵循邮件卫生最佳实践来提高收件箱投递率。
- [邮件声誉最佳实践](https://documentation.onesignal.com/docs/cn/email-reputation-best-practices.md): 建立和维护健康的电子邮件发送声誉，以提高送达率并避免垃圾邮件投诉。
- [邮件地址验证](https://documentation.onesignal.com/docs/cn/email-address-validation.md): 在 CSV 导入期间及批量验证邮件地址，以减少退信并保护您的发件人声誉。
- [邮件预热指南](https://documentation.onesignal.com/docs/cn/email-warm-up.md): 预热确保收件箱提供商信任您的邮件发送。了解如何在保持高参与度和低投诉率的同时逐步增加发送量。
- [Google Postmaster Tools](https://documentation.onesignal.com/docs/cn/google-postmaster-tools.md): 设置 Google Postmaster Tools 以监控 Gmail 垃圾邮件率和域名声誉——Gmail 不会直接与电子邮件发送者共享的数据。
- [抑制列表](https://documentation.onesignal.com/docs/cn/suppressions.md): 在 OneSignal 中管理被抑制的电子邮件地址，以维护列表健康状态、减少退回并保护您的发件人声誉。
- [邮件故障排除](https://documentation.onesignal.com/docs/cn/email-troubleshooting.md): 如何诊断和解决常见的 OneSignal 邮件问题。

##### 电子邮件消息

- [使用拖放功能设计邮件](https://documentation.onesignal.com/docs/cn/design-emails-with-drag-and-drop.md): 使用 OneSignal 的拖放邮件生成器直观地构建响应式邮件——设置、行、内容区块、个性化和合规链接。
- [使用 HTML 设计电子邮件](https://documentation.onesignal.com/docs/cn/design-emails-with-html.md): 使用 OneSignal 的 HTML 编辑器发送完全自定义的品牌电子邮件——支持的 HTML 规则、内联 CSS、深色模式、取消订阅处理及客户端限制。
- [邮件取消订阅链接和标头](https://documentation.onesignal.com/docs/cn/unsubscribe-links-email-subscriptions.md): 了解如何在 OneSignal 中管理邮件取消订阅行为，包括取消订阅链接、List-Unsubscribe 标头、抑制规则和重新订阅工作流程。
- [邮件模板转发](https://documentation.onesignal.com/docs/cn/email-template-forwarding.md): 转发您的邮件模板以快速创建它们！

#### 短信和RCS

- [SMS、MMS 和 RCS 概览](https://documentation.onesignal.com/docs/cn/sms-messaging.md): 使用 OneSignal 发送文本消息。涵盖 SMS、MMS 和 RCS 格式、三种短信程序类型（营销类、事务类、OTP）以及每种用例的设置路径。
- [富媒体通信服务 (RCS)](https://documentation.onesignal.com/docs/cn/rcs-messaging.md): 在 OneSignal 中使用 RCS 发送品牌化、类应用的消息。涵盖富媒体内容类型、发送方设置、图片要求、SMS 回退和国家/地区可用性。

##### 短信设置

- [SMS 设置](https://documentation.onesignal.com/docs/cn/sms-setup.md): 使用 OneSignal 设置短信发送。了解品牌、发送者和发送者资源模型，在 OneSignal SMS 与 Twilio 之间做出选择，并学习如何从现有提供商迁移。
- [发送方资源申请与各国要求](https://documentation.onesignal.com/docs/cn/sms-registration-requirements.md): 按国家/地区申请 SMS 和 RCS 发送方资源。涵盖品牌和营销活动审批流程、标准申请要求、发送方资源类型特征，以及所有受支持地区的各国审批表。
- [SMS 选择加入和收集](https://documentation.onesignal.com/docs/cn/sms-opt-in-and-collection.md): 为推广、事务性和 OTP 计划收集有效的 SMS 同意。涵盖选择加入收集方法、披露要求、受众验证以及电话号码格式要求。
- [SMS 同意关键词管理](https://documentation.onesignal.com/docs/cn/sms-consent-keyword-management.md): 管理 SMS 选择退出关键词、重新订阅流程和自动回复。涵盖 STOP/HELP/START 行为、面向字母数字发送方的网页退订、共享发送方的选择退出策略，以及查看订阅者的同意状态。
- [SMS 关键词](https://documentation.onesignal.com/docs/cn/keywords.md): OneSignal 中的 SMS 关键词通过自动回复、用户标记和基于订阅者响应的细分来实现双向互动。

##### 短信消息

- [SMS 消息报告](https://documentation.onesignal.com/docs/cn/sms-message-reports.md): 在 OneSignal 中查看 SMS 和 RCS 投递统计、点击率以及失败详情。涵盖所有消息指标、错误代码故障排除、数据保留以及如何导出数据。
- [一次性密码（OTP）](https://documentation.onesignal.com/docs/cn/sms-verify.md): 使用 OneSignal 发送一次性密码消息，用于双因素身份验证、账户验证和欺诈防范。涵盖 OneSignal Verify、自建验证码身份验证、专用发件人最佳实践以及受众验证。

#### 实时活动

- [Live Activities](https://documentation.onesignal.com/docs/cn/live-activities.md): 在 iOS 锁屏和 Dynamic Island 上为配送、行程和实时比分显示实时更新，涵盖设置、定位和分析。
- [Live Activities 分析](https://documentation.onesignal.com/docs/cn/live-activities-analytics.md): 了解如何通过 OneSignal 分析和测量您的 iOS Live Activities 性能。跟踪投递率、点击量和用户参与度，以优化您的实时更新策略。

#### 功能

- [A/B 测试](https://documentation.onesignal.com/docs/cn/ab-testing.md): 使用 OneSignal 的 A/B 测试优化推送和邮件消息，提升用户参与度和营销活动效果。
- [多语言消息传递](https://documentation.onesignal.com/docs/cn/multi-language-messaging.md): 使用 OneSignal 的仪表板或 API 在推送、电子邮件和应用内消息中发送多语言个性化消息。
- [重定向消息](https://documentation.onesignal.com/docs/cn/retargeting.md): 了解如何使用 OneSignal 根据用户过去的消息交互重定向用户。通过向与您原始消息交互或未交互的用户发送后续消息来提高参与度。
- [模板](https://documentation.onesignal.com/docs/cn/templates.md): 在 OneSignal 中为推送通知、电子邮件和短信创建、发送和跟踪可重复使用的模板，支持 Liquid 个性化和聚合性能指标。
- [标签](https://documentation.onesignal.com/docs/cn/labels.md): 使用 OneSignal 中的标签来组织和管理跨推送、电子邮件、短信和应用内渠道的消息。轻松过滤、分类并简化您的活动工作流程。

##### 消息个性化

- [个性化](https://documentation.onesignal.com/docs/cn/message-personalization.md): 比较 OneSignal 中的 Properties、Custom Events、custom_data 和 Data Feeds 等个性化数据来源，并使用 Liquid 语法在推送通知、邮件和短信中渲染用户姓名、购物车商品、账户余额或一次性密码等动态内容，发送个性化消息。
- [使用 Liquid 语法](https://documentation.onesignal.com/docs/cn/using-liquid-syntax.md): 使用 Liquid 标签、过滤器、条件语句和循环个性化电子邮件、推送、短信、应用内和 Live Activity 内容——由 OneSignal 数据源（如标签、属性、自定义数据和 Data Feeds）提供支持。
- [数据源](https://documentation.onesignal.com/docs/cn/data-feeds.md): 使用数据源，通过 Liquid 语法实现个性化，在发送时将您的 API 中的实时数据拉取到 OneSignal 电子邮件消息中。
- [使用 Custom Events 进行个性化](https://documentation.onesignal.com/docs/cn/personalization-custom-event.md): 使用 Custom Event 属性通过 Liquid 语法个性化 Journey 消息。了解事件如何存储、访问以及在推送、邮件和短信模板中渲染。
- [使用属性进行个性化](https://documentation.onesignal.com/docs/cn/personalization-properties-and-tags.md): 使用预定义属性和自定义数据 Tags 个性化 OneSignal 消息。通过 Liquid 语法跨电子邮件、推送、短信和 Webhook 访问用户、订阅、Journey、消息、模板和应用级数据。
- [使用 API custom_data 个性化消息](https://documentation.onesignal.com/docs/cn/personalization-api-custom-data.md): 通过 Create Message API 使用 custom_data 发送动态的、消息级别的数据。使用 Liquid 语法在模板中引用值，实现实时个性化。
- [使用 CSV 的动态内容](https://documentation.onesignal.com/docs/cn/dynamic-content.md): 在 OneSignal 中使用 CSV 上传和 Liquid 语法，大规模个性化推送、电子邮件和短信消息。

##### URL、链接和深层链接

- [URL、链接和深度链接](https://documentation.onesignal.com/docs/cn/links.md): 设置推送通知、电子邮件、应用内消息、短信和 RCS 中的启动 URL、深度链接、动态 URL、UTM 跟踪和点击跟踪。
- [深度链接](https://documentation.onesignal.com/docs/cn/deep-linking.md): 设置深度链接，通过通用链接、应用链接或自定义 URI 方案，将用户从推送通知、电子邮件和应用内消息引导至 Android 或 iOS 应用中的特定页面。
- [邮件取消订阅链接和标头](https://documentation.onesignal.com/docs/cn/unsubscribe-links-email-subscriptions.md): 了解如何在 OneSignal 中管理邮件取消订阅行为，包括取消订阅链接、List-Unsubscribe 标头、抑制规则和重新订阅工作流程。

### 旅程

- [旅程概述](https://documentation.onesignal.com/docs/cn/journeys-overview.md): 基于用户行为、时间延迟或个人资料属性发送电子邮件、推送通知、短信和应用内消息的自动化多渠道消息流程。
- [旅程示例](https://documentation.onesignal.com/docs/cn/journeys-examples.md): 入门、重新参与、购物车放弃、A/B 测试、循环发送和事件驱动工作流的分步旅程配置。

#### 旅程功能

- [Journey 设置](https://documentation.onesignal.com/docs/cn/journeys-settings.md): 配置您的 Journey，包括谁进入、退出、重新进入以及何时开始或停止。
- [旅程消息](https://documentation.onesignal.com/docs/cn/journeys-messages.md): 配置旅程中的推送通知、电子邮件、短信和应用内消息步骤，包括模板、投递时间和会话要求。
- [旅程操作](https://documentation.onesignal.com/docs/cn/journeys-actions.md): 定义等待期、根据用户行为分支旅程并使用旅程步骤标记用户。
- [旅程 Webhook](https://documentation.onesignal.com/docs/cn/journeys-webhook.md): 从旅程步骤向外部服务器发送 HTTP 请求，通过 Liquid 语法使用用户数据进行个性化，并具备重试逻辑和调试工具。
- [通过 Journey Webhook 发送 WhatsApp 消息](https://documentation.onesignal.com/docs/cn/sending-whatsapp-messages-via-journey-webhooks.md): 使用 OneSignal Journeys 和 webhook 自动发送 WhatsApp 消息。
- [管理 Journey](https://documentation.onesignal.com/docs/cn/managing-journeys.md): 编辑 Journey 步骤和消息、查看统计数据、复制或归档流程、删除 Journey，以及添加团队笔记进行协作。
- [旅程分析](https://documentation.onesignal.com/docs/cn/journeys-analytics.md): 通过推送、电子邮件、SMS 和应用内渠道的传递指标、用户活动和转化洞察分析 OneSignal 旅程性能。

### 受众和自定义事件

- [细分](https://documentation.onesignal.com/docs/cn/segmentation.md): 在 OneSignal 中创建和管理动态用户细分，基于活动、位置、标签等进行个性化消息定向。
- [导入](https://documentation.onesignal.com/docs/cn/import.md): 使用CSV上传、REST API或手动输入在OneSignal中导入或更新用户。支持电子邮件、短信、标签等，实现无缝用户入门或迁移。

#### 用户 & 订阅

- [用户](https://documentation.onesignal.com/docs/cn/users.md): 了解用户在 OneSignal 中的工作方式，包括用户识别、OneSignal ID、外部 ID，以及如何跨渠道管理订阅和用户属性。
- [订阅](https://documentation.onesignal.com/docs/cn/subscriptions.md): 在 OneSignal 中管理移动推送、网络推送、电子邮件和 SMS 的订阅。涵盖属性、状态以及如何更新或迁移订阅。
- [别名](https://documentation.onesignal.com/docs/cn/aliases.md): 了解如何在 OneSignal 中使用自定义别名，通过您自己的唯一标识符跨不同平台和设备识别和跟踪用户。别名有助于统一来自多个来源的用户数据，对于集成、用户数据管理和事务性消息传递至关重要。
- [测试用户](https://documentation.onesignal.com/docs/cn/test-users.md): 在 OneSignal 中将用户标记为测试用户，以便在正式发送前验证所有订阅的消息投递、渲染效果和 Journey 行为。
- [删除用户](https://documentation.onesignal.com/docs/cn/delete-users.md): 通过仪表板或 API 在 OneSignal 中删除用户和订阅，用于隐私合规、数据清理或批量删除非活跃数据。

#### 自定义事件

- [自定义事件](https://documentation.onesignal.com/docs/cn/custom-events.md): 使用自定义事件跟踪用户行为，用于触发旅程、通过等待直到步骤控制流程、实时个性化消息以及衡量转化。
- [自定义事件存储和保留](https://documentation.onesignal.com/docs/cn/custom-event-storage.md): 存储自定义事件以构建细分并在用户资料上查看事件历史，为每个事件选择保留期，并管理已存储的事件。

#### 标签

- [标签](https://documentation.onesignal.com/docs/cn/add-user-data-tags.md): 使用OneSignal数据标签存储用户属性和跟踪事件，实现高级细分和个性化消息传递。
- [标签：时间操作符](https://documentation.onesignal.com/docs/cn/time-operators.md): 使用时间流逝操作符搭配以秒为单位存储 Unix 时间戳的标签，自动发送相对于特定时刻的消息，例如事件发生后的跟进或即将到来的日期前的提醒，适用于购物车放弃挽回、生日祝福、预约与续订提醒等常见用例，无需手动安排即可实现基于时间的消息自动化，并支持与细分和 Journeys 结合使用。

### 分析和集成

#### 分析

- [分析概述](https://documentation.onesignal.com/docs/cn/analytics-overview.md): OneSignal 分析功能概述：在仪表板中衡量消息表现、用户参与度和转化效果，涵盖消息报告、参与与订阅趋势、留存分析、旅程与模板分析、转化归因和目标设置，以及事件流和 CSV 数据导出选项，帮助您根据优化活动、调试投递或分析长期行为等目标选择合适的分析工具。
- [目标](https://documentation.onesignal.com/docs/cn/goals.md): 在旅程（Journeys）上使用参与或转化指标定义成功指标和目标值，然后在旅程交付报告中实时跟踪进度，了解哪些消息内容有效。本文介绍目标可跟踪的参与与转化指标类型、目标的设置步骤，以及如何在交付报告中解读目标的完成情况。目标功能目前处于测试版阶段，所有计划均可提前体验。
- [模板分析](https://documentation.onesignal.com/docs/cn/template-analytics.md): 在 OneSignal 中查看推送通知、电子邮件和短信模板的投递统计、参与度指标和受众活动。
- [导出数据](https://documentation.onesignal.com/docs/cn/exporting-data.md): 使用仪表板 CSV 导出、REST API 端点和 Event Streams 实时数据流从 OneSignal 导出数据，涵盖消息与投递数据、每条消息的受众活动、订阅与用户配置文件数据以及邮件消息投递报告，帮助您根据自身用例选择合适的数据导出与集成方式，满足分析与备份需求。
- [自定义结果](https://documentation.onesignal.com/docs/cn/custom-outcomes.md): 学习如何使用OneSignal自定义结果跟踪推送通知和应用内消息产生的用户操作和收入。自定义归因并通过跨平台的灵活结果类型测量参与度。
- [转化指标](https://documentation.onesignal.com/docs/cn/conversion-metrics.md): 通过将购买和注册等转化归因于推送、电子邮件、短信、应用内消息和 RCS 消息，追踪您的消息传递的业务影响。
- [参与度趋势](https://documentation.onesignal.com/docs/cn/engagement-analytics.md): 使用 OneSignal 参与度趋势图表跟踪推送、应用内消息、电子邮件和短信的用户参与度，涵盖通过仪表板、API 或旅程发送的全部消息，查看发送量、投递率、点击率和退订率等统计数据，支持导出为 CSV 文件，并根据您的定价计划保留长达两年的历史数据，便于分析参与趋势。
- [订阅趋势](https://documentation.onesignal.com/docs/cn/subscription-trends.md): 在 OneSignal 仪表板的订阅趋势图表中按渠道跟踪订阅数随时间的增长和下降：监控推送、电子邮件、短信和应用内渠道的总订阅数、选择加入与退出活动以及订阅状态变化，与消息参与度指标区分开来，帮助您了解受众规模的真实变化并及时发现异常退订，从而优化您的订阅增长策略。
- [指标术语表](https://documentation.onesignal.com/docs/cn/analytics-metrics-glossary.md): 对照 OneSignal 仪表板、View Message API、CSV 导出和 Event Streams 中推送、邮件、短信/RCS、应用内消息及 Live Activities 的投递与参与指标名称，包含各渠道术语定义、投递生命周期和指标映射，帮助协调不同数据来源并构建内部报告。

##### 留存指标

- [留存指标](https://documentation.onesignal.com/docs/cn/retention-metrics.md): 使用 OneSignal 仪表板上的留存图表追踪用户在活跃后的几天内是否回访您的应用或网站：按起始日期构建用户同期群，衡量 7 天、14 天或 30 天留存率，并了解可用的渠道筛选器、会话定义、数据可用性与图表导出选项。留存功能目前处于测试阶段，已向所有账户开放。
- [解读留存曲线](https://documentation.onesignal.com/docs/cn/interpreting-retention-curves.md): 在选定同期群后解读 OneSignal 留存曲线：了解曲线形状对用户回访行为的含义、留存率为何会随时间上升、如何将曲线变化视为需要调查的信号而非原因，以及如何按推送等渠道和平台序列比较留存表现与计算方式，并结合转化指标将消息与用户后续行为关联，从而定位留存变化的原因。

#### 事件流

- [事件流](https://documentation.onesignal.com/docs/cn/event-streams.md): 将已发送、已投递、已点击和已退回等消息事件从 OneSignal 实时流式发送到您的服务器、webhook 和集成。
- [Event Stream 数据参考](https://documentation.onesignal.com/docs/cn/event-streams-data.md): Event Streams 和 Webhooks 中可用的所有事件、消息、用户和订阅属性的架构参考，以及每个字段的 Liquid 语法。
- [应用内消息事件流](https://documentation.onesignal.com/docs/cn/iam-event-streams.md): 如何利用事件流来捕获应用内消息指标
- [Google Sheets 与事件流集成](https://documentation.onesignal.com/docs/cn/google-sheets-integration-with-event-streams.md): 本指南介绍设置 OneSignal 的事件 Webhooks 与自定义 Google Sheets 文档连接所需的步骤，以分析 OneSignal 生成的消息事件。

#### 集成

- [集成概览](https://documentation.onesignal.com/docs/cn/integrations.md): 将 OneSignal 连接到第三方平台，同步受众、自定义事件和消息数据，涵盖数据仓库、CRM、分析和自动化工具等集成目录，帮助您根据目标选择入站、出站或双向集成，并了解事件流 webhooks、旅程 webhooks 与自定义数据库、DMP 或 CRM 连接选项。
- [数据仓库、DMP 和 CRM 集成](https://documentation.onesignal.com/docs/cn/database-dmp-crm-integration.md): 将您的 CRM、数据库或 DMP 与 OneSignal 集成，以触发个性化的实时通知并大规模同步用户消息数据。

##### OneSignal 作为数据源

- [Amplitude](https://documentation.onesignal.com/docs/cn/amplitude.md): 将 OneSignal 与 Amplitude 集成，同步行为群体、跟踪消息事件，并跨推送、电子邮件、短信和应用内渠道定向用户。
- [Databricks](https://documentation.onesignal.com/docs/cn/databricks.md): 将 OneSignal 消息事件导出到 Databricks，并将 Databricks 行为事件导入到 OneSignal，以触发旅程并个性化消息。
- [Google BigQuery](https://documentation.onesignal.com/docs/cn/bigquery.md): 将消息事件数据导出到 BigQuery，并从 BigQuery 导入自定义事件以触发个性化活动。
- [Mixpanel](https://documentation.onesignal.com/docs/cn/mixpanel.md): 将 OneSignal 与 Mixpanel 集成，以同步行为群组、跟踪消息事件，并通过推送、电子邮件、短信和应用内渠道定向用户。
- [Snowflake](https://documentation.onesignal.com/docs/cn/snowflake.md): 连接 OneSignal 与 Snowflake：导出消息事件数据进行分析，并同步自定义用户事件以触发自动化 Journey 和个性化消息。
- [Segment (Twilio)](https://documentation.onesignal.com/docs/cn/segment-onesignal-integration.md): 将 OneSignal 与 Twilio Segment 集成，用于用户数据和消息事件。

##### OneSignal 作为目的地

- [Adobe Audience Manager](https://documentation.onesignal.com/docs/cn/adobe-audience-manager.md): 学习如何将OneSignal与Adobe Audience Manager集成，同步受众细分和行为数据，实现有针对性的多渠道消息活动，推动参与度、转化和收入增长。
- [AlloyDB](https://documentation.onesignal.com/docs/cn/alloydb.md): 将 Google AlloyDB 的自定义事件同步到 OneSignal，基于用户行为触发自动化旅程和个性化消息活动。
- [Amazon Athena](https://documentation.onesignal.com/docs/cn/amazon-athena.md): 将 Amazon Athena 的自定义事件同步到 OneSignal，基于用户行为触发自动化旅程和个性化消息活动。
- [Amazon S3](https://documentation.onesignal.com/docs/cn/s3.md): 将来自 Amazon S3 CSV 文件的自定义事件同步到 OneSignal，以根据用户行为触发自动化 Journey 和个性化消息活动。
- [Amplitude](https://documentation.onesignal.com/docs/cn/amplitude.md): 将 OneSignal 与 Amplitude 集成，同步行为群体、跟踪消息事件，并跨推送、电子邮件、短信和应用内渠道定向用户。
- [Apache Kafka](https://documentation.onesignal.com/docs/cn/kafka.md): 从 Apache Kafka 主题同步自定义事件到 OneSignal，以基于实时用户行为触发自动化旅程和个性化消息传递活动。
- [Amazon Redshift](https://documentation.onesignal.com/docs/cn/amazon-redshift.md): 将 Amazon Redshift 的自定义事件同步到 OneSignal，基于用户行为触发自动化旅程和个性化消息活动。
- [Azure Synapse](https://documentation.onesignal.com/docs/cn/azure-synapse.md): 将 Azure Synapse 的自定义事件同步到 OneSignal，以基于用户行为触发自动化旅程和个性化消息活动。
- [ClickHouse](https://documentation.onesignal.com/docs/cn/clickhouse.md): 将 ClickHouse 作为自定义事件源连接到 OneSignal，从高性能列式分析数据库自动同步用户行为事件，用于触发自动化旅程和个性化消息活动，涵盖创建只读数据库用户、映射事件数据列、配置同步的具体步骤，以及针对大型事件表的查询优化建议，实现数据高效稳定同步。
- [Confluent Cloud](https://documentation.onesignal.com/docs/cn/confluent-cloud.md): 将Confluent Cloud的自定义事件同步到OneSignal，基于实时用户行为触发自动化旅程和个性化消息活动。
- [Databricks](https://documentation.onesignal.com/docs/cn/databricks.md): 将 OneSignal 消息事件导出到 Databricks，并将 Databricks 行为事件导入到 OneSignal，以触发旅程并个性化消息。
- [Elasticsearch](https://documentation.onesignal.com/docs/cn/elasticsearch.md): 从 Elasticsearch 同步自定义事件到 OneSignal，以根据用户行为触发自动化 Journey 和个性化消息传送活动。
- [Google BigQuery](https://documentation.onesignal.com/docs/cn/bigquery.md): 将消息事件数据导出到 BigQuery，并从 BigQuery 导入自定义事件以触发个性化活动。
- [Google Cloud SQL](https://documentation.onesignal.com/docs/cn/google-cloud-sql.md): 从 Google Cloud SQL 同步自定义事件到 OneSignal，基于用户行为触发自动化 Journeys 和个性化消息活动。
- [Google Sheets](https://documentation.onesignal.com/docs/cn/google-sheets.md): 将自定义事件从 Google Sheets 同步到 OneSignal，以基于用户行为触发自动化 Journeys 和个性化消息推送活动。
- [Greenplum](https://documentation.onesignal.com/docs/cn/greenplum.md): 将自定义事件从 Greenplum 同步到 OneSignal，以基于用户行为触发自动化 Journeys 和个性化消息推送活动。
- [HubSpot](https://documentation.onesignal.com/docs/cn/hubspot.md): 使用原生 OneSignal 集成，通过 HubSpot 工作流自动化推送通知、电子邮件、短信和应用内消息。
- [Materialize](https://documentation.onesignal.com/docs/cn/materialize.md): 将 Materialize 的自定义事件同步到 OneSignal，基于实时用户行为触发自动化 Journey 和个性化消息传递活动。
- [Microsoft Fabric](https://documentation.onesignal.com/docs/cn/microsoft-fabric.md): 将自定义事件从 Microsoft Fabric 同步到 OneSignal，以基于用户行为触发自动化旅程和个性化消息活动。
- [Mixpanel](https://documentation.onesignal.com/docs/cn/mixpanel.md): 将 OneSignal 与 Mixpanel 集成，以同步行为群组、跟踪消息事件，并通过推送、电子邮件、短信和应用内渠道定向用户。
- [MotherDuck](https://documentation.onesignal.com/docs/cn/motherduck.md): 将 MotherDuck 的自定义事件同步到 OneSignal，基于用户行为触发自动化 Journey 和个性化消息活动。
- [MySQL](https://documentation.onesignal.com/docs/cn/mysql.md): 将 MySQL 的自定义事件同步到 OneSignal，基于用户行为触发自动化 Journey 和个性化消息活动。
- [PostgreSQL](https://documentation.onesignal.com/docs/cn/postgresql.md): 将 PostgreSQL 中的自定义事件同步到 OneSignal，以根据用户行为触发自动化 Journey 和个性化消息活动。
- [Pub/Sub](https://documentation.onesignal.com/docs/cn/google-pubsub.md): 将自定义事件从 Google Pub/Sub 同步到 OneSignal，以基于实时用户行为触发自动化 Journeys 和个性化消息推送活动。
- [SingleStore](https://documentation.onesignal.com/docs/cn/singlestore.md): 将 SingleStore 的自定义事件同步到 OneSignal，以基于用户行为触发自动化 Journeys 和个性化消息活动。
- [Snowflake](https://documentation.onesignal.com/docs/cn/snowflake.md): 连接 OneSignal 与 Snowflake：导出消息事件数据进行分析，并同步自定义用户事件以触发自动化 Journey 和个性化消息。
- [SQL Server](https://documentation.onesignal.com/docs/cn/sql-server.md): 将 Microsoft SQL Server 的自定义事件同步到 OneSignal，基于用户行为触发自动化 Journey 和个性化消息活动。
- [Starburst Enterprise](https://documentation.onesignal.com/docs/cn/starburst-enterprise.md): 将自定义事件从 Starburst Enterprise 同步到 OneSignal，以触发基于用户行为的自动化旅程和个性化消息活动。
- [Starburst Galaxy](https://documentation.onesignal.com/docs/cn/starburst-galaxy.md): 将自定义事件从 Starburst Galaxy 同步到 OneSignal，以基于用户行为触发自动化旅程和个性化消息活动。
- [Trino](https://documentation.onesignal.com/docs/cn/trino.md): 将自定义事件从 Trino 同步到 OneSignal，以基于用户行为触发自动化旅程和个性化消息活动。
- [Segment (Twilio)](https://documentation.onesignal.com/docs/cn/segment-onesignal-integration.md): 将 OneSignal 与 Twilio Segment 集成，用于用户数据和消息事件。

##### 归因

- [RevenueCat](https://documentation.onesignal.com/docs/cn/revenuecat.md): 从 RevenueCat 同步应用内购买和订阅数据到 OneSignal 以实现个性化消息传递。
- [Adjust](https://documentation.onesignal.com/docs/cn/adjust.md): 将 OneSignal External ID 作为 Adjust 合作伙伴参数传递，把 Adjust 的归因和事件回调与 OneSignal 用户关联起来。
- [BlueConic](https://documentation.onesignal.com/docs/cn/blueconic.md): 配置 BlueConic Webhook 集成，在站点发生特定事件时通过 Update user API 将用户档案和细分数据实时同步到 OneSignal，涵盖使用 BlueConic ID 作为别名关联用户、更新脚本示例以及 Webhook 连接的设置步骤。

### 隐私和安全

#### 安全凭证

- [SOC 2 Type II](https://documentation.onesignal.com/docs/cn/soc-2-type-ii.md): OneSignal 的 SOC 2 Type II 合规认证和安全控制。
- [ISO 27001](https://documentation.onesignal.com/docs/cn/iso27001.md): 了解 ISO/IEC 27001 信息安全管理系统（ISMS）国际标准的涵盖范围与要求、OneSignal 在信息安全管理方面的认证状态，以及如何按需索取认证证书副本，帮助您评估 OneSignal 在数据安全、风险管理与合规审计方面提供的保障措施，满足供应商安全审查需求。
- [HIPAA](https://documentation.onesignal.com/docs/cn/hipaa.md): OneSignal HIPAA 合规性概述，包括企业客户的 BAA。

#### 数据隐私和合规

- [GDPR 和个人权利](https://documentation.onesignal.com/docs/cn/gdpr-compliance.md): OneSignal 提供以下解决方案来帮助符合 GDPR 合规要求。
- [欧盟-美国数据隐私框架](https://documentation.onesignal.com/docs/cn/eu-us-data-privacy-framework.md): 了解在将欧盟个人数据传输给美国公司时，欧盟-美国数据隐私框架为何重要：它为欧盟个人提供数据访问、更正与删除等权利，以及免费的独立争议解决机制和仲裁小组等补救途径，并确认 OneSignal 已通过该框架认证、列于官方公共注册表，为欧盟个人数据的跨境处理提供合规保障。
- [邮件法规合规](https://documentation.onesignal.com/docs/cn/email-compliance.md): 了解如何在使用 OneSignal 发送营销邮件时遵守全球隐私和通信法规。本指南涵盖欧盟、美国、加拿大等主要地区的同意要求、退出规则和邮件内容法规。
- [SMS 法规合规](https://documentation.onesignal.com/docs/cn/sms-regulatory-compliance.md): 了解 OneSignal 支持的每个国家/地区的 SMS 合规要求。涵盖按消息类型划分的同意标准、发送者标识、选择退出、安静时段、禁止内容、记录保存和欺诈防范。
- [Apple 应用隐私要求](https://documentation.onesignal.com/docs/cn/apple-app-privacy-requirements.md): 了解如何在您的 iOS 应用中准确披露 OneSignal 的使用情况，以符合 Apple 的应用隐私要求。了解 OneSignal 收集哪些数据类型以及如何在 App Store Connect 中报告这些数据。
- [Google Play 数据安全要求](https://documentation.onesignal.com/docs/cn/google-play-data-safety-requirements.md): 学习在使用 OneSignal 时如何准确填写 Google Play 数据安全表单。了解收集了哪些数据、如何披露以及确保符合 Google 的隐私政策。
- [数据收集和安全常见问题](https://documentation.onesignal.com/docs/cn/data-questions.md): 了解 OneSignal 如何保护您的数据、维护合规性并支持隐私法规。
- [OneSignal SDK收集的数据](https://documentation.onesignal.com/docs/cn/data-collected-by-the-onesignal-sdk.md): OneSignal SDK自动、手动和/或通过用户许可收集的数据字段——以及如何控制数据收集以确保隐私合规。
- [处理个人数据](https://documentation.onesignal.com/docs/cn/handling-personal-data.md): 了解 OneSignal 如何处理个人数据以及如何满足 GDPR、CCPA 等隐私法规要求，涵盖处理用户数据的全部选项、数据收集与删除的最佳实践，以及在合规场景下获取 DPA 数据处理协议和标准合同条款的方法，即使是免费计划也支持合规使用，帮助您安心保护用户个人信息与隐私。

#### 认证

- [两步验证](https://documentation.onesignal.com/docs/cn/2-step-authentication.md): 设置、管理和恢复OneSignal账户的双重身份验证(2FA)，包括恢复代码、转移到新设备以及被锁定后重新获取访问权限。
- [单点登录 (SSO)](https://documentation.onesignal.com/docs/cn/sso.md): 为您的 OneSignal 组织配置 SSO（SAML 2.0 或 OIDC），使团队成员通过您的身份提供者进行身份验证。
