주요 API 식별자

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

일반 식별자

애플리케이션 코드

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

찾는 위치

Pushwoosh 제어판 → 애플리케이션 이름 아래.

API 액세스 토큰

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

찾는 위치

Pushwoosh 제어판 → API 액세스.

기기 식별자

하드웨어 ID

Pushwoosh SDK 에 의해 기기에 할당된 고유 식별자입니다. SDK 에 의해 자동으로 설정되거나 기기 등록 중에 전달됩니다. 더 알아보기

찾는 위치

• 기기 로그에서. 더 알아보기

• User Explorer에서 User ID로 검색할 때

• 세그먼트 목록에서 다운로드한 CSV 파일에서

푸시 토큰

푸시 알림을 전달하기 위해 앱-기기 쌍을 식별하는 플랫폼 제공업체에서 발급한 토큰입니다. 푸시 권한이 부여되면 SDK 에서 자동으로 수집합니다. 더 알아보기

찾는 위치

• 기기 로그에서. 더 알아보기

• User Explorer에서 검색 필드에 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 제어판 → Audience → User Explorer

메시징 식별자

메시지 코드

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

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

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

찾는 위치

• Pushwoosh 제어판: 메시지 기록으로 이동한 다음 원하는 메시지의 속성을 엽니다. 메시지 코드가 거기에 표시됩니다.
• /createMessage API 응답: API 를 통해 새 메시지를 생성할 때 메시지 코드가 응답에 포함됩니다.

콘텐츠 식별자

프리셋 코드

저장된 메시지 프리셋(예: 푸시 또는 SMS)에 대한 식별자입니다. 더 알아보기

찾는 위치

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 제어판 → 세그먼트.

세그먼트 / 필터 코드

Pushwoosh 에서 세그먼트(필터라고도 함)를 식별하는 XXXXX-XXXXX 형식의 고유 코드입니다. 이 코드는 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 제어판 → Audience → 이벤트.

지리적 위치 식별자

지오존 ID

위치 기반 알림을 트리거하는 데 사용되는 지오펜스 영역을 식별합니다. 더 알아보기

찾는 위치

Pushwoosh 제어판 → 지오존.