메인 콘텐츠로 건너뛰기
사용자 지정 이벤트는 현재 Early Access 단계입니다. 액세스를 요청하려면 다음을 포함하여 support@onesignal.com으로 문의하세요:
  • 회사 이름
  • 활성화하려는 OneSignal 앱 ID

​
개요

사용자 지정 이벤트를 사용하면 앱, 웹사이트 또는 외부 시스템에서 의미 있는 사용자 작업을 추적하고 실시간으로 조치를 취할 수 있습니다. OneSignal 외부에서 발생하는 행동에 대한 사용자 이벤트를 보내고 더 타겟팅되고 관련성 있고 시기적절한 메시징을 제공하는 데 사용하세요. 다음을 수행할 수 있습니다:
  • OneSignal SDK를 사용하여 앱이나 웹사이트에서 직접 이벤트 보내기
  • 통합, CDP 또는 데이터 웨어하우스에서 이벤트 가져오기
  • 실시간 행동을 기반으로 Journeys 트리거, Wait Until 단계 활성화 및 사용자 세분화에 사용(세분화 옵션 출시 예정)
사용 사례 예시:
  • 사용자 가입 → 온보딩 Journey 시작
  • 사용자가 결제를 포기함 → 알림 또는 제안 보내기
  • 게이머가 새로운 레벨에 도달 → 인앱 보상 보내기
  • 사용자가 계정을 취소하려고 시도함 → 윈백 캠페인 트리거

​
사용자 지정 이벤트란 무엇인가요?

사용자 지정 이벤트는 비즈니스에 중요한 추적된 사용자 작업(또는 비활동)입니다. 일반적인 예는 다음과 같습니다:
  • 구매하기
  • 게임 레벨 완료하기
  • 운동 시작하기
  • 구독 취소하기
각 이벤트에는 추가 컨텍스트를 제공하기 위한 속성이 포함될 수 있습니다. 사용자 지정 이벤트 구조:
  • name(문자열, 필수) — 이벤트 이름, 최대 128자
  • properties(객체, 선택 사항) — JSON의 컨텍스트 데이터
  • 사용자 식별자(필수) — external_id 또는 onesignal_id 중 하나
예시: 
{
  "events": [
    {
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:09:32.263Z",
      "name": "purchase",
      "properties": {
        "item": "T-shirt",
        "size": "small",
        "color": "blue",
        "price": 24.99
      }
    }
  ]
}
사용자 지정 이벤트는 다음과 같이 수행할 수 있습니다:
  • 앱이나 사이트에서 실시간으로 생성(OneSignal Mobile/Web SDK)
  • Segment, Amplitude 또는 Databricks와 같은 통합에서 수집(출시 예정)
  • 웨어하우스 또는 CDP에서 가져오기(출시 예정)

​
태그 vs 사용자 지정 이벤트

Tags and Custom Events are both ways to add data to your users. However, there are some key differences:
FeatureTagsCustom Events
Data usageSegmentation and personalizationTrigger Journeys without a Segment, Wait Until steps, personalization directly within Journeys
Data retentionLifetime30+ days (lifetime storage is available)
Data formatKey-value strings or numbersJSON
Data sourceOneSignal SDK, API, or integrations (limited)OneSignal SDK, API, or integrations
Data accessSegmentation and message personalizationJourneys and Journey-message-template personalization, Segmentation (Coming soon)
The key distinction between Tags and Custom Events is in their depth and use cases. Tags are properties of a user, such as Name, Account Status, or Location. Events are thing that the user has done, such as Purchasing an Item, Completing a Level, or Inviting a Friend. Both tags and events can be used for segmentation and personalization. In practice, you will likely use both:
  • Tags for user properties that are static and don’t change often
  • Custom Events for real-time scenarios, complex segmentation, and more sophisticated journey workflows

​
OneSignal로 사용자 지정 이벤트 가져오기

API를 사용하여 직접 이벤트를 생성하거나 다른 시스템에서 수집할 수 있습니다.
SDK에서 생성되거나 데이터 웨어하우스에서 수집된 모든 이벤트는 청구 목적상 동일하게 처리됩니다.

​
OneSignal API 및 SDK

다음을 통해 이벤트를 보내세요: 예시: API를 통해 보내기
curl
curl --request POST \
  --url https://api.onesignal.com/apps/{app_id}/custom_events \
  --header 'Content-Type: application/json' \
  --data '{
  "events": [
    {
      "name": "completed_onboarding",
      "external_id": "user_12345",
      "properties": {
        "plan": "Pro",
        "time_to_complete": 600
      }
    }
  ]
}'
​
name
string
required
이벤트의 식별자 또는 이름. 최대 128자.
​
external_id
string
이벤트 대상 사용자의 외부 ID. 사용자의 외부 ID 또는 OneSignal ID 중 하나가 필요합니다.
​
properties
object
이벤트에 대한 선택적 매개변수(예: 플랜 이름, 제품 ID, 가격).
이 이벤트는 즉시 completed_onboarding을 사용자 지정 이벤트 진입 규칙 트리거 또는 대기 작업으로 사용하는 Journey에 external_id user_12345를 가진 사용자를 추가합니다.

​
통합

이벤트가 이미 다른 곳에서 추적되고 있는 경우 지원되는 통합을 통해 가져오세요.

​
이벤트 보기 및 확인

이벤트가 유입되기 시작하면 OneSignal의 여러 도구를 통해 이벤트를 보고 문제를 해결할 수 있습니다.

​
Event List 탭

조직으로 이동

Event List 탭은 이벤트 유형별로 구성된 이벤트의 상위 수준 대시보드를 제공합니다. 각 이벤트 종류에 대해 수집된 총 이벤트 수, 가장 최근에 수집된 이벤트(속성과 함께 JSON 형식으로 표시됨), 이벤트 소스(SDK, API 또는 통합) 및 이벤트 유형이 마지막으로 발생한 시간을 볼 수 있습니다. 각 이벤트의 세부 보기 내에서 보존 기간을 업데이트할 수 있는 옵션도 있습니다. 하위 세부 보기는 세 가지 주요 영역에 대한 추가 인사이트를 제공합니다:
  • Source Breakdown – 소스별로 수집된 이벤트 수를 표시하며 마지막으로 본 이벤트의 타임스탬프와 함께 이벤트의 최신 스키마를 확장하고 볼 수 있는 옵션이 있습니다.
  • Activities – 소스와 타임스탬프를 표시하여 수집된 가장 최근 10개의 이벤트를 나열합니다. 각 항목을 확장하여 이벤트의 전체 JSON 페이로드를 표시할 수 있습니다.
  • Usage – 세그먼트 또는 Journey와 같이 OneSignal 내에서 특정 이벤트가 사용되는 위치를 표시합니다. 여기에서 관련 세그먼트 또는 Journey를 직접 클릭하여 설정에 액세스할 수 있습니다.

​
Event Activity 탭

조직으로 이동

Event Activity 탭은 OneSignal 앱에 수집된 가장 최근 이벤트의 라이브 피드를 제공합니다. 피드를 확장하여 최대 90일 전의 이벤트를 검토하고 소스, 이벤트 속성 또는 외부 ID별로 필터를 적용할 수 있습니다. 이 탭은 이벤트 소스를 구성할 때 문제를 디버깅하는 데 특히 유용합니다. 이벤트가 예상대로 애플리케이션에 도달하는지 확인할 수 있기 때문입니다. 피드는 자동으로 새로 고쳐지지 않으므로 새 이벤트를 보낸 후 최신 활동을 보려면 수동으로 새로 고쳐야 합니다.

​
Event Storage 탭 (출시 예정)

OneSignal 애플리케이션의 이벤트 스토리지를 관리하는 전용 보기입니다.

​
OneSignal에서 사용자 지정 이벤트 사용

​
이벤트로 Journeys 트리거

이벤트 트리거 Journeys를 사용하면 실시간 활동을 기반으로 즉시 사용자에게 메시지를 보낼 수 있습니다. 세그먼트 업데이트를 기다릴 필요가 없습니다. 사용자가 주요 작업을 수행하는 순간 Journey를 시작할 수 있습니다.

​
Wait Until 이벤트

Wait Until 단계를 사용하여 특정 사용자 지정 이벤트 또는 다른 작업이 발생할 때까지 Journey에서 사용자를 일시 중지하세요.
만료 기간을 정의할 수도 있습니다. 사용자가 제시간에 조건을 충족하지 않으면 대체 경로를 계속 진행하거나 대체 메시지를 보내거나 Journey를 종료할 수 있습니다.

​
사용자 지정 이벤트별 세분화(Early Access 단계)

사용자 지정 이벤트의 발생을 기반으로 세그먼트를 만들 수 있습니다. 이를 통해 OneSignal SDK를 사용하여 애플리케이션의 행동을 기반으로 하거나 OneSignal 외부에서 캡처된 이벤트에서 사용자를 세분화할 수 있습니다. 사용자 지정 이벤트 세분화에 대한 자세한 내용은 세분화 페이지에서 확인할 수 있습니다. 사용자 지정 이벤트 세분화를 위한 Early Access 프로그램에 참여하고 싶으시면 support@onesignal.com 또는 OneSignal 계정 담당자에게 문의하세요. 이 기능이 Early Access 단계에 있는 동안의 제한 사항:
  • 이메일 Warm Up 및 A/B 테스트와 함께 사용할 수 없습니다.
  • 사용자 지정 이벤트 세그먼트는 Journeys를 구동하는 데 사용할 수 없습니다.
  • 아직 사용자 지정 이벤트 필터를 다른 세분화 필터(사용자 속성 또는 메시지 이벤트와 같은)와 결합할 수 없습니다.

​
플랜 가용성 및 보존 비용

사용자 지정 이벤트는 모든 유료 플랜에서 사용할 수 있습니다. 자세한 내용은 청구 FAQ를 참조하세요.