SDK를 설치하세요

사용자 식별

이벤트 추적하기

속성 추적

사용자 그룹화

피드백 주세요

자바스크립트 SDK

SDK를 설치하세요

아래는 Specific 태그입니다. Specific이 사용자를 추적할 수 있도록 하고자 하는 웹사이트나 웹 앱의 모든 페이지 코드에 복사하여 붙여넣으세요. <head> 요소 바로 뒤에 붙여넣으세요. 각 페이지에 하나 이상의 Specific 태그를 추가하지 마세요.

마지막 줄에서 귀하의 WORKSPACE_ID를 반드시 교체하십시오. 통합 섹션에서 찾을 수 있습니다.

<script type="text/javascript">
  (function(l, e, a, p) {
    if (window.Specific) return;
    window.Specific = function() {
      S._queue.push(arguments);
    };
    var S = window.Specific;
    S.appId = a;
    S._queue = [];
    a = l.createElement('script');
    a.async = 1;
    a.src = e + '?id=' + S.appId;
    p = l.getElementsByTagName('script')[0];
    p.parentNode.insertBefore(a, p);
  })(document, 'https://cdn.specific.app/bundle.js', 'WORKSPACE_ID');
</script>

사용자 식별

누가 무슨 말을 했는지 알고 싶다면 이것이 중요합니다. 그렇지 않으면 모든 응답은 익명으로 유지됩니다.

사용자가 Specific SDK가 있는 페이지를 방문하면 타겟 설문조사를 가능하게 하는 고유한 방문자 ID를 받습니다. 하지만 방문자 ID가 귀하의 시스템에 있는 고유한 사용자 ID와 일치할 때까지 사용자는 인증되지 않습니다.

이미 시스템에서 ID를 사용하고 계신다면, 일관된 타겟팅을 위해 플랫폼 간에 ID를 동기화하고 설문이 반복되지 않도록 권장합니다.

ID 요구 사항:

고유함: 두 사용자가 동일한 ID를 공유하지 않습니다.
연결 가능함: ID는 내부 시스템과 연결됩니다.
정적임: ID는 시간이 지나도 동일하게 유지됩니다.

사용자 ID 설정

사용자 ID를 지정하려면 setUserId를 사용하여 로그인 시 사용자의 식별자(최대 256자)를 할당하세요. 이 함수는 여러 번 호출해도 안전하며, 세션 간 일관된 사용자 식별을 보장합니다.

Specific('setUserId', 'USER_ID');

로그아웃

사용자가 사이트나 제품에서 로그아웃할 때, 우리 시스템에서도 반드시 로그아웃 처리하세요. 이는 새로운 행동이 잘못된 사용자에게 귀속되는 것을 방지합니다. 인증되지 않은 사용자를 위해 이 기능을 사용할 경우, 새로운 ID가 생성되고 사용자 제한에 별도로 계산된다는 점을 유념하세요.

Specific('사용자 로그아웃');

이벤트를 추적하여 설문 조사를 시작하세요

이벤트는 사용자가 제품 내에서 수행하는 행동에 따라 설문조사를 트리거하거나 특정 사용자를 대상으로 하기 위해 사용됩니다. 이벤트를 추적함으로써 설문조사가 적절한 순간에 올바른 청중에게 표시되도록 할 수 있습니다.

이벤트 유형

우리 플랫폼은 설문 조사를 트리거하고 필터링하기 위한 두 가지 유형의 이벤트를 지원합니다:

코드 필요 없음 이벤트: 이러한 이벤트는 팀원이 코드베이스에 접근하지 않고도 설정할 수 있어 빠른 업데이트나 실험에 이상적입니다. 코드 필요 없음 이벤트는 우리 사용하기 쉬운 인터페이스를 통해 나중에 구성할 수 있습니다.
코드 이벤트: 이러한 이벤트는 개발자가 코드베이스에 직접 추적을 구현해야 합니다. 높은 커스터마이즈 가능성을 제공하며, 더 상세한 타겟팅이나 행동 분석을 위해 추가 속성을 포함할 수 있습니다.

코드 없는 이벤트 설정하기

노코드 이벤트는 애플리케이션의 코드를 수정하지 않고도 이벤트 인터페이스를 통해 직접 구성할 수 있습니다. 덕분에 비기술 팀원들이 설문 조사를 트리거하는 이벤트를 빠르게 정의하고 관리할 수 있습니다.

코드 이벤트 구현하기

코드 이벤트를 추적하려면, 귀하의 애플리케이션에서 다음 코드를 사용할 수 있습니다. 이는 백그라운드에서 이벤트를 추적합니다:

스페시픽('event', '이벤트 이름');

이벤트가 즉시 설문조사를 시작하도록 트리거하려면(예: 사용자가 버튼을 클릭한 후 모달을 여는 경우), 이 향상된 스니펫을 사용하세요. 서버 응답을 기다리지 않고 즉각적인 피드백을 제공합니다:

Specific('event', '이벤트 이름', { loadingPlacement: 'center', autoFocus: true });

속성을 파악하여 사용자 타겟팅

속성은 두 가지 주요 목표를 달성할 수 있게 해줍니다: 사용자에 대한 더 많은 컨텍스트를 얻고 설문 조사를 보다 효과적으로 타겟팅하세요.

사용자에 대한 데이터를 추가하면 각 응답을 제공한 사람을 확인할 수 있어 대화가 익명 대신 식별 가능해집니다.

타겟팅에 관해서는 속성을 통해 초점을 좁힐 수 있습니다. 예를 들어, 특정 사용자 세그먼트, 예를 들어 파워 유저나 특정 국가의 사용자에게만 설문 조사를 표시할 수 있습니다. 또한 속성을 사용하면 설문 조사 응답을 필터링하고 분석하기가 더 쉬워집니다.

이름, 이메일

사용자 이름과 이메일 주소를 지정하려면 setName 및 setEmail을 사용하세요.

Specific('setName', '존 도');
Specific('setEmail', 'john@example.com');

맞춤 속성

사용자 정의 속성을 추가하려면 setAttributes 또는 setAttribute를 사용하세요. 예를 들어, 사용자의 국가나 파워 유저 여부와 같은 속성을 추가할 수 있습니다.

// 여러 속성 설정
Specific('setAttributes', {
  power_user: true,
  country: "US"
});

// 단일 속성 설정
Specific('setAttribute', 'country', 'US');

언어

제품의 UI가 여러 언어를 지원하면 사용자의 모국어로 설문조사를 진행할 수 있습니다. setLanguage를 ISO 639-1 언어 코드와 함께 사용하여 (언어 코드 목록 참조) 사용자가 선호하는 언어로 설정하세요.

Specific('setLanguage', 'ko');

백엔드에서 속성 설정하기

백엔드에서 속성을 설정해야 하는 다양한 사용 사례가 있습니다. 이것도 가능합니다! 문자열, 숫자, 그리고 불리언에 대한 예시를 소개합니다.

Preferences의 API 섹션에서 개인 API 키를 생성하고, 통합 UI에서 작업 공간 ID를 가져올 수 있습니다. # 주석을 제거하는 것을 잊지 마세요.

curl -X POST 'https://wapi.specific.app/api/v1/user' \
-H 'authorization: PERSONAL_API_KEY' \
-H 'x-app: WORKSPACE_ID' \
-H 'Content-Type: application/json' \
-d '{
  "id": "123456789",            # 필수: 사용자 고유 ID
  "name": "John Doe",           # 선택: 사용자 이름
  "email": "john@example.com",  # 선택: 사용자 이메일
  "group": {                    # 선택: 그룹 정보
    "id": "4242424242424242",   # 선택: 그룹 ID
    "name": "Acme Inc."         # 선택: 그룹 이름
  },
  "attrs": [                    # 선택: 사용자 속성
    {
      "key": "company_size",    # 선택 속성 키
      "value": 1000             # 예제 값
    },
    {
      "key": "active",          # 선택 속성 키
      "value": true             # 예제 값
    },
    {
      "key": "subscription_plan", # 선택 속성 키
      "value": "Free"             # 예제 값
    }
  ]
}'

사용자 그룹화 (회사, 작업 공간 등으로)

사용자들을 의미 있는 그룹으로 구성하려면 setGroup 함수를 사용하세요. 예를 들어 회사나 작업 공간(Figma의 작업 공간 등)과 같은 그룹으로 조직할 수 있습니다. 이 함수는 사용자가 로그인할 때 특정 그룹—회사나 작업 공간 ID 등—에 할당되어 세션 전체에 걸쳐 일관된 그룹 추적을 보장합니다. 각 그룹 ID는 최대 256자까지 가능합니다.

주요 추천 사항:

배치: 이 코드 스니펫은 애플리케이션의 어디에나 포함할 수 있지만, 일반적으로 사용자 가입 또는 로그인 시 setUserId 함수 근처에 추가됩니다.
고유성: GROUP_ID가 고유 식별자인지 확인하세요. 이상적으로는 데이터베이스의 워크스페이스 또는 회사 ID가 되어야 합니다.
속성: 회사 이름과 추가 속성 (예: subscription_plan, company_size)을 포함하여 필터링과 보고 기능을 향상시켜 보세요.
제한사항: 사용자는 한 번에 하나의 그룹에만 속할 수 있습니다.

사용자 그룹화는 대화를 분석하고, 보고서를 필터링하며, 설문 조사를 보다 효과적으로 타겟팅할 수 있도록 도와줍니다.

Specific('setGroup', 'GROUP_ID', {
    name: 'Acme Inc.',
    attributes: {
        'subscription_plan': '무료',
        'company_size': 1000,
    }
});

백엔드에서 속성 설정하기

백엔드에서 속성을 설정해야 한다면, 그렇게 할 수 있습니다!

Preferences의 API 섹션에서 개인 API 키를 생성하고, 통합 UI에서 작업 공간 ID를 가져올 수 있습니다. # 주석을 제거하는 것을 잊지 마세요.

curl -X POST 'https://wapi.specific.app/api/v1/group' \
-H 'authorization: PERSONAL_API_KEY' \
-H 'x-app: WORKSPACE_ID' \
-H 'Content-Type: application/json' \
-d '{
  "id": "4242424242424242",         # 필수: 고유 그룹 ID
  "name": "Acme Inc.",              # 선택 사항: 그룹 이름
  "attrs": [                        # 선택 사항: 그룹 속성
    {
      "key": "active",              # 선택 속성 키
      "value": true                 # 예시 값 (그룹 활성화)
    },
    {
      "key": "company_size",        # 선택 속성 키
      "value": 1000                 # 예시 값 (직원 수)
    },
    {
      "key": "subscription_plan",   # 선택 속성 키
      "value": "Free"               # 예시 값 (구독 유형)
    }
  ]
}'

당사의 공용 API를 사용하여 더 많은 작업을 수행할 수 있습니다. API 문서에서 자세히 알아보세요.