사용자 정의 차원 및 메트릭 구성
이 문서에서:
- 사용자 정의 차원
- 사용자 정의 계정 메트릭
- 제한 사항 및 주의점
사용자 정의 차원
Freshsuccess는 계정, 사용자, 목표 및 지원 티켓에 대한 사용자 정의 차원을 지원합니다. 새로운 사용자 정의 차원을 추가하고 추적을 시작할 수 있는 여러 옵션이 있습니다.
- "필드 관리" 페이지 사용
설정 > 관리 센터 > 필드 관리 페이지로 이동하여 사용자 정의 필드를 추가할 객체를 선택하고 오른쪽 상단의 "사용자 정의 필드 추가"를 클릭합니다.
팝업 창에서 다음 세부 정보를 입력합니다:
- 차원 유형 선택 - 요구 사항에 따라 적절한 차원 유형을 선택합니다.
- 이름 – Freshsuccess 플랫폼에 표시될 사용자 정의 차원의 이름입니다.
- 설명 - 이 사용자 정의 계정 차원에 대한 선택적 설명입니다.
- 필드를 "읽기 전용" 필드로 만들고 싶은지 선택합니다.
이 방법은 계정, 사용자, 목표 및 지원 티켓 사용자 정의 차원을 추가할 때 적용됩니다.
- Freshsuccess 계정 API 사용
Freshsuccess 계정 API를 사용하여 구현에서 새로운 사용자 정의 계정 차원을 보낼 수 있습니다.
사용자 정의 차원을 보낼 때, 각 유형에 대해 계정, 계정 제품 사용자 또는 계정 연락처 엔드포인트 아래의 이름을 사용하여 Freshsuccess 규칙 및 보고서에서 사용자 정의 차원을 올바르게 사용할 수 있도록 하십시오.
- 텍스트 필드: custom_label_dimensions
- 숫자 필드: custom_value_dimensions
- 날짜 선택기: custom_event_dimensions
그런 다음 귀하의 데이터는 사용자 정의 차원 정의를 사용하여 즉시 처리됩니다. 계정 차원 드롭다운에서 자동으로 보낸 사용자 정의 차원의 이름을 캡처합니다.
이 방법은 계정, 사용자 및 지원 티켓 사용자 정의 차원을 추가할 때 적용됩니다.
API를 사용하여 텍스트 필드, 숫자 및 날짜 선택기 유형 필드만 사용자 정의 필드를 생성할 수 있음을 유의하십시오.
- UI의 API 업로드 기능 사용
설정 > IT 관리 페이지 아래에 있는 API 업로드 기능을 사용하여 새로운 사용자 정의 계정 차원을 업로드할 수 있습니다.
사용자 정의 차원을 업로드할 때 올바른 API 템플릿을 선택하여 Freshsuccess 규칙 및 보고서에서 올바르게 사용할 수 있도록 하십시오.
- 텍스트: custom_label_dimensions
- 숫자: custom_value_dimensions
- 날짜 선택기: custom_event_dimensions
업데이트가 발생하면 모든 업데이트가 즉시 표시됩니다. 업로드가 완료된 후 동일한 페이지에 성공 및 오류(오류 세부 정보 포함) 메시지가 인쇄됩니다.
이 방법은 계정, 사용자 및 지원 티켓 사용자 정의 차원을 추가할 때 적용됩니다.
사용자 정의 계정 메트릭
사용자 정의 차원은 "차원" 페이지에서 직접 추가할 수 있지만, 사용자 정의 메트릭은 Freshsuccess 계정 API 또는 API 업로드 기능을 사용하여 생성 및 업데이트해야 합니다.
사용자 정의 메트릭은 시계열 데이터이기 때문에 각 데이터 포인트에 대한 타임스탬프 정보와 함께 전송되어야 합니다. 타임스탬프는 epoch 밀리초를 나타내는 숫자 또는 ISO8601 타임스탬프로 제공될 수 있습니다. 예: 'YYYY-MM-DD HH: MM' 또는 'YYYY/MM/DD'. 모든 타임스탬프는 UTC 시간대를 기준으로 합니다.
그런 다음 귀하의 데이터는 사용자 정의 메트릭 정의를 사용하여 즉시 처리됩니다. 계정 메트릭 드롭다운에서 자동으로 보낸 사용자 정의 메트릭의 이름을 캡처합니다.
제한 사항 및 주의점
- 사용자 정의 차원 또는 메트릭이 추가되면 이름만 수정할 수 있으며 유형은 수정할 수 없습니다. 이름이 변경되면 새로운 이름으로 데이터를 전송해야 하며, 모든 이전 데이터에 대해 이름이 업데이트됩니다.
- 사용자 정의 차원 또는 메트릭의 삭제는 영구적이며 복구할 수 없습니다. "차원" 페이지를 통해 차원을 삭제하면 해당 차원과 관련된 데이터도 삭제됩니다.
- 사용자 정의 차원 및 메트릭의 값은 "Double"로 저장되어 소수점 숫자를 허용합니다.
- 텍스트 차원에 허용되는 최대 문자 수는 255자입니다. 즉, 특정 차원의 이름과 값 모두 최대 문자 수 내에 있어야 합니다.
- 사용자 정의 차원 및 메트릭의 이름 지정 시, 각 이름은 전역적으로 고유해야 합니다.
- API를 통해 사용자 정의 차원 및 메트릭을 전송할 때, 동일한 차원/메트릭의 이름은 일관되게(정확히 일치) 유지되어야 하며, 그렇지 않으면 별도의 사용자 정의 차원/메트릭으로 캡처됩니다.
- 계정에 사용자 정의 메트릭 및/또는 값 차원의 값이 없는 경우, 해당 계정에 대해 0으로 설정됩니다. 사용자 정의 텍스트 차원의 값이 없는 계정의 경우, "사용자 정의 텍스트 차원의 이름" "정의되지 않음"이라는 조건을 구성하여 계정 목록 규칙에서 이러한 계정을 필터링할 수 있습니다.
- Freshsuccess는 현재 계정에 대한 사용자 정의 차원 및 메트릭을 지원하지만 사용자에 대해서는 사용자 정의 차원만 지원합니다.