# 주요 API 식별자

이 게시물은 Pushwoosh API 요청에 사용되는 필수 식별자를 나열합니다. 이러한 식별자는 애플리케이션 전반에서 사용자를 인증, 메시지 생성, 타겟팅, 세분화, 추적 및 관리하는 데 필요합니다.

## 일반 식별자

### 애플리케이션 코드

Pushwoosh 계정의 각 애플리케이션에 할당된 고유 식별자입니다. 대부분의 API 호출에서 대상 앱을 지정하는 데 필요합니다.

**찾는 위치**

Pushwoosh Control Panel → 애플리케이션 이름 아래.

### API 액세스 토큰

Pushwoosh 계정에 할당된 고유 토큰으로, API 요청을 인증하는 데 사용됩니다. 이를 통해 프로젝트 관리, 메시지 전송, 설정 수정 및 데이터 검색에 액세스할 수 있습니다. 각 계정에는 기본적으로 하나 이상의 토큰이 생성됩니다. [자세히 알아보기](/ko/developer/api-reference/api-access-token/)

**찾는 위치**

Pushwoosh Control Panel → API Access.

## 기기 식별자

### 하드웨어 ID

Pushwoosh SDK에 의해 기기에 할당된 고유 식별자입니다. SDK에 의해 자동으로 설정되거나 기기 등록 중에 전달됩니다. [자세히 알아보기](/ko/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid)

**찾는 위치**

* 기기 로그에서. [자세히 알아보기](/ko/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token)

* **User ID**로 검색할 때 [User Explorer](/ko/product/audience-data-and-segmentation/user-explorer/)에서
* [Segments 목록](/ko/product/audience-data-and-segmentation/segmentation/segments/)에서 다운로드한 CSV 파일에서

### 푸시 토큰

플랫폼 제공업체에서 발급하는 토큰으로, 푸시 알림을 전달하기 위해 앱-기기 쌍을 식별합니다. 푸시 권한이 부여되면 SDK에서 자동으로 수집합니다. [자세히 알아보기](/ko/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token)

**찾는 위치**

* 기기 로그에서. [자세히 알아보기](/ko/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token)

* [User Explorer](/ko/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

사용자에게 할당된 맞춤형 식별자로, 교차 기기 및 개인화된 타겟팅을 가능하게 합니다. [자세히 알아보기](/ko/developer/pushwoosh-knowledge-hub/users-userids/users-userids/)

**찾는 위치**

Pushwoosh Control Panel → Audience → User Explorer 

## 메시징 식별자

### 메시지 코드

각 메시지가 생성될 때 할당되는 고유 식별자입니다. **XXXX-XXXXXXXX-XXXXXXXX** 형식입니다.

이 코드는 다음에 필수적입니다:

* 특정 메시지의 상태 및 전달 추적
* 이전에 보낸 메시지 취소(또는 삭제)
* 메시지 통계 얻기

**찾는 위치**

* **Pushwoosh Control Panel:** **Campaigns → One-time messages**로 이동한 다음, 원하는 메시지의 **속성**을 엽니다. 메시지 코드가 거기에 표시됩니다.
* **[`/createMessage`](/ko/developer/api-reference/messages-api/#createmessage) API 응답:** API를 통해 새 메시지를 생성할 때, 메시지 코드가 응답에 포함됩니다.

## 콘텐츠 식별자

### 프리셋 코드

저장된 메시지 프리셋(예: 푸시 또는 SMS)에 대한 식별자입니다. [자세히 알아보기](/ko/product/content/)

**찾는 위치**

Pushwoosh Control Panel → Content → Presets.

프리셋 코드는 두 곳에서 찾을 수 있습니다:
- 목록 보기에서 프리셋 이름 아래에 표시됩니다.

- 프리셋을 편집하거나 생성할 때 URL에 있습니다(URL의 마지막 부분입니다).

**예시**:

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

프리셋 코드: `AAAAA-BBBBB`

### 리치 미디어 코드

인앱 메시지 템플릿의 식별자입니다. [자세히 알아보기](/ko/product/content/in-apps/)

**찾는 위치**

Pushwoosh Control Panel → Content → Rich media.

**예시:**
URL: `https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics`
리치 미디어 코드: `AAAAA-BBBBB`

### 이메일 콘텐츠 코드

이메일 콘텐츠 코드는 저장된 이메일 콘텐츠에 대한 고유 식별자입니다. [자세히 알아보기](/ko/product/content/email-content/)

**찾는 위치**

Pushwoosh Control Panel → Content → Email content.

코드는 URL의 마지막 부분입니다.

**예시**:

URL: `https://app.pushwoosh.com/applications/XXXXX-XXXXX/email-content/edit/AAAAA-BBBBB`
이메일 콘텐츠 코드: `AAAAA-BBBBB`

## 캠페인 식별자

### 캠페인 코드

추적 및 분석을 위해 특정 캠페인을 참조하는 데 사용되는 고유 식별자입니다.

**찾는 위치**

캠페인 코드는 Pushwoosh Control Panel에서 캠페인 관련 통계를 볼 때 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 Control Panel의 캠페인 캔버스 URL에 나타납니다.

**예시:**
URL: `https://app.pushwoosh.com/journeys/XXXXX-XXXXX/1/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee`

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



## 세분화 및 타겟팅 식별자

### 세그먼트 / 필터 이름 

오디언스 타겟팅을 위해 Pushwoosh에서 생성된 사전 정의된 사용자 세그먼트의 이름입니다. [자세히 알아보기](/ko/product/audience-data-and-segmentation/segmentation/segments/)

**찾는 위치**

Pushwoosh Control Panel → Segments.

### 세그먼트 / 필터 코드 

Pushwoosh에서 세그먼트(필터라고도 함)를 식별하는 XXXXX-XXXXX 형식의 고유 코드입니다. 이 코드는 API 호출, 자동화 로직 및 동적 세분화 규칙에 사용됩니다.

**찾는 위치**

- [`/listFilters`](/ko/developer/api-reference/segmentation-filters-api/#listfilters) API 메서드를 통해.

- Pushwoosh Control Panel에서 세그먼트를 볼 때 주소 표시줄에서:

**예시:**

**URL:** `https://app.pushwoosh.com/applications/XXXXX-XXXXX/segments/XXXE9-XXX49/detail`
**세그먼트 코드:** `XXXE9-XXX49`




### 태그

사용자 또는 기기에 할당된 맞춤 속성입니다. 동적 세분화 및 개인화에 사용됩니다. [자세히 알아보기](/ko/developer/guides/audience-and-segmentation/tags/)

**찾는 위치**

Pushwoosh Control Panel → Tags 또는 [`/getTags`](/ko/developer/api-reference/device-api/#gettags) API를 통해.

## 이벤트 식별자

### 이벤트 이름

추적된 이벤트의 이름입니다(예: `purchase`, `login`, `subscription`). 자동화된 워크플로우를 트리거하거나 분석에 사용됩니다. [자세히 알아보기](/ko/developer/guides/audience-and-segmentation/events/)

**찾는 위치**

Pushwoosh Control Panel → Audience → Events.

## 지리적 위치 식별자

### 지오존 ID

위치 기반 알림을 트리거하는 데 사용되는 지오펜싱 영역을 식별합니다. [자세히 알아보기](/ko/product/messaging-channels/push-notifications/geo-based-push/)

**찾는 위치**

Pushwoosh Control Panel → Geozones.