활동

k-ID API의 대부분은 제품이 묻는 질문에 답합니다. 이 플레이어는 몇 살인지, 무엇이 허용되는지, 부모가 동의했는지 같은 질문입니다. 활동은 그 반대 방향입니다. 제품이 아이가 실제로 무엇을 했는지 보고하면, k-ID는 그 보고를 신뢰할 수 있는 성인이 확인할 수 있는 형태로 만듭니다.

제품에서 활동이 무엇을 의미하는지는 직접 결정합니다. 채팅 기능 사용 시간, 보낸 메시지 수, 구매한 아이템, 완료한 레슨처럼 의미 있는 유형을 선언하고 그에 대해 레코드를 푸시합니다. k-ID는 보낸 내용을 저장하고 집계합니다.

활동 레코드란

활동 레코드는 제품에서 발생한 하나의 타임스탬프가 있는 사건이며, k-ID 세션에 연결됩니다.

필드	내용
id	제품이 생성하는 UUID입니다. 멱등성을 위해 레코드를 식별합니다.
type	Compliance Studio에서 제품에 선언된 활동 유형의 키입니다.
value	측정값이며, 유형의 메트릭 유형이 정한 형식을 따릅니다.
timestamp	발생 시각(UTC)입니다. 최근 7일 이내여야 합니다.
attributes	선택적 키/값 메타데이터이며, 유형이 선언한 속성 키로 제한됩니다.

귀속의 단위는 세션입니다. 레코드는 푸시 대상 세션에 속하며, 신뢰할 수 있는 성인용 화면은 제품별로 플레이어당 하나의 세션을 읽습니다. 따라서 기기마다 새 세션을 만들지 말고, 이미 보유한 세션에 해당 플레이어의 모든 활동을 푸시하십시오.

활동 유형

활동 유형은 "이 제품은 이런 종류의 사건을 이런 방식으로 측정해 보고한다"는 선언입니다. 유형은 Compliance Studio에서 제품별로 구성하므로, 유형을 추가하는 일은 통합 프로젝트가 아니라 구성 변경입니다. 활동 유형을 참조하십시오.

각 유형은 메트릭 유형을 고정하며, 이는 제품이 푸시하는 모든 value의 형식을 결정합니다.

메트릭 유형	값 형식	예
duration	seconds	기능 사용 시간
currency	amount(최소 단위)와 currency(ISO 4217)	구매 및 기타 금액
count	count	보낸 메시지 수와 같은 개별 사건
gauge	number	완료율과 같은 소수 값
boolean	bool	발생했거나 발생하지 않은 사건

value가 유형의 메트릭 유형과 맞지 않는 레코드는 거부되며, 제품이 선언하지 않은 type을 지정한 레코드도 마찬가지입니다.

k-ID는 활동을 어떻게 사용하나요

활동은 신뢰할 수 있는 성인이 보는 화면에 반영됩니다. Family Connect에서 연결된 성인은 아이가 이용하는 제품을 열고 해당 제품의 활동을 전용 탭에서 확인합니다. 또한 연결된 성인은 해당 제품에 대한 활동 요약 이메일을 정기적으로 받습니다. 기본값은 매주이며 주기는 본인이 조정할 수 있습니다. 두 화면 모두 원본 레코드가 아니라 집계된 활동을 읽습니다.

활동이 아닌 것

이 경계는 의도적이며 분명히 밝혀 둘 가치가 있습니다.

• k-ID는 활동을 저장하고 집계합니다. 그 내용을 해석하거나 모더레이션하지 않습니다.
• 활동 수집은 아이를 차단하거나 권한을 변경하거나 개입을 실행하지 않습니다. 스크린 타임 제한처럼 아이의 행동에 작용하는 기능은 별개이며 활동을 읽어 갑니다.
• 활동은 수신 전용입니다. 활동 웹훅 이벤트는 없습니다. 제품이 k-ID로 푸시하고 응답에서 레코드별 결과를 받습니다.

스크린 타임 보고는 활동 수집과 같은 형태입니다. 앱이 사용량을 k-ID에 보고하는 데 부모 설정이 필요 없으며, 부모용 제어는 그 위에 얹히는 별도의 선택적 계층입니다. 스크린 타임의 기능 플래그를 참조하십시오.

개인정보와 속성

속성은 게임의 어떤 모드에서 시간을 보냈는지처럼, 신뢰할 수 있는 성인에게 나누어 보여주고 싶은 차원을 위한 것입니다. 범용 페이로드가 아닙니다.

여기에서 두 가지 규칙이 따라옵니다. 유형은 허용하는 속성 키를 선언하며, 그 밖의 키를 담은 레코드는 거부됩니다. 그리고 개인정보로 보이는 속성 값은 그대로 거부됩니다. 개인정보 자체가 아니라 자체 시스템에서 해석할 수 있는 불투명한 식별자를 보내십시오.

보존 기간

k-ID는 개별 활동 레코드를 90일 동안 보관합니다. 신뢰할 수 있는 성인용 화면이 읽는 집계된 활동은 최대 2년 동안 보관됩니다. 세션이나 플레이어를 삭제하면 거기에 귀속된 활동도 함께 삭제됩니다.

테스트와 라이브

활동은 제품 구성의 나머지 부분과 동일하게 동작합니다. 제품 편집기에서 선언한 활동 유형은 환경에 푸시할 때까지 로컬 상태이며, 엔드포인트는 API 키의 모드가 가리키는 구성을 제공합니다. 유형을 선언하고 테스트에 푸시한 다음, 테스트 API 키로 검증하고 나서 라이브에 퍼블리싱하십시오. 테스트 및 퍼블리싱을 참조하십시오.

다음 단계

• 사용량 보고: 활동 레코드, 스크린 타임 사용량, 완료된 구매 푸시, 항목별 결과 처리, 엔드 투 엔드 검증.
• 활동 유형: Compliance Studio에서 유형 선언.
• /activity/push: 엔드포인트 레퍼런스.