이 페이지에서는 Topics API를 사용하여 프로덕션용 구현을 빌드, 테스트, 확장하는 방법을 다룹니다.
Topics 백엔드 구현
백엔드 구현은 브라우저에서 계산된 주제를 사용하는 방법에 따라 달라집니다. 광고 기술 솔루션은 주제를 추가 IBA 신호로 사용하는 것이 좋습니다.
// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
// If the list is not empty, continue
// Use topics as an additional signal
}
Topics를 추가 신호로 사용
주제 데이터는 잠재고객에 관한 추가 신호로 URL, 키워드 또는 기타 메타데이터와 함께 고려할 수 있습니다.
서드 파티 쿠키가 없는 환경에서의 광고 관련성 극대화에 설명된 대로 Topics를 활용하여 관련성 있는 광고를 게재하는 방법에는 여러 가지가 있습니다. 이러한 접근 방식 중 일부는 주제를 사용하여 잠재고객을 구축하는 것을 포함하며, 다른 접근 방식에서는 주제를 다른 신호 중 하나로 사용하여 잠재고객의 추가 관심분야를 추론하거나 입찰 로직을 최적화하는 데 사용될 머신러닝 모델을 학습시키는 것을 제안합니다.
빌드 및 배포
- 프로덕션에서 사용자를 관찰하여 주제를 수집합니다 (예상 구현 시간: 약 1주일).
- HTTP 헤더 또는 iframe 및 JavaScript를 사용하여 Topics를 호출하는 방법을 비롯한 옵션을 알아봅니다.
- Topics API를 호출할 iframe의 도메인을 정의합니다.
- 헤더 데모 또는 JavaScript 데모를 코드 참조로 사용하여 솔루션을 빌드합니다.
- 게시자가 사이트에 삽입하는 코드 (예: 광고 iframe)에 Topics를 통합합니다. 삽입에서 주제를 호출해야 합니다.
- 사용자 주제 관찰을 시작하려면 프로덕션 웹사이트에 최신 버전의 스크립트를 삽입하세요. 월별 방문수가 적은 자체 웹사이트에서 먼저 구현을 테스트하는 것이 좋습니다. 이 단계에서는 새 Topics 기반 솔루션을 5개 이상의 사이트에 삽입하는 것이 좋습니다.
- 이 시점에서 API는 빈 배열을 결과로 반환해야 합니다. 이는 아직 사용자에 대해 관찰된 주제가 없기 때문입니다. 사용자 주제를 가져오기 시작하는 데 최대 3주가 걸릴 수 있습니다.
- 기능 테스트 및 검증을 실행합니다. 솔루션을 수동 또는 자동으로 테스트할 수 있습니다. 예를 들면 다음과 같습니다.
- 플래그를 사용하여 브라우저를 열고 브라우저가 더 빨리 주제를 다시 계산하도록 에포크를 15초로 설정합니다.
- 스크립트를 삽입한 사이트를 방문합니다.
chrome://topics-internals/에서 스크립트에 의해 주제가 관찰되는지 확인합니다.- 예상되는 결과를 확인하세요.
- Topics 데이터를 다른 문맥 신호 (예: URL, 메타데이터 등)와 함께 사용 (예상 시간: 약 3일)
- 프로덕션에서 3주가 지나면 스크립트에서 일부 사용자의 주제를 관찰해야 합니다. 이 시점부터는 주제 데이터를 추가 신호로 사용할 수 있습니다.
- 비어 있지 않은 주제 목록을 수신하기 시작하면 다른 컨텍스트 신호와 함께 백엔드로 전송할 수 있습니다.
타겟 사이트에 배포
스크립트에 Topics 호출을 통합한 후 첫 번째 테스트를 위해 일부 프로덕션 사이트에 삽입해야 합니다. 구현이 예상대로 작동하는지 확인합니다.
타겟 사이트 선택
게시자 사이트에 솔루션을 배포하기 전에 내가 소유한 웹사이트의 제어된 환경에서 테스트하는 것이 좋습니다. 다음과 같이 타겟 웹사이트를 선택하는 것이 좋습니다.
- 사이트의 월간 방문수가 적음 (약 100만 회 미만/월): 먼저 소수의 잠재고객에게 API를 배포해야 합니다.
- 사이트 소유 및 관리: 필요한 경우 복잡한 승인 없이 구현을 빠르게 사용 중지할 수 있습니다.
- 사이트가 비즈니스에 중요하지 않음: 위험이 낮은 타겟 사이트부터 시작합니다.
- 총 5개 이하의 사이트: 지금은 많은 트래픽이나 노출이 필요하지 않습니다.
- 타겟 사이트가 서로 다른 테마를 나타냄: 서로 다른 카테고리를 나타내는 웹사이트를 선택합니다 (예: 스포츠에 관한 웹사이트, 뉴스에 관한 웹사이트, 음식 및 음료에 관한 웹사이트). Chrome의 내부 주제 도구를 사용하여 도메인과 주제 머신러닝 분류기가 도메인을 분류하는 방식을 검증할 수 있습니다.
기능 테스트 및 검증
이 제한된 환경에서 Topics API를 호출하면 다음 결과가 예상됩니다.
- 지난 7일 동안 이 사이트와 호출자에 대해 이 기기의 첫 번째 호출인 경우 주제
[]의 빈 배열입니다. 이 사용자의 관심사를 나타내는 0~3개의 주제 목록입니다. 7일간의 관찰 후 다음을 받게 됩니다.
- 한 주제는 해당 주에 호출자가 주제를 관찰한 페이지의 호스트 이름에서 계산된 사용자의 상위 5개 주제에서 선택됩니다.
이전의 모든 Topics API 호출과 정확히 동일한 API 응답입니다. 동일한 호출자, 사용자, 최상위 사이트의 경우 API는 에포크 전체에 대해 동일한 주제를 반환합니다. 이렇게 하면 사용자의 관심분야가 너무 많이 노출되지 않습니다. GitHub에서 자세히 알아보기
관찰 기간이 4주 지난 후 Topics를 호출하는 경우 세 개의 이전 주제 중 하나를 대체하는 새 주제
지난 3주 이상 사용자의 주제를 관찰하지 않은 경우 Topics API는 빈 배열
[]을 다시 반환합니다.
성능 측정항목을 수집하여 사용자 환경을 평가합니다.
- 크로스 오리진 iframe 내에서 Topics API에 대한 JavaScript 호출의 실행 시간은 향후 성능 분석에 사용하기 위해 측정해야 합니다.
- 주제를 수신한 후 iframe 및
postMessage()주제를 만드는 데 걸리는 시간입니다.
문제 해결은 지원 섹션을 참고하세요.
프로덕션으로 확장
이 시점에서 관리 환경 (소유한 일부 사이트)에서 Topics를 테스트해야 합니다. 모든 것이 예상대로 작동하면 이 구현을 확장할 수 있습니다. 더 많은 타겟 웹사이트에 동일한 코드를 배포합니다. 이를 통해 더 많은 사용자를 관찰하고, 더 많은 주제 데이터를 수집하고, 잠재고객에 대한 이해를 높일 수 있습니다.
프로덕션으로 확장하는 방법을 단계별로 요약하면 다음과 같습니다.
- 더 많은 트래픽에서 Topics API 기반 솔루션을 테스트합니다.
- 방문수가 많은 소유한 사이트에 iframe을 추가하고 아래 안내에 따라 부하 테스트를 실행합니다.
- 게시자 사이트에 솔루션을 배포합니다.
- 자체 테스트 환경에서 솔루션이 올바르게 작동하면 게시자와 협력하여 iframe을 웹사이트에 통합합니다. 예를 들어 iframe을 포함하는 라이브러리를 업데이트해야 할 수 있습니다.
- 주제 데이터 처리 및 사용 (예상 시간: 약 4주)
- 주제 데이터를 다른 데이터와 함께 추가 신호로 통합합니다.
- 실시간 입찰 테스트 파트너를 소싱합니다.
- 주제를 다른 데이터에 추가 신호로 사용하여 유틸리티 테스트를 실행합니다.
부하 테스트
시스템에서 트래픽을 처리할 수 있도록 주제 기반 솔루션을 게시자 사이트에 배포하기 전에 부하 테스트를 실행하는 것이 좋습니다.
- 특히 트래픽이 많은 타겟 사이트를 중심으로 소유한 사이트에 점진적으로 배포합니다.
- 예상 트래픽에 따라 주제 데이터에 대한 부하 테스트를 실행합니다.
- iframe에서 백엔드로 주제 정보를 전송해야 합니다. 이를 통해 Topics API 결과를 추가로 처리하고 이를 사용자에게 더 관련성 있는 광고를 선택하는 데 도움이 되는 추가 신호로 사용할 수 있습니다. 더 많은 사이트에서 삽입을 통합할수록 백엔드에 대한 호출 수가 크게 증가합니다. 백엔드가 iframe에서 발생하는 많은 호출을 처리할 수 있는지 확인합니다.
- 분석을 위해 측정항목 수집 및 로그를 설정합니다.
- Topics API를 배포한 직후 측정항목을 확인하여 심각한 최종 사용자 문제를 감지합니다. 측정항목을 정기적으로 확인하세요.
- 중단이나 예상치 못한 동작이 발생하면 배포를 롤백하고 로그를 분석하여 문제를 파악하고 해결하세요.
참고 항목
웹에서 Topics API를 더 잘 이해하려면 리소스를 확인하세요.
- 주제 데모, 공동작업, 둘러보기 동영상을 확인하세요.
- 개발자가 테스트를 위해 Topics API를 맞춤설정할 수 있는 Chrome 플래그 목록을 참고하세요.
- 사용자와 개발자가 API를 제어하는 방법을 알아보세요.
- 기술 설명 및 지원은 리소스를 확인하세요. 질문하고, 참여하고, 의견을 공유하세요.