플랫폼의 동의 문맥 반영

1. 고지한 문서 ID 보관하기

동의 문서 목록과 고지에 따라 동의 문서의 제목과 전문을 그대로 표시합니다.
이용자가 동의한 문서 ID와 일시를 이용자별로 저장소에 보관합니다.

2. 초기화할 때 현재 동의 전달하기

initializePlatform의 최상위 옵션인 publisherContext에 consent.grants를 설정합니다. 동의 문서 ID는 24자리 16진수로 최대 16개까지 입력하며, 대소문자만 다른 중복 없이 고유한 ID로 지정합니다. 동의를 받지 않았거나 모두 거부한 경우 빈 배열 []을 입력합니다.
실제로 고지하고 동의받은 범위에 한해 회원 ID와 관심사를 추가로 입력합니다. 회원 ID는 identity.userId에 입력하며, 로그아웃한 이용자는 identity를 생략합니다. 관심사는 targeting.keywords에 문자열 배열로 입력합니다. 분류 코드를 사용하면 targeting.taxonomy에 분류 체계를, targeting.segments에 그 체계의 코드 배열을 함께 전달합니다.

아래 ID와 회원 값은 형식 예시입니다. 실제 동의 내역과 회원 정보로 바꿉니다.

const context = {
  consent: { grants: ['66f0a1b2c3d4e5f6a7b8c9d0'] },
  identity: { userId: 'player-123' },
  targeting: { keywords: ['퍼즐'] }
};

3. 변경·거부·철회 반영하기

이용자의 동의 변경·거부·철회 선택을 저장소에 반영합니다.
현재 동의 및 회원 정보 전체를 담은 문맥을 구성하여 updatePublisherContext로 전달합니다. 유지할 값을 모두 포함합니다. 생략한 회원 ID·관심사는 제거됩니다. 전체를 철회할 때는 consent.grants에 빈 배열 []을 입력하고, 로그아웃한 경우에는 identity를 생략합니다.

export function updateChoice(
  host: ReturnType<typeof window.EasterAdH5.initializePlatform>,
  context: Parameters<typeof host.updatePublisherContext>[0]
) {
  return host.updatePublisherContext(context);
}

await updateChoice(host, context)가 완료된 뒤 새 게임 액션을 실행합니다.
호출이 실패하면 광고 없이 게임을 진행하고 호스트 다시 연결하기 절차를 확인합니다.