关键 API 标识符

本文列出了 Pushwoosh API 请求中使用的基本标识符。这些标识符是跨应用进行身份验证、消息创建、目标定位、分群、跟踪和用户管理所必需的。

通用标识符

应用代码

分配给您 Pushwoosh 帐户中每个应用的唯一标识符。在大多数 API 调用中，都需要它来指定目标应用。

在哪里找到

Pushwoosh 控制面板 → 应用名称下方。

API 访问令牌

分配给 Pushwoosh 帐户的唯一令牌，用于验证 API 请求。它允许访问以管理项目、发送消息、修改设置和检索数据。默认情况下，每个帐户至少创建一个令牌。了解更多

在哪里找到

Pushwoosh 控制面板 → API 访问。

设备标识符

硬件 ID

由 Pushwoosh SDK 分配给设备的唯一标识符。由 SDK 自动设置或在设备注册期间传递。了解更多

在哪里找到

• 在设备日志中。了解更多

• 在 用户浏览器 中按 User ID 搜索时

• 从 分群列表 下载的 CSV 文件中

推送令牌

由平台提供商颁发的令牌，用于识别应用-设备对以发送推送通知。当授予推送权限时，SDK 会自动收集。了解更多

在哪里找到

• 在设备日志中。了解更多

• 在 用户浏览器 中，在搜索字段中输入 HWID 以查找关联的设备，然后打开设备详细信息以查看推送令牌。

设备类型

使用数字代码指示目标设备的平台。由 SDK 自动设置。

支持的值：

1 – iOS
3 – Android
7 – macOS
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
14 – Email
17 – Huawei
18 – SMS
21 – WhatsApp
22 – Line

用户标识符

User ID

分配给用户的自定义标识符，可实现跨设备和个性化定位。了解更多

在哪里找到

Pushwoosh 控制面板 → 受众 → 用户浏览器

消息标识符

消息代码

创建时分配给每条消息的唯一标识符。它遵循特定格式：XXXX-XXXXXXXX-XXXXXXXX。

此代码对于以下操作至关重要：

• 跟踪特定消息的状态和送达情况
• 取消（或删除）先前发送的消息
• 获取消息统计信息

在哪里找到

• Pushwoosh 控制面板： 导航到 消息历史，然后打开所需消息的 属性。消息代码将显示在那里。
• /createMessage API 响应： 通过 API 创建新消息时，消息代码会包含在响应中。

内容标识符

预设代码

已保存消息预设（例如，推送或短信）的标识符。了解更多

在哪里找到

Pushwoosh 控制面板 → 内容 → 预设。

您可以在两个地方找到预设代码：

• 在列表视图中，显示在预设名称下方。

• 在编辑或创建预设时，位于 URL 中（它是 URL 的最后一部分）。

示例：

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/sms-presets/edit/AAAAA-BBBBB

预设代码：AAAAA-BBBBB

富媒体代码

应用内消息模板的标识符。了解更多

在哪里找到

Pushwoosh 控制面板 → 内容 → 富媒体。

示例： URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics 富媒体代码：AAAAA-BBBBB

电子邮件内容代码

电子邮件内容代码是已保存电子邮件内容的唯一标识符。了解更多

在哪里找到

Pushwoosh 控制面板 → 内容 → 电子邮件内容。

该代码是 URL 的最后一部分。

示例：

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/email-content/edit/AAAAA-BBBBB 电子邮件内容代码：AAAAA-BBBBB

营销活动标识符

营销活动代码

用于引用特定营销活动以进行跟踪和分析的唯一标识符。

在哪里找到

在 Pushwoosh 控制面板中查看营销活动相关统计信息时，营销活动代码会出现在 URL 中。 要找到它，请转到 统计 → 聚合统计，点击所需的营销活动，然后复制 URL 末尾的代码。

示例：

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/statistics/aggregated-message?campaignCode=YYYYY-YYYYY

营销活动代码： YYYYY-YYYYY

Journey ID

用于将消息与特定营销活动关联以进行跟踪和性能分析的唯一标识符。

在哪里找到

Journey ID 出现在 Pushwoosh 控制面板中营销活动画布的 URL 中。

示例： URL: https://app.pushwoosh.com/journeys/XXXXX-XXXXX/1/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Journey ID: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

分群和定位标识符

分群 / 筛选器名称

在 Pushwoosh 中为受众定位创建的预定义用户分群的名称。了解更多

在哪里找到

Pushwoosh 控制面板 → 分群。

分群 / 筛选器代码

格式为 XXXXX-XXXXX 的唯一代码，用于识别 Pushwoosh 中的分群（也称为筛选器）。此代码用于 API 调用、自动化逻辑和动态分群规则。

在哪里找到

• 通过 /listFilters API 方法。

• 在 Pushwoosh 控制面板中查看分群时，位于地址栏中：

示例：

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/segments/XXXE9-XXX49/detail 分群代码： XXXE9-XXX49

标签

分配给用户或设备的自定义属性。用于动态分群和个性化。了解更多

在哪里找到

Pushwoosh 控制面板 → 标签或通过 /getTags API。

事件标识符

事件名称

被跟踪事件的名称（例如，purchase、login、subscription）。用于触发自动化工作流或进行分析。了解更多

在哪里找到

Pushwoosh 控制面板 → 受众 → 事件。

地理位置标识符

地理区域 ID

识别用于触发基于位置的通知的地理围栏区域。了解更多

在哪里找到

Pushwoosh 控制面板 → 地理区域。