커스텀 이벤트

SDK v1.0.24부터 커스텀 이벤트를 보낼 수 있습니다. 이건 일반 trackEvent()와 비슷한데, WebView와 네이티브 간 통신에 특화되어 있습니다.

사용 시나리오

보통은 trackEvent()만 써도 충분합니다. 하지만 다음과 같은 경우에는 커스텀 이벤트가 유용합니다:

  • 오퍼월 WebView에서 특정 액션을 했을 때 앱에 알리고 싶을 때

  • 앱에서 WebView로 데이터를 전달하고 싶을 때

  • SDK 내부 로직을 커스터마이징하고 싶을 때

기본 사용법

Android:

AdchainSdk.trackCustomEvent(
    eventName = "custom_action",
    data = mapOf(
        "action" to "special_button_click",
        "value" to 100
    )
)

iOS:

React Native:

trackEvent()와의 차이점

구분
trackEvent()
trackCustomEvent()

용도

일반 분석용 이벤트

SDK 내부 통신용

전송 타이밍

배치 전송 (10개 or 30초)

즉시 전송

대시보드

통계에 포함됨

통계에 안 나올 수 있음

사용 빈도

자주 써도 됨

필요할 때만

일반적으로는 trackEvent()를 쓰시면 됩니다.

주의사항

커스텀 이벤트는 즉시 전송되기 때문에:

  • 너무 자주 호출하면 비효율적

  • 네트워크가 안 좋으면 실패할 수 있음

  • 중요한 이벤트만 보내는 게 좋음

다음 단계

Last updated