- 시작하기 — OneSignal 앱에 액세스하고 API 키 찾기
- 메시징 채널 설정 — SDK 설치 및 채널 구성
- SDK 및 API 참조 — 메서드, 클래스, 엔드포인트 상세 문서
- 사용자 및 ID — 사용자 식별, 구독 관리, 액세스 보안
- 테스트 및 디버깅 — 라이브 전에 통합 확인
- 웹훅 및 이벤트 — 서버 측에서 메시지 이벤트 수신
시작하기
팀에 이미 OneSignal 계정이 있다면 관리자에게 Organization에 초대를 요청하세요. 그렇지 않으면 계정을 만들어 시작하세요. OneSignal 앱은 사용자 및 메시지 데이터가 저장되는 곳입니다. 각 앱에는 고유한 앱 ID, API 키, 메시징 채널이 있습니다. 서로 다른 프로젝트나 환경을 위해 하나의 Organization에 여러 앱을 가질 수 있습니다.앱, Organization 및 계정
앱, Organization, 계정의 관계.
키 및 ID
인증을 위한 앱 ID, REST API 키, Organization ID를 찾습니다.
팀 멤버 추가
개발자를 초대하고 Organization 내 역할을 할당합니다.
사용량 및 청구
청구, 인보이스 및 사용량 세부 정보.
메시징 채널 설정
OneSignal SDK를 설치하여 플랫폼 전반의 사용자 참여를 생성하고 추적합니다. 각 메시지 채널에는 자격 증명, SDK 초기화, 튜토리얼을 다루는 자체 설정 가이드가 있습니다.모바일 SDK 설정
iOS, Android, Huawei, Amazon용 SDK 설정. 푸시 알림, In-App Message, Live Activities를 지원합니다.
웹 푸시
Web SDK 설치 및 브라우저 푸시 알림 설정.
이메일 채널 구성 및 발신 도메인 확인.
In-App Message
모바일 앱 내에 풍부하고 대화형 메시지를 표시합니다.
SMS
SMS 채널 설정 및 통신사 등록.
RCS
브랜드 콘텐츠와 읽음 확인이 포함된 리치 메시지.
Live Activities
iOS 동적 잠금 화면 업데이트. Android에서도 유사한 기능 제공.
모바일 푸시 프롬프트
모바일에서 푸시 구독을 수집하기 위한 옵트인 프롬프트를 구성합니다.
웹 푸시 프롬프트
웹에서 푸시 구독을 수집하기 위한 옵트인 프롬프트를 구성합니다.
SDK 및 API 참조
클라이언트 SDK, 서버 SDK, REST API에 대한 상세 문서.모바일 SDK 참조
iOS, Android, 크로스 플랫폼 SDK의 메서드, 클래스, 이벤트 훅.
웹 SDK 참조
초기화, 사용자 관리, 구독 메서드, 사용자 지정 트리거.
서버 SDK 참조
Node.js, Python, Java, Go, PHP, Ruby, C#, Rust용 서버 SDK 설치 및 구성.
REST API 개요
엔드포인트, 인증, 속도 제한, 요청/응답 형식.
트랜잭션 메시지
개인화된 데이터로 OTP, 영수증, 시간에 민감한 알림을 API를 통해 전송합니다.
GitHub의 서버 SDK
모든 서버 SDK 라이브러리의 소스 코드와 예시.
사용자 및 ID
OneSignal은 각 사람에게 OneSignal ID를 할당하고, 기기, 이메일 주소, 전화번호를 구독으로 추적합니다. 사용자는 External ID와 함께login을 호출하여 식별할 때까지 익명으로 유지됩니다. 사용자를 식별하면 채널과 기기 전반에 걸쳐 구독이 통합됩니다.
사용자
사용자 모델, External ID, 익명 vs. 식별된 사용자, 로그인/로그아웃.
구독
메시지를 수신하는 기기, 이메일 주소, 전화번호.
ID 확인
사용자 사칭을 방지하기 위해 서버 생성 JWT를 요구합니다.
별칭
크로스 플랫폼 추적 및 통합을 위해 사용자 지정 식별자를 사용자에게 매핑합니다.
태그
개인화와 세분화를 위해 사용자에게 키-값 데이터를 설정합니다.
사용자 지정 이벤트
Journey를 트리거하거나 분석을 지원하기 위해 사용자 행동을 추적합니다.
테스트 및 디버깅
전체 오디언스에게 전송하기 전에 통합이 제대로 작동하는지 확인합니다.테스트 구독
푸시, 이메일, SMS용 테스트 구독을 찾고 구성합니다.
디버그 로그
문제 해결을 위해 모바일 앱에서 상세 SDK 로그를 캡처합니다.
모바일 문제 해결
일반적인 푸시 전달, APNS, In-App Message 문제를 해결합니다.
웹 문제 해결
서비스 워커, 브라우저 호환성, 웹 푸시 문제를 수정합니다.
웹훅 및 이벤트
분석, 자동화 또는 외부 시스템과의 동기화를 위해 서버 측에서 메시지 이벤트를 수신합니다.Event Streams
클릭, 열람, 수신 등 메시지 이벤트를 실시간으로 데이터 웨어하우스에 스트리밍합니다.
Journey 웹훅
Journey 단계에서 서버로 HTTP 요청을 보냅니다.
웹 푸시 웹훅
웹 푸시 표시, 클릭, 닫기 이벤트에 대한 HTTP 콜백.
자주 묻는 질문
REST API 요청을 어떻게 인증하나요?
Authorization 헤더에 Bearer 토큰으로 REST API 키를 포함합니다: Authorization: Key YOUR_REST_API_KEY. OneSignal 대시보드의 설정 > 키 및 ID에서 키를 확인하세요. 자세한 내용은 키 및 ID를 참조하세요.
클라이언트 SDK와 서버 SDK의 차이점은 무엇인가요?
클라이언트 SDK(모바일 및 웹)는 사용자 기기의 앱에서 실행됩니다. 구독 등록, 권한 프롬프트, In-App Message,login을 통한 사용자 식별을 처리합니다. 서버 SDK는 백엔드에서 실행되며 REST API를 호출하여 메시지 전송, 사용자 관리, 데이터 내보내기를 수행합니다.
기기 간 사용자를 어떻게 식별하나요?
사용자가 로그인한 후 각 기기에서OneSignal.login("your_external_id")를 호출합니다. OneSignal은 동일한 External ID를 가진 모든 구독을 단일 사용자 아래에 통합합니다. 구현 세부 정보는 사용자를 참조하세요.
ID 확인을 설정해야 하나요?
ID 확인은 선택 사항이지만 프로덕션 앱에는 강력히 권장됩니다. 설정하지 않으면 어떤 클라이언트든 임의의 External ID로login을 호출할 수 있습니다. ID 확인을 활성화하면 서버 생성 JWT를 사용하도록 OneSignal SDK를 업데이트해야 하며, 사칭을 방지합니다.
도움이 필요하신가요?지원 팀과 채팅하거나
support@onesignal.com으로 이메일을 보내주세요.다음을 포함해 주세요:- 발생한 문제의 세부 정보 및 재현 단계(가능한 경우)
- OneSignal 앱 ID
- External ID 또는 Subscription ID(해당하는 경우)
- OneSignal 대시보드에서 테스트한 메시지의 URL(해당하는 경우)
- 관련 로그 또는 오류 메시지