아니요, 사용자 식별자 설정은 필수는 아닙니다. 그러나 다음과 같은 경우에는 설정을 고려해보실 수 있습니다. 또한, 보안을 위해 사용자 식별자는 해시화하여 전송하는 것이 좋습니다.

• 내부 이벤트 분석: 에어브릿지 이벤트를 내부 사용자 ID 기준으로 분석하려는 경우

• 서드파티 연동: 일부 서드파티 솔루션은 사용자 ID를 기준으로 이벤트를 수집하므로, 회원 유저와의 연결이 필요하다면 설정할 수 있습니다.

네, 간편 로그인(예: 네이버, 카카오)이나 간편 결제 서비스(예: 네이버페이, 카카오페이)를 사용하는 경우, 이벤트를 안정적으로 전송하기 위해서는 유저가 다른 페이지로 이동한 후 다시 돌아와 페이지가 로드된 시점에 이벤트를 수집하는 것이 좋습니다. 이는 창이 여러 번 이동하는 과정에서 이벤트 전송이 실패할 가능성이 있기 때문입니다.

예를 들어, 유저가 네이버 페이로 결제를 진행할 때, 결제 페이지가 로드되는 사이가 아니라 유저가 결제를 완료하고 다시 앱으로 돌아와 주문서 페이지가 완전히 로드된 후에 이벤트를 전송하는 것이 안전합니다.

웹뷰에서 발생하는 이벤트는 에어브릿지에서 앱(App) 이벤트로 인식되도록 설정해야 합니다. 이를 위해 에어브릿지는 하이브리드 앱 설정을 통해 웹뷰 이벤트를 처리할 수 있는 Bridge Function을 제공합니다.

웹뷰에서 발생하는 이벤트가 앱 이벤트로 올바르게 전송되도록 하려면, 다음과 같은 개발 언어별 설정 방법을 참고해 주세요.

▶ Android, iOS, Flutter, React Native, Unity: 웹페이지에 에어브릿지 Web SDK를 설치한 후, 해당 SDK로 이벤트를 전송하고 웹뷰 영역에 하이브리드 앱 설정을 적용해 주세요.

• Android: 하이브리드 앱 설정

• iOS: 하이브리드 앱 설정

• Flutter: 하이브리드 앱 설정

• React Native: 하이브리드 앱 설정

• Unity: 하이브리드 앱 설정

▶ Cordova, Ionic, PhoneGap SDK: 웹뷰에서 발생하는 이벤트가 앱 이벤트인지 웹 이벤트인지 직접 구분한 후, 앱 이벤트로 판단되면 Cordova SDK를 통해 전송하고, 웹 이벤트로 판단되면 Web SDK를 통해 전송해 주세요.

• Cordova Ionic Phonegap SDK

• Web SDK

참고로, 웹뷰에서 전송한 앱 이벤트는 QA할 때 ‘웹 이벤트 실시간 로그(Web Real-time log)’가 아닌, ‘앱 이벤트 실시간 로그(App Real-time log)’에 기록되어야 합니다.

마케터가 사전에 고려하여 설정한 이벤트 택소노미에 따라 작성된 프로퍼티들을 수집하는 것을 권장합니다.다만 이벤트 별로 반드시 누락되어서는 안 되는 프로퍼티를 아래에 안내드리니, 해당 프로퍼티들을 반드시 포함시켜 주시기 바랍니다. 아래 이벤트들을 수집하지 않을 경우 고려하지 않아도 됩니다.

구매 완료(결제 완료) 이벤트

• 이벤트명: airbridge.ecommerce.order.completed

• 구매액: eventData.value

  • 리포트에서 구매액을 확인하기 위해 사용됩니다.

• 통화 정보 (KRW, USD 등): eventData.goal.semanticAttributes.currency

  • 광고 미디에이션 솔루션을 사용하면 인앱 광고로 벌어들인 수익이 미국 달러(USD)로 수집됩니다. 이를 대시보드의 앱 기준 통화로 변환하기 위해서는 이벤트에 통화 정보가 수집되어야 합니다.

    • Applovin Max, Google Admob, Unity Levelplay Mediation를 사용한다면 미디에이션 플랫폼 연동하기에서 예시 코드를 참고할 수 있습니다.

  • 기준 통화는 영문 대문자 3자리입니다 (예: KRW, USD 등).

  • eventData.goal.semanticAttributes.currency로 전송해 주세요. (eventData.goal.semanticAttributes.products.$0.currency가 아닙니다.)

• 주문번호: eventData.goal.semanticAttributes.transactionID

  • 추후 동일한 주문번호로 들어온 이벤트를 중복 제거할 수 있습니다.

구매 취소 이벤트

• 이벤트명: airbridge.ecommerce.order.canceled

• 주문번호: eventData.goal.semanticAttributes.transactionID

  • 취소가 아닌 구매 완료 시점의 주문번호를 전송해 주세요.

  • ▶ 구매 취소 이벤트 수집하기

광고 노출 이벤트

• 이벤트명: airbridge.adImpression

• 통화 정보 (KRW, USD 등): eventData.goal.semanticAttributes.currency

  • 광고 미디에이션 솔루션을 사용하면 인앱 광고로 벌어들인 수익이 미국 달러(USD)로 수집됩니다. 이를 대시보드의 앱 기준 통화로 변환하기 위해서는 이벤트에 통화 정보가 수집되어야 합니다.

    • Applovin Max, Google Admob, Unity Levelplay Mediation를 사용한다면 미디에이션 플랫폼 연동하기에서 예시 코드를 참고할 수 있습니다.

  • 기준 통화는 영문 대문자 3자리입니다 (예: KRW, USD 등).

  • eventData.goal.semanticAttributes.currency로 전송해 주세요. (eventData.goal.semanticAttributes.products.$0.currency가 아닙니다.)

에어브릿지 유저 가이드의 앱마켓 심사 준비하기에서 확인하실 수 있습니다.