이 가이드는 모바일 SDK 버전 2, 3 또는 4 또는 웹 SDK v15에서 오랫동안 OneSignal을 사용해 온 고객을 위한 것입니다.신규 고객이거나 이미 모바일 SDK 버전 5 또는 웹 SDK v16으로 마이그레이션한 경우 이 가이드를 건너뛰고 다음으로 이동할 수 있습니다:
사용자 모델을 사용한 다채널 메시징
사용자 모델이란 무엇인가요?
사용자 모델을 사용하면 개별 기기를 타겟팅하는 대신 구독한 모든 메시징 채널(모바일 푸시, 웹 푸시, 이메일, SMS 및 인앱)에서 실제 사용자를 타겟팅할 수 있습니다. 각 사용자:- 하나 이상의 ID 별칭을 가집니다(예: external_id, 사용자 지정 별칭)
- 각 채널 또는 기기에 대해 하나씩 여러 구독을 가질 수 있습니다
- 태그, 언어 및 활동 기록과 같은 메타데이터를 포함합니다
Player 모델 vs. 사용자 모델
핵심 개념
- 사용자
- 구독
- 별칭
사용자는 실제 사람을 나타냅니다. 시스템 생성 또는 사용자 지정 별칭을 사용하여 사용자를 식별할 수 있습니다.
onesignal_id: OneSignal에서 자동 생성됨external_id: SDKlogin()또는 API를 통해 설정됨(예약된 별칭)- 사용자 지정 별칭: 예:
user_id,email,facebook등
마이그레이션의 이점
- 통합 ID: 모든 기기 및 채널에서 한 명의 사용자
- 고급 메시징: 저니, 인앱 로그인 추적 및 수명 주기 캠페인과 같은 강력한 기능
- 깔끔한 세분화: 태그, 구독 상태, 채널 참여 등으로 사용자를 그룹화
- 단순화된 API: 더 적은 엔드포인트, 더 일관된 데이터 모델
마이그레이션 단계
사용자 모델은 이전 버전과 호환되지 않습니다. 마이그레이션은 Player 모델에서 사용자 모델로의 단방향입니다.마이그레이션하기 전에:
- 스테이징 환경에서 철저히 테스트
- 모든 SDK 및 백엔드 서비스를 업데이트한 후에만 마이그레이션
1
2
OneSignal SDK 업데이트
모든 OneSignal 모바일 SDK v5+ 및 웹 SDK v16+는 사용자 모델을 지원합니다.위험을 최소화하기 위해 단계적 배포 전략을 사용하여 SDK 업데이트를 롤아웃합니다:아래 SDK 지원 표를 참조하세요.
3
새로운 사용자 API를 사용하도록 백엔드 업데이트
더 이상 사용되지 않는 Player 모델 API 호출을 새로운 사용자 모델 동등물로 교체합니다.이전 엔드포인트를 새 엔드포인트로 매핑하려면 API 참조 및 아래 표를 사용하세요.
SDK 지원 및 마이그레이션 가이드
- 모바일 SDK
- 웹 SDK
- 백엔드 SDK
API 참조
- Player 모델(더 이상 사용되지 않음)
- 사용자 모델(신규)
다음 단계
- 📘 사용자 및 구독 문서를 참조하세요
- 🛠️ SDK를 업데이트하고 프로덕션으로 이동하기 전에 스테이징에서 테스트하세요
- 💬 도움이 필요하신가요?
support@onesignal.com으로 문의하세요
이제 새로운 사용자 모델로 구동되는 개인화된 다채널 메시징 경험을 구축할 준비가 되었습니다!