- 시작하기: App ID와 API 키 찾기
- SDK 설치: 모바일 또는 웹 SDK 설치
- 사용자 및 ID: 사용자 식별, 구독 관리, 액세스 보안
- 통합 테스트: 라이브 전에 전달 확인
- 문제 해결: 전달 문제 디버그
시작하기
팀에 이미 OneSignal 계정이 있다면 관리자에게 Organization에 초대를 요청하세요. 그렇지 않으면 계정을 만들어 시작하세요. OneSignal 앱은 SDK 설정에 필요한 App ID와 API 키를 포함하여 사용자 및 메시지 데이터를 보관합니다. 여러 프로젝트나 환경을 관리하는 경우 앱, 조직 및 계정의 관계를 알아보세요.키 및 ID
인증을 위한 App ID, REST API 키, Organization ID를 찾습니다.
SDK 설치
플랫폼에 맞는 OneSignal SDK를 설치하세요.모바일 SDK 설정
iOS, Android, Huawei, Amazon용 SDK 설정. 푸시 알림, In-App Message, Live Activities를 지원합니다.
웹 SDK 설정
Web SDK 설치 및 브라우저 푸시 알림 설정.
- Windows
- macOS (Mac Catalyst 앱은 iOS SDK를 통해 지원됩니다)
- watchOS 및 Wear OS
사용자 및 ID
OneSignal은 각 사람에게 OneSignal ID를 할당하고, 기기, 이메일 주소, 전화번호를 구독으로 추적합니다. 사용자는 External ID와 함께login을 호출하여 식별할 때까지 익명으로 유지됩니다. 사용자를 식별하면 채널과 기기 전반에 걸쳐 구독이 통합됩니다.
사용자
사용자 모델, External ID, 익명 vs. 식별된 사용자, 로그인/로그아웃.
구독
메시지를 수신하는 기기, 이메일 주소, 전화번호.
태그
개인화와 세분화를 위해 사용자에게 사용자 지정 속성을 추가합니다.
사용자 지정 이벤트
Journeys를 트리거하거나 분석을 지원하기 위해 사용자 행동을 추적합니다.
통합 테스트
전체 오디언스에게 전송하기 전에 테스트 사용자로 전달, 렌더링, 딥 링크를 확인하세요.테스트 사용자
푸시, 이메일, SMS용 테스트 사용자를 찾고 구성합니다.
문제 해결
디버그 로그부터 시작한 다음 통합에 맞는 플랫폼 가이드를 사용하세요.모바일 문제 해결
일반적인 푸시 전달, APNs, In-App Message 문제를 해결합니다.
웹 SDK 문제 해결
서비스 워커 오류, 오리진 불일치, 표시되지 않는 알림 문제를 해결합니다.
디버그 로그
상세 로깅을 활성화하고, 문제를 재현하고, 로그를 지원팀과 공유합니다.
웹 푸시 권한 재설정
깨끗한 테스트를 위해 브라우저 캐시, 서비스 워커, 알림 권한을 지웁니다.
설정 이후
일반적인 사용 사례를 살펴보고 개발하면서 SDK 메서드나 REST API 엔드포인트를 찾아보세요.튜토리얼 및 사용 사례
장바구니 이탈, 온보딩 플로우, 재참여 캠페인 등을 위한 구현 가이드를 탐색하세요.
태그
개인화와 세분화를 위해 사용자에게 사용자 지정 속성을 추가합니다.
사용자 지정 이벤트
Journeys를 트리거하거나 분석을 지원하기 위해 사용자 행동을 추적합니다.
모바일 SDK 참조
iOS, Android, 크로스 플랫폼 SDK의 메서드, 클래스, 이벤트 훅.
웹 SDK 참조
초기화, 사용자 관리, 구독 메서드, 사용자 지정 트리거.
서버 SDK 참조
Node.js, Python, Java, Go, PHP, Ruby, C#, Rust용 서버 SDK 설치 및 구성.
REST API 개요
엔드포인트, 인증, 속도 제한, 요청/응답 형식.
자주 묻는 질문
기기 간 사용자를 어떻게 식별하나요?
사용자가 로그인한 후 각 기기에서OneSignal.login("your_external_id")를 호출하세요. OneSignal은 동일한 External ID를 가진 모든 구독을 단일 사용자 아래에 통합합니다. 구현 세부 정보는 사용자를 참조하세요.
ID 확인을 설정해야 하나요?
ID 확인은 선택 사항이지만 프로덕션 앱에는 강력히 권장됩니다. 설정하지 않으면 어떤 클라이언트든 임의의 External ID로login을 호출할 수 있습니다. ID 확인을 활성화하면 서버 생성 JWT를 사용하도록 OneSignal SDK를 업데이트해야 하며, 사칭을 방지합니다.