동의 문서 목록과 고지

콘솔의 개인정보 동의 메뉴나 서버 API로 고지문을 확인하고 발급된 제목·전문·서식을 그대로 표시합니다. 문구 수정이 필요하면 문의하기로 재발급을 요청합니다.

고지할 문서 버전 선택하기

동의 문서는 종류별로 관리되며 버전 번호(version)가 가장 큰 문서가 최신 문서입니다.

새 버전이 추가되어도 기존 버전에 동의한 내역은 계속 유효합니다.
새로 동의를 받을 때는 종류별 최신 버전을 고지합니다.

서버 API로 목록 조회하기

전제조건

서버 API로 문서를 받아 표시할 때는 API 키를 발급하고 조직 ID를 확인합니다.

API 키 역할에 동의 문서 조회 권한(consent_document:read)이 필요하며, 조직 관리자에게 권한 부여를 요청합니다. API는 퍼블리셔 서버에서 서버 API 키로 호출합니다.

고지 준비 순서

게임을 등록한 조직의 동의 문서 목록을 조회합니다.
고지할 종류별로 가장 높은 버전(version)의 항목을 선택하고 document._id를 확인합니다.
고지 화면에 표시할 전문을 단건 조회 API로 조회합니다.
아래 고지 표시에 따라 제목과 전문을 표시하고 동의 결과를 보관합니다.

목록 조회 요청

조직의 전체 동의 문서 목록을 조회합니다. 특정 종류만 조회할 때는 ?kind=CONSENT_DOCUMENT_KIND_MEASUREMENT처럼 kind 쿼리 매개변수를 지정합니다.

$API_BASE는 Core API 주소인 https://www.easterad.com입니다. $KEY는 서버 API 키, $ORG는 게임을 등록한 조직 ID입니다.

curl -s "$API_BASE/api/core/organization/$ORG/privacy/consent-documents" \
  -H "Authorization: Bearer $KEY" \
  -H "Accept: application/json"

응답은 목록 항목의 배열입니다.

[
  {
    "kind": "CONSENT_DOCUMENT_KIND_MEASUREMENT",
    "version": 2,
    "addedAt": "2026-10-11T09:00:00.000Z",
    "document": {
      "_id": "66f0a1b2c3d4e5f6a7b8c9d0",
      "kind": "CONSENT_DOCUMENT_KIND_MEASUREMENT",
      "notice": {
        "title": "광고 측정을 위한 개인정보 수집·이용 동의",
        "language": "ko"
      },
      "partners": [],
      "dataItems": [
        "CONSENT_DATA_ITEM_CROSS_SITE_ID",
        "CONSENT_DATA_ITEM_PUBLISHER_USER_ID"
      ],
      "issuedAt": "2026-10-10T09:00:00.000Z"
    }
  }
]

목록 응답 필드

목록의 각 항목은 kind, version, addedAt, document로 구성됩니다.

목록의 문서 정보(document)에 포함되는 필드는 다음과 같습니다.

필드	설명
`_id`	문서 ID(24자리 16진수). 광고 SDK에 동의 내역을 전달할 때 사용합니다(세션 동의 전달).
`kind`	동의 종류(`CONSENT_DOCUMENT_KIND_MEASUREMENT`, `CONSENT_DOCUMENT_KIND_PERSONALIZATION`, `CONSENT_DOCUMENT_KIND_THIRD_PARTY_SHARING`, `CONSENT_DOCUMENT_KIND_OVERSEAS_TRANSFER`). 동의 종류별 상세 기준과 동시 동의 요건은 동의 개요를 참고합니다.
`notice.title`	고지 제목
`notice.language`	고지 언어 코드(`ko`)
`partners`	제3자 제공·국외 이전 문서의 수신자 목록입니다. 이름(`name`)과 수신 법인(`recipientEntity`)을 확인합니다.
`dataItems`	문서가 다루는 데이터 항목 목록. 아래 데이터 항목을 참고합니다.
`issuedAt`	발급 일시(ISO 8601 형식 문자열)

데이터 항목

dataItems에는 문서가 다루는 데이터 항목이 담깁니다. 각 항목의 목적·보유기간·수신자 등 세부 내용은 고지 전문에 포함되어 있습니다.

단건 조회 요청

선택한 문서 ID로 고지 전문을 조회합니다. 응답 본문은 동의 화면용 공식 HTML 조각이며 text/html; charset=utf-8 형식으로 반환됩니다. 고지 언어는 Content-Language 헤더에 담깁니다. 문서 ID, 종류, 제목 같은 문서 정보는 목록 조회에서 확인합니다.

curl -s "$API_BASE/api/core/organization/$ORG/privacy/consent-documents/66f0a1b2c3d4e5f6a7b8c9d0" \
  -H "Authorization: Bearer $KEY" \
  -H "Accept: text/html"

<h2>광고 측정을 위한 개인정보 수집·이용</h2>
<table>
<thead>
<tr><th>항목</th><th>목적</th><th>보유기간</th></tr>
</thead>
<tbody>
<tr><td>…</td><td><strong>…</strong></td><td><strong>…</strong></td></tr>
</tbody>
</table>

한 번 조회한 전문은 문서 ID별로 보관하여 재사용할 수 있습니다.

고지 표시

이용자에게 고지를 표시할 때는 다음 요건을 따릅니다.

동의 화면에 notice.title을 동의 항목의 이름으로 표시하고 이용자가 전문을 온전히 확인할 수 있게 제공합니다.
단건 조회로 받은 HTML의 제목, 강조, 목록, 표 서식을 유지하여 전문 전체를 표시합니다. 보유기간·수신자·목적의 강조도 유지합니다.
이용자가 동의하면 해당 문서의 _id와 동의 일시를 자체 저장소에 보관합니다. 광고 SDK를 연동할 때 동의한 문서 ID 목록을 전달합니다.