# Ключевые идентификаторы API

В этой статье перечислены основные идентификаторы, используемые в запросах Pushwoosh API. Эти идентификаторы необходимы для аутентификации, создания сообщений, таргетинга, сегментации, отслеживания и управления пользователями в ваших приложениях.

## Общие идентификаторы

### Код приложения (Application code)

Уникальный идентификатор, присваиваемый каждому приложению в вашем аккаунте Pushwoosh. Он требуется в большинстве вызовов API для указания целевого приложения.

**Где найти**

Панель управления Pushwoosh → Под названием приложения.

### Токен доступа API (API access token)

Уникальный токен, присваиваемый аккаунту Pushwoosh и используемый для аутентификации запросов API. Он предоставляет доступ к управлению проектами, отправке сообщений, изменению настроек и получению данных. В каждом аккаунте по умолчанию создан как минимум один токен. [Узнать больше](/ru/developer/api-reference/api-access-token/)

**Где найти**

Панель управления Pushwoosh → API Access.

## Идентификаторы устройств

### Hardware ID (HWID)

Уникальный идентификатор, присваиваемый устройству SDK Pushwoosh. Устанавливается автоматически SDK или передается при регистрации устройства. [Узнать больше](/ru/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid)

**Где найти**

*   В логах устройства. [Узнать больше](/ru/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token)

*   В [User Explorer](/ru/product/audience-data-and-segmentation/user-explorer/) при поиске по **User ID**
*   В CSV-файле, загруженном из [списка сегментов](/ru/product/audience-data-and-segmentation/segmentation/segments/)

### Push-токен (Push token)

Токен, выдаваемый поставщиками платформ, который идентифицирует пару приложение-устройство для доставки push-уведомлений. Собирается автоматически SDK при предоставлении разрешений на отправку push-уведомлений. [Узнать больше](/ru/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token)

**Где найти**

*   В логах устройства. [Узнать больше](/ru/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token)

*   В [User Explorer](/ru/product/audience-data-and-segmentation/user-explorer/) введите HWID в поле поиска, чтобы найти связанное устройство, затем откройте сведения об устройстве, чтобы просмотреть push-токен.

### Тип устройства (Device type)

Указывает платформу целевого устройства с помощью числового кода. Устанавливается автоматически 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
```

## Идентификаторы пользователей

### User ID

Пользовательский идентификатор, присваиваемый пользователю, который позволяет осуществлять кросс-девайсный и персонализированный таргетинг. [Узнать больше](/ru/developer/pushwoosh-knowledge-hub/users-userids/users-userids/)

**Где найти**

Панель управления Pushwoosh → Audience → User Explorer

## Идентификаторы сообщений

### Код сообщения (Message code)

Уникальный идентификатор, присваиваемый каждому сообщению при его создании. Он имеет определенный формат: **XXXX-XXXXXXXX-XXXXXXXX**.

Этот код необходим для:

*   Отслеживания статуса и доставки определенного сообщения
*   Отмены (или удаления) ранее отправленного сообщения
*   Получения статистики по сообщению

**Где найти**

*   **Панель управления Pushwoosh:** Перейдите в **Campaigns → One-time messages**, затем откройте **свойства** нужного сообщения. Код сообщения (Message Code) будет отображен там.
*   **Ответ API [`/createMessage`](/ru/developer/api-reference/messages-api/#createmessage):** При создании нового сообщения через API, код сообщения (Message Code) включается в ответ.

### Код In-App сообщения (In-app code)

Уникальный код, который идентифицирует кампанию [мгновенных In-App сообщений](/ru/product/messaging-channels/in-apps/send-in-apps/send-instant-in-apps/).
**Где найти**

Панель управления Pushwoosh → **Campaigns** → **Instant in-apps**. В списке код отображается под названием кампании.

**Пример**: `AAAAA-BBBBB`

## Идентификаторы контента

### Код пресета (Preset code)

Идентификатор для сохраненного пресета сообщения (например, push или SMS). [Узнать больше](/ru/product/content/)

**Где найти**

Панель управления Pushwoosh → Content → Presets.

Вы можете найти код пресета в двух местах:
- В виде списка, под названием пресета.

- В URL-адресе при редактировании или создании пресета (это последняя часть URL).

**Пример**:

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

Код пресета: `AAAAA-BBBBB`

### Код Rich Media

Идентификатор для шаблона In-App сообщения. [Узнать больше](/ru/product/content/in-apps/)

**Где найти**

Панель управления Pushwoosh → Content → Rich media.

**Пример:**
URL: `https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics`
Код Rich Media: `AAAAA-BBBBB`

### Код контента email-сообщения

Код контента email-сообщения — это уникальный идентификатор для сохраненного контента email-сообщений. [Узнать больше](/ru/product/content/email-content/)

**Где найти**

Панель управления Pushwoosh → Content → Email content.

Код является последней частью URL-адреса.

**Пример**:

URL: `https://app.pushwoosh.com/applications/XXXXX-XXXXX/email-content/edit/AAAAA-BBBBB`
Код контента email-сообщения: `AAAAA-BBBBB`

## Идентификаторы кампаний

### Код кампании (Campaign code)

Уникальный идентификатор, используемый для ссылки на конкретную кампанию для отслеживания и анализа.

**Где найти**

Код кампании появляется в URL-адресе при просмотре статистики по кампании в панели управления Pushwoosh.
Чтобы найти его, перейдите в **Statistics → Aggregated statistics**, нажмите на нужную кампанию и скопируйте код, находящийся в конце URL.

**Пример:**

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

**Код кампании:** `YYYYY-YYYYY`

### Journey ID

Уникальный идентификатор, используемый для связи сообщений с конкретными маркетинговыми кампаниями для отслеживания и анализа эффективности.

**Где найти**

*   В URL-адресе холста кампании в панели управления Pushwoosh.
*   Выберите точку на холсте и нажмите **Ctrl+I** (Cmd+I) — в буфер обмена будет скопирована строка `<journey UUID>/<point UUID>`; Journey ID — это часть до слэша.

**Пример:**
URL: `https://app.pushwoosh.com/journeys/XXXXX-XXXXX/1/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee`

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

## Идентификаторы для сегментации и таргетинга

### Название сегмента / фильтра (Segment / Filter name)

Название предопределенного сегмента пользователей, созданного в Pushwoosh для таргетинга аудитории. [Узнать больше](/ru/product/audience-data-and-segmentation/segmentation/segments/)

**Где найти**

Панель управления Pushwoosh → Segments.

### Код сегмента / фильтра (Segment / Filter code)

Уникальный код в формате XXXXX-XXXXX, который идентифицирует сегмент (также называемый фильтром) в Pushwoosh. Этот код используется в вызовах API, логике автоматизации и правилах динамической сегментации.

**Где найти**

- Через метод API [`/listFilters`](/ru/developer/api-reference/segmentation-filters-api/#listfilters).

- В адресной строке при просмотре сегмента в панели управления Pushwoosh:

**Пример:**

**URL:** `https://app.pushwoosh.com/applications/XXXXX-XXXXX/segments/XXXE9-XXX49/detail`
**Код сегмента:** `XXXE9-XXX49`

### Тег (Tag)

Пользовательский атрибут, присваиваемый пользователям или устройствам. Используется для динамической сегментации и персонализации. [Узнать больше](/ru/developer/guides/audience-and-segmentation/tags/)

**Где найти**

Панель управления Pushwoosh → Tags или через API [`/getTags`](/ru/developer/api-reference/device-api/#gettags).

## Идентификаторы событий

### Название события (Event name)

Название отслеживаемого события (например, `purchase`, `login`, `subscription`). Используется для запуска автоматизированных рабочих процессов или для аналитики. [Узнать больше](/ru/developer/guides/audience-and-segmentation/events/)

**Где найти**

Панель управления Pushwoosh → Audience → Events.

## Идентификаторы геолокации

### Geozone ID

Идентифицирует геозону, используемую для запуска уведомлений на основе местоположения. [Узнать больше](/ru/product/messaging-channels/push-notifications/geo-based-push/)

**Где найти**

Панель управления Pushwoosh → Geozones.