Documentation Index
Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
Use this file to discover all available pages before exploring further.
활동 피드란 무엇인가요?
활동 피드를 통해 사용자는 앱 내에서 수신한 알림의 기록을 볼 수 있습니다.
OneSignal은 알림 전달에 중점을 두지만 현재 각 개별 사용자에게 전송된 메시지의 기록을 저장하지 않습니다. 이 기능을 구축하려면 백엔드 서버 또는 사용자 기기에 직접 알림 데이터를 직접 저장해야 합니다.
서버에 저장
권장 접근 방식앱의 백그라운드 처리에 의존하는 대신 Create notification REST API를 사용하여 각 알림을 보내고 서버에 사본을 저장하세요. 그런 다음 앱이 시작될 때 서버에서 업데이트를 확인할 수 있습니다.데이터가 저장되면 언제든지 사용자의 알림 기록을 검색하고 표시할 수 있습니다.OneSignal Event Streams를 사용하여 활동 피드 만들기
OneSignal의 Event Streams 기능은 앱에서 백엔드 시스템이나 데이터 웨어하우스로 실시간 이벤트를 스트리밍하는 확장 가능한 방법을 제공합니다. 이를 통해 팔로우, 댓글, 구매 또는 알림 이벤트와 같은 인앱 사용자 행동을 반영하는 피드를 앱 내에서 수동으로 업데이트하지 않고도 구축할 수 있습니다.작동 방식
Event Streams는 다음을 포함한 라이브 이벤트 데이터를 내보냅니다:
- 알림 전달
- 이메일/SMS 열기 및 클릭
- 사용자 트리거 작업
대상에는 다음이 포함됩니다:
- Webhooks(HTTP 엔드포인트)
- Amazon Kinesis
- Amazon S3
- Google Cloud Storage
- BigQuery
- 기타
시스템은 이러한 이벤트가 발생할 때 수신하고 이를 사용하여 피드 UI 또는 분석 파이프라인을 업데이트할 수 있습니다.Event Streams로 활동 피드를 설정하는 단계
Event Streams 활성화
- OneSignal 대시보드 > Settings > Event Streams로 이동하세요.
- Webhook 또는 데이터 파이프라인(예: Amazon Kinesis)과 같은 대상을 선택하세요.
- 스트리밍하려는 이벤트를 선택하세요(예:
message.sent, message.delivered, message.clicked).
이벤트 데이터를 처리하도록 백엔드 구성
-
이벤트 데이터를 수집하는 webhook 또는 컨슈머를 만드세요.
-
이벤트 페이로드를 파싱하여 다음과 같은 관련 필드를 추출하세요:
external_id(사용자 ID)event 유형(message.delivered 등)timestampcontents(알림 메시지)additional_data(사용자 지정 메타데이터)
활동 피드 항목 저장 및 구조화
- 이러한 이벤트를 쿼리 및 렌더링에 적합한 형식으로 데이터베이스에 저장하세요.
{
"message.id": "f3c9cd09-10d7-4f59-b9bc-66e16607f1d5",
"message.name": "the-name-you-set",
"message.title": "Claim 50% Off Today", // email subject example
"message.title": "{'en':'the message title/headings'}", // push title example
"message.contents": "{'en':'the message content'}",
"message.template_id": "the-template-uuid-if-set",
"message.url": "the-message-url",
"message.app_url": "the-message-app-url",
"message.web_url": "the-message-web-url"
}
앱에서 피드 렌더링
- 로그인한 사용자에 대한 최근 이벤트를 쿼리하고 표시하는 프론트엔드 컴포넌트(예: React, SwiftUI 또는 Android View)를 구축하세요.
- 선택적으로 이벤트 유형별 필터 또는 그룹화를 포함하세요.
추가 메타데이터로 향상
-
알림을 보낼 때 피드 컨텍스트를 제공하기 위해
additional_data를 포함하세요. 예를 들어:
{
"action": "commented",
"post_id": "xyz123"
}
-
이를 통해 “Jane님이 게시물에 댓글을 달았습니다.”와 같은 풍부한 피드 항목을 만들 수 있습니다.
사용 사례 예시
- 전자상거래: 주문 확인, 배송 업데이트 및 프로모션을 표시합니다.
- 소셜 앱: 좋아요, 댓글, 팔로우를 표시합니다.
- SaaS 플랫폼: 작업 할당, 멘션 또는 활동 로그를 추적합니다.
- 이벤트 스트리밍을 통한 실시간 업데이트
- 완전히 사용자 지정 가능한 로직 및 디스플레이
- 확장 가능한 백엔드 기반 아키텍처
