집계 서비스

집계 서비스는 집계 가능한 원시 보고서에서 상세한 전환 데이터 및 도달범위 측정의 요약 보고서를 생성합니다. 광고 기술은 클라이언트 측의 두 가지 주요 집계 진입점인 Attribution Reporting API와 Private Aggregation API를 사용하여 보고서를 집계 서비스로 전달하고 응답으로 요약 보고서를 수신할 수 있습니다.

이 페이지에서는 광고 기술에 숙련된 사용자를 대상으로 다음을 다룹니다.

• 구현 상태
• 주요 용어 및 개념
• 집계 사용 사례
• 엔드 투 엔드 흐름
• 집계 가능한 보고서 일괄 처리
• 클라우드 구성요소

구현 상태

• 집계 서비스가 정식 버전으로 전환되었습니다.
• Aggregation Service는 Protected Audience API 및 Shared Storage API의 Attribution Reporting API 및 Private Aggregation API와 함께 사용할 수 있습니다.

가용성

Proposal	Status
Cross Cloud Privacy Budget Service Explainer	Available
Aggregation Service support for Amazon Web Services (AWS) across Attribution Reporting API, Private Aggregation API Explainer	Available
Aggregation Service support for Google Cloud across Attribution Reporting API, Private Aggregation API Explainer	Available
Aggregation Service site enrollment and multi-origin aggregation. Site enrollment includes mapping of a site to cloud accounts (AWS, or GCP). To aggregate multiple origins, they must be of the same site. FAQs on GitHub Site aggregation API documentation	Available
The Aggregation Service's epsilon value will be kept as a range of up to 64, to facilitate experimentation and feedback on different parameters. Submit ARA epsilon feedback. Submit PAA epsilon feedback.	Available. We will provide advanced notice to the ecosystem before the epsilon range values are updated.
More flexible contribution filtering for Aggregation Service queries Explainer	Available
Process for budget recovery post-disasters (errors, misconfigurations, and so on) Explainer	Available Mechanism to review the percentage of shared IDs recovered by an ad tech using budget recovery and suspend future recoveries for excessive recoveries planned for H1 2025
Accenture operating as one of the Coordinators on AWS Developer Blog	Available
Independent party operating as one of the Coordinators on Google Cloud Developer blog	Available
Aggregation Service support for Aggregate Debug Reporting on Attribution Reporting API Explainer	Available

주요 용어 및 개념

워크플로에 집계 서비스를 고려하고 있다면 다음 용어와 개념을 통해 이 새로운 집계 흐름이 팀에 어떤 이점을 제공할 수 있는지 알아보세요.

용어집

집계 가능한 보고서

집계 가능한 보고서는 개별 사용자 기기에서 전송된 암호화된 보고서입니다. 이 보고서에는 교차 사이트 사용자 행동 및 전환에 관한 데이터가 포함됩니다. 전환 (기여 분석 트리거 이벤트라고도 함) 및 관련 측정항목은 광고주 또는 광고 기술에서 정의합니다. 각 보고서는 여러 당사자가 기본 데이터에 액세스하지 못하도록 암호화됩니다.

집계 가능한 보고서 자세히 알아보기

집계 가능한 보고서 회계

할당된 개인 정보 보호 예산을 추적하고 '중복 없음' 규칙을 적용하는 두 코디네이터에 모두 있는 분산 원장입니다. 이는 개인 정보 보호 메커니즘으로, 조정자 내에 위치하고 실행되며 할당된 개인 정보 보호 예산을 초과하는 보고서가 집계 서비스를 통과하지 않도록 합니다.

일괄 처리 전략이 집계 가능한 보고서와 어떤 관련이 있는지 자세히 알아보기

집계 가능한 보고서 회계 예산

개별 보고서가 두 번 이상 처리되지 않도록 하는 예산 참조입니다.

Aggregation Service

집계 가능한 보고서를 처리하여 요약 보고서를 생성하는 광고 기술 운영 서비스입니다.

설명 및 전체 약관 목록에서 집계 서비스의 배경에 대해 자세히 알아보세요.

증명

일반적으로 암호화 해시 또는 서명을 사용하여 소프트웨어 ID를 인증하는 메커니즘입니다. 집계 서비스 제안서의 경우 증명은 광고 기술 운영 집계 서비스에서 실행되는 코드를 오픈소스 코드와 일치시킵니다.

증명에 관해 자세히 알아보기

기여도 결합

코디네이터

키 관리 및 집계 가능한 보고서 회계를 담당하는 법인입니다. 조정자는 승인된 집계 서비스 구성의 해시 목록을 유지하고 복호화 키에 대한 액세스를 구성합니다.

노이즈 및 확장

개인 정보를 보호하고 최종 보고서에서 익명화된 측정 정보를 제공하기 위해 집계 프로세스 중에 요약 보고서에 추가되는 통계적 노이즈입니다.

라플라스 분포에서 가져온 덧셈 노이즈 메커니즘에 대해 자세히 알아보세요.

신고 출처

집계 가능한 보고서를 수신하는 항목입니다. 즉, 개발자 또는 Attribution Reporting API를 호출한 광고 기술입니다. 집계 가능한 보고서는 사용자 기기에서 보고 출처와 연결된 잘 알려진 URL로 전송됩니다. 보고 출처는 등록 중에 지정됩니다.

공유 ID

A computed value that consists of shared_info, reporting_origin, destination_site (for Attribution Reporting API only), source_registration-time (for Attribution Reporting API only), scheduled_report_time, and version.

Multiple reports that share the same attributes in the shared_info field should have the same shared ID. Shared IDs play an important role within Aggregatable Report Accounting.

Read more about Trusted Servers.

요약 보고서

Attribution Reporting API 및 Private Aggregation API 보고서 유형입니다. 요약 보고서에는 집계된 사용자 데이터가 포함되며 노이즈가 추가된 세부 전환 데이터가 포함될 수 있습니다. 요약 보고서는 집계 보고서로 구성됩니다. 특히 전환 가치와 같은 일부 사용 사례의 경우 이벤트 수준 보고보다 더 유연하고 더 풍부한 데이터 모델을 제공합니다.

신뢰할 수 있는 실행 환경 (TEE)

외부 당사자가 노출될 위험 없이 머신에서 실행 중인 소프트웨어의 정확한 버전을 확인할 수 있는 컴퓨터 하드웨어 및 소프트웨어의 보안 구성입니다. TEE를 사용하면 외부 사용자가 소프트웨어가 소프트웨어 제조업체가 주장하는 것과 정확히 일치하는지 확인할 수 있습니다.

개인 정보 보호 샌드박스 제안에 사용되는 TEE에 관해 자세히 알아보려면 Protected Audience API 서비스 설명 및 집계 서비스 설명을 참고하세요.

집계 사용 사례

광고 측정 및 해당 측정 클라이언트 라이브러리의 다음 개발자 여정을 고려해 보세요.

사용 사례	진입점	설명
입찰 최적화	Attribution Reporting API (Chrome 및 Android)	집계된 보고서를 사용하여 입찰가 최적화를 위해 전환 신호를 처리합니다.
교차 플랫폼 측정	Attribution Reporting API (Chrome 및 Android)	교차 웹 및 앱 측정 기능을 사용하여 Chrome과 Android 전반의 실적을 파악하세요.
전환 보고	Attribution Reporting API (Chrome 및 Android)	고객의 캠페인 요구사항에 맞게 집계된 전환 보고를 만듭니다 (CTC 및 VTC 포함).
캠페인 도달범위 측정	Shared Storage API 및 Private Aggregation API (Chrome)	교차 사이트 광고 조회 변수를 사용하여 캠페인 도달범위를 측정합니다.
인구통계 보고	Shared Storage API 및 Private Aggregation API (Chrome)	교차 사이트 광고 조회수 및 인구통계 정보를 사용하여 인구통계별 도달범위를 측정합니다.
전환 경로 분석	Shared Storage API 및 Private Aggregation API (Chrome)	집계된 전환 경로 분석을 실행하기 위해 교차 사이트 광고 조회 및 전환 변수를 저장합니다.
브랜드 및 전환 상승도	Shared Storage API 및 Private Aggregation API (Chrome)	브랜드 효과 및 증분을 측정하기 위한 테스트/대조군 및 폴링 정보 보고
입찰 디버깅	Protected Audience API 및 Private Aggregation API (Chrome)	집계된 보고서를 디버깅에 사용합니다.
입찰가 분포	Protected Audience API 및 Private Aggregation API (Chrome)	집계된 보고서를 사용하여 입찰의 입찰가 값 분포를 파악합니다.

엔드 투 엔드 흐름

다음 다이어그램은 집계 서비스가 작동하는 모습을 보여줍니다. 웹 및 휴대기기에서 보고서가 수신된 시점부터 집계 서비스에서 요약 보고서가 생성될 때까지의 엔드 투 엔드 흐름에 중점을 둡니다.

엔드 투 엔드 집계 서비스 흐름

1. 공개 키를 가져와 암호화된 보고서를 생성합니다.
2. 암호화된 집계 가능한 보고서는 수집, 변환, 일괄 처리되도록 광고 기술 서버로 전송됩니다.
3. 광고 기술 서버는 보고서 (avro 형식)를 일괄 처리하여 집계 서비스로 전송합니다. (이 단계는 완료해야 합니다.)
4. 집계 작업자는 집계된 보고서를 가져와 복호화합니다.
5. 집계 작업자는 코디네이터에서 복호화 키를 가져옵니다.
6. 집계 작업자는 집계 및 노이즈 추가를 위해 보고서를 복호화합니다.
7. 집계 가능한 보고서 회계 서비스는 지정된 집계 가능한 보고서의 요약 보고서를 생성하기에 충분한 개인 정보 보호 예산이 있는지 확인합니다.
8. 최종 요약 보고서를 제출합니다.

다이어그램은 집계 서비스와 주요 클라이언트 측정 API인 Attribution Reporting API, Private Aggregation API, 조정자와의 대략적인 관계를 보여줍니다.

흐름은 Attribution Reporting API 또는 Private Aggregation API와 같은 측정 API로 시작하여 여러 브라우저 인스턴스에서 보고서를 생성합니다. Chrome은 보고서를 광고 기술 보고 출처로 전송하기 전에 보고서를 암호화하기 위해 코디네이터의 키 호스팅 서비스에서 공개 키를 가져옵니다. 공개 키는 7일마다 순환됩니다.

광고 기술 보고 출처는 일괄 처리 전략에 설명된 대로 수신 보고서를 수집하여 avro 형식으로 변환하고 집계 서비스로 전송하도록 구성해야 합니다.

일괄 처리가 준비되면 집계 서비스에 일괄 요청을 전송합니다. 집계 서비스는 키 호스팅 서비스에서 복호화 키를 가져오고, 보고서를 복호화하고, 집계 및 노이즈를 제거하여 요약 보고서를 만듭니다. 이는 개인 정보 보호 예산이 충분하여 이를 만들 수 있는지에 따라 달라집니다.

보고서가 수집되는 광고 기술 보고 출처 엔드포인트를 호스팅하고 집계 서비스는 광고 기술 클라우드에 배포됩니다.

집계 가능한 보고서 일괄 처리

지정된 보고 출처 서버의 도움이 없다면 보고 흐름이 완료되지 않습니다. 등록 과정에서 제출한 출처입니다. 보고 출처는 수신하는 집계 가능 보고서를 수집, 변환, 일괄 처리하고 Google Cloud 또는 Amazon Web Services의 집계 서비스로 전송할 수 있도록 준비합니다. 집계 가능한 보고서를 준비하는 방법을 자세히 알아보세요.

이제 일반적인 개념을 알았으므로 집계 서비스에 배포된 구성요소를 자세히 살펴보겠습니다.

Cloud 구성요소

집계 서비스는 여러 클라우드 서비스 구성요소로 구성됩니다. 제공된 Terraform 스크립트를 사용하여 필요한 모든 클라우드 서비스 구성요소를 프로비저닝하고 구성합니다.

집계 서비스 클라우드 구성요소

프런트엔드 서비스

관리형 클라우드 서비스: Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)

프런트엔드 서비스는 작업 생성 및 작업 상태 검색을 위한 Aggregation API 호출의 기본 진입점인 서버리스 게이트웨이입니다. 집계 서비스 사용자의 요청을 수신하고, 입력 매개변수를 검증하고, 집계 작업 예약 프로세스를 시작합니다.

프런트엔드 서비스에는 다음과 같은 두 가지 API가 있습니다.

엔드포인트	설명
createJob	이 API는 집계 서비스 작업을 트리거합니다. 작업을 트리거하려면 작업 ID, 입력 저장소 세부정보, 출력 저장소 세부정보, 보고 출처 등의 정보가 필요합니다.
getJob	이 API는 지정된 작업 ID가 있는 작업의 상태를 반환합니다. '수신됨', '진행 중', '완료됨'과 같은 작업 상태에 관한 정보를 제공합니다. 작업이 완료되면 작업 실행 중에 발생한 오류 메시지를 포함하여 작업 결과도 반환합니다.

Aggregation Service API 문서를 확인하세요.

작업 대기열

관리형 클라우드 서비스: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)

작업 큐는 집계 서비스의 작업 요청이 포함된 메시지 큐입니다. 프런트엔드 서비스는 작업 요청을 큐에 삽입하고, 큐에 있는 작업 요청은 이를 처리하는 집계 작업자에 의해 사용됩니다.

클라우드 스토리지

관리형 클라우드 서비스: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services)

집계 서비스에서 사용하는 입력 및 출력 파일(예: 암호화된 보고서 파일, 출력 요약 보고서)은 Cloud Storage에 보관됩니다.

작업 메타데이터 데이터베이스

관리형 클라우드 서비스: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)

작업 메타데이터 데이터베이스는 집계 작업의 상태를 저장하고 추적하는 데 사용됩니다. 생성 시간, 요청 시간, 업데이트 시간과 같은 메타데이터와 수신됨, 진행 중, 완료됨과 같은 상태를 기록합니다. 집계 작업자는 작업이 진행됨에 따라 작업 메타데이터 데이터베이스를 업데이트합니다.

집계 작업자

관리형 클라우드 서비스: 기밀 공간이 있는 Compute Engine (Google Cloud) / Nitro Enclave가 있는 Amazon Web Services EC2 (Amazon Web Services)

집계 작업자는 작업 대기열에서 작업 요청을 처리하고, 코디네이터의 키 생성 및 배포 서비스 (KGDS)에서 가져온 키를 사용하여 암호화된 입력을 복호화합니다. 집계 작업자는 작업 처리 지연 시간을 최소화하기 위해 8시간 동안 복호화 키를 캐시하고 처리하는 작업 전반에서 이를 사용합니다.

집계 작업자는 신뢰할 수 있는 실행 환경 (TEE) 인스턴스 내에서 작동합니다. 작업자는 한 번에 하나의 작업만 처리합니다. 자동 확장 구성을 설정하여 여러 작업자가 작업을 동시에 처리하도록 구성할 수 있습니다. 자동 확장이 사용되면 작업 큐의 메시지 수에 따라 작업자 수가 동적으로 조정됩니다. Terraform 환경 파일을 통해 자동 확장에 사용할 최소 및 최대 작업자 수를 구성할 수 있습니다. 자동 확장에 관한 자세한 내용은 Amazon Web Services 또는 Google Cloud Terraform 스크립트를 참고하세요.

집계 작업자는 집계 가능한 보고서 회계를 위해 집계 가능한 보고서 회계 서비스를 호출합니다. 이 서비스는 개인 정보 보호 예산 한도가 초과되지 않은 경우에만 작업이 실행되도록 합니다. ('중복 없음' 규칙 참고) 예산을 사용할 수 있으면 노이즈가 있는 집계를 사용하여 요약 보고서가 생성됩니다. 집계 가능한 보고서 회계에 관한 추가 세부정보를 확인하세요.

집계 작업자는 작업 메타데이터 데이터베이스에서 작업 메타데이터를 업데이트합니다. 이 정보에는 작업 반환 코드와 부분 보고서 실패의 경우 보고서 오류 카운터가 포함됩니다. 사용자는 getJob 작업 상태 검색 API를 사용하여 상태를 가져올 수 있습니다.

집계 서비스에 관한 자세한 내용은 이 설명을 참고하세요.

다음 단계

이제 집계 서비스의 주요 기능을 살펴봤으므로 Google Cloud 또는 Amazon Web Services를 통해 집계 서비스의 자체 인스턴스를 배포해 보세요. 시작하기 섹션을 참고하거나 이 링크를 따라 집계 서비스 운영에 대해 자세히 알아보세요.

문제 해결

오류 메시지, 발생한 오류의 원인, 완화 조치의 다음 단계에 관한 자세한 설명은 일반적인 오류 코드 및 완화 조치 문서를 참고하세요.

지원받기 및 의견 보내기

• 제품 관련 질문, 의견, 기능 요청은 GitHub 저장소에서 문제를 만드세요.
• 집계 서비스로 작업을 배포, 유지 관리 또는 실행하는 중에 오류가 발생한 경우 기술 문제 해결 지원을 요청하려면 이 기술 지원 양식을 사용하세요.
• 공개 상태 대시보드에서 알려진 문제를 확인하세요.