메시지, 인앱, 푸시 마케팅 | Appbox Android SDK 가이드

기기 기능

푸시 허용 여부

푸시 수신 동의 상태를 조회합니다. 푸시 설정 화면에서 현재 수신 가능 상태를 보여줄 때 사용합니다.

getPushAgree(callback)

호출 형태: 패턴 A(인자 없는 값 조회).

푸시 알림 허용 여부를 확인

AppBox.getPushAgree(callback)

Kotlin
1 AppBox.getPushAgree { value, error ->
2 if (error != null) return@getPushAgree
3 Log.d("AppBox", value.toString())
4 }
1 AppBox.getPushAgree((value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

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(선택 인자가 여러 개인 함수).

주요 내용을 로컬푸시로 알림

AppBox.localPushSend(message, title, targetUrl, overlap, groupID, imageUrl, sound, callback)

Kotlin
1 AppBox.localPushSend(message = "네트워크 없이도 즉시 뜨는 로컬 알림입니다.", title = "앱 공지",
2 targetUrl = "https://appboxapp.com/notice", overlap = false, groupID = 0,
3 imageUrl = "https://example.com/push.png", sound = "default") { value, error ->
4 if (error != null) return@localPushSend
5 Log.d("AppBox", value.toString())
6 }
1 AppBox.localPushSend("네트워크 없이도 즉시 뜨는 로컬 알림입니다.", "앱 공지",
2 "https://appboxapp.com/notice", false, 0,
3 "https://example.com/push.png", "default", (value, error) -> {
4 if (error != null) return;
5 Log.d("AppBox", String.valueOf(value));
6 });

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(인자 있는 동작).

개인화 세그먼트

AppBox.setSegment(segment, callback)

Kotlin
1 AppBox.setSegment(
2 segment = mapOf(
3 "memberId" to "kingofking",
4 "interest" to "테크"
5 )
6 ) { value, error ->
7 if (error != null) return@setSegment
8 Log.d("AppBox", value.toString())
9 }
1 Map<String, Object> segment = new HashMap<>();
2 segment.put("memberId", "kingofking");
3 segment.put("interest", "테크");
4
5 AppBox.setSegment(segment, (value, error) -> {
6 if (error != null) return;
7 Log.d("AppBox", String.valueOf(value));
8 });

Request 항목 정의

Request 항목필수여부설명기본값
segment필수Map<String, Any?>. 콘솔에서 정의한 세그먼트를 key-value로 전달합니다 (세그먼트 가이드)-


Response 항목 정의

Response 결과값
값성공 여부 (Boolean)

웹 브릿지에서는 세그먼트 등록의 message.setSegment입니다.

www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.