콘텐츠로 건너뛰기
개발자 문서지원 데모 요청 로그인
Pushwoosh.com

기본 이벤트

기본 이벤트란 무엇인가요?

Anchor link to

기본 이벤트는 사용자가 산업이나 기능에 관계없이 앱이나 웹사이트에서 수행하는 기본적인 상호작용입니다. 이러한 핵심 사용자 행동은 고객 커뮤니케이션의 핵심을 형성하며, 고객 생애 주기의 모든 단계에서 모든 제품과 고객에게 활용될 수 있습니다.

기본 이벤트는 최신 SDK 버전에서 바로 사용할 수 있습니다. PW_InAppPurchase(아래 세부 정보 참조)를 제외하고는 추가 설정이 필요하지 않습니다.

Pushwoosh에서 사용 가능한 기본 이벤트를 찾아 활성화하려면 다음 단계를 따르세요.

  1. Audience 섹션 내의 Events 탭으로 이동합니다.
  2. Create Event를 클릭합니다.
  3. 드롭다운 메뉴에서 Default Event를 선택합니다.
  4. 팝업 창에서 원하는 이벤트를 선택하고 Activate를 클릭합니다.
활성화할 수 있는 이벤트를 보여주는 기본 이벤트 드롭다운 메뉴

활성화되면 기본 이벤트는 행동 기반 메시징에 사용될 수 있습니다. 예를 들어, Customer Journey에서 Trigger-based Entry로 사용하거나 인앱 메시지의 트리거로 사용할 수 있습니다.

PW_DeviceRegistered

Anchor link to

이 이벤트는 각 기기에서 앱 최초 실행 및 SDK 초기화 시 한 번만 발생합니다. 이름에서 알 수 있듯이, 이 이벤트는 앱에서의 기기 등록을 추적합니다.

사용 사례

  • 새로 등록한 사용자를 위한 온보딩 캠페인 시작 – PW_DeviceRegistered 이벤트를 사용하는 Trigger-based Entry를 온보딩 Customer Journey에 추가합니다.
  • 이벤트 통계로 더 많은 신규 사용자를 유치하는 획득 활동을 식별합니다.
  • 사용자의 첫 방문 시 바로 참여 유도: DeviceRegistered 이벤트로 트리거되는 인앱으로 사용자를 맞이합니다.
신규 사용자 온보딩을 위해 DeviceRegistered 이벤트로 트리거된 인앱 메시지

PW_DeviceUnregistered

Anchor link to

이 이벤트는 앱이 제거되거나 사용자가 이메일 또는 푸시 알림 수신을 거부할 때 발생합니다.

이벤트 속성

  • message_id (문자열)
  • message_code (문자열)
  • campaign_id (문자열)

사용 사례

  • 사용자가 앱 사용을 중단하기로 결정했을 때 사용자를 유지합니다. 예를 들어, 앱을 제거한 모든 사용자에게 특별 혜택이 담긴 이메일을 보낼 수 있습니다.
  • 채널 중 하나에서 구독을 취소한 사용자와의 커뮤니케이션을 유지합니다. 예를 들어, 사용자가 더 이상 푸시 알림을 받기를 원하지 않는 경우, 이메일을 보내거나 인앱을 표시하여 앱을 더 자주 사용하도록 유도할 수 있습니다.

PW_ApplicationOpen

Anchor link to

모바일 앱 전용

ApplicationOpen 이벤트는 사용자가 기기에서 모바일 앱을 실행할 때마다 트리거됩니다.

이벤트 속성

  • device_type (정수 기기 유형 코드, 자세한 내용은 registerDevice 참조)
  • application_version

사용 사례

  • ApplicationOpen 이벤트 통계를 기반으로 사용자 유지율 통계를 수집합니다.
  • 앱에서 활성 상태인 사용자를 위해 인앱 메시징 캠페인을 실행합니다.

PW_ScreenOpen

Anchor link to

모바일 앱 전용

이 이벤트는 사용자가 모바일 앱의 특정 화면을 볼 때마다 발생합니다.

이벤트 속성

  • application_version
  • device_type (정수 기기 유형 코드, 자세한 내용은 registerDevice 참조)
  • screen_name (앱에서 얻은 기술적인 화면 이름)

사용 사례

  • PW_ScreenOpen 이벤트로 Customer Journey를 시작하여 특정 앱 섹션에 관심을 보인 사용자에게 완벽하게 관련성 있는 메시지를 보냅니다.
  • 프로모션의 효과를 평가하고 개선합니다: 제안의 두 가지 또는 여러 버전을 A/B/n 테스트하고, ScreenOpen 이벤트가 발생하기를 기다린 다음 어떤 콘텐츠가 가장 좋은 성과를 냈는지 확인합니다.
  • 어떤 앱 화면이 가장 많이 방문되는지 파악합니다: 화면 이름으로 이벤트 통계를 필터링합니다.
화면 이름으로 필터링된 이벤트 통계 대시보드로 사용자 참여 데이터 표시

PW_ApplicationMinimized

Anchor link to

모바일 앱 전용

이 이벤트는 사용자가 기기에서 앱을 최소화할 때(강제 종료는 아님) 발생합니다.

이벤트 속성

  • device_type (정수 기기 유형 코드, 자세한 내용은 registerDevice 참조)
  • application_version

사용 사례

  • ApplicationOpen과 ApplicationMinimized 이벤트 사이의 평균 세션 시간을 추적합니다.
  • 앱이 백그라운드에서 실행되는 동안 푸시 알림을 보내 사용자의 주의를 끌고 앱으로 다시 돌아오게 합니다.

PW_UserIdle

Anchor link to

모바일 앱 전용

이 이벤트는 사용자가 앱 내에 있지만 설정 가능한 기간 동안 화면과 상호 작용하지 않았을 때 발생합니다. 사용자가 앱을 떠난 후 트리거되는 PW_ApplicationMinimized와 달리, PW_UserIdle은 사용자가 아직 앱에 있는 동안 발생하여 주의가 산만해지거나, 망설이거나, 다른 일에 정신이 팔리는 순간을 포착합니다. 이를 서버 측 신호로 사용하여 시기적절한 인앱을 표시하거나, 도움을 제공하거나, 사용자를 다음 단계로 유도할 수 있습니다.

유휴 감지는 기본적으로 양쪽 플랫폼에서 비활성화되어 있습니다. 타임아웃 키가 없거나 0으로 설정된 경우 PW_UserIdle 이벤트가 전송되지 않습니다. 활성화하려면 앱의 플랫폼 구성에서 타임아웃(최소 30초)을 설정하세요.

  • iOS의 경우:
    • 앱의 Info.plist에 Pushwoosh_IDLE_TIMEOUT_SECONDS 키(숫자, 최소 30)를 추가합니다.
  • Android의 경우:
    • AndroidManifest.xml에 com.pushwoosh.idle_timeout_seconds 메타데이터(정수, 최소 30)를 추가합니다.

이벤트 속성

  • screen_name (문자열) — 사용자가 유휴 상태가 된 화면. Android에서는 ActivityName/FragmentName 형식, iOS에서는 현재 화면이 중첩된 경우 ParentVC/ChildVC 형식으로 표시되며, 그렇지 않은 경우 액티비티 또는 뷰 컨트롤러 이름입니다.
  • idle_seconds (정수) — 경과된 설정된 유휴 타임아웃.
  • session_duration (정수) — 앱이 마지막으로 포그라운드로 전환된 후 경과된 시간(초).
  • device_type (정수 기기 유형 코드, 자세한 내용은 registerDevice 참조)
  • application_version (문자열)

동작

  • 포그라운드 세션당 최대 한 번 발생합니다. 백그라운드로 갔다가 다시 포그라운드로 돌아오면 새 세션이 시작됩니다.
  • 소프트 키보드가 열려 있거나, 모달 대화 상자 또는 시스템 프롬프트가 화면에 표시되어 있거나, 앱이 백그라운드에 있는 동안 타이머가 자동으로 일시 중지됩니다.
  • 화면과의 물리적 상호 작용(터치, 스크롤, 타이핑)은 타이머를 재설정합니다.

사용 사례

  • 사용자가 장바구니, 가격 책정, 결제와 같은 높은 의도를 가진 화면에서 조치 없이 머무를 때 인앱 제안이나 상황에 맞는 도우미를 트리거합니다.
  • 사용자가 온보딩 단계에서 멈출 때 힌트나 튜토리얼을 표시합니다.
  • screen_name으로 유휴 이벤트 통계를 필터링하여 사용자가 추진력을 잃는 지점을 식별합니다.

PW_ApplicationExit

Anchor link to

모바일 앱 전용

이 이벤트는 사용자가 앱을 백그라운드로 전환하고 설정 가능한 타임아웃 내에 돌아오지 않을 때 발생합니다. 사용자가 떠날 때 즉시 발생하는 PW_ApplicationMinimized와 달리, PW_ApplicationExit은 설정된 지연 시간이 경과한 후에만 발생하여 사용자가 잠시 앱을 전환한 것이 아니라 실제로 세션을 떠났음을 확인합니다. 이를 사용하여 흐름 중간에 세션을 포기한 사용자를 다시 참여시키거나, 확인된 이탈 후 후속 캠페인을 트리거할 수 있습니다.

이탈 의도 감지는 기본적으로 비활성화되어 있습니다. 활성화하려면 앱의 플랫폼 구성에서 타임아웃(10–30초, 이 범위를 벗어난 값은 자동으로 조정됨)을 설정하세요.

  • Android의 경우:
    • AndroidManifest.xml에 com.pushwoosh.exit_intent_timeout_seconds 메타데이터(정수, 10–30)를 추가합니다.
  • iOS의 경우:
    • 앱의 Info.plist에 Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS 키(숫자, 10–30)를 추가합니다.

이벤트 속성

  • screen_name (문자열) — 사용자가 앱을 백그라운드로 전환했을 때 마지막으로 활성화된 화면.
  • session_duration (정수) — 앱이 마지막으로 포그라운드로 전환된 후 경과된 시간(초).
  • exit_intent_seconds (정수) — 이벤트가 발생하기 전에 경과된 유효 타임아웃(10–30초).
  • device_type (정수 기기 유형 코드, 자세한 내용은 registerDevice 참조)
  • application_version (문자열)

동작

  • 타이머는 앱이 백그라운드로 전환될 때 시작되며, 사용자가 타임아웃이 만료되기 전에 돌아오면 취소됩니다.
  • 화면 이름과 세션 기간은 이벤트가 발생할 때가 아니라 백그라운드로 전환되는 순간에 캡처됩니다.
  • 이탈 의도 감지가 비활성화된 경우(타임아웃 키가 0이거나 설정되지 않은 경우) 이벤트가 발생하지 않습니다.

사용 사례

  • 구매 또는 가입 흐름을 포기한 사용자를 다시 참여시킵니다 — 알림이나 할인이 포함된 푸시 알림 또는 이메일을 트리거합니다.
  • 핵심 작업을 완료하지 않고 이탈한 사용자(예: 장바구니를 떠나거나 온보딩 중간에 중단)를 위해 재획득 Customer Journey를 시작합니다.
  • screen_name으로 이벤트 통계를 필터링하여 이탈률이 높은 화면을 식별합니다.

PW_SiteOpened

Anchor link to

웹 플랫폼 전용

SiteOpened 이벤트는 사용자가 웹사이트 페이지 중 하나를 열 때마다 발생합니다.

이벤트 속성

  • device_type (정수 기기 유형 코드, 자세한 내용은 registerDevice 참조)
  • title – 방문한 페이지의 제목
  • url – 방문한 페이지의 URL

사용 사례

  • 사이트 트래픽 분포를 분석하고 사용자가 특정 사이트 페이지를 여는 횟수를 비교합니다. 이를 위해 이벤트 통계를 속성으로 필터링합니다.
  • 사용자의 웹사이트 방문에 대해 관련성 있는 커뮤니케이션으로 후속 조치를 취합니다: 특정 ‘title’ 또는 ‘url’ 속성에 대해 설정된 SiteOpened 이벤트로 시작하는 여정을 구축합니다.
페이지 방문 통계 및 사용자 행동 패턴을 보여주는 웹사이트 트래픽 분석

PW_InAppPurchase

Anchor link to

모바일 앱 전용

InAppPurchase 이벤트는 사용자가 앱에서 인앱 아이템을 구매할 때마다 발생합니다. 예로는 유료 구독, 게임 메커니즘 요소, 인앱 통화 등이 있습니다.

인앱 구매 이벤트를 구현하려면:

  • iOS의 경우:
    • Control Panel에서 PW_InAppPurchase 이벤트를 활성화합니다.
    • Pushwoosh iOS SDK의 Pushwoosh_PURCHASE_TRACKING_ENABLED 파라미터를 ‘yes’로 설정합니다.
  • Android의 경우:
    • Control Panel에서 PW_InAppPurchase 이벤트를 활성화합니다.
    • 이 가이드를 사용하여 Pushwoosh로 구매 정보 전송을 구성합니다.

이벤트 속성

  • productIdentifier (App Store에서 얻음)
  • quantity – 구매한 아이템 수
  • transactionDate – 구매 날짜
  • status – 구매 상태

사용 사례

  • 인앱 구매 통계를 수집합니다.
  • 프로모션을 실행하고 그 성공을 추적합니다: 프로모션 메시지 다음에 Wait for Trigger 이벤트를 설정합니다.
인앱 구매 이벤트와 함께 트리거 대기 단계를 보여주는 고객 여정 구성

PW_NotificationOpen

Anchor link to

모바일 및 웹 플랫폼용

이 이벤트는 사용자가 Pushwoosh로 보낸 푸시 알림을 열 때마다 발생합니다.

사용 사례

PW_NotificationSend

Anchor link to

모바일 및 웹 플랫폼용

이 이벤트는 Pushwoosh 메시지가 사용자 기기로 전송되면 발생합니다.

이벤트 속성

  • message_id (문자열)
  • message_code (문자열)
  • campaign_id (문자열)

사용 사례

  • 사용된 채널에 관계없이 메시지가 전송되었는지 추적합니다.
  • 전송된 메시지 수를 기반으로 사용자 세그먼트를 생성합니다.
  • 이벤트 기록에서 사용자에게 전송된 모든 메시지를 보고 사용자의 추가 행동을 분석합니다.

PW_EmailLinkClicked

Anchor link to

이메일 플랫폼 전용

이 이벤트는 사용자가 이메일의 링크를 클릭할 때마다 발생합니다.

이벤트 속성

  • message_id (문자열)
  • message_code (문자열)
  • campaign_id (문자열)
  • redirect_link (문자열)
  • original_link (문자열)

사용 사례

  • 이메일의 특정 링크를 클릭한 사용자를 대상으로 타겟 캠페인을 실행합니다.
  • 첫 번째 이메일의 링크를 무시한 사용자에게 다른 메시지를 보내 링크를 클릭하도록(또는 다른 조치를 취하도록) 유도합니다.

PW_EmailOpen

Anchor link to

이 이벤트는 사용자가 Pushwoosh를 통해 보낸 이메일을 열 때 발생합니다.

이벤트 속성

  • campaign_code (문자열): 이메일과 관련된 캠페인의 고유 코드입니다.
  • campaign_id (문자열): 캠페인의 ID입니다.
  • message_code (문자열): 특정 이메일 메시지의 고유 식별자입니다.
  • message_id (문자열): 메시지의 ID입니다.

사용 사례

  • 이메일 열람을 추적하여 이메일에 적극적으로 참여하는 사용자를 식별합니다. 이 데이터를 사용하여 프로모션 이메일을 여는 사용자에게 할인 코드를 보내는 등 후속 캠페인을 만듭니다.
  • 사용자가 이메일을 열었지만 원하는 작업(예: 구매)을 완료하지 않은 경우, 알림이나 개인화된 제안이 포함된 후속 이메일을 트리거할 수 있습니다.
  • 캠페인 전반의 열람률을 분석하여 제품 출시나 계절별 프로모션과 같은 캠페인의 제목과 이메일 타이밍 전략을 개선합니다.

PW_InAppShown

Anchor link to

이 이벤트는 인앱 메시지가 사용자에게 표시될 때 발생합니다.

이벤트 속성

  • message_code (문자열): 인앱과 관련된 특정 메시지의 고유 식별자입니다.
  • message_id (정수): 메시지의 ID입니다.
  • campaign_code (문자열): 인앱과 관련된 캠페인의 고유 코드입니다.
  • campaign_id (정수): 인앱을 트리거한 캠페인의 ID입니다.
  • rich_media_code (문자열): 인앱에 표시된 리치 미디어 콘텐츠의 고유 식별자입니다.
  • inapp_code (문자열): 표시된 특정 인앱 메시지를 식별하는 고유 코드입니다.

사용 사례

  • 인앱 메시지 조회 빈도를 추적하여 메시징 전략을 조정합니다. 예를 들어, 사용자를 성가시게 할 수 있는 중복 메시지를 제거합니다.
  • 인앱 노출 데이터를 사용하여 플래시 세일이나 구독 업그레이드와 같은 프로모션 캠페인의 도달 범위를 평가합니다.
  • 인앱 메시지가 표시되었지만 클릭되지 않은 경우, 유사한 콘텐츠의 푸시 알림을 보내는 등 후속 조치를 트리거하여 메시지를 강화할 수 있습니다.

PW_InAppClicked

Anchor link to

이 이벤트는 사용자가 인앱 메시지를 클릭하여 상호 작용할 때 발생합니다.

이벤트 속성

  • message_code (문자열): 인앱과 관련된 특정 메시지의 고유 식별자입니다.
  • message_id (정수): 메시지의 ID입니다.
  • campaign_code (문자열): 인앱과 관련된 캠페인의 고유 코드입니다.
  • campaign_id (정수): 인앱을 트리거한 캠페인의 ID입니다.
  • rich_media_code (문자열): 인앱에 표시된 리치 미디어 콘텐츠의 고유 식별자입니다(해당하는 경우).
  • inapp_code (문자열): 클릭된 특정 인앱 메시지를 식별하는 고유 코드입니다.
  • element_id (문자열): 인앱 메시지 내에서 클릭된 특정 요소(예: 버튼 또는 링크)의 식별자입니다.
  • link (문자열): 클릭된 요소와 관련된 URL 또는 딥 링크입니다.

사용 사례

  • 클릭 행동을 분석하여 사용자가 가장 자주 상호 작용하는 버튼이나 링크를 식별하고 향후 인앱 메시지 디자인을 최적화합니다. 예를 들어, 구독 업그레이드 캠페인에서 다른 CTA를 테스트합니다.
  • 사용자 클릭을 기반으로 자동화된 작업을 트리거합니다. 예를 들어, 사용자를 특정 제품 페이지로 리디렉션하거나 푸시 알림을 보냅니다.

PW_WhatsAppReceived

Anchor link to

이 이벤트는 시스템을 통해 WhatsApp 메시지가 수신될 때 발생합니다.

이벤트 속성

  • message (문자열): 수신된 메시지의 내용입니다. 위치 메시지의 경우 "위도,경도" 형식의 좌표를 포함합니다(예: "55.751244,37.618423").
  • latitude (숫자): 공유된 위치의 위도입니다. 사용자가 현재 위치를 공유할 때만 포함됩니다.
  • longitude (숫자): 공유된 위치의 경도입니다. 사용자가 현재 위치를 공유할 때만 포함됩니다.

사용 사례

  • 수신되는 WhatsApp 메시지에 대한 후속 조치를 자동화합니다(예: Customer Journey 시작 또는 사용자 참여 이벤트 추적).
  • WhatsApp 메시지 상호 작용을 기반으로 사용자를 세분화하여 타겟 메시징 또는 개인화된 캠페인을 활성화합니다.
  • 사용자가 위치를 공유할 때 latitude 및 longitude 속성을 사용하여 위치 기반 여정을 트리거합니다.