Topics API: 테스트 및 분석 도구

Chrome에서 사용할 수 있는 도구에 관해 알아보고 Topics API 정보를 확인하고, 주제가 할당되는 방식을 파악하고, 구현을 디버그하세요.

Topics API 정보 보기

Topics API를 사용 설정하면 데스크톱의 Chrome에서 chrome://topics-internals 페이지를 사용할 수 있습니다. 현재 사용자의 주제, 호스트 이름에서 추론된 주제, API 구현에 관한 기술 정보가 표시됩니다. Google에서는 개발자 의견을 바탕으로 페이지 디자인을 반복하고 개선하고 있습니다. 의견을 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개의 주제를 제공할 만큼 방문 기록이 충분하지 않으므로 나머지 3개 주제는 임의로 선택되었습니다.

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

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

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

<ph type="x-smartling-placeholder">
</ph> 분류 패널이 선택된 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일)로 설정되었습니다.

<ph type="x-smartling-placeholder">
</ph> 기능 및 매개변수 패널이 선택된 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.