인앱 메시지 예제
- 푸시 알림 구독 또는 위치 업데이트와 같은 사용자 작업 프롬프트.
- 타겟 사용자에게 새로운 기능 또는 활용도가 낮은 기능 홍보.
- 앱 업데이트를 릴리스하지 않고 실시간으로 공지 사항 및 뉴스 표시.
- 설문조사 및 캐러셀 생성.
- 온보딩 및 교육 콘텐츠 지원.
설정 및 요구 사항
인앱 메시지를 사용하려면 앱에 OneSignal SDK가 설치되어 있어야 합니다. 완료되면 코드를 작성하지 않고 OneSignal 대시보드에서 인앱 메시지를 생성하고 전송할 수 있습니다. SDK에는 다음과 같은 고급 사용 사례를 위한 메서드도 있습니다:- 특정 시간에 메시지 트리거
- 클릭 처리 및 딥 링킹
- 메시지 일시 중지
- 수명 주기 관리 등!
모바일 SDK 설정
모바일 앱 코드베이스에 OneSignal을 추가합니다.
인앱 메시지 SDK 메서드
개발자: 트리거, 클릭 핸들러 및 수명 주기 API에 액세스합니다.
인앱 트리거
사용자 동작 또는 앱 활동을 기반으로 메시지가 표시되는 시기를 제어합니다.
인앱 클릭 작업
사용자가 메시지와 상호 작용할 때 발생하는 작업을 정의합니다.
인앱 메시지 전송
OneSignal 대시보드 및 Journeys 내에서 인앱 메시지를 전송할 수 있습니다.메시지 채널 선택
- 왼쪽 사이드바에서 + 생성… > 인앱을 선택하거나 오른쪽 상단 모서리에서 새 메시지 > 새 인앱을 선택합니다.
- 메시지 > 인앱으로 이동하여 이전에 대시보드에서 생성한 메시지를 볼 수도 있습니다.
OneSignal 대시보드의 새 메시지 전송 옵션.
이름 및 레이블 설정
- 내부 추적 메타데이터를 추가합니다.
타겟 오디언스 설정
메시지를 받을 자격이 있는 사용자입니다. 세그먼트를 포함 및 제외하여 특정 사용자를 타겟팅할 수 있습니다.
- 기본 세그먼트로 전송: 설정되지 않은 경우 모든 “구독 사용자”가 기본값입니다.
- 특정 세그먼트로 전송: 세그먼트를 명시적으로 포함 및 제외합니다. 여러 세그먼트에는 “OR” 관계가 있으며 중복 구독이 자동으로 제거됩니다.
이름, 레이블 및 오디언스 세그먼트 선택 인터페이스
메시지 디자인
더 많은 제어를 위해 시각적 드래그 앤 드롭 에디터 또는 HTML 에디터를 사용하세요.
편집 화면
드래그 앤 드롭으로 디자인
시각적 에디터를 사용하여 메시지를 빠르게 빌드합니다.
HTML로 디자인
개발자가 메시지를 사용자 지정할 수 있도록 완전히 제어합니다.
미리 만들어진 HTML 템플릿
테스트된 레이아웃 및 캠페인에서 시작합니다.
HTML용 인앱 JavaScript API
HTML 메시지에 OneSignal의 클릭 작업을 추가합니다.
메시지 개인화
각 사용자에 대한 메시지를 개인화하기 위한 동적 콘텐츠를 추가합니다.
다국어 메시징
글로벌 오디언스를 위해 콘텐츠를 현지화합니다.
클릭 작업
사용자가 메시지의 요소를 클릭할 때 발생하는 작업을 사용자 지정합니다.
클릭 작업 옵션
클릭 작업
사용자가 메시지의 요소를 클릭할 때 발생하는 작업을 사용자 지정합니다.
이벤트 스트림
메시지와의 상호 작용을 추적합니다.
SDK 클릭 핸들러
모바일 SDK로 클릭 이벤트에 반응합니다.
딥 링킹
클릭 시 사용자를 탐색합니다.
트리거
앱 세션 중에 메시지가 표시되는 시기를 정의합니다.
트리거 설정
앱 열기 시
사용자가 앱을 실행할 때 트리거됩니다.
세션 지속 시간
앱 열기 후 X초 지연.
마지막 메시지 이후
마지막 인앱 메시지 이후 X시간 지연.
사용자 지정 트리거
SDK
addTrigger(s)를 통해 제어됩니다.이 메시지는 언제 해제되어야 합니까?
메시지는 다음과 같이 해제될 수 있습니다:- 사용자 상호 작용 시(클릭, 스와이프)
- 설정된 시간 이후(자동 해제)
90초 후 자동 해제
일정 및 빈도
- 표시 시작: 메시지가 적격이 되는 시간
- 표시 중지: 종료 날짜/시간 설정 또는 “영원히 표시”
이 메시지를 얼마나 자주 표시하시겠습니까?
- 한 번만(기본값)
- 트리거가 충족될 때마다
- 사용자 지정 반복 논리를 사용하여 여러 번:
- 1시간 간격으로 2번 표시
- 30일 간격으로 12번 표시
예제는 30일마다 총 12번 메시지를 표시합니다.
인앱 메시지가 표시되는 방법
인앱 메시지는 적극적으로 푸시되지 않습니다. 대신 오디언스를 기반으로 앱 시작 시 풀링됩니다. 그런 다음 트리거 논리를 기반으로 표시됩니다.
인앱 메시지 표시 논리 흐름
- 사용자가 새 세션이 시작되기 전에 오디언스 기준을 충족합니다.
- 사용자가 앱을 백그라운드에 두거나 최소 30초 동안 닫은 후 앱을 열면 새 세션이 시작됩니다.
- 메시지가 활성화되거나 동일한 세션 중에 세그먼트에 진입할 때 사용자가 앱을 열어 둔 경우 메시지를 볼 수 있으려면 최소 30초 동안 앱을 포커스에서 벗어나게(닫기 또는 백그라운드) 해야 합니다.
- 트리거 조건이 충족됩니다.
- 예약된 시간 및 빈도가 유효합니다.
테스트
테스트하는 동안 다음을 수행하는 것이 좋습니다:1
앱에 자세한 로깅 추가
앱에
setLogLevel 메서드를 Verbose로 추가하여 더 자세한 로그를 가져옵니다.2
구독이 세그먼트에 있는지 확인
위의 인앱 메시지가 표시되는 방법에서 설명한 것처럼 사용자는 새 세션이 시작되기 전에 오디언스 기준과 일치해야 합니다.
- 기기의 구독 ID를 모르는 경우 기기 찾기 및 테스트 사용자 설정을 참조하세요.
- 기기의 구독이 포함된 세그먼트에 있고 사용 중인 경우 제외된 세그먼트에 없는지 확인하세요.
- 팁: 기기를 테스트 구독으로 추가하고 테스트 사용자 필터를 포함하도록 세그먼트를 생성하거나 업데이트할 수 있습니다.
3
앱이 최소 30초 동안 닫혀 있거나 포커스가 벗어나 있는지 확인
이렇게 하면 앱을 열어 새 세션을 만들고 메시지를 받을 자격이 있는지 확인할 수 있습니다.
4
트리거 조건 확인
메시지가 표시되도록 트리거를 충족하는지 확인하세요.
5
일정 및 빈도 확인
- “표시 시작” 및 “표시 중지” 날짜가 올바르게 설정되었는지 확인하세요.
- 테스트하는 동안 “이 메시지를 얼마나 자주 표시하시겠습니까?”를 “트리거 조건이 충족될 때마다”로 설정하세요.
6
메시지를 업데이트하고 활성 상태인지 확인
- 메시지가 활성화되면 기기에서 앱을 열 수 있습니다.
- 트리거 조건에 따라 메시지가 표시되어야 합니다.
테스트 및 미리보기 버튼
테스트 및 미리보기 버튼을 사용하면 선택한 테스트 기기로 푸시 알림이 전송됩니다. 푸시를 클릭하여 앱을 열면 인앱 메시지가 표시됩니다. 이 기능을 사용하려면 다음을 수행해야 합니다:- 기기가 테스트 사용자인지 확인하세요.
- 푸시 알림은 테스트 목적으로만 전송됩니다. 메시지가 활성화되면 푸시가 전송되지 않습니다.
- 앱을 열고 “테스트 메시지”를 보낼 수 있습니다. 인앱 메시지가 표시됩니다.
- 테스트 인앱 메시지의 경우 태그 대체가 작동하지 않습니다.
- 메시지가 표시되지 않으면 테스트 단계를 따랐는지 확인하세요.
- 테스트 인앱 메시지를 받으려면 기기가 푸시를 구독해야 합니다. 테스트 IAM은 푸시 알림에 의해 트리거되므로 구독에 잘못된 APNs 토큰이 있거나 푸시를 구독하지 않은 경우 테스트가 작동하지 않습니다.
도움이 필요하신가요?지원 팀과 채팅하거나
[email protected]으로 이메일을 보내주세요.다음을 포함해 주세요:- 발생한 문제의 세부 정보 및 재현 단계(가능한 경우)
- OneSignal 앱 ID
- External ID 또는 Subscription ID(해당하는 경우)
- OneSignal 대시보드에서 테스트한 메시지의 URL(해당하는 경우)
- 관련 로그 또는 오류 메시지
튜토리얼 및 사용 사례
인앱 메시지 개인화
태그로 인앱 메시지를 개인화하는 단계별 가이드.
오래된 앱 버전 타겟팅
사용자에게 앱 업데이트를 프롬프트합니다.
앱 스토어 리뷰 프롬프트
적시에 리뷰 요청으로 평점을 높입니다.
사용자 설문조사 생성
앱 내에서 피드백을 수집합니다.
푸시 권한 프롬프트
푸시 옵트인 비율을 개선합니다.
위치 권한 프롬프트
사용자에게 위치 추적 활성화를 요청합니다.
튜토리얼 생성
사용자가 앱의 새로운 기능을 이해할 수 있도록 튜토리얼을 설정하세요!