常见用例
使用交易消息来：- 发送登录和验证码 (OTP)
- 确认订单、收据或订阅更改
- 发送账单状态或续订提醒
- 提醒用户有关约会或截止日期
- 确认关键操作（例如注册或购买）
要求
在发送交易消息之前，我们建议阅读以下指南：- 了解 OneSignal 用户、订阅 和 别名。
- 设置您的 数据库、DMP 或 CRM 与 OneSignal 通信 或使用我们的一个 集成。
- 创建 模板 来个性化您的消息。
- 使用 Liquid 语法 来个性化您的消息。
识别用户
要定向单个用户，您必须在 OneSignal 中识别他们。推荐的方法是设置 External ID，它应该映射到您在数据库或 CRM 中使用的用户标识符。 OneSignal 还支持每个用户最多 20 个别名，使您能够在您的系统中关联多个标识符（例如other_user_id、facebook_id 等）。对于电子邮件和 SMS，您也可以分别使用电子邮件地址或电话号码直接发送消息。
定向用户
使用 创建消息 API 通过别名、电子邮件地址、电话号码或订阅 ID 定向用户，在推送、电子邮件和 SMS 渠道上发送交易消息。发送到别名（推荐）
使用include_aliases 来定向推荐的 external_id 或其他别名，如下所示：
发送到订阅
如果您想要发送到特定的订阅，您可以使用include_subscription_ids 属性。不推荐这个选项，因为用户可以有多个订阅。
发送到电子邮件地址
如果您有用户的电子邮件地址，您可以使用include_email_tokens 属性向他们发送电子邮件。
包含的任何在您的 OneSignal 应用中不存在的电子邮件将自动创建新的电子邮件订阅。
发送到电话号码
如果您有用户的电话号码，您可以使用include_phone_numbers 属性向他们发送 SMS 和 MMS。
包含的任何在您的 OneSignal 应用中不存在的电话号码将自动创建新的 SMS 订阅。
添加自定义数据
对于个性化内容，使用模板和 Liquid 语法将用户特定的custom_data 传递给消息。
添加自定义数据的步骤：
- 通过仪表板或 创建模板 API 创建 模板。
- 在您的模板中添加 Liquid 变量（例如
{{ message.custom_data.order_id }}）。 - 在您的创建消息 API 调用中引用
template_id和custom_data。
示例：一次性密码 (OTP)
- 使用别名、电子邮件或电话号码识别用户。
- 创建包含验证码的模板：
- 当用户请求访问时，在您的服务器上生成
verification_code。 - 将
verification_code值输入到 API 请求中。
custom_data，您可以通过字符串连接直接将变量值输入到消息中。例如：
故障排除
- 对于
include_aliases，别名必须事先在用户上注册。 - 对于电子邮件/SMS，确保格式正确。