PUSH API · v1a

기본 개념

같은 이름의 앱이라도 환경이 다르면 키, 기기, 푸시 서비스 연결과 발송 대상이 다릅니다. 작업 전에 현재 범위를 확인하세요.

개념의미
조직함께 운영하는 계정과 프로젝트를 묶는 단위입니다.
프로젝트관련 앱을 묶는 단위입니다. 프로젝트 환경은 공통 사용자 정보와 정의의 경계를 나눕니다.
앱Android 또는 iOS 같은 실제 클라이언트입니다.
앱 환경키와 푸시 서비스 연결, 앱 설치, 발송을 분리하는 범위입니다. 키 하나는 앱 환경 하나에 고정됩니다.
앱 사용자서비스가 식별하는 사용자예요. 등록 시 익명 사용자가 생겨요. 관리형 로그인은 기기 인증에 더해 BASIC은 external ID, VERIFIED는 신뢰할 수 있는 고객 백엔드의 JWT를 사용해요. BASIC은 ID 소유권을 검증하지 않아요.
앱 설치기기에 설치된 앱 하나입니다. 한 사용자에게 여러 앱 설치가 있을 수 있습니다.
푸시 구독과 주소앱 설치의 푸시 수신 경로입니다. FCM/APNs 주소가 바뀌면 SDK에 새 주소를 전달해야 합니다.
메시지와 개별 발송메시지는 발송 요청이고, 개별 발송은 각 구독에 대한 처리 결과입니다.

서로 다른 세 가지 상태

  • OS 알림 권한: 운영체제에서 앱의 알림 표시를 허용했는지입니다.
  • 앱 수신 설정: 사용자가 앱 안에서 푸시 수신을 선택했는지입니다.
  • 마케팅 동의: 마케팅 발송의 별도 동의 기록입니다. OS 권한이나 수신 설정으로 대체하지 않습니다.