Topics API를 사용하여 웹 애플리케이션의 사용, 테스트, 개발을 위한 환경을 준비하세요.
로컬에서 빌드 및 테스트
이 섹션에서는 Topics API를 개별 개발자로 사용해 볼 수 있도록 로컬 환경을 설정하는 방법을 설명합니다. Topics를 실제로 사용하기 전에 데모를 살펴보고 Topics의 작동 방식을 이해하는 것이 좋습니다.
브라우저에서 Topics 사용 설정
로컬 테스트를 위해 자체 Chrome 인스턴스에서 Topics API를 사용 설정하는 방법에는 두 가지가 있습니다.
chrome://settings/adPrivacy에서 모든 광고 개인 정보 보호 API를 사용 설정합니다.- (권장) Topics API 관련 매개변수를 사용하여 Chromium 플래그로 명령줄에서 Chrome을 실행하여 필요에 따라 구성합니다. 명령줄에서 Chrome을 실행하면 Topics 기능을 더 세밀하게 제어할 수 있습니다. 예를 들어 Topics 에포크 (API가 사용자 관심분야를 계산하는 데 사용하는 기간)를 설정하고 필요에 따라 API의 동작을 구성할 수 있습니다.
주요 권장사항
- 플래그를 사용하여 새 프로세스를 시작하기 전에 모든 Chrome 프로세스를 닫고 중지해야 합니다.
chrome://settings/adPrivacy아래에서 모든 광고 개인 정보 보호 API가 사용 설정되어 있는지 확인합니다.- API가 예상대로 작동하지 않으면 문제 해결 도움말을 참고하세요.
- 궁금한 점이 있으면 설명 자료의 GitHub 문제를 확인하세요.
Chrome 플래그로 Topics API 제어
Chrome 플래그는 Topics API의 동작을 수정할 수 있습니다. 테스트를 용이하게 하기 위해 지정된 매개변수를 사용하여 명령줄에서 Chrome을 실행합니다. 예를 들어 headers demo에서는 다음 플래그 사용을 권장합니다.
--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 | 각 인기 주제에 대해 유지할 최대 observed-by 컨텍스트 도메인 수입니다. 사용 중인 메모리를 제한하기 위한 것입니다. |
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에 익숙해지는 것이 좋습니다.
- 개발자 문서 검토:
<ph type="x-smartling-placeholder">
- </ph>
- Topics API의 목적 및 관심 기반 광고에서의 역할 이해
- 웹에서 Topics가 작동하는 방식을 이해합니다.
- 데모를 사용해 보고 주제 데모, Colab, 도구 워크스루 동영상을 시청하세요.
- 데모를 포크하여 내 사이트에서 실행하세요.
- 자세한 내용은 API 설명서를 참고하세요.
- 점점 더 많은 사용자에게 서드 파티 쿠키를 사용할 수 없는 미래에 광고 관련성 지원에서 API가 어떤 역할을 하는지 이해합니다.
- API의 상태 변경에 관한 알림을 받으려면 개발자용 메일링 리스트에 가입하고 최신 Topics 업데이트를 기대해 주세요.
- GitHub 문제 또는 W3C 호출에 관한 대화에 참여하세요.
- 익숙하지 않은 용어가 나오면 개인 정보 보호 샌드박스 용어집을 검토하세요.
- Chrome 플래그와 같은 Chrome 개념에 관한 자세한 내용은 goo.gle/cc에서 제공되는 짧은 동영상과 도움말을 참고하세요.
