주요 API 식별자

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

일반 식별자

애플리케이션 코드

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

찾는 위치

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

API 액세스 토큰

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

찾는 위치

Pushwoosh Control Panel → API Access.

기기 식별자

하드웨어 ID

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

찾는 위치

• 기기 로그에서. 자세히 알아보기

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

• 세그먼트 목록에서 다운로드한 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

사용자 식별자

사용자 ID

사용자에게 할당된 사용자 지정 식별자로, 교차 기기 및 개인화된 타겟팅을 가능하게 합니다. 자세히 알아보기

찾는 위치

Pushwoosh Control Panel → Audience → User Explorer

메시징 식별자

메시지 코드

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

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

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

찾는 위치

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

콘텐츠 식별자

프리셋 코드

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

찾는 위치

Pushwoosh Control Panel → Content → Presets.

프리셋 코드는 두 곳에서 찾을 수 있습니다:

• 목록 보기에서 프리셋 이름 아래에 표시됩니다.

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

예시:

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

프리셋 코드: AAAAA-BBBBB

리치 미디어 코드

인앱 메시지 템플릿의 식별자입니다. 자세히 알아보기

찾는 위치

Pushwoosh Control Panel → Content → Rich media.

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

이메일 콘텐츠 코드

이메일 콘텐츠 코드는 저장된 이메일 콘텐츠에 대한 고유 식별자입니다. 자세히 알아보기

찾는 위치

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에 나타납니다. 코드를 찾으려면 통계 → 집계 통계로 이동하여 원하는 캠페인을 클릭하고 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에서 생성된 사전 정의된 사용자 세그먼트의 이름입니다. 자세히 알아보기

찾는 위치

Pushwoosh Control Panel → Segments.

세그먼트 / 필터 코드

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

찾는 위치

• /listFilters API 메서드를 통해.

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

예시:

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

태그

사용자 또는 기기에 할당된 사용자 지정 속성입니다. 동적 세분화 및 개인화에 사용됩니다. 자세히 알아보기

찾는 위치

Pushwoosh Control Panel → Tags 또는 /getTags API를 통해.

이벤트 식별자

이벤트 이름

추적된 이벤트의 이름입니다(예: purchase, login, subscription). 자동화된 워크플로를 트리거하거나 분석에 사용됩니다. 자세히 알아보기

찾는 위치

Pushwoosh Control Panel → Audience → Events.

지리적 위치 식별자

지오존 ID

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

찾는 위치

Pushwoosh Control Panel → Geozones.