본문으로 건너뛰기

3개의 게시물개의 게시물이 "widgets" 태그를 포함

모든 태그 보기

위젯 및 연령 확인을 위한 모바일 통합 안내

모바일에서 k-ID를 가장 잘 통합하는 방법을 명확히 하기 위해 문서를 업데이트했습니다: 연령 게이트와 동의 단계에는 네이티브로 구축한 UX가 플레이어에게 가장 원활한 경험을 제공하며, 연령 확인 및 연령 보증 URL과 같은 웹 임베드는 시스템 브라우저 구성요소를 통해 표시됩니다.

새로운 기능​

연령 게이트 및 End-to-End 위젯에 대한 모바일 안내​

연령 게이트 및 end-to-end 위젯은 모바일에서 완전히 지원됩니다. 연령 게이트와 동의 단계의 경우, 가장 브랜드에 통합된 경험을 위해 사용자 정의 워크플로를 사용하고 CDK UX 가이드라인에 따라 UX를 네이티브로 구축하는 것을 권장합니다.

k-ID API가 반환하는 연령 확인 및 연령 보증 URL도 동일한 방식으로 표시됩니다. 특정 엔드포인트와 챌린지 유형은 모바일 앱 가이드를 참조하세요.

개편된 모바일 앱 가이드​

모바일 앱 가이드는 모바일에서 가장 일반적인 웹 임베드인 연령 확인을 중심으로 재구성되었습니다:

기본 브라우저 방법​

기본 외부 브라우저 방법이 모바일 구현 방법에 문서화되었습니다. 이 방법은 Android(Intent.ACTION_VIEW)와 iOS(UIApplication.open) 모두에서 작동하고, AgeKeys를 완전히 지원하며, redirectUrl 콜백을 통해 앱으로 포커스를 반환합니다.

기기 방향 안내​

연령 확인은 세로 방향에서 가장 잘 작동합니다. 인앱 브라우저 환경은 앱의 방향 고정을 상속하므로, 가로 방향으로 고정된 앱은 기본 외부 브라우저에서 확인 URL을 열어야 합니다. 브라우저는 자체 방향을 관리하므로 사용자가 세로로 회전할 수 있으며, 흐름이 완료되면 redirectUrl 콜백이 사용자를 앱으로 반환합니다.

업데이트된 문서​

다음 단계​

  • 모바일에서 통합하는 경우 가장 원활한 경험을 위해 사용자 정의 워크플로와 CDK UX 가이드라인을 사용하여 연령 게이트와 동의 UX를 네이티브로 구축하는 것을 고려하세요
  • 확인 URL을 표시할 때 가로 고정 앱에는 기본 브라우저 방법을 사용하세요

Age Gate Widget 리디렉션 URL 지원

Age Gate Widget 엔드포인트에 redirectUrl을 선택적 매개변수로 추가했습니다.

새로운 기능​

Age Gate Widget API 업데이트​

/widget/generate-age-gate-url 엔드포인트는 이제 options 객체 내에서 선택적 redirectUrl 매개변수를 지원합니다. 이를 통해 Age Gate Widget이 완료된 후 리디렉션할 URL을 지정할 수 있으며, 이는 엔드투엔드 위젯 엔드포인트와 유사합니다.

redirectUrl 매개변수는 HTTP/HTTPS URL 또는 사용자 정의 프로토콜 스키마를 사용하는 모바일 딥링크를 지원합니다.

업데이트된 API​

Widget.ExitReview 명확화 및 API 업데이트

연령 확인 및 VPC 흐름에 대한 위젯 UI를 언제 닫을지 명확히 하고 MegaWidgetOptions 스키마에 redirectUrl 지원을 추가했습니다.

새로운 기능​

Widget.ExitReview 명확화​

연령 확인 및 VPC 흐름에 대한 UI를 언제 닫을지 결정하는 신호로 Widget.ExitReview를 사용해야 함을 명확히 하기 위해 문서를 업데이트했습니다.

업데이트된 문서:

  • 연령 확인 가이드 - 확인 UI를 닫기 위해 Widget.ExitReview를 수신하는 방법에 대한 지침 추가
  • VPC 가이드 - VPC 위젯 UI를 닫기 위해 Widget.ExitReview를 수신하는 방법에 대한 지침 추가
  • CDK 임베디드 흐름 - 위젯 UI를 닫기 위해 Widget.ExitReview를 수신하는 방법에 대한 지침 추가

모든 언어 버전(영어, 일본어, 간체 중국어, 한국어)이 이 명확화로 업데이트되었습니다.

API 업데이트​

MegaWidgetOptions의 redirectUrl​

MegaWidgetOptions 스키마에 연령 확인 요청 스키마와 일관된 redirectUrl 지원이 포함되었습니다. 이를 통해 엔드투엔드 위젯을 사용할 때 리디렉션 URL을 지정할 수 있습니다.

업데이트된 스키마:

  • MegaWidgetOptions에 #/components/schemas/RedirectUrl에 대한 참조가 있는 redirectUrl 필드가 포함되었습니다

이 변경 사항은 모든 OpenAPI 사양 파일(영어, 일본어, 간체 중국어, 한국어)에서 사용할 수 있습니다.

문서 개선​

프로덕트 이미지 사양​

Compliance Studio의 프로덕트 이미지에 대한 권장 종횡비 및 해상도를 추가했습니다:

  • 로고: 1:1 (정사각형), 512×512px
  • 배너: 3:1 (가로), 2430×810px