주요 API 식별자

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

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

찾는 위치

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

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

찾는 위치

Pushwoosh Control Panel → API 액세스.

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
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

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

찾는 위치

Pushwoosh Control Panel → Audience → User Explorer

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

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

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

찾는 위치

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

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

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

자체 값 설정

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

찾는 위치

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

예시: a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d

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

Pushwoosh Control Panel → 캠페인 → 즉시 인앱. 목록에서 코드는 캠페인 이름 아래에 표시됩니다.

예시: AAAAA-BBBBB

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

찾는 위치

Pushwoosh Control Panel → 콘텐츠 → 프리셋.

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

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

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

예시:

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

프리셋 코드: AAAAA-BBBBB

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

찾는 위치

Pushwoosh Control Panel → 콘텐츠 → 리치 미디어.

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

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

찾는 위치

Pushwoosh Control Panel → 콘텐츠 → 이메일 콘텐츠.

코드는 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

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

찾는 위치

• 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 → 세그먼트.

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 → 태그 또는 /getTags API를 통해.

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

찾는 위치

Pushwoosh Control Panel → Audience → 이벤트.

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

찾는 위치

Pushwoosh Control Panel → 지오존.