# 关键 API 标识符

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

## 通用标识符

### 应用代码

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

**查找位置**

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

### API 访问令牌

分配给 Pushwoosh 账户的唯一令牌，用于验证 API 请求。它允许访问以管理项目、发送消息、修改设置和检索数据。每个账户默认至少创建一个令牌。[了解更多](/zh/developer/api-reference/api-access-token/)

**查找位置**

Pushwoosh 控制面板 → API Access。

## 设备标识符

### 硬件 ID

由 Pushwoosh SDK 分配给设备的唯一标识符。由 SDK 自动设置或在设备注册期间传递。[了解更多](/zh/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid)

**查找位置**

*   在设备日志中。[了解更多](/zh/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token)

*   在 [User Explorer](/zh/product/audience-data-and-segmentation/user-explorer/) 中通过 **User ID** 搜索时
*   在从 [Segments 列表](/zh/product/audience-data-and-segmentation/segmentation/segments/) 下载的 CSV 文件中

### 推送令牌

由平台提供商颁发的令牌，用于识别应用-设备对以传递推送通知。当授予推送权限时，SDK 会自动收集。[了解更多](/zh/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token)

**查找位置**

*   在设备日志中。[了解更多](/zh/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token)

*   在 [User Explorer](/zh/product/audience-data-and-segmentation/user-explorer/) 中，在搜索字段中输入 HWID 以查找关联的设备，然后打开设备详情以查看推送令牌。

### 设备类型

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

支持的值：

```
1 – iOS
3 – Android
7 – macOS
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
13 – Internet Explorer
14 – Email
16 – Baidu Android
17 – Huawei
18 – SMS
20 – Web
21 – WhatsApp
22 – Line
23 – Kakao Talk
24 – Telegram
25 – Apple Wallet
26 – Google Wallet
27 – Viber
```

## 用户标识符

### 用户 ID

分配给用户的自定义标识符，可实现跨设备和个性化定向。[了解更多](/zh/developer/pushwoosh-knowledge-hub/users-userids/users-userids/)

**查找位置**

Pushwoosh 控制面板 → Audience → User Explorer

## 消息标识符

### 消息代码

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

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

*   跟踪特定消息的状态和投递情况
*   取消（或删除）先前发送的消息
*   获取消息统计数据

**查找位置**

*   **Pushwoosh 控制面板：** 导航至 **Campaigns → One-time messages**，然后打开所需消息的 **properties**。消息代码将显示在那里。
*   **[`/createMessage`](/zh/developer/api-reference/messages-api/#createmessage) API 响应：** 通过 API 创建新消息时，消息代码会包含在响应中。

## 内容标识符

### 预设代码

已保存消息预设（例如，推送或 SMS）的标识符。[了解更多](/zh/product/content/)

**查找位置**

Pushwoosh 控制面板 → Content → Presets。

您可以在两个地方找到预设代码：
- 在列表视图中，显示在预设名称下方。

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

**示例**：

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

预设代码：`AAAAA-BBBBB`

### 富媒体代码

应用内消息模板的标识符。[了解更多](/zh/product/content/in-apps/)

**查找位置**

Pushwoosh 控制面板 → Content → Rich media。

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

### 电子邮件内容代码

电子邮件内容代码是已保存电子邮件内容的唯一标识符。[了解更多](/zh/product/content/email-content/)

**查找位置**

Pushwoosh 控制面板 → Content → Email content。

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

**示例**：

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

## 营销活动标识符

### 营销活动代码

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

**查找位置**

在 Pushwoosh 控制面板中查看营销活动相关统计数据时，营销活动代码会出现在 URL 中。
要找到它，请转到 **Statistics → Aggregated statistics**，点击所需的营销活动，然后复制 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 中为受众定向创建的预定义用户分群的名称。[了解更多](/zh/product/audience-data-and-segmentation/segmentation/segments/)

**查找位置**

Pushwoosh 控制面板 → Segments。

### 分群 / 筛选器代码

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

**查找位置**

- 通过 [`/listFilters`](/zh/developer/api-reference/segmentation-filters-api/#listfilters) API 方法。

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

**示例：**

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




### 标签

分配给用户或设备的自定义属性。用于动态分群和个性化。[了解更多](/zh/developer/guides/audience-and-segmentation/tags/)

**查找位置**

Pushwoosh 控制面板 → Tags 或通过 [`/getTags`](/zh/developer/api-reference/device-api/#gettags) API。

## 事件标识符

### 事件名称

被跟踪事件的名称（例如，`purchase`、`login`、`subscription`）。用于触发自动化工作流或进行分析。[了解更多](/zh/developer/guides/audience-and-segmentation/events/)

**查找位置**

Pushwoosh 控制面板 → Audience → Events。

## 地理位置标识符

### 地理区域 ID

识别用于触发基于位置的通知的地理围栏区域。[了解更多](/zh/product/messaging-channels/push-notifications/geo-based-push/)

**查找位置**

Pushwoosh 控制面板 → Geozones。