跳转到主要内容

​
概览

您可以在推送、电子邮件、应用内消息和短信中包含 URL 和深度链接。本指南解释了如何正确设置这些链接、链接跟踪的工作原理以及何时使用深度链接。
对于更高级的链接（如自定义方案或应用路由），请参阅我们的深度链接指南。

​
平台链接选项

  • 推送通知
  • 电子邮件
  • 应用内消息
  • 短信

​
启动 URL

使用启动 URL 在点击通知时打开链接。这通常会在默认浏览器中打开，并应以 https:// 开头。
要在 Apple 设备上使用 http:// URL，您必须在应用的 Info.plist 文件中设置 NSAppTransportSecurity 属性。
如果您使用像 your-custom-scheme:// 这样的移动深度链接，结果可能会有所不同。请参阅深度链接。

​
针对多个平台

如果您向网页和移动用户发送单一消息，请使用：
  • url — 用于跨所有平台的常规定向。
  • web_url — 用于网页推送订阅。
  • app_url — 用于移动订阅。

OneSignal 仪表板 - 启动 URL 字段

​
附加数据

您可以使用附加数据字段（API 中的 data）而不是启动 URL 来随推送发送自定义数据，并使用 SDK 的通知点击监听器通过 additionalData 属性在您的应用中处理此数据。这可能比启动 URL 更好的选择，提供更多灵活性。

通过附加数据字段在您的应用中发送要读取的 URL。

​
动态 URL

您可以使用 Liquid 语法 和以下数据创建自定义的用户特定 URL：
  • 用户属性（如 external_id、email）
  • 存储在 OneSignal 中的标签
  • 通过 API 发送的 custom_data
这在您的消息中启用个性化链接，引导用户到专门为他们量身定制的内容。
  • 用户属性
  • 数据标签
  • custom_data
将像 external_id 或 email 这样的值直接注入到 URL 中。Example:
  https://yourdomain.com/profile/user={{subscription.external_id}}
如果用户的 external_id 是 12345，最终 URL 将是：
https://yourdomain.com/profile/user=12345
Similarly:
https://yourdomain.com/profile/email={{subscription.email}}
如果用户的电子邮件地址是 john@example.com，最终 URL 将是：
https://yourdomain.com/profile/email=john@example.com
最佳实践：
  • 仅为 URL 的部分设置数据标签或 custom_data。不要在 URL 中包含协议（https:// 或 your-app-scheme://）和域名。
  • 如果没有设置标签，请使用 default 过滤器设置默认值。
有关更多详情，请参阅：

​
UTM 参数

UTM 参数通过在 URL 中附加 source、medium 和 campaign 详情来帮助跟踪消息活动的性能。只需将您的 UTM 参数直接添加到您消息的 URL 中。 您可以让 OneSignal 自动将 UTM 添加到从仪表板发送的推送通知启动 URL。
导航到设置 > 推送和应用内 > UTM 设置并开启自动 UTM 标记。一旦启用，OneSignal 会附加您可以编辑的提供值：
  • Source = utm_source 默认为 onesignal
  • Medium = utm_medium 默认为 push
  • Campaign = utm_campaign 默认为 {{ sendDate }}-{{ title }}
    • sendDate：发送日期
    • title：消息标题中的前 15 个字母数字字符、下划线或连字符
Example:
https://test.com?utm_source=onesignal&utm_medium=push&utm_campaign=2020-06-03-sale-today
来自仪表板的 UTM 标记不适用于：
  • 电子邮件、短信、应用内消息
  • 旅程、模板、自动化消息
  • API 请求
  • “发送测试消息”按钮
  • 附加数据字段
对于这些情况，您必须在模板或 API 负载中手动添加 UTM 参数。

​
URL 处理和覆盖

如果您在启用此功能的情况下向推送启动 URL 添加不同的 UTM，这些手动设置的新 UTM 将覆盖仪表板自动功能中设置的 UTM 参数。

​
常见问题

​
如何链接到应用商店？

您可以将商店链接输入为启动 URL。示例： Android - https://developer.android.com/distribute/marketing-tools/linking-to-google-play.html iOS - 获取应用商店页面的链接，但将 https:// 替换为 itms-apps://。

​
我可以链接到其他应用吗？

对于推送和应用内消息，在大多数情况下，您可以设置 URL Scheme 并使用协议 x:// 进行深度链接。例如，深度链接到 Whatsapp，您可以使用：whatsapp://wa.me/15551234567 对于电子邮件和短信，您需要使用 https:// 应用商店链接。

​
我可以防止链接到我的应用或网站吗？

目前在移动应用上，用户点击推送时将打开应用。 网页推送： 如果您不希望链接到任何页面或 URL，您可以在 URL 末尾添加 ?_osp=do_not_open，如 https://yoursite.com/page?_osp=do_not_open 作为启动 URL，这将防止推送在点击时转到任何 URL，只会解散推送。
⌘I