인앱 메시지·푸시 마케팅 SDK 연동 | Appbox

메시지•인앱•푸시 마케팅

푸시 허용 등록

웹에서 사용자의 푸시 알림 수신 여부(ON/OFF)를 네이티브 앱에 전달해 업데이트할 수 있는 기능입니다.
이를 통해 사용자 설정에 따라 푸시 메시지가 정상적으로 발송되거나 차단될 수 있도록 제어할 수 있어, 개인정보 동의 상태나 알림 설정 변화에 따른 정확한 메시지 발송이 가능합니다.

푸시 알림 허용 여부를 갱신

AppboxSDK.message.setPushAgree(...)

Javascript
1 // 푸시 수신 동의 ON/OFF
2 AppboxSDK.message.setPushAgree( { agree: "Y" }, (err, data) => {
3 if (err) {
4 console.error( "푸시 동의 ON 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "푸시 동의 ON OK:", data.result );
7 }
8 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
agree 필수 푸시수신 동의 여부 (Y 또는 N) Y


Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)
err.code 에러코드 ( -7000 : 권한 없음, -8000 : 서버 오류)
err.message 에러 메시지

푸시를 수신하려면 사용자가 푸시 권한을 승인 하여야 합니다. 허용하지 않은 경우 위의 표기와 같이 err.code = -7000 시스템 권한 없음으로 리턴됩니다.
이런 경우 "앱 설정으로 이동 AppboxSDK.application.openAppSettings(); " 을 이용하여 사용자가 푸시 허용을 설정할 수 있도록 자동 이동 시킬 수 있습니다.






푸시 허용 여부

현재 앱이 푸시 알림 수신을 허용했는지 여부(ON/OFF)를 확인 할 수 있는 기능입니다.
이를 통해 앱의 푸시 설정 페이지 등에서 푸시 수신여부 추기값을 ON 또는 OFF로 설정할 수 있습니다.

푸시 알림 허용 여부를 확인

AppboxSDK.message.getPushAgree(...)

Javascript
1 // 푸시 수신 여부 가져오기
2 AppboxSDK.message.getPushAgree( (err, data) => {
3 if (err) {
4 console.error( "푸시 동의 여부 가져오기 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "푸시 동의 여부:", data.result );
7 }
8 });

Response 항목 정의

Response 결과값
data.result Y : 허용, N : 거부
err.code 에러코드 (-8000 : 서버 오류)
err.message 에러 메시지

data.result 값이 Y인 경우는 필히 푸시를 수신할 수 있는 경우입니다.
단, N으로 리턴 되는 경우는 OS 설정 에서 해당앱의 푸시를 거부하거나, 사용자가 앱에서 푸시를 거부 한 경우입니다.
사용자가 앱에서 푸시를 받겠다고 설정하여도 OS설정에서 푸시 거부가 되어 있는 상태라면, N으로 리턴됩니다.






푸시 토큰 요청

웹페이지에서 네이티브 영역으로 푸시 토큰을 요청하는 기능입니다.
웹과 네이티브 간 연동을 통해 사용자 기기에서 토큰을 수신할 수 있는 기능으로, 앱 실행 시 또는 토큰이 필요한 시점에 호출하여 최신 토큰을 확보할 수 있습니다.

푸시 토큰 요청

AppboxSDK.message.getToken(...)

Javascript
1 // 푸시 토큰을 웹페이지에서 네이티브에 요청합니다.
2 AppboxSDK.message.getToken( (err, data) => {
3 if (err) {
4 console.error( "푸시 토큰 요청 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "푸시 토큰 :", data.result );
7 }
8 });

Response 항목 정의

Response 결과값
data.result 사용자 디바이스 푸시 토큰





로컬 푸시 발송

웹에서 서버를 거치지 않고 기기 자체에서 푸시 알림을 즉시 표시할 수 있는 기능입니다.
네트워크가 연결되어 있지 않아도 알림을 바로 보여줄 수 있어, 예약 알림, 미션 완료 안내, 앱 내 이벤트 반응 등 즉각적인 피드백이 필요한 상황에 효과적으로 활용할 수 있습니다.

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

AppboxSDK.message.localPushSend(...)

Javascript
1 // 로컬 푸시 발송
2 AppboxSDK.message.localPushSend(
3 {
4 title: "앱 공지",
5 message: "네트워크 없이도 즉시 뜨는 로컬 알림입니다.",
6 targetUrl: "https://www.appboxapp.com",
7 overlap: true,
8 groupID: 1
9 }, (err, data) => {
10 if (err) {
11 console.error( "로컬 푸시 실패:", "code:", err.code, "message:", err.message );
12 } else {
13 console.log( "로컬 푸시 OK:", data.result );
14 }
15 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
title - 제목
message 필수 메시지 내용
targetUrl - 이동 URL
overlap - true: groupID가 동일하면 최종건 하나만 노출, false: 항상 쌓임 false
groupID - overlap의 항목과 함께 사용되는 그룹아이디 (0부터 9까지 숫자만 입력) 0


Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)
err.code 에러코드 ( -7000 : 권한 없음 )
err.message 에러 메시지

푸시를 수신하려면 사용자가 푸시 권한을 승인 하여야 합니다. 허용하지 않은 경우 위의 표기와 같이 err.code = -7000 시스템 권한 없음으로 리턴됩니다.
이런 경우 "앱 설정으로 이동 AppboxSDK.application.openAppSettings(); " 을 이용하여 사용자가 푸시 허용을 설정할 수 있도록 자동 이동 시킬 수 있습니다.






세그먼트 등록

사용자를 특정 기준에 따라 그룹으로 나누는 기능입니다.
콘솔에서 메시지를 발송할 때 세그먼트를 활용하면 전체 사용자에게 동일한 메시지를 보내는 대신, 관심사·행동·기록·속성 등에 따라 대상자를 구분하여 더욱 관련성 높은 메시지를 전달할 수 있습니다.

segment를 이용하면 사용자의 관심사/행동/특성별로 그룹을 나누어 관련성 높은 메시지를 보내고, 관심사 등의 특성별로 고객 패턴 통계를 모니터링 할 수 있습니다.

개인화 세그먼트

AppboxSDK.message.setSegment(...)

Javascript
1 // 세그먼트 등록
2 const payload = {
3 segment: {
4 memberID: "kingofking",
5 name: "홍길동",
6 age: "23",
7 interest: "테크"
8 }
9 };
10 AppboxSDK.message.setSegment( payload, (err, data) => {
11 if (err) {
12 console.error( "세그먼트 등록 실패:", "code:", err.code, "message:", err.message );
13 } else {
14 console.log( "세그먼트 등록 성공:", data.result );
15 }
16 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
segment 필수 segment 값에는 콘솔에서 정의한 json 파라미터가 key, value 형태로 들어가야 합니다.

segment 의 값은 {key: value} 형태로 value는 string형 입니다. 여러항목이 들어가야 할때는 {key1: value, key2: value, key3:value...} 형태로 들어갑니다.




Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)
err.code 에러코드 (-8000 : 서버 오류)
err.message 에러 메시지





메시지 구독 등록

사용자가 특정 주제, 또는 이벤트에 대한 푸시 및 인앱메시지 수신하도록 등록하는 기능입니다. 이를 통해 관심 있는 정보만 선별적으로 받아볼 수 있어 불필요한 알림을 줄이고, 사용자 맞춤형 커뮤니케이션이 가능합니다. 마케팅 캠페인, 이벤트 안내, 콘텐츠 업데이트 등 다양한 상황에서 타겟팅된 메시지를 효과적으로 전달할 수 있습니다.

메시지 구독 등록

AppboxSDK.message.subscribeToTopic(...)

Javascript
1 // 메시지 수신 그룹에 구독합니다.
2 AppboxSDK.message.subscribeToTopic( { topicScheme:[ 'Soccer', 'Baseball', 'abc123' ] }, (err, data) => {
3 if (err) {
4 console.error( "구독에 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "구독에 성공:", data.result );
7 }
8 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
topicScheme 필수 구독 키값(단일 string 또는 string 배열)


Response 항목 정의

Response 결과값
data.result.succeeded 구독 성공한 topic 키값 배열
data.result.failed 구독 실패한 topic 키값 배열

구독 브릿지 인터페이스 전에 앱박스 콘솔에 로그인하여 사용자 관리 > 구독 등록에서 등록되어야 합니다.






메시지 구독 해지

사용자가 특정 주제, 카테고리, 또는 이벤트에 대한 메시지 수신을 중단하도록 설정하는 기능입니다. 이를 통해 더 이상 필요하지 않은 알림을 간편하게 차단할 수 있으며, 사용자에게 부담을 주지 않는 커뮤니케이션 환경을 유지할 수 있습니다. 또한 구독 상태를 유연하게 관리함으로써 사용자 경험을 향상시키고, 서비스에 대한 신뢰도를 높이는 데 도움을 줍니다.

메시지 구독 해지

AppboxSDK.message.unsubscribeFromTopic(...)

Javascript
1 // 메시지 수신 그룹에 구독을 해지합니다.
2 AppboxSDK.message.unsubscribeFromTopic( { topicScheme:[ 'Soccer', 'Baseball', 'abc123'] }, (err, data) => {
3 if (err) {
4 console.error( "구독 해지 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "구독 해지 성공:", data.result );
7 }
8 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
topicScheme 필수 구독 키값(단일 string 또는 string 배열)


Response 항목 정의

Response 결과값
data.result.succeeded 구독 성공한 topic 키값 배열
data.result.failed 구독 실패한 topic 키값 배열






메시지 구독 갱신

구독할 주제와 해지할 주제를 한 번의 호출로 함께 갱신하는 기능입니다. 사용자가 알림 설정 화면에서 여러 항목을 변경했을 때 변경된 항목만 전달하는 델타 방식으로 동작하며, 구독 등록과 해지를 각각 호출할 필요 없이 하나의 요청으로 처리되어 호출 코드가 간결해지고 처리 결과도 한 번의 콜백으로 확인할 수 있습니다. 같은 주제를 구독과 해지에 동시에 요청하는 모순된 입력은 자동으로 거부되므로, 구독 상태를 안전하고 일관되게 관리할 수 있습니다.

메시지 구독 갱신

AppboxSDK.message.updateTopics(...)

Javascript
1 // 구독할 토픽과 해지할 토픽을 한 번의 호출로 갱신합니다.
2 AppboxSDK.message.updateTopics( { subscribe: ['Topic-A'], unsubscribe: ['ABCD'] }, (err, data) => {
3 if (err) {
4 console.error( "구독 갱신 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "구독 갱신 성공:", data.result );
7 }
8 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
subscribe 선택 구독할 토픽 키값 배열(string 배열, 최대 20개)
unsubscribe 선택 해지할 토픽 키값 배열(string 배열, 최대 20개)

* subscribe와 unsubscribe 중 최소 1개는 필수입니다. 같은 토픽 키값을 두 항목에 동시에 지정하면 요청 전체가 거부됩니다.



Response 항목 정의

Response 결과값
data.result.subscribe.succeeded 구독 성공한 topic 키값 배열
data.result.subscribe.failed 구독 실패한 topic 키값 배열
data.result.unsubscribe.succeeded 해지 성공한 topic 키값 배열
data.result.unsubscribe.failed 해지 실패한 topic 키값 배열






전환 이벤트 기록

사용자가 푸시 알림을 받거나 인앱 메시지 팝업에서 버튼을 클릭한 후, 실제 행동(이벤트 참여, 회원가입, 구매 등)을 완료하면 해당 결과가 ‘전환’으로 기록됩니다.
이 기능은 메시지에 반응한 사용자가 최종 목표(참여, 가입, 구매 등)를 얼마나 달성했는지를 측정하는 데 활용되며, 캠페인 효과 분석과 퍼널 개선에 중요한 지표로 사용됩니다.

이벤트(푸시, 인앱 메시지)에 대한 전환 기록

AppboxSDK.message.trackConversion(...)

Javascript
1 // 전환 이벤트 기록
2 const convCode = "camp_convercode_2025"
3 AppboxSDK.message.trackConversion( { conversionCode : convCode }, (err, data) => {
4 if (err) {
5 console.error( "전환 기록 실패:", "code:", err.code, "message:", err.message );
6 } else {
7 console.log( "전환 기록 OK:", data.result );
8 }
9 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
conversionCode 필수 콘솔에서 푸시 또는 인앱메시지를 발송시 생성되는 전환 코드를 입력하세요.


Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)
err.code 에러코드 (-8000 : 서버 오류)
err.message 에러 메시지

전환 기록은 앱박스 콘솔로 전달되어 캠페인별 전환 성과를 집계하고 통계로 확인 할 수 있습니다.






푸시 수신 리스트

앱이 수신한 푸시 알림 내역을 목록 형태로 불러오는 기능입니다.
브릿지를 통해 웹페이지에서 네이티브에 저장된 푸시 수신 이력을 조회할 수 있습니다.

받은 푸시 메시지를 리스트로 가져오기

AppboxSDK.message.getPushList(...)

Javascript
1 // 받은 푸시 리스트
2 AppboxSDK.message.getPushList( { fromDate : "20251212", toDate : "20260530" }, (err, data) => {
3 if (err) {
4 console.error( "푸시 리스트 받기 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "푸시 리스트 받기 OK:", data.result );
7 }
8 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
fromDate - 시작일
toDate - 종료일


Response 항목 정의

Response 결과값
data.result title 제목
body 메시지 내용
param 파라미터 (URL 또는 파라미터 등)
imageUrl 푸시에 이미지가 포함되었을때 이미지 URL
createdAt 수신 일자













앱 데모체험
지금 웹사이트 주소를 입력하고
데모 앱을 체험해 보세요!
앱으로 바꾸고 싶은 당신의 웹사이트 주소를 입력해 보세요. 즉각 체험할 수 있는 데모 앱을 받을 수 있습니다.

QR 코드
QR 코드를 찍고 앱으로 바뀐
웹사이트를 지금 바로 확인해 보세요!
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.