PUSH API · v1a
기본 개념
같은 이름의 앱이라도 환경이 다르면 키, 기기, 푸시 서비스 연결과 발송 대상이 다릅니다. 작업 전에 현재 범위를 확인하세요.
| 개념 | 의미 |
|---|---|
| 조직 | 함께 운영하는 계정과 프로젝트를 묶는 단위입니다. |
| 프로젝트 | 관련 앱을 묶는 단위입니다. 프로젝트 환경은 공통 사용자 정보와 정의의 경계를 나눕니다. |
| 앱 | Android 또는 iOS 같은 실제 클라이언트입니다. |
| 앱 환경 | 키와 푸시 서비스 연결, 앱 설치, 발송을 분리하는 범위입니다. 키 하나는 앱 환경 하나에 고정됩니다. |
| 앱 사용자 | 서비스가 식별하는 사용자예요. 등록 시 익명 사용자가 생겨요. 관리형 로그인은 기기 인증에 더해 BASIC은 external ID, VERIFIED는 신뢰할 수 있는 고객 백엔드의 JWT를 사용해요. BASIC은 ID 소유권을 검증하지 않아요. |
| 앱 설치 | 기기에 설치된 앱 하나입니다. 한 사용자에게 여러 앱 설치가 있을 수 있습니다. |
| 푸시 구독과 주소 | 앱 설치의 푸시 수신 경로입니다. FCM/APNs 주소가 바뀌면 SDK에 새 주소를 전달해야 합니다. |
| 메시지와 개별 발송 | 메시지는 발송 요청이고, 개별 발송은 각 구독에 대한 처리 결과입니다. |
서로 다른 세 가지 상태
- OS 알림 권한: 운영체제에서 앱의 알림 표시를 허용했는지입니다.
- 앱 수신 설정: 사용자가 앱 안에서 푸시 수신을 선택했는지입니다.
- 마케팅 동의: 마케팅 발송의 별도 동의 기록입니다. OS 권한이나 수신 설정으로 대체하지 않습니다.