이벤트 트래킹

이벤트와 이벤트 토큰 연결을 통해 Adjust SDK가 이벤트 정보를 트래킹하도록 할 수 있습니다. 이를 위해 Adjust 대시보드에서 트래킹하고자 하는 개별 이벤트에 대해 이벤트 토큰을 생성해야 합니다.

예를 들어 앱에서 버튼을 누르는 행동을 모두 트래킹하고 싶다면 우선 이벤트 토큰을 설정해야 합니다. 이후 사용자가 버튼을 누를 때 마다 이벤트 토큰과 함께 trackEvent 메서드를 호출할 수 있습니다.

AdjustEvent adjustEvent = new AdjustEvent("abc123");
Adjust.trackEvent(adjustEvent);

로깅이 활성화된 경우 SDK가 이벤트를 로그했음을 알리는 메시지를 확인할 수 있습니다.

매출 트래킹

이벤트 트래킹을 사용하여 앱에서 매출을 창출하는 행동을 트래킹할 수 있습니다. 이는 광고 인게이지먼트와 인앱 구매를 포함합니다. 예를 들어, 광고를 누르는 행위에 €0.01의 매출이 발생하는 상황에서는 다음을 통해 해당 매출 이벤트를 트래킹할 수 있습니다.

AdjustEvent adjustEvent = new AdjustEvent("abc123");
adjustEvent.setRevenue(0.01, "EUR");
Adjust.trackEvent(adjustEvent);

통화 토큰은 ISO 4217 standard에 따라 3개 문자로 이루어진 문자열이어야 합니다. Adjust 백엔드는 이후 원하는 보고 통화에 따라 매출을 전환합니다. 자세한 정보는 Adjust의 여러 통화로 구매 트래킹 가이드를 참조하시기 바랍니다.

결제 검증

구매 검증 을 활성화한 경우, 이를 검증하기 위해 구매 이벤트와 함께 추가 정보를 전송해야 합니다. Adjust의 서버가 이벤트 객체에서 해당 정보를 수신하면, 구매를 검증하기 위해 이를 Apple에 전달합니다.

productId (String) : 성공적으로 구매된 아이템의 제품 식별자

purchaseToken (String) : 성공적으로 완료된 인앱 구매에 대해 생성된 구매 토큰

val adjustEvent = AdjustEvent("abc123")
adjustEvent.setRevenue(6.0, "EUR");
adjustEvent.setProductId("product-id");
adjustEvent.setPurchaseToken("purchase-token");
Adjust.trackEvent(adjustEvent);

콜백 파라미터

Adjust 대시보드에서 이벤트에 대한 콜백 URL을 등록할 수 있습니다. Adjust 백엔드는 SDK가 이벤트를 트래킹할 때마다 해당 URL로 GET 요청을 전송합니다. 이벤트를 트래킹하기 전에 이벤트에서 addCallbackParameter 메서드 를 호출하여 해당 이벤트에 콜백 파라미터를 추가 할 수 있습니다. Adjust 백엔드는 이후 해당 파라미터를 콜백 URL에 추가합니다.

SDK는 서버로 콜백 파라미터를 전송합니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 콜백 URL에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 유저의 인앱 행동을 분석할 수 있습니다.

예를 들어, URL http://www.mydomain.com/callback 을 등록한 경우 다음과 같이 이벤트를 트래킹할 수 있습니다.

AdjustEvent adjustEvent = new AdjustEvent("abc123");
adjustEvent.addCallbackParameter("key", "value");
adjustEvent.addCallbackParameter("foo", "bar");
Adjust.trackEvent(adjustEvent);

Adjust SDK는 이벤트를 트래킹하고, 콜백 파라미터와 함께 URL에 요청을 전송합니다.

http://www.mydomain.com/callback?key=value&foo=bar

CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다.

Adjust는 SDK에서 URL로 정보를 전송하는데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, {gps_adid} 플레이스홀더를 사용하여 기기의 광고 ID를 전달할 수 있습니다. {publisher_parameter} 플레이스홀더는 단일 문자열에서 모든 콜백 파라미터를 보여줍니다.

Adjust 콜백 가이드에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다.

파트너 파라미터

파트너 파라미터를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다.

Adjust는 설정한 외부 파트너에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 원하는 파트너에 대해 파라미터를 설정하고 활성화하면 백엔드는 해당 파라미터를 전달합니다.

예를 들어 구매 이벤트와 함께 product_id 정보를 전송하거나, 로그인 이벤트와 함께 user_id를 전달할 수 있습니다. 콜백 파라미터와 달리 파트너 파라미터는 기본값으로 로데이터에 나타나지 않습니다. 이를 단일 문자열로 수신하려면 {partner_parameters}를 추가할 수 있습니다.

파트너 파라미터는 콜백 파라미터와 비슷한 방식으로 작동합니다. 이벤트에서 addPartnerParameter 메서드 를 호출하여 추가할 수 있습니다.

AdjustEvent adjustEvent = new AdjustEvent("abc123");
adjustEvent.addPartnerParameter("key", "value");
adjustEvent.addPartnerParameter("foo", "bar");
Adjust.trackEvent(adjustEvent);

콜백 ID

트래킹하고자 하는 각 이벤트에 맞춤 문자열 ID를 추가할 수도 있습니다. Adjust 백엔드는 이 ID를 이벤트 콜백으로 보고합니다. 이를 통해 성공적으로 트래킹된 이벤트가 무엇인지 확인할 수 있습니다. 이벤트의 setCallbackId 메서드 를 호출하여 이 ID를 설정할 수 있습니다.

AdjustEvent adjustEvent = new AdjustEvent("abc123");
adjustEvent.setCallbackId("Your-Custom-Id");
Adjust.trackEvent(adjustEvent);