跳转到主要内容
受众 > 订阅显示您 OneSignal 应用中的每个订阅，以及 OneSignal SDK 收集的数据。 订阅共有四种类型：
订阅类型可接收
电子邮件电子邮件消息
短信SMS、MMS 和 RCS 消息
网页推送网页推送通知
移动移动推送通知、应用内消息和实时活动
Subscriptions page showing Email, SMS, Web Push, and Mobile subscription types

订阅

了解更多关于订阅以及如何管理它们的信息。
您可以通过外部 ID、电子邮件、电话号码或 OneSignal ID 搜索用户和/或订阅。但如果您未向 OneSignal 提供电子邮件、电话号码或外部 ID，则无法通过这些方式进行搜索。详见查找订阅。

​
测试订阅

测试订阅是您指定用于测试消息投递的一组订阅。它们会显示在专用过滤器中，并可直接从消息编辑器中定向发送。 将您的设备添加为测试订阅：
  1. 使用以下方法之一查找您的订阅 ID。
  2. 在订阅 ID 旁边，选择选项 > 添加为测试订阅。
  3. 为您的测试订阅命名。
Options menu on a subscription record with Add as test subscription highlighted

​
通过 API 设置

您也可以通过 REST API 将用户标记为测试用户，只需在创建或更新用户时设置 test_user_name 属性。 
curl -X POST https://api.onesignal.com/apps/YOUR_APP_ID/users \
  -H "Content-Type: application/json" \
  -d '{
    "properties": {
      "test_user_name": "QA Device - Jane"
    }
  }'
要移除测试用户标签，请将 test_user_name 设置为空字符串（""）。

​
查找订阅

查找订阅最简便的方式是通过 OneSignal 仪表板。如果您已知用户的外部 ID、电子邮件或电话号码，可直接在受众 > 订阅中搜索。

​
按最后活跃时间搜索

如果您不知道用户的 ID，可以通过活动记录找到您的设备：
  1. 在您要查找的设备上打开您的应用或网站。确保 OneSignal 已初始化（代码正在运行）。
  2. 在 OneSignal 仪表板中，前往受众 > 订阅。
  3. 按最后活跃排序（箭头向上），将最近活跃的设备显示在顶部。

​
确认是您的设备

如果出现多个订阅，请使用右上角的显示列过滤器，显示有助于识别您设备的其他列：
列检查内容
外部 ID应与您数据库中该用户的 ID 匹配。
最后活跃应反映您刚刚打开应用或网站的时间。刷新页面以更新。
首次会话设备首次订阅的时间。如果您刚完成首次订阅，此项很有用。
IP 地址如已启用，可与您在 whatismyipaddress.com 上查到的 IP 进行比对。参见 SDK 收集的数据。
标签、国家如果您在此设备上设置了已知标签（如 user_name 或 email），可作为参考。
设备网页显示浏览器及版本，移动应用显示设备型号及操作系统版本。

​
通过细分标签查找

如果您为用户添加了特定标签（例如 user_name、email 或其他标识符），可以创建一个带有用户标签过滤器的细分来定位该设备。
Segment builder with a user tag filter to find a specific device

​
通过代码查找订阅 ID

对于需要直接从代码中获取订阅 ID 的开发者：
  1. 在已订阅推送的浏览器配置文件中打开您的网站。
  2. 打开浏览器控制台（F12 或右键点击 > 检查 > 控制台）。
  3. 运行：OneSignal.User.PushSubscription.id
  4. 订阅 ID 将输出到控制台。
对于移动网页，请通过 USB 将 Android 设备连接到计算机，并使用 chrome://inspect/#devices 打开远程控制台会话。
使用 OneSignal SDK 的用户数据方法，从 Xcode 或 Android Studio 将订阅 ID 输出到控制台。

​
常见问题

​
如何删除测试订阅？

前往受众 > 订阅，搜索该订阅，然后选择选项 > 从测试订阅中移除。该订阅仍保留在您的应用中，但不再被标记为测试用途。

​
是否可以通过 API 设置测试订阅？

可以。在调用创建用户或更新用户时使用 test_user_name 属性，将用户标记为测试用户。此标签会自动同步至该用户的所有订阅。

​
是否可以通过 API 向测试订阅发送消息？

可以。使用创建通知 API，通过 include_subscription_ids 参数传入您测试设备的订阅 ID。

​
我的测试订阅显示为已取消订阅，如何重新订阅？

这取决于订阅类型：
  • 移动推送：用户必须在设备设置中重新为您的应用启用通知（设置 > 通知 > [您的应用]）。OneSignal 无法以编程方式覆盖用户的通知权限。
  • 网页推送：用户必须在浏览器设置中清除您网站的通知屏蔽并重新订阅。具体步骤请参见网页推送故障排查。
  • 电子邮件 / 短信：前往受众 > 订阅，找到该订阅并查看其状态。如果订阅是由取消订阅操作删除的，您可以通过更新订阅 API 将 "status" 设置为适当的值来更新它。仅在用户重新同意接收消息后才可执行此操作。
在未获得用户同意的情况下重新订阅，违反消息合规规定，可能导致垃圾邮件投诉、运营商过滤或账号暂停。

​
为什么我在仪表板中找不到我的订阅？

最常见的原因包括：
  • 您使用的页面或界面上未初始化 OneSignal SDK。
  • 您使用了错误的 ID 类型进行搜索。请尝试通过电子邮件、电话号码或订阅 ID 搜索。
  • 该订阅创建于其他 OneSignal 应用（例如测试环境与生产环境不同）。

​
相关页面

用户

了解 OneSignal 用户模型、别名和订阅记录。

细分

创建细分以定向特定用户群体（包括测试设备）。

SDK 收集的数据

查看 OneSignal SDK 为每个订阅收集和存储的数据。

创建消息 API

通过编程方式向特定订阅 ID 发送通知。