메시지, 인앱, 푸시 마케팅 | Appbox Android SDK 가이드
기기 기능
푸시 허용 여부
푸시 수신 동의 상태를 조회합니다. 푸시 설정 화면에서 현재 수신 가능 상태를 보여줄 때 사용합니다.
getPushAgree(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
푸시 알림 허용 여부를 확인
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | "Y" / "N". JSON이 아닌 평문 문자열 |
appbox-push가 추가로 필요합니다. 저장된 수신 동의와 OS 알림 권한을 함께 판정한 결과입니다. Push 수신 동의 저장으로 true를 저장한 직후라도 알림 권한이 꺼져 있으면 "N"입니다. 저장값 자체와 1:1로 대응하지 않습니다.
웹 브릿지에서는 푸시 허용 여부의 message.getPushAgree입니다.
로컬 푸시 발송
localPushSend(message, title?, targetUrl?, overlap?, groupID?, imageUrl?, sound?, callback)
호출 형태: 패턴 D(선택 인자가 여러 개인 함수).
주요 내용을 로컬푸시로 알림
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
message | 필수 | 알림 본문 | - |
title | - | 알림 제목 | - |
targetUrl | - | 클릭 시 이동할 URL | - |
overlap | - | true면 같은 groupID의 마지막 1건만 남고, false면 계속 쌓입니다 | false |
groupID | - | overlap과 함께 쓰는 그룹 식별자(0~9) | 0 |
imageUrl | - | 알림에 표시할 이미지 URL | - |
sound | - | 알림 사운드 이름 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
| 오류 코드 | -4000: 초기화 설정의 common.pushIcon 미설정-7000: 알림 권한 거부 |
appbox-push가 추가로 필요합니다. targetUrl, imageUrl에 URL 정책이 적용됩니다.
웹 브릿지에서는 로컬 푸시 발송의 message.localPushSend입니다.
세그먼트 등록
setSegment(segment, callback)
호출 형태: 패턴 C(인자 있는 동작).
개인화 세그먼트
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
segment | 필수 | Map<String, Any?>. 콘솔에서 정의한 세그먼트를 key-value로 전달합니다 (세그먼트 가이드) | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
웹 브릿지에서는 세그먼트 등록의 message.setSegment입니다.