커스텀 이벤트

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:

AdchainSdk.shared.trackCustomEvent(
    "custom_action",
    data: [
        "action": "special_button_click",
        "value": 100
    ]
)

React Native:

await AdchainSdk.trackCustomEvent('custom_action', {
  action: 'special_button_click',
  value: 100,
});

trackEvent()와의 차이점

구분	trackEvent()	trackCustomEvent()
용도	일반 분석용 이벤트	SDK 내부 통신용
전송 타이밍	배치 전송 (10개 or 30초)	즉시 전송
대시보드	통계에 포함됨	통계에 안 나올 수 있음
사용 빈도	자주 써도 됨	필요할 때만

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

주의사항

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

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

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

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

다음 단계

• 기본 이벤트 추적

• 문제 해결