- 라이브 데이터를 사용하여 개인화된 시간에 민감한 메시지 전송
- 시스템 간에 사용자 속성 및 메시지 데이터 동기화
- 시스템 내 사용자 작업에서 자동화된 Journeys 트리거
- OneSignal의 메시징 인프라를 활용하면서 내부 시스템을 신뢰할 수 있는 소스로 사용
통합 가이드
OneSignal은 많은 인기 플랫폼과 직접 통합됩니다. 통합 페이지에서 플랫폼이 지원되는지 확인하세요. 지원되는 경우 해당 설정 가이드를 따르세요.통합
CRM, 데이터 웨어하우스, 분석 도구 등과의 모든 사용 가능한 OneSignal 통합을 탐색하세요.
1단계: External ID로 사용자 식별
OneSignal의external_id는 OneSignal과 데이터베이스 간의 핵심 연결 고리입니다. OneSignal에서 각 사용자의 external_id를 데이터베이스의 사용자 ID와 일치하도록 설정하세요. 이를 통해 이미 보유한 식별자를 사용하여 사용자를 타겟팅하고, 데이터를 동기화하고, 메시지를 트리거할 수 있습니다.
여러 OneSignal 앱(예: iOS, Android, 웹용 별도 앱)을 사용하는 경우, 모든 앱에서 동일한 external_id를 설정하면 플랫폼 전반에서 동일한 사용자를 식별할 수 있습니다.
익명 사용자가 있거나 시스템 간에 사용자를 추적하기 위한 안정적인 사용자 ID가 없는 경우 OneSignal의 onesignal_id 또는 subscription_id를 사용할 수 있습니다. 그러나 사용자가 안정적이고 식별 가능할 때 external_id를 설정하는 것을 권장합니다.
onesignal_id 및/또는 subscription_id는 Create user API 응답과 Observer 메서드를 사용하는 모바일 및 웹 SDK를 통해 사용할 수 있습니다.
API 전용 설정
OneSignal을 이메일 및 SMS/RCS에만 사용하는 경우(모바일 앱 또는 웹사이트 없음), REST API를 통해 전적으로 사용자를 관리할 수 있습니다:- Create user —
external_id, 이메일 주소 및/또는 전화번호로 사용자 생성 - Update user — 사용자 속성 및 구독 업데이트
external_id를 설정합니다:
- 플랫폼용 OneSignal SDK를 설치합니다.
- 앱에서 인증된 후 사용자의
external_id로login을 호출합니다. - SDK가 자동으로 푸시 토큰을 캡처하고 사용자에게 연결합니다.
2단계: 사용자 데이터 및 이벤트 동기화
사용자 ID가 설정되면 시스템에서 OneSignal로 두 가지 유형의 데이터를 동기화할 수 있습니다: 태그 — 지속적인 사용자 속성 태그는 세분화 및 메시지 개인화를 위해 OneSignal에 사용자 속성을 저장합니다. 플랜 유형, 선호 언어 또는 가입일 등 사용자가 누구인지 설명하는 데이터에 사용하세요.- Update user API 또는 프론트엔드 SDK를 통해 태그를 설정합니다
- 태그는 업데이트하거나 제거할 때까지 사용자에게 유지됩니다
- 태그를 사용하여 세그먼트를 구축하고 메시지 콘텐츠를 개인화합니다
completed_purchase, viewed_page 또는 subscription_expired와 같이 사용자가 취하는 작업을 나타냅니다. 자동화된 Journeys를 트리거하는 데 사용합니다.
- API 또는 프론트엔드 SDK를 통해 커스텀 이벤트를 전송합니다
- 커스텀 이벤트는 태그처럼 지속되지 않지만 Journeys 및 메시지 개인화를 트리거하는 데 사용할 수 있습니다
3단계: 메시지 및 참여 데이터 내보내기
시스템으로 전달 및 참여 데이터를 다시 동기화하려면:- Event Streams — (권장) 메시지 이벤트(전송됨, 전달됨, 클릭됨 등)의 실시간 웹훅 전달. 이벤트가 발생할 때 데이터베이스를 동기화하는 데 가장 적합합니다.
- 구독 CSV 내보내기 — 정기 동기화 또는 마이그레이션을 위한 구독 데이터 일괄 내보내기.
- 메시지 보기 API — 메시지 기록 및 전달 통계를 프로그래밍 방식으로 조회합니다.
아키텍처 권장 사항
- 데이터베이스를 신뢰할 수 있는 소스로 유지하세요. OneSignal을 메시징 레이어로 취급하세요. 사용자 데이터와 이벤트를 OneSignal에 푸시하고 전달/참여 데이터를 다시 가져오세요.
- 실시간 업데이트에는 API를 사용하세요. 사용자가 작업을 수행할 때(예: 구매 완료) 즉시 OneSignal API를 호출하여 태그를 업데이트하거나 커스텀 이벤트를 전송하세요.
- 대량 작업에는 CSV 가져오기를 사용하세요. 초기 온보딩 또는 대규모 마이그레이션의 경우 수천 건의 개별 API 호출 대신 CSV 가져오기를 사용하세요.
- 속도 제한을 준수하세요. 대량 업데이트의 경우 가능한 경우 요청을 일괄 처리하고 지수 백오프로 재시도 로직을 구현하세요.
- 반환 경로에 Event Streams를 사용하세요. 전달 데이터를 위해 OneSignal API를 폴링하는 대신 Event Streams를 설정하여 메시지 이벤트에 대한 실시간 웹훅을 수신하세요.
데이터베이스에서 메시지 트리거
두 가지 접근 방식을 사용하여 메시지를 트리거할 수 있습니다. 사용 사례에 따라 하나 또는 둘 다 선택하세요.- API
- 태그 및 Journeys
- 커스텀 이벤트 및 Journeys
즉각적인 트랜잭션 메시징을 위해 Create message API를 사용하세요.다음을 통해 사용자 타겟팅:
external_id- 별칭(예:
crm_id) - 이메일 또는 전화번호
- 트랜잭션 메시지(예: 영수증, 알림)
- 시간에 민감하거나 개인화된 알림
- 개인 또는 그룹 타겟팅(호출당 최대 20,000명의 사용자)
send_after 매개변수를 사용하여 메시지를 예약할 수도 있습니다.FAQ
데이터베이스에서 메시지를 전송하려면 API와 Journeys 중 어느 것을 사용해야 합니까?
영수증이나 알림과 같은 즉각적인 트랜잭션 메시지에는 Create message API를 사용하세요. 시각적 워크플로 빌딩의 이점을 받는 자동화된 라이프사이클 및 마케팅 메시지에는 태그 또는 커스텀 이벤트와 함께 Journeys를 사용하세요.OneSignal과 내 자체 시스템에 어떤 데이터를 저장해야 합니까?
데이터의 목적에 따라 결정하세요: OneSignal에 저장할 항목- 메시징에 직접 사용되는 데이터를 저장하세요:
OneSignal은 메시지 개인화에서 자세히 설명된 여러 메시지 개인화 방법을 지원합니다.
- 메시징과 관련이 없는 데이터(예: 전체 사용자 프로필, 거래 로그)는 성능, 개인정보 보호 및 제어를 위해 자체 시스템에 보관하세요. 장기 분석 또는 규정 준수를 위해 OneSignal의 메시지 기록을 아카이브하세요.
External ID가 없는 사용자에게 메시지를 보낼 수 있습니까?
예, 하지만 추가 처리가 필요합니다. OneSignal의onesignal_id 또는 subscription_id를 사용할 수 있지만, 이들은 external_id에 연결될 때까지 익명입니다. 시스템 간 식별을 단순화하기 위해 모든 사용자에게 external_id를 설정하는 것을 권장합니다.
태그와 커스텀 이벤트의 차이점은 무엇입니까?
태그는 세분화 및 개인화에 사용되는 지속적인 사용자 속성(예: 플랜 유형, 언어 기본 설정)입니다. 커스텀 이벤트는 Journeys를 트리거하는 데 사용되는 일회성 사용자 작업(예:completed_purchase)을 나타냅니다. 태그는 사용자가 누구인지 설명하고, 커스텀 이벤트는 사용자가 무엇을 했는지 설명합니다.
사용자
OneSignal 사용자 모델과 ID 구조 방식을 이해합니다.
커스텀 이벤트
시스템에서 이벤트를 전송하여 Journeys를 트리거하고 사용자 행동을 추적합니다.
메시지 개인화
태그, 커스텀 데이터 및 동적 콘텐츠로 메시지를 개인화합니다.
Journeys
사용자 행동 및 데이터로 트리거되는 자동화된 메시징 워크플로를 구축합니다.