주요 API 식별자

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

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

찾는 위치

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

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

찾는 위치

Pushwoosh Control Panel → API Access.

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

찾는 위치

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

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

• Segments 목록에서 다운로드한 CSV 파일에서

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

찾는 위치

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

• 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
17 – Huawei
18 – SMS
20 – Web
21 – WhatsApp
22 – Line
23 – Kakao Talk
24 – Telegram
25 – Apple Wallet
26 – Google Wallet
27 – Viber

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

찾는 위치

Pushwoosh Control Panel → Audience → User Explorer

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

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

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

찾는 위치

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

메시지를 생성한 HTTP 요청과 메시지를 연관시켜, HTTP 호출부터 Pushwoosh의 라우팅 계층을 거쳐 결과 메시지에 이르기까지 단일 전송을 종단 간 추적할 수 있습니다.

Control Panel에서 보낸 메시지를 포함하여 /createMessage 또는 Messaging API v2에 대한 HTTP 호출로 생성된 모든 메시지에 존재합니다. Journey, cron 전송 또는 기타 비-HTTP 내부 트리거로 생성된 메시지에는 요청 ID가 없습니다.

자체 값 설정

요청과 함께 X-Request-ID 헤더를 전달합니다. 값이 8-128자 길이이고 라틴 문자, 숫자, 점, 밑줄, 하이픈만 포함하는 경우 Pushwoosh는 이를 재사용합니다. 그렇지 않거나 헤더가 생략된 경우 Pushwoosh가 하나를 생성합니다. 잘못된 값은 자동으로 대체되므로 요청이 실패하지 않습니다. 고유성은 강제되지 않으므로 추적에 의존하는 경우 요청당 실제로 고유한 값을 사용하십시오.

찾는 위치

Pushwoosh Control Panel → 메시지 열기 → 메시지 세부 정보(Message Details) → 모든 속성 표시(Show all properties) → 메시지 설정(Message settings) → 요청 ID(Request ID) (복사 버튼 포함).

예시: a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d

즉시 인앱 캠페인을 식별하는 고유 코드입니다. 찾는 위치

Pushwoosh Control Panel → Campaigns → Instant in-apps. 목록에서 캠페인 이름 아래에 코드가 표시됩니다.

예시: AAAAA-BBBBB

저장된 메시지 프리셋(예: 푸시 또는 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에 나타납니다. 이를 찾으려면 Statistics → Aggregated statistics로 이동하여 원하는 캠페인을 클릭하고 URL 끝에 있는 코드를 복사하십시오.

예시:

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

캠페인 코드: YYYYY-YYYYY

추적 및 성과 분석을 위해 메시지를 특정 마케팅 캠페인과 연결하는 데 사용되는 고유 식별자입니다.

찾는 위치

• Pushwoosh Control Panel의 캠페인 캔버스 URL에서.
• 캔버스에서 지점을 선택하고 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

오디언스 타겟팅을 위해 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.

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

찾는 위치

Pushwoosh Control Panel → Geozones.