플랫폼 연령 신호
게임 플랫폼(Apple iOS, Google Play, Xbox, Meta Horizon, k-ID 자체)은 플레이어에 대한 연령 데이터를 제공할 수 있습니다. 이 데이터는 자체 신고된 연령과 함께 또는 대신 k-ID에 전달될 수 있습니다. k-ID는 이를 사용하여 적절한 경우 연령 게이트를 억제하고, 연령 충돌을 해결하며, 신호가 확인된 것으로 간주될 때 추가 확인 단계 없이 연령 확인 요건을 충족합니다.
플랫폼 연령 신호는 고위험 기능을 위한 연령 보증과 함께 작동합니다. 예를 들어, 확인된 Apple iOS 신호는 연령 게이트를 건너뛰고 별도의 확인 단계 없이 브라질의 루트 박스 권한을 잠금 해제할 수 있습니다.
시작하기
다음을 원할 때 이 기능 세트를 사용하세요:
- 플랫폼이 이미 플레이어에 대해 알고 있는 연령 정보 재사용
- 확인된 성인 신호에 대한 연령 게이트 건너뛰기
- 플레이어에게 다시 확인을 요청하지 않고 브라질 루트 박스 및 타겟 광고와 같은 고위험 권한 잠금 해제
- 플랫폼 연령 신호가 자체 신고된 연령과 충돌하는 시점 감지
빠른 통합 경로
| 게임이 다음을 갖고 있는 경우… | k-ID로 전송 | 일반적으로 발생하는 일 |
|---|---|---|
| Apple iOS, Google Play 또는 k-ID의 확인된 성인 신호 | GET /age-gate/get-requirements 및 POST /age-gate/check 모두에 플랫폼 신호 | 연령 게이트를 건너뛰고 확인된 연령 권한을 즉시 활성화할 수 있음 |
| Xbox 또는 Meta Horizon과 같은 미확인 신호 | get-requirements 및 check에 플랫폼 신호 | k-ID가 보수적인 연령 확인에 사용할 수 있지만 확인된 연령 권한을 충족하지 못함 |
| 카테고리 기반 플랫폼 신호 | 카테고리를 직접, 또는 먼저 POST /age-gate/get-platform-age-range로 변환 | k-ID가 카테고리를 관할권별 연령 범위로 해석 |
| 플랫폼 신호 없음 | 일반적인 연령 게이트 입력 | 표준 연령 게이트 흐름이 적용되고 고위험 권한은 나중에 연령 보증이 필요할 수 있음 |
API 맵
개발자가 통합 중에 가장 많이 사용하는 엔드포인트:
| 엔드포인트 | 언제 호출하는지 | 중요한 이유 |
|---|---|---|
GET /age-gate/get-requirements | 연령 게이트를 표시하기 전 | 게이트를 표시해야 하는지, 확인된 연령 권한에 아직 보증이 필요한지 알려줌 |
GET /session/get | check 또는 Challenge 완료 후 | 권한을 새로 고치고 ageVerification을 검사할 수 있게 해줌 |
POST /age-gate/check | 항상, 플레이어의 연령 입력이 있은 후 | 세션을 생성하거나 업데이트하고 확인된 플랫폼 신호가 허용할 때 세션에 확인된 연령을 기록 |
POST /session/upgrade | 플레이어가 고위험 기능을 사용하려 할 때 | 요청된 권한을 즉시 활성화하거나 연령 보증 Challenge를 생성 |
POST /age-gate/get-platform-age-range | 카테고리 기반 플랫폼 신호에만 해당 | 플랫폼 카테고리를 ageLow 및 ageHigh로 변환 |
종단 간 흐름
권장 요청 순서
- 시작 시 플랫폼 신호를 가져옵니다. 플랫폼이 연령 데이터를 제공하는 경우,
get-requirements및check모두에서 사용할 수 있도록 최대한 빨리 캡처합니다. GET /age-gate/get-requirements를 호출합니다. 연령 게이트 표시 여부와 확인된 연령이 필요한 권한이 있는지 알려줍니다.- 항상
POST /age-gate/check를 호출합니다. 게이트가 건너뛰어지더라도 세션을 생성하거나 업데이트하려면check가 필요합니다. sessionId및 현재 권한을 저장합니다. 게임이 기능 액세스를 제어하는 데 사용해야 하는 정보입니다.- 필요한 경우에만
POST /session/upgrade를 호출합니다. 플레이어가 아직 활성화되지 않은 고위험 기능을 적극적으로 사용하려 할 때 이 작업을 수행합니다.
shouldDisplay가 false이지만 전송할 플랫폼 신호가 실제로 없는 경우, 보수적인 대안으로 age: 1과 함께 POST /age-gate/check를 호출하세요。
POST /age-gate/check가 플랫폼 신호를 사용하는 방법
주요 개념
PlatformAgeSignal 객체
플랫폼에서 보고한 연령 신호를 설명하는 통합 객체입니다. category 또는 ageLow와 ageHigh 모두 중 하나만 제공하세요. 둘 다 제공하지 마세요.
{
"name": "apple-ios",
"ageLow": 18,
"ageHigh": 25,
"declarationType": "governmentIDChecked",
"verificationId": null
}
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
name | string | 예 | 플랫폼 식별자: apple-ios, google-play, xbox, meta-horizon 또는 k-id |
category | string | 아니오 | 플랫폼별 연령 카테고리 (예: digital-youth, TN, teen) |
ageLow | integer | 아니오 | 플랫폼의 최소 연령(년). ageHigh와 쌍으로 사용해야 합니다. |
ageHigh | integer | 아니오 | 플랫폼의 최대 연령(년). ageLow와 쌍으로 사용해야 합니다. |
declarationType | string | 아니오 | 플랫폼이 연령을 결정한 방법 (예: governmentIDChecked, VERIFIED) |
verificationId | string (UUID) | 아니오 | k-id 신호만 해당: 완료된 k-ID 확인 레코드를 참조 |
지원되는 플랫폼
| 플랫폼 | 허용되는 입력 | 확인된 선언 유형 | 참고 사항 |
|---|---|---|---|
apple-ios | ageLow + ageHigh만 | paymentChecked, governmentIDChecked, guardianPaymentChecked, guardianGovernmentIDChecked | 카테고리 입력은 400 반환 |
google-play | ageLow + ageHigh만 | VERIFIED, SUPERVISED | 카테고리 입력은 400 반환 |
| Xbox | category (child, teen, adult) | 없음 (연령 요건에 대해 미확인) | 범위는 관할권에 따라 다름 |
| meta-horizon | category (CH, TN, AD) | 없음 (연령 요건에 대해 미확인) | 범위는 관할권에 따라 다름 (Meta Horizon 참조) |
| k-ID | category (digital-minor, digital-youth, adult) | KIDVerified (서버에서 확인) | 확인된 선언에는 Compliance Studio 내 동일 조직의 유효한 verificationId가 필요 |
확인된 신호와 미확인 신호
플랫폼 신호는 declarationType이 해당 플랫폼의 확인된 세트에 있을 때만 확인된 것으로 간주됩니다. 확인된 신호는 다음을 할 수 있습니다:
- 연령 게이트를 억제 (
shouldDisplay = false): 신호가 성인(ageLow >= civilAge)임을 나타낼 때 - 권한의 연령 확인 임계값을 충족: 예를 들어 별도의 확인 단계 없이 루트 박스를 활성화
- 세션에
ageVerification기록: 향후 권한 확인을 위해
미확인 신호(예: Xbox, Meta Horizon 또는 자체 선언된 Apple 또는 Google 신호)는 여전히 연령 충돌 감지 및 보수적인 연령 확인에 유용하지만, 확인 요건을 우회할 수 없습니다.
확인된 연령 임계값
일부 권한은 활성화되기 전에 확인된 연령이 필요합니다. 이 경우 권한에 verifiedAgeThreshold 정수 필드가 포함됩니다.
예를 들어 브라질에서 loot-boxes-paid-cosmetic-only, loot-boxes-paid-gameplay-impacting, targeted-ads, profiling은 확인된 연령 18이 필요하고, direct-marketing은 확인된 연령 12가 필요합니다. 플레이어의 유효 연령이 임계값 미만인 경우 권한은 PROHIBITED가 됩니다. 플레이어가 임계값을 충족하지만 아직 연령을 확인하지 않은 경우 권한은 다음 중 하나가 될 때까지 enabled: false로 유지됩니다:
- 확인된 플랫폼 신호가 임계값을 충족하거나,
- 플레이어가 고위험 기능을 위한 연령 보증을 완료
연령 충돌 감지
기본 연령 매개변수(dateOfBirth, age 또는 kuid)와 platformAgeSignal 모두 /age-gate/check에 제공되는 경우, 시스템은 연령 카테고리를 비교합니다:
- 플랫폼이 자체 신고보다 더 어린 경우 (예: 플랫폼은 "아동"이지만 플레이어는 "성인"이라 함):
AGE_CONFLICT(400 오류) 반환 - 플랫폼이 자체 신고보다 더 나이든 경우: 허용됨; 더 보수적인(낮은) 연령이 사용됨
- 같은 카테고리: 충돌 없음; 정상적으로 진행
연령 충돌 감지는 개발자별 기능 플래그입니다. 활성화하려면 k-ID에 문의하세요。
다음 단계
- 정확한 요청 형태, 플랫폼별 참고 사항 및 유효성 검사 규칙은 플랫폼 신호 세부 사항을 참조하세요.
- 확인된 연령 권한 및 세션 업그레이드 동작은 고위험 기능을 위한 연령 보증을 참조하세요.