콘텐츠로 건너뛰기

기본 이벤트

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

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가 초기화될 때 한 번만 발생합니다. 이름에서 알 수 있듯이 이 이벤트는 앱에서의 기기 등록을 추적합니다.

사용 사례

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

PW_DeviceUnregistered

Anchor link to

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

이벤트 속성

  • message_id (string)
  • message_code (string)
  • campaign_id (string)

사용 사례

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

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_SiteOpened

Anchor link to

웹 플랫폼 전용

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

이벤트 속성

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

사용 사례

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

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 이벤트를 설정하세요.
인앱 구매 이벤트가 포함된 Wait for Trigger 단계를 보여주는 Customer Journey 구성

PW_NotificationOpen

Anchor link to

모바일 및 웹 플랫폼용

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

사용 사례

PW_NotificationSend

Anchor link to

모바일 및 웹 플랫폼용

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

이벤트 속성

  • message_id (string)
  • message_code (string)
  • campaign_id (string)

사용 사례

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

PW_EmailLinkClicked

Anchor link to

이메일 플랫폼 전용

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

이벤트 속성

  • message_id (string)
  • message_code (string)
  • campaign_id (string)
  • redirect_link (string)
  • original_link (string)

사용 사례

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

PW_EmailOpen

Anchor link to

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

이벤트 속성

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

사용 사례

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

PW_InAppShown

Anchor link to

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

이벤트 속성

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

사용 사례

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

PW_InAppClicked

Anchor link to

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

이벤트 속성

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

사용 사례

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

PW_WhatsAppReceived

Anchor link to

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

이벤트 속성

  • message (string): 수신된 WhatsApp 메시지의 내용 또는 식별자입니다.

사용 사례

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