이벤트 분석

페이 스테이션을 이미 통합했고 다음 계정 중 하나 이상 설정한 경우 이 기능을 사용할 수 있습니다.

주의

사용자가 모든 쿠키 사용을 허용하거나 GDPR 배너에서 분석 및 성능 쿠키 사용에 동의한 경우 Google 애널리틱스 및 Facebook에서 개인 정보를 수집합니다.

애널리틱스 플랫폼과의 통합

사용자가 결제 UI와 상호 작용할 때 발생하는 이벤트를 추적하려면 관리자 페이지에서 다음과 같은 분석 플랫폼을 연결합니다.

구글 Analytics

애널리틱스 플랫폼을 연결하는 방법:

  1. 관리자 페이지에서 프로젝트를 엽니다.
  2. 페이 스테이션 > 설정으로 이동합니다.
  3. 섹션에서 Google 애널리틱스를 선택합니다.
  4. 연결을 클릭합니다.

Google 애널리틱스를 연결하면 해당 이벤트가 본인의 Google 애널리틱스 계정으로 전송됩니다. 이러한 이벤트는 Behaviour > Events > Top EventsGoogle 애널리틱스에서 확인할 수 있습니다.

다음 이벤트를 추적할 수 있습니다.

동작설명
open-{state_name}결제 UI에서 페이지 열기.
click-btn-pay청구 데이터 입력 양식에서 지금 지불 버튼 클릭.
return저장/시작으로 다시 돌아가기 버튼을 클릭합니다.
create-invoice거래 생성입니다.
purchase인보이스 생성(거래 ID 할당). 이벤트 매개 변수에는 품목 가격 및 세금 등 구매에 대한 자세한 정보가 포함됩니다. 매개 변수에 대한 설명은 Google Analytics 문서를 참조하십시오.

스토어 섹션의 관리자 페이지에서 카탈로그를 구성한 경우에만 이벤트가 전송됩니다.
open-payment-credit-card카드 세부 정보를 입력하기 위해 결제 UI를 엽니다.
open-payment-saved-methods저장된 결제 방식이 있는 페이지가 열립니다.
open-payment-payment-methods더 보기를 클릭하면 사용할 수 있는 모든 결제 방식 목록이 열립니다.
open-payment-{id}id가 결제 방식 ID인 특정 결제 방식의 페이지를 엽니다.
open-status결제 상태 페이지가 열립니다.
open-status-processing처리중 결제 상태(processing)가 있는 페이지가 열립니다. 처리가 완료되면 상태를 성공(success) 또는 오류(error)로 변경할 수 있습니다.
open-status-error오류 결제 상태(error)가 있는 페이지가 열립니다.
open-status-success성공 결제 상태(success)가 있는 페이지가 열립니다.
choose-method더 보기 목록을 열 때의 결제 방식을 선택합니다.
맞춤 측정기준, Google Analytics 사용
규격 ID이름설명
1version페이 스테이션 버전.
2purchase_invoice_id엑솔라 시스템의 결제 인보이스 ID.
3external_id파트너 시스템의 결제 인보이스 ID.
5total_sum총 구매 금액. 모든 비용이 포함되어 있습니다.
6total_sum_currency총 구매 금액 통화.
7pid결제 시스템 ID.
8projectId프로젝트 ID.
9country결제 국가.
10projectName프로젝트명.

Facebook Analytics

애널리틱스 플랫폼을 연결하는 방법:

  1. 관리자 페이지에서 프로젝트를 엽니다.
  2. 페이 스테이션 > 설정으로 이동합니다.
  3. 섹션에서 Facebook Pixel을 선택합니다.
  4. 연결을 클릭합니다.

Facebook Pixel을 연결하면 해당 이벤트가 Facebook Analytics 계정으로 전송됩니다. 이러한 이벤트는 Business Settings > Measure & Report > Analytics > Pixels > OverviewFacebook Analytics에서 확인할 수 있습니다.

다음 이벤트를 추적할 수 있습니다.

이벤트설명
open-{state_name}결제 UI에서 페이지 열기. 상태 이름은 parameters에서 전달됩니다.
click-btn-pay청구 데이터 입력 양식에서 지금 결제 버튼을 클릭. 결제 방식 이름은 parameters에서 전달됩니다.
return저장/시작으로 돌아가기 버튼을 클릭. 상태 이름은 parameters에서 전달됩니다.
change-status-{status_name}결제 상태 변경.
사용자가 결제 UI를 닫거나 페이지를 떠나면 상태가 변경되며 이벤트 메시지가 전송되지 않습니다.
create-invoice거래 생성입니다.
open-payment-credit-card카드 세부 정보를 입력하기 위해 결제 UI를 엽니다.
open-payment-saved-methods저장된 결제 방식이 있는 페이지가 열립니다.
open-payment-payment-methods더 보기를 클릭하면 사용할 수 있는 모든 결제 방식 목록이 열립니다.
open-payment-{id}id가 결제 방식 ID인 특정 결제 방식의 페이지를 엽니다.
open-status결제 상태 페이지가 열립니다.
open-status-processing처리중 결제 상태(processing)가 있는 페이지가 열립니다. 처리가 완료되면 상태를 성공(success) 또는 오류(error)로 변경할 수 있습니다.
open-status-error오류 결제 상태(error)가 있는 페이지가 열립니다.
open-status-success성공 결제 상태(success)가 있는 페이지가 열립니다.
choose-method더 보기 목록을 열 때의 결제 방식을 선택합니다.

애널리틱스 플랫폼 통합 방법:

  1. 다음으로 이동 관리자 페이지 > 페이 스테이션 > 설정.
  2. Google Analytics/Facebook Pixel을 섹션에서 선택.
  3. 추적 ID를 입력하고 연결을 클릭합니다.

여러분이 Google AnalyticsFacebook Pixel을 통합할 때, 이에 상응하는 이벤트가 Google Analytics 및 Facebook Analytics 계정으로 전송됩니다.

GameAnalytics

분석 플랫폼 연결 방법:
  1. 관리자 페이지에서 프로젝트를 엽니다.
  2. 페이 스테이션 > 설정으로 이동합니다.
  3. 섹션에서 GameAnalytics를 선택합니다.
  4. 연결을 클릭합니다.

  1. GameAnalytics 게임 키 필드에 게임 키를 입력합니다. GameAnalytics 계정에서 이러한 정보를 찾는 방법:
    1. 상단 패널의 드롭다운 메뉴에서 게임을 선택합니다.
    2. Keys 섹션에서 Game key 옆에 있는 복사 아이콘을 클릭합니다.

알림
게임이 여러 플랫폼에 출시되고 GameAnalytics의 각 플랫폼에 대한 전용 프로젝트가 있는 경우, 관리자 페이지에서 이러한 플랫폼에 대한 게임 키를 입력할 수 있습니다.

  1. 연결을 클릭합니다.

현재 GameAnalytics 플랫폼과의 통합을 통해 결제 성공 이벤트에 대한 정보를 수신할 수 있습니다. Monetization 섹션 대시보드의 GameAnalytics 계정에서 이 데이터를 찾을 수 있습니다.

결제 UI 이벤트

결제 인터페이스 이벤트는 iframe, 새 창 혹은 페이 스테이션 임베드에서 페이 스테이션을 열 때 postMessage 메커니즘을 통해 처리됩니다.

postMessage를 통해 전송된 메시지를 처리하는 시나리오의 예제:

  1. postMessage를 통해 전송된 메시지를 수신하려면 정기 결제하세요.
  2. 이벤트 데이터를 JSON 형식으로 파싱합니다.
  3. 처리해야 하는 이벤트가 있는지 확인하는 기능을 구현합니다.
  4. 요청한 이벤트를 수신하면 이를 처리하는 로직을 구현합니다. 아래 예제에서는 콘솔에 텍스트가 출력됩니다. 자신만의 로직을 추가할 수 있습니다.

예제:
Copy
Full screen
Small screen
    window.addEventListener('message', (event) => {
      const eventData = JSON.parse(event.data);
    
      if (eventData.command === 'open-payment') {
        console.log('hello!')
      }
    });
    
    이벤트설명
    add_saved_account결제 계정 저장에 성공했습니다.
    add_saved_account_error결제 계정 저장 중 오류가 발생했습니다.
    cancel_save_account결제 계정 저장을 사용자가 취소했습니다.
    cart_display결제 UI를 열로 표시합니다. value 매개변수는 다음과 같을 수 있습니다.
    • 1, 결제 UI가 두 개의 열로 열리는 경우
    • 0, 결제 UI가 한 개의 열로 열리는 경우(예: 저장된 결제 방식을 관리하는 페이지)
    예시: {“command”:“cart_display”,“data”:{“value”:“1”,“version”:“Pay Station 4”}}.
    change-status결제 상태 변경. 사용자가 결제 UI를 닫거나 페이지를 떠나면 상태가 변경되며 이벤트 메시지는 전송되지 않습니다.
    choose-method더 보기 목록을 열 때의 결제 방식을 선택합니다.
    click-custom-package-continue임의이 게임머니 금액을 구매할 때 계속 버튼을 클릭.
    click-comment버튼을 클릭하여 의견 게시.
    click-buy-package게임머니 패키지를 구매할 때 패키지 구매 버튼을 클릭.
    click-buy-gift-package선물하기 위해 게임머니 패키지를 구매할 때 버튼을 클릭.
    click-buy-gift-custom-package선물하기 위해 임의의 게임머니 금액을 구매할 때 버튼을 클릭.
    click-btn-pay청구 데이터 입력 양식에서 지금 지불 버튼 클릭.
    click-btn-continue버튼을 클릭하여 정기결제 구매.
    click-btn-apply쿠폰을 사용할 때 적용 버튼을 클릭.
    click-btn-activate게임 키를 활성화할 때 활성화 버튼을 클릭.
    click-btn-accept버튼을 클릭하여 디지털 콘텐츠 구매.
    create-invoice거래 생성입니다.
    dimensionsiframe에서 페이 스테이션이 열릴 때 iframe 너비와 높이는 widthheight 매개 변수에서 전달됩니다.
    error결제 프로세스 중에 발생한 오류입니다. 오류 코드는 data.code 매개 변수에서 전달되며, 결제 UI의 오류 설명은 data.message 매개 변수에서 전달됩니다.
    external-link-open외부 리소스로 리디렉션. 리디렉션이 일어나는 주소는 url 매개 변수에서 전달됩니다.
    external-payment-open결제 UI에서 외부 결제 시스템 또는 3-D Secure 인증으로 리디렉션합니다.
    focus-change페이 스테이션 위젯 요소의 포커스 변경. 포커스 상태가 hasFocus 매개 변수에서 전달되며 true 또는 false일 수 있습니다.
    open-{state_name}결제 UI에서 페이지 열기.
    open-payment-credit-card카드 세부 정보를 입력하기 위해 결제 UI를 엽니다.
    open-payment-saved-methods저장된 결제 방식이 있는 페이지가 열립니다.
    open-payment-payment-methods더 보기를 클릭하면 사용할 수 있는 모든 결제 방식 목록이 열립니다.
    open-payment-{id}id가 결제 방식 ID인 특정 결제 방식의 페이지를 엽니다.
    open-status결제 상태 페이지가 열립니다.
    open-status-processing처리중 결제 상태(processing)가 있는 페이지가 열립니다. 처리가 완료되면 상태를 성공(success) 또는 오류(error)로 변경할 수 있습니다.
    open-status-error오류 결제 상태(error)가 있는 페이지가 열립니다.
    open-status-success성공 결제 상태(success)가 있는 페이지가 열립니다.
    order-status주문 상태를 done으로 변경합니다. 다음 API 호출 중 하나를 통해 주문이 생성된 경우 결제 상태 페이지로부터 이벤트가 전송됩니다.
    사용자, 거래 및 주문에 대한 데이터는 data 개체에서 전달됩니다.

    예시: {“command”:“order-status”,“data”:{“user_id”:“123abc-456”,“invoice_id”:123456,“price”:{“amount”:“12.96”,“currency”:“USD”},“order_id”:123456,“items”:[{“id”:123456,“sku”:“booster_min”,“quantity”:2,“amount”:“3.99”,“price”:{“amount”:“3.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:123456,“sku”:“boots_1”,“quantity”:1,“amount”:“2.99”,“price”:{“amount”:“2.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:1234567,“sku”:“xsolla_gloves”,“quantity”:1,“amount”:“1.99”,“price”:{“amount”:“1.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:12345678,“sku”:“reward_vp_a”,“quantity”:5,“amount”:“0”,“price”:{“amount”:“0”,“currency”:“USD”},“tax_category”:“DG00001”}],“version”:“Pay Station 4”}}.
    resize결제 UI 크기를 변경합니다. 열려 있는 결제 UI의 너비와 높이가 data 개체에서 전달됩니다.
    예시: {“command”:“resize”,“data”:{“dimensions”:{“width”:924,“height”:754},“version”:“Pay Station 4”}}.
    show-error-page오류가 있는 페이지를 엽니다. 오류 코드가 value 매개변수에서 전달됩니다.
    status결제 상태 페이지로 이동. 전달될 수 있는 매개 변수:
    • status — 결제 상태
    • email — 사용자 이메일
    • invoice — 트랜잭션 ID
    • virtualCurrencyAmount — 구매된 인게임 재화 금액
    • userId — 사용자 ID
    • discount — 결제에 적용된 할인
    status-redeem결제 양식에서 쿠폰 사용.
    close결제 UI 닫기.
    이벤트 매개 변수는 postMessage의 각 메시지에서 전달됩니다. 매개 변수 정보가 아직 수집되지 않은 경우에는 빈 문자열이 표시됩니다.
    매개변수유형설명
    actionstring이벤트 이름.
    valuestring추가 매개변수. 사용자의 선택에 따라 달라지는 특정 이벤트 매개변수 포함.
    statestring작업이 수행된 결제 UI 페이지.
    datestringGMT 형식의 날짜와 시간.
    millisecondsnumberUnix 시간 형식의 날짜와 시간.
    timezonestring사용자 시간대.
    session_idstring세션 ID. 세션에는 30분 이내 또는 결제 UI가 닫히기 전까지의 모든 사용자 작업이 포함됩니다. 세션은 결제 UI가 실행되는 순간부터 시작되며, 결제 UI가 있는 페이지를 새로고침하면 세션이 저장됩니다.
    payment_countrystring결제 국가.
    purchase_invoice_idnumber엑솔라 시스템의 결제 인보이스 ID.
    purchase_external_idstring파트너 시스템의 결제 인보이스 ID.
    purchase_typestring구매 유형. 가능한 유형: virtual item, virtual currency, pay2play, subscription.
    purchase_sumnumber명목상 구매 금액.
    purchase_currencystring게임머니 구매.
    purchase_skustring구매한 아이템의 SKU.
    purchase_digital_content_skustring구입한 게임 키 패키지의 SKU.
    purchase_descriptionstring구매 설명.
    virtual_currency_amountnumber게임머니 금액.
    coupon_codestring쿠폰 코드.
    subscription_package_external_idnumber정기결제 ID입니다.
    subscription_package_namestring정기결제 이름.
    subscription_package_descriptionstring정기결제 설명.
    total_sumnumber총 구매 금액. 모든 비용이 포함되어 있습니다.
    total_sum_currencystring총 구매 금액 통화.
    user_idstring사용자 ID (v1).
    user_countrystring사용자 국가.
    payment_instance_namestring결제 방식 이름.
    이벤트는 아이템을 구매할 때 사용자가 모든 작업을 수행하는 페이지로 연결됩니다.
    시/도설명
    cart선택한 아이템을 게임머니로 구매한 페이지 및 구매 확인.
    coupon쿠폰 입력 양식.
    giftcard기프트 카드 목록이 있는 페이지(기프트 카드 위젯).
    giftrecipient기프트 구매 페이지.
    history구매 내역 페이지.
    index응용 프로그램을 실행한 후 사용자가 리디렉션되는 서비스 페이지. 사용자에게는 표시되지 않습니다.
    legal법률 문서 링크가 포함된 페이지의 모바일 버전.
    list결제 방식 목록.
    paybycash캐시 키오스크(현금으로 결제 위젯)를 통해 구매할 수 있는 결제 방식 목록이 있는 페이지.
    payment결제 양식.
    paymentaccount저장된 결제 계정이 있는 페이지.
    paymentreturn결제 후 사용자가 리디렉션되고, 사용자가 상태 페이지로 전송되기 이전에 머무는 서비스 페이지. 사용자에게는 표시되지 않습니다.
    pincart디지털 콘텐츠 플랫폼 목록 페이지.
    pricepoint게임머니 스토어.
    savedmethod저장한 결제 방식 목록.
    shippingaddress배송 주소 양식.
    status상태 페이지.
    subscription정기결제 요금제 스토어.
    subscriptionchange정기결제 요금제 변경.
    useraccount향후 아이템 구매 시 확인 화면 비활성화 설정이 있는 계정 정보 페이지(사용자 이름, 잔액).
    userinventory사용자 인벤토리.
    usermenu사용자 메뉴 페이지 모바일 버전.
    usersubscription사용자 정기결제 관리.
    usersubscriptioninfo정기결제 세부 정보 페이지.
    virtualitem게임 아이템 스토어.

    이벤트를 Google AnalyticsFacebook Analytics 계정으로 전송하려면, 이러한 애널리틱스 플랫폼을 통합해야 합니다.
    이 기사가 도움이 되었나요?
    감사합니다!
    개선해야 할 점이 있을까요? 메시지
    유감입니다
    이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
    의견을 보내 주셔서 감사드립니다!
    메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
    마지막 업데이트: 2024년 10월 3일

    오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

    문제 보고
    콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
    후속 조치를 위해 이메일을 제공해 주세요
    의견을 보내 주셔서 감사드립니다!