Topics API: 테스트 및 분석 도구

Chrome에서 Topics API 정보를 확인하는 데 사용할 수 있는 도구에 대해 알아보고 주제가 할당되는 방식을 이해합니다.

Topics API 정보 보기

Topics API를 사용 설정하면 데스크톱 Chrome에서 chrome://topics-internals 페이지를 사용할 수 있습니다. 현재 사용자의 주제, 호스트 이름에서 추론된 주제, API 구현에 관한 기술 정보가 표시됩니다. 개발자 의견을 바탕으로 페이지 디자인을 반복적으로 개선하고 있습니다. 의견을 Chromium 버그로 제출하여 Topics API를 개선할 수 있습니다.

브라우저에서 관찰된 주제 보기

사용자는 chrome://topics-internals를 확인하여 현재 및 이전 에포크 동안 브라우저에서 관찰된 주제에 관한 정보를 볼 수 있습니다.

Topics State 패널이 선택된 chrome://topics-internals 페이지
chrome://topics-internals 페이지 주제 상태 패널에는 주제 ID, 무작위 및 실제 주제 할당, 분류 및 모델 버전이 표시됩니다.

이 스크린샷에는 최근에 방문한 사이트에 topics-demo-cats.glitch.me 및 cats-cats-cats-cats.glitch.me가 포함되어 있음을 보여줍니다. 이렇게 하면 Topics API가 Pets 및 Cats를 현재 에포크의 상위 주제 2개로 선택합니다. 나머지 세 가지 주제는 주제를 관찰하는 사이트에서 5가지 주제를 제공하기에 충분한 방문 기록이 없으므로 무작위로 선택되었습니다.

Observed-by context domains (hashed)(관찰된 컨텍스트 도메인(해싱됨)) 열에는 주제가 관찰된 호스트 이름의 해싱된 값이 제공됩니다.

호스트 이름에 대해 추론된 주제 보기

chrome://topics-internals에서 하나 이상의 호스트 이름에 대해 Topics 분류기 모델에서 추론된 주제를 볼 수도 있습니다.

분류 패널이 선택된 chrome://topics-internals 페이지
chrome://topics-internals 페이지 분류기 패널에는 선택한 주제, 방문한 호스트, 모델 버전 및 경로가 표시됩니다.

현재 Topics API 구현은 URL의 다른 부분이 아닌 호스트 이름에서만 주제를 추론합니다.

프로토콜이나 경로 없이 호스트 이름만 사용하여 chrome://topics-internals 분류기에서 추론된 주제를 확인합니다. 호스트 필드에 '/'을 포함하려고 하면 chrome://topics-internals에 오류가 표시됩니다.

Topics API 정보 보기

chrome://topics-internals에서 분류 버전 및 시대 기간과 같은 Topics API 구현 및 설정에 관한 정보를 확인할 수 있습니다. 이러한 값은 명령줄에서 설정된 API 또는 매개변수의 기본 설정을 반영합니다. 명령줄 플래그가 예상대로 작동하는지 확인하는 데 도움이 될 수 있습니다.

이 예에서는 time_period_per_epoch가 15초로 설정되어 있습니다 (기본값은 7일).

기능 및 매개변수 패널이 선택된 chrome://topics-internals 페이지
chrome://topics-internals 기능 및 매개변수 패널에는 사용 설정된 기능, 에포크당 시간, 주제를 계산하는 데 사용할 에포크 수, 분류 버전, 기타 설정이 표시됩니다.

스크린샷에 표시된 매개변수는 명령줄에서 Chrome을 실행할 때 설정할 수 있는 플래그에 해당합니다. 전용 설정 섹션에서 Chrome 플래그로 Topics API를 제어하는 방법을 자세히 알아보세요.

--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Colab

Colab을 실행하여 Chrome에서 호스트 이름에서 주제를 추론하는 데 사용하는 TensorFlow Lite 모델을 로드하는 방법을 알아보세요. Colab 설명 또는 워크스루 동영상에서 안내를 확인하세요. 이 colab에서는 이전 분류 버전을 사용합니다.

prebid.js가 있는 웹사이트에서 Topics API 사용

Prebid 7 출시에서 언급했듯이 커뮤니티는 새 모듈을 사용하여 Topics API와의 통합을 적극적으로 개발했습니다. 이 모듈은 2022년 12월에 병합되었습니다. Prebid의 Topics API 모듈 문서를 읽어보세요. 통합에 관한 자세한 내용은 제공하는 표준 채널을 통해 Prebid.js에 문의하세요.

Next steps

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.
Check out our resources for troubleshooting, technical support, filing bugs and asking questions.

See also

Check out our resources to better understand the Topics API on the Web.