Topics API로 웹 애플리케이션을 사용, 테스트, 개발할 수 있도록 환경을 준비합니다.
로컬에서 빌드 및 테스트
이 섹션에서는 개별 개발자가 Topics API를 사용해 볼 수 있도록 로컬 환경을 설정하는 방법을 설명합니다. 구현을 시작하기 전에 데모를 살펴보고 주제가 어떻게 작동하는지 이해하는 것이 좋습니다.
브라우저에서 Topics 사용 설정하기
로컬 테스트를 위해 자체 Chrome 인스턴스에서 Topics API를 사용 설정하려면 다음 두 가지 옵션이 있습니다.
chrome://settings/adPrivacy에서 모든 광고 개인 정보 보호 API를 사용 설정합니다.- (권장) 필요에 따라 구성하기 위해 Topics API 관련 매개변수를 사용하여 Chromium 플래그와 함께 명령줄에서 Chrome을 실행합니다. 명령줄에서 Chrome을 실행하면 주제 기능을 더 세밀하게 제어할 수 있습니다. 예를 들어 주제 에포크 (API가 사용자 관심분야를 계산하는 데 사용하는 기간)를 설정하고 필요에 따라 API의 동작을 구성할 수 있습니다.
주요 권장사항
- 플래그를 사용하여 새 프로세스를 시작하기 전에 모든 Chrome 프로세스를 닫고 중지해야 합니다.
chrome://settings/adPrivacy에서 모든 광고 개인 정보 보호 API가 사용 설정되어 있는지 확인합니다.- API가 예상대로 작동하지 않으면 문제 해결 도움말을 참고하세요.
- 궁금한 점이 있으면 설명서의 GitHub 문제를 확인하세요.
Chrome 플래그로 Topics API 제어하기
Chrome 플래그는 Topics API의 동작을 수정할 수 있습니다. 테스트를 용이하게 하기 위해 지정된 매개변수를 사용하여 명령줄에서 Chrome을 실행합니다. 예를 들어 헤더 데모에서는 다음 플래그를 사용하는 것이 좋습니다.
--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting
다음 표에서는 각 매개변수, 기본값, 용도를 설명합니다.
| 플래그 이름 | 기본값 | 설명 |
|---|---|---|
BrowsingTopics |
사용 설정됨 | Topics API가 사용 설정되어 있는지 여부입니다. |
PrivacySandboxAdsAPIsOverride |
사용 설정됨 | 광고 API(Attribution Reporting, Protected Audience, Topics, Fenced Frames)를 사용 설정합니다. |
PrivacySandboxSettings4 |
사용 중지됨 | 개인 정보 보호 샌드박스 UI 설정의 네 번째 버전을 사용 설정합니다. |
OverridePrivacySandboxSettingsLocalTesting |
사용 설정됨 | 사용 설정된 경우 브라우저에서 개인 정보 보호 샌드박스 기능을 사용 설정하기 위해 기본 설정을 사용 설정할 필요가 없습니다. |
BrowsingTopicsBypassIPIsPubliclyRoutableCheck |
사용 중지됨 | 사용 설정된 경우 주제 계산에 페이지를 포함할 자격을 결정할 때 IP 주소가 공개적으로 라우팅 가능한지 확인하는 작업이 우회됩니다. |
BrowsingTopics:number_of_epochs_to_expose |
3 | 요청 컨텍스트에 제공할 주제를 계산할 시작 에포크 수입니다. 브라우저는 내부적으로 최대 N+1개의 에포크를 유지합니다. |
BrowsingTopics:time_period_per_epoch |
7d-0h-0m-0s | 각 에포크의 지속 시간입니다. 디버깅의 경우 기본값인 7일 대신 15초로 설정하는 것이 유용할 수 있습니다. |
BrowsingTopics:number_of_top_topics_per_epoch |
5 | 에포크당 계산된 주제 수입니다. |
BrowsingTopics:use_random_topic_probability_percent |
5 | 에포크 내 개별 주제가 전체 주제 분류에서 무작위로 반환될 확률입니다. 무작위성은 에포크와 사이트에 고정됩니다. |
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering |
3 | 호출 컨텍스트의 주제를 필터링하는 데 사용될 API 사용 데이터 (즉, 주제 관찰)의 에포크 수입니다. |
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic |
1000 | 각 상위 주제에 대해 유지할 관찰 대상 컨텍스트 도메인의 최대 수입니다. 사용 중인 메모리를 제한하는 것이 목적입니다. |
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch |
100000 | API 사용 컨텍스트의 각 쿼리에 대해 데이터베이스에서 가져올 수 있는 최대 항목 수입니다. 이 쿼리는 주제 계산 시간에 에포크당 한 번 발생합니다. 최대 메모리 사용량을 제한하는 것이 목적입니다. |
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load |
30 | 페이지 로드당 저장할 수 있는 API 사용 컨텍스트 도메인의 최대 수입니다. |
BrowsingTopics:config_version |
1 | Topics API 구성 매개변수를 인코딩합니다. 각 버전 번호는 하나의 구성 세트에만 매핑되어야 합니다. config_version를 업데이트하지 않고 구성 매개변수를 업데이트하는 것은 일반적으로 로컬 테스트에 적합하지만, 경우에 따라 브라우저가 일관되지 않은 상태가 되어 브라우저가 비정상 종료될 수 있습니다(예: number_of_top_topics_per_epoch 업데이트). |
BrowsingTopics:taxonomy_version |
1 | API에서 사용되는 분류 버전입니다. |
구현을 시작하기 전에
구현을 시작하기 전에 다음 리소스를 검토하여 Topics API를 숙지하는 것이 좋습니다.
- 개발자 문서를 검토합니다.
- Topics API의 목적과 관심 기반 광고에서의 역할 이해
- 웹에서 Topics가 작동하는 방식을 이해합니다.
- 데모를 사용해 보고 Topics 데모, Colab, 도구 안내 동영상을 시청하세요.
- 데모를 포크하고 자체 사이트에서 실행합니다.
- API 설명을 읽고 자세한 내용을 확인하세요.
- 점점 더 많은 사용자가 서드 파티 쿠키를 사용할 수 없게 되는 미래에 광고 관련성 지원에서 API의 역할을 이해합니다.
- API의 상태 변경 알림을 받으려면 개발자 메일링 리스트에 가입하고 최신 주제 업데이트를 확인하세요.
- GitHub 문제 또는 W3C 통화에 참여하세요.
- 낯선 용어가 나오면 개인 정보 보호 샌드박스 용어집을 검토하세요.
- Chrome 플래그와 같은 Chrome 개념에 관한 자세한 내용은 goo.gle/cc에서 제공되는 짧은 동영상과 도움말을 참고하세요.
