이 문서는 Ruby SDK를 사용하기 위한 정보를 제공하고 설명합니다.

📘

Before You Read

  • SDK 연동이 처음이라면, SDK 문서를 참고해주세요.

  • 문서에서 언급되는 몇 가지 키가 있습니다. 각 키 개념 및 키를 확인하는 방법에 대해서는 SDK에서 사용되는 키 문서를 읽어주시기 바랍니다.

개요

Ruby SDK 기능

SDK는 두 가지 주요 기능이 있습니다.

  • 테스트 그룹 분배
    A/B 테스트에서 사용하는 기능으로, 사용자를 A, B, C 등 특정 테스트 그룹으로 분배하여 할당하고 분배된 그룹을 반환합니다. 사용자가 A/B 테스트에 노출되었음을 기록하기 위해 할당된 그룹 정보를 핵클로 전송합니다.

  • 사용자 이벤트 전송
    A/B 테스트 목표 계산데이터 분석에서 사용하는 기능으로, 사용자의 행동을 분석하기 위해 이벤트를 전송합니다.

사용자 식별자 관리

사용자 식별자는 A/B 테스트에서 사용자를 고유하게 식별하는 데 사용됩니다. 테스트 그룹 분배, 사용자 이벤트 전송 기능을 사용할 때 사용자 식별자를 같이 전달해야 됩니다.

사용자 식별자에 대한 자세한 정보는 사용자 식별자 관리하기에서 확인할 수 있습니다.


작업 순서

1141

SDK 연동

SDK 기능을 적용하기 위해 SDK 연동 작업이 필요합니다.
1단계 및 2단계가 이에 해당되며, 최초 연동 시 반드시 거쳐야 합니다.

A/B test or Data Analytics?

핵클 플랫폼 연동의 목적이 A/B 테스트인지 혹은 데이터 분석인지에 따라 적용해야 할 SDK 기능에 차이가 있습니다.

  • A/B 테스트: 3단계 → 4단계 순으로 적용합니다.
    (1) A/B 테스트를 진행할 곳에 테스트 그룹 분배 기능을 적용합니다.
    (2) A/B 테스트의 목표를 추적할 곳에 사용자 이벤트 전송 기능을 적용합니다.
  • 데이터 분석: 4단계를 적용합니다.
    분석할 이벤트가 발생하는 곳에 사용자 이벤트 전송 기능을 적용합니다.