토큰 조회

'토큰 조회'는 Player ID 기준으로 푸시 서버에 저장된 디바이스 토큰 정보를 조회하는 기능입니다. 조회한 토큰의 전체 문자열을 확인하고, 단일 토큰 대상으로 테스트 푸시를 발송합니다.

➡️ 콘솔 경로: 푸시 알림 > 토큰 조회

메뉴 권한이 있으면 접근, 검색과 토큰 보기를 수행합니다. 테스트 발송과 취소를 수행하려면 수정 퍼미션이 필요합니다.

토큰 조회

프로젝트를 선택한 뒤 Player ID를 입력해 토큰 정보를 조회합니다. 하나의 Player ID는 여러 개의 토큰을 가질 수 있습니다.

토큰 정보

항목	설명
Provider Type	`FCM`, `APNS`, `APNS_SANDBOX` 중 하나가 표시됩니다. 값이 없으면 `-`로 표시됩니다.
App ID	토큰이 속한 App ID입니다.
SDK Version	Hive Axyl SDK 버전입니다.
정보성 알림 수신	서비스 알림 수신 여부를 `Y` 또는 `N`으로 표시합니다.
광고성 알림 수신	광고성 알림 수신 여부를 `Y` 또는 `N`으로 표시합니다.
야간 광고성 알림 수신	야간 광고성 알림 수신 여부를 `Y` 또는 `N`으로 표시합니다.
업데이트 시각	토큰의 마지막 갱신 시각입니다. 토큰 정보는 최신 업데이트 시각 기준 내림차순으로 정렬됩니다.

설정 방법

토큰 조회로 이동합니다.
프로젝트를 선택합니다.
Player ID를 입력하고 검색을 클릭합니다.
조회된 토큰 정보를 확인합니다.

토큰 상세 정보 확인

토큰 목록에서 보기를 클릭하면 토큰 상세 정보 슬라이드 시트가 열립니다. 슬라이드 시트에서 전체 토큰 문자열을 확인합니다.

설정 방법

토큰 목록에서 확인할 토큰의 보기를 클릭합니다.
토큰 상세 정보 슬라이드 시트에서 전체 토큰 문자열을 확인합니다.

테스트 발송

테스트 발송은 운영 확인을 위한 기능이며 단일 토큰 대상으로만 수행됩니다. 실제 캠페인 발송과 별개로 동작하고, 테스트 발송 결과는 저장하지 않습니다.

정보성 알림 수신, 광고성 알림 수신, 야간 광고성 알림 수신 설정은 테스트 발송에 적용되지 않습니다.

(이미지 추가: 테스트 발송 슬라이드 시트)

메시지와 옵션

항목	설명
제목	최대 240자까지 입력합니다.
본문	최대 420자까지 입력합니다.
이미지 URL	최대 512자까지 선택적으로 입력합니다.
사운드	`default` 또는 `custom`을 선택합니다. `custom`을 선택하면 사운드 파일명을 최대 128자까지 입력합니다.
FCM 옵션	아이콘, 우선순위, 덮어쓰기, 클릭 액션, 채널 ID와 커스텀 데이터를 설정합니다.
APNs 옵션	뱃지와 카테고리를 설정합니다.

플랫폼별 옵션은 해당 OS에만 적용됩니다. 미설정 옵션은 기본값으로 발송됩니다.

커스텀 데이터

커스텀 데이터는 Key와 Value를 문자열로 입력합니다. Key는 중복할 수 없고, Key와 Value에 빈 값을 저장할 수 없습니다.

설정 방법

토큰 목록에서 테스트할 토큰의 발송을 클릭합니다.
테스트 발송 슬라이드 시트에서 제목, 본문, 이미지 URL과 플랫폼별 옵션을 입력합니다.
발송을 클릭합니다. 발송 접수에 성공하면 "테스트 푸시 발송 요청이 접수되었습니다." 메시지가 표시됩니다.

발송 접수에 실패하면 원인에 따라 "테스트 발송에 실패했습니다. 잠시 후 다시 시도해 주세요.", "등록된 푸시 토큰이 없습니다.", "해당 Provider는 테스트 발송을 지원하지 않습니다.", "푸시 발송에 필요한 인증 정보가 설정되지 않았습니다.", "푸시 발송 권한이 없어 테스트 발송을 할 수 없습니다." 메시지가 표시됩니다.