활동 유형
활동 유형은 제품이 k-ID에 보고하는 사건의 한 종류와 그 측정 방식을 선언합니다. 제품은 선언된 유형에 대해 레코드를 푸시하고, k-ID는 그 밖의 유형을 지정한 레코드를 거부합니다. 유형 선언은 직접 수행하는 구성 변경이므로, 새로운 종류의 활동을 추가하는 데 k-ID 엔지니어가 필요하지 않습니다.
활동 탭 찾기
제품 편집기에서 제품을 열고 활동 탭을 선택하십시오. 이 탭에는 해당 제품의 활동 유형이 있으며, 조직에서 스크린 타임을 사용할 수 있는 경우 스크린 타임 설정도 함께 있습니다.
활동을 사용하려면 k-ID에 연락하여 이 기능을 조직에 대해 활성화해 주십시오.
유형 선언
-
활동 탭에서 활동 유형 추가를 선택하십시오. 새 항목이 표시되며 저장할 때까지 조치 필요로 표시됩니다.
-
레이블을 입력하십시오. 이는 신뢰할 수 있는 성인이 Family Connect에서 보는 사람이 읽을 수 있는 이름이므로, 코드가 아니라 부모를 위해 작성하십시오.
chat_time_v2가 아니라 채팅 사용 시간처럼 씁니다. 최대 128자입니다. -
메트릭 유형을 선택하십시오. 이것이 해당 유형으로 제품이 푸시하는 모든 값의 형식을 결정합니다.
선택 항목 제품이 푸시하는 value기간(초){ "seconds": 1800 }통화(최소 단위 + ISO){ "amount": 999, "currency": "USD" }카운트(정수){ "count": 7 }게이지(소수){ "number": 0.85 }불리언{ "bool": true } -
필요하면 허용된 속성 키를 추가하십시오. 여기에 추가한 키는 이 유형의 레코드에 붙일 수 있는 키가 됩니다. 키는 소문자로 시작하고 소문자, 숫자, 밑줄만 포함하며 최대 64자, 유형당 최대 32개입니다.
-
저장을 선택하십시오.
메트릭 유형은 영구적입니다. 해당 유형으로 이미 저장된 레코드가 그 형식으로 검증되었기 때문에, 유형을 만든 뒤에는 변경할 수 없습니다. 다른 형식이 필요하면 새 유형을 만드십시오.
제품에서 유형 참조하기
각 활동 유형에는 키가 있으며, 제품은 레코드의 type 필드에 이 키를 보냅니다.
키는 유형을 추가할 때 k-ID가 생성하는 UUID입니다. 직접 선택할 수도, 편집할 수도 없습니다. 유형을 저장하면 레이블 필드 옆에 복사 컨트롤이 표시됩니다. 이를 사용해 키를 복사하고 그 값을 통합에 붙여 넣으십시오.
레이블에서 유추하거나 다시 입력하지 말고, 매번 Compliance Studio에서 키를 복사하십시오. 키는 생성된 UUID이며 직접 구성할 값이 아닙니다.
예약된 키가 하나 있습니다. screentime_usage는 k-ID의 스크린 타임 엔드포인트에 속하며, 사용 구간이 그 키로 기록됩니다. 제품이 이 키로 레코드를 푸시하는 일은 없습니다.
편집과 삭제
유형의 레이블과 허용된 속성 키는 생성 후에 변경할 수 있습니다. 둘 다 변경이 환경에 반영된 뒤 푸시된 레코드부터 적용됩니다.
허용된 속성 키를 제거하면 그 키를 담은 레코드가 attribute_key_not_allowed 사유로 거부되기 시작합니다. 통합에서 먼저 키를 제거한 다음 유형에서 제거하십시오.
유형을 삭제하면 선언이 사라지므로, 그 키로 푸시된 레코드는 unknown_type 사유로 거부되기 시작합니다. 삭제하기 전에 해당 유형의 푸시를 중단하십시오.
제한
| 항목 | 값 |
|---|---|
| 제품당 활동 유형 | 50 |
| 유형당 허용된 속성 키 | 32 |
| 레이블 길이 | 128자 |
| 속성 키 길이 | 64자 |
변경 사항 퍼블리싱
활동 유형은 제품 구성의 나머지 부분과 같은 경로를 따릅니다. 추가한 유형은 푸시하기 전까지 로컬 상태이며, 각 환경은 그 환경에 푸시된 구성을 제공합니다. 테스트에 푸시해 테스트 API 키로 검증한 다음 라이브에 퍼블리싱하십시오. 테스트 및 퍼블리싱을 참조하십시오.
API 키가 사용하는 환경에 아직 도달하지 않은 유형을 지정한 레코드는 unknown_type으로 거부됩니다. 새 유형이 작동하지 않는 것처럼 보이는 가장 흔한 원인입니다.