OneSignal 연동에서 무엇을 연결하나요?
OneSignal 연동은 앱 SDK, 고객 ID, 채널 구독, 속성과 행동 이벤트를 연결하는 작업입니다. 앱에 SDK를 넣는 것과 고객의 상태에 맞는 메시지를 운영하는 것은 서로 이어지는 구현 단계입니다.
앱 팀은 기기와 화면에서 발생하는 동작을, 서버 팀은 계정과 거래의 확정 상태를, CRM 담당자는 대상과 안내 조건을 정의합니다. 세 역할이 같은 고객 ID와 이벤트 명세를 사용해야 메시지와 실제 서비스 상태가 일치합니다.
고객, 기기, 채널 구독을 구분합니다
휴대전화를 바꾸거나 이메일을 추가해도 같은 고객으로 다루려면 앱의 회원 식별값과 OneSignal의 구독 구조를 연결해야 합니다.
User
여러 채널의 구독을 묶는 고객 단위입니다. 고객 속성은 이 단위에서 관리하고, 특정 기기에서 메시지를 받을 수 있는지는 개별 구독 상태로 확인합니다.
Subscription
모바일 앱, 웹 브라우저, 이메일 등 메시지를 받는 접점입니다. 한 고객에게 여러 구독이 있을 수 있으므로 구독 수를 회원 수와 같은 값으로 해석하지 않습니다.
External ID
서비스가 정한 안정적인 회원 식별값입니다. 인증된 회원 ID를 로그인 흐름에 연결해 여러 기기와 채널을 같은 고객으로 묶습니다.
현재 상태는 속성, 일어난 행동은 이벤트
“유료 회원이다”와 “방금 결제했다”는 다른 데이터입니다. 현재 상태를 담는 Tags와 행동을 담는 Custom Events를 나누면, 대상 선정과 시점 기반 자동화의 책임도 명확해집니다.
Tags: 현재 고객 속성
plan, preferred_language처럼 메시지 대상과 개인화에 필요한 값을 관리합니다. 상태가 바뀔 때 갱신할 담당 시스템과 불필요해진 값의 삭제 시점을 정합니다.
Custom Events: 발생한 행동
subscription_started, booking_confirmed처럼 실제 발생한 행동을 보냅니다. 이벤트 이름, 발생 조건, 고객 ID, 관련 식별값과 속성의 자료형을 명세합니다.
Custom Events는 유료 플랜에서 사용할 수 있고 저장에는 별도 과금 조건이 있습니다. 이벤트 이력 기반 세그먼트는 Early Access이므로 계정의 활성화 여부와 저장 조건을 먼저 확인해야 합니다.
SDK와 서버의 역할을 나눕니다
같은 행동을 앱과 서버에서 각각 보내면 중복 안내가 시작될 수 있습니다. 거래의 완료 여부처럼 한 곳에서 확정할 수 있는 값은 해당 시스템을 기준으로 삼습니다.
앱·웹
SDK 초기화, 인증된 회원의 로그인·로그아웃 연결, 알림 권한 요청, 클릭 후 이동, 앱 내 행동을 구현합니다. 계정 전환 때 이전 고객의 문맥이 남지 않는지 확인합니다.
서버·데이터 시스템
결제와 예약의 확정 이벤트, 회원 속성 갱신, 실패 재시도와 중복 방지를 담당합니다. 이벤트별 발송 책임과 식별값을 정해 후속 행동을 정확히 연결합니다.
운영·보안
공개 식별자인 App ID와 비밀 API 키를 구분합니다. API 키는 앱 코드에 넣지 않고 서버의 안전한 보관소에서 관리하며, 테스트와 운영의 설정을 구분합니다.
발송 성공 외에 확인할 동작
도입 검증에서는 메시지가 한 번 도착했다는 결과만으로 운영 준비를 판단하기 어렵습니다. 실제 고객이 겪는 계정 변경과 수신 설정, 실패 상황을 포함해 확인합니다.
계정 전환
익명 이용 → 로그인 → 로그아웃 → 다른 회원 로그인 흐름에서 고객과 구독이 올바르게 연결되는지 확인합니다.
권한과 이동
허용·거부·수신 해제, 앱 실행 상태, 로그인 필요 화면, 삭제되거나 만료된 목적지에서 적절한 동작을 확인합니다.
데이터와 반복
이벤트 누락·중복·재시도, 잘못된 속성 자료형, 목표 행동 후 메시지 중단을 점검하고 운영 담당자가 확인할 기록을 남깁니다.
설계 예시
예약 확정부터 방문 준비 안내까지
앱에서 신청하고 서버가 예약을 확정하는 서비스의 설계 예시입니다. 신청 버튼의 클릭과 예약 확정을 구분합니다.
회원 연결
로그인한 회원의 안정적인 ID를 연결하고 해당 고객의 채널별 구독 상태를 확인합니다.
서버 확정 이벤트
예약 저장이 완료되면 booking_confirmed를 보냅니다. booking_id와 안내에 필요한 속성만 포함합니다.
다음 행동 안내
이벤트를 기준으로 안내를 시작하고, 메시지 링크는 해당 예약 상세로 연결합니다. 변경·취소 시의 종료 조건도 함께 정합니다.
변경 상황 검증
서버 재시도, 동일 고객의 여러 예약, 로그아웃 상태의 링크 열기를 테스트합니다. 다른 예약의 행동이 섞이지 않는지 확인합니다.
고객 데이터는 안내와 조건 판단에 필요한 범위로 정합니다. 메시지 본문과 이벤트 속성에 불필요한 민감정보를 넣지 않도록 데이터 담당자와 항목을 확정합니다.
IXC 도입 지원
IXC는 연동 설계와 앱 수정을 직접 지원합니다
IXC는 OneSignal 국내 공식 파트너로서 SDK 추가, 앱 기능과 딥링크 개발, 서버·고객 데이터 연동, QA와 운영을 지원합니다. 기존 시스템의 구조에 맞춰 도입 범위와 역할을 정합니다.
연동 설계
회원 ID, 기기 구독, Tags와 이벤트 목록, 수신 동의 상태, 원천 시스템을 정리합니다.
구현과 이행
앱과 서버 코드를 연결하고 기존 메시지 도구의 고객 식별값과 운영 흐름을 대조합니다.
검증과 운영 인계
테스트 시나리오와 확인 기록, 오류 대응 기준, 캠페인 변경 절차를 운영 담당자에게 전달합니다.
설계·검증에 쓰는 실무 자료
자주 묻는 질문
SDK만 설치하면 고객별 메시지를 보낼 수 있나요?
SDK는 구독과 앱 동작을 연결하는 기반입니다. 고객별 안내에는 회원 ID, 필요한 속성·이벤트, 채널 설정과 수신 상태도 연결해야 합니다. 현재 앱의 로그인과 서버 구조에 따라 개발 범위가 달라집니다.
한 고객의 여러 기기는 어떻게 연결하나요?
서비스의 안정적인 회원 식별값을 External ID로 연결합니다. 로그인 시 같은 회원 ID를 사용해 여러 구독을 같은 고객으로 묶고, 로그아웃과 다른 계정으로 전환하는 흐름도 함께 구현해야 합니다.
Tags에 모든 행동 이력을 저장하면 되나요?
Tags는 현재 고객 속성을 관리하는 데 적합합니다. 발생 시점과 개별 속성이 필요한 행동은 Custom Events로 구분하고, 이력 저장과 이벤트 세그먼트의 이용 조건을 확인해 필요한 항목만 설계합니다.
앱을 수정할 개발자가 부족한 경우에도 가능한가요?
IXC가 SDK 추가와 앱 수정, 딥링크, 서버 이벤트, 고객 데이터 연동을 지원할 수 있습니다. 사용 중인 앱 기술, 소스 접근 범위, 배포 방식, 현재 메시지 도구를 기준으로 필요한 구현과 검증 범위를 정합니다.