Push 개요 | Push | Appbox Android SDK 가이드

Android SDK 연동

Push 개요

전제내용
필요 artifactappbox-push + 초기화 설정의 push (예외는 함수별 표기)
전제 미충족 시콜백 error로 AppBoxPushUnavailableException(artifact 없음) 또는 AppBoxPushNotConfiguredException(설정 없음) → 예외 카탈로그
콘솔, 서버 전제topic 등록은 서버에서 관리합니다. 등록되지 않은 topic은 필터되어 무시됩니다(호출은 성공 처리)
웹 브릿지 대응message.setPushAgree, getToken, getPushList, subscribeToTopic, unsubscribeFromTopic, setChannelPhoneNumber

클릭 라우팅

수신 → 표시 → 클릭. 클릭의 목적지는 초기화 설정의 usageMode가 결정합니다.

usageMode클릭하면
APPBOX_WEBVIEWAppBox 관리 화면으로 이동
SERVICE_APP (기본)SDK는 이동하지 않음. 앱이 setPushEventListener payload로 직접 처리

listener는 Application.onCreate()에서 등록하세요.

topic 규칙 요약

구독, 해제 4개 함수의 공통 계약입니다. 상세 동작은 아래 동작 설명에 있습니다.

상황동작
success == true서버 접수 의미: 실제 구독 상태를 보장하지 않음
미등록 topic걸러지고 성공 처리 (무엇이 걸러졌는지 알 수 없음)
부분 실패없음. 전체 반영 또는 전체 오류
AOS-<PROJECT_ID>1.4.0부터 SDK 보호 topic 이 아닙니다. 서버가 시스템 topic 으로 보고 처리하지 않으므로 구독, 해제 모두 반영되지 않습니다(네이티브는 성공으로 끝나지만 아무 것도 바뀌지 않음, 웹 브릿지는 failed). 수신을 끄려면 setPushAgreement(false)
웹 브릿지topic별 succeeded/failed 배열 반환 (네이티브와 다름)

동작 설명

topic 구독, 해제 요청은 다음 순서로 처리됩니다.

  • success == true는 서버가 변경 요청을 접수했다는 의미입니다. FCM 구독, 해제는 서버가 기기 토큰으로 대행하므로 이 값으로 실제 구독 상태를 확인할 수 없습니다.
  • 서버가 요청한 topic을 모두 거부해도 success == true입니다. 등록되지 않은 topic 이름을 보낸 경우가 여기에 해당하며, 어떤 topic이 걸러졌는지는 응답으로 알 수 없습니다.
  • 부분 실패나 롤백이라는 상태가 없습니다. 어느 단계든 실패하면 요청 전체가 오류로 끝나고 아무 topic도 반영되지 않으며, 성공하면 filter를 통과한 topic 전체가 한 번에 반영됩니다.
  • 앞뒤 공백이 제거되고 빈 값과 중복이 정리됩니다. 처리할 대상이 남지 않으면 아무 것도 하지 않고 성공으로 끝납니다.
  • 수신 동의는 topic 이 아니라 토큰 등록의 동의값으로 서버에 반영됩니다. 동의하지 않은 기기는 콘솔 전체 발송, 구독 그룹, 여정, API 그룹 발송에서 빠집니다. SDK 가 수신 동의에 맞춰 topic 을 구독, 해제하지 않습니다.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.