집계 서비스

집계 서비스는 집계 가능한 원시 보고서에서 상세한 전환 데이터 및 도달범위 측정의 요약 보고서를 생성합니다. 광고 기술에는 클라이언트 측에서 Attribution Reporting API 또는 Private Aggregation API를 통해 보고서를 집계 서비스로 유입경로하기 위한 두 가지 기본 집계 진입점이 있습니다.

구현 상태

가용성

제안 내용 상태
Attribution Reporting API, Private Aggregation API 전반에서 Amazon Web Services (AWS)에 대한 집계 서비스 지원
설명 자료		 사용 가능
Attribution Reporting API, Private Aggregation API 전반에서 Google Cloud를 위한 집계 서비스 지원
설명		 사용 가능
집계 서비스 사이트 등록 및 다중 출처 집계 사이트 등록에는 사이트를 클라우드 계정 (AWS 또는 GCP)에 매핑하는 작업이 포함됩니다. 여러 출처를 집계하려면 출처가 동일한 사이트에 있어야 합니다.
GitHub FAQ
사이트 집계 API 문서 		사용 가능
다양한 매개변수에 대한 실험과 의견을 용이하게 하기 위해 집계 서비스의 epsilon 값이 최대 64로 유지됩니다.
ARA 엡실론 의견 제출
PAA 엡실론 의견 제출		 사용 가능 에피론 범위 값이 업데이트되기 전에 생태계에 사전 알림이 제공됩니다.
집계 서비스 쿼리에 대한 더 유연한 참여 필터링
설명		 사용 가능
재해(오류, 구성 오류 등) 후 예산 복구 절차
설명		 사용 가능
예산 복구를 사용하여 광고 기술에서 복구한 공유 ID의 비율을 검토하고 2025년 상반기로 계획된 과도한 복구에 대해 향후 복구를 정지하는 메커니즘
AWS의 코디네이터 중 하나로 활동하는 Accenture
개발자 블로그		 사용 가능
Google Cloud에서 조정자 중 한 명으로 운영되는 독립 당사자
개발자 블로그		 사용 가능
Attribution Reporting API의 집계 디버그 보고를 위한 집계 서비스 지원
설명		 사용 가능

주요 용어 및 개념

광고 기술 워크플로에서 집계 서비스를 사용하려는 경우 다음 용어와 개념을 통해 이 새로운 집계 흐름이 팀에 어떤 도움을 줄 수 있는지 알아보세요.

术语 说明
汇总服务 由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。
可汇总的报告

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

详细了解可汇总的报告。
可汇总报告的会计核算 位于两个协调器中的分布式账本，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是一种隐私保护机制，位于协调者中并在其中运行，可确保通过汇总服务传递的报告不会超出分配的隐私预算。 详细了解批处理策略与可汇总报告的关系。
可汇总报告的会计核算预算 对预算的引用，用于确保报告不会被处理多次。
可信执行环境 (TEE)

신뢰할 수 있는 실행 환경은 컴퓨터 하드웨어와 소프트웨어의 특수한 구성으로, 외부 IP 주소를 소프트웨어의 정확한 버전을 확인하도록 할 것입니다. TEE를 사용하면 외부 사용자가 소프트웨어가 소프트웨어 제조업체가 주장하는 것과 정확히 일치하는지 확인할 수 있습니다.

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

코디네이터는 키 관리 및 집계 가능한 보고서 회계를 담당하는 주체입니다. 코디네이터는 승인된 집계 서비스 구성의 해시 목록을 유지관리하고 복호화 키에 대한 액세스를 구성합니다.
共享 ID 计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。 这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。 详细了解可信服务器。
汇总报告

摘要报告是一种 Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，摘要报告具有更大的灵活性和数据模型，尤其是对于某些应用场景（例如转化价值）。
举报来源

보고 출처는 집계 가능한 보고서를 수신하는 항목 즉, 광고 기술 Attribution Reporting API를 호출했습니다 집계 가능한 보고서는 사용자 기기에서 보고 출처와 연결된 잘 알려진 URL로 전송됩니다. 등록 시 이 보고 출처를 지정해야 합니다.
贡献债券 可汇总的报告可以包含任意数量的计数器增量。例如，报告中可能包含用户在广告客户网站上查看过的商品数量。与单个来源事件相关的所有可汇总报告中的增量之和不得超过给定限制“L1=2^16”。 如需了解详情，请参阅可汇总报告说明。
噪声和缩放 在汇总过程中，系统会向摘要报告添加一定量的统计噪声，这也有助于保护隐私并确保最终报告提供匿名化效果衡量信息。详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。
证明

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

详细了解证明。

설명 및 전체 용어 목록에서 집계 서비스에 관한 배경 정보를 자세히 알아보세요.

집계 사용 사례

광고 측정 및 해당하는 측정 클라이언트 라이브러리에 관한 다음 개발자 여정을 고려하세요.

사용 사례 진입점 설명
입찰 최적화 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 서비스: Cloud Function(Google Cloud)/API Gateway(Amazon Web Services)

프런트엔드 서비스는 작업 생성 및 작업 상태 검색을 위한 집계 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) 클라우드 스토리지는 집계 서비스에서 사용하는 입력 및 출력 파일(예: 암호화된 보고서 파일, 출력 요약 보고서 등)을 저장하는 데 사용됩니다.

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

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

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

집계 작업자

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

집계 작업자는 작업 큐의 작업 요청으로 시작된 작업 요청을 처리하여 코디네이터의 키 생성 및 배포 서비스 (KGDS)에서 가져온 키를 사용하여 암호화된 입력을 복호화합니다. 작업 처리 지연 시간을 최소화하기 위해 복호화 키는 8시간 동안 집계 작업자에 캐시되며, 해당 작업자 인스턴스가 처리하는 모든 작업에서 사용할 수 있습니다.

작업자는 TEE (신뢰할 수 있는 실행 환경) 인스턴스 내에서 작동합니다. 각 작업자는 한 번에 하나의 작업만 처리합니다. 광고 기술은 자동 확장 구성을 설정하여 여러 작업자를 구성하여 동시에 작업을 처리할 수 있습니다. 자동 확장을 통해 작업자 수는 작업 큐에 남아 있는 메시지 수에 따라 동적으로 조정됩니다. 자동 확장의 최소 및 최대 작업자 수는 Terraform 환경 파일을 통해 구성할 수 있습니다. 자동 확장에 대한 자세한 내용은 다음 terraform 스크립트에서 확인할 수 있습니다. [Amazon Web Services / Google Cloud]

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

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

집계 서비스에 대한 자세한 설명은 설명 자료를 참고하세요.

다음 단계

집계 서비스의 주요 내용을 살펴보았으므로 이제 Google Cloud 또는 Amazon Web Services를 통해 자체 집계 서비스 인스턴스를 배포할 차례입니다. 시작하기 섹션을 확인하세요. 배포된 집계 서비스를 운영하는 방법에 대한 자세한 내용은 이 링크를 통해 집계 서비스 운영에 대해 자세히 알아보세요.

문제 해결

오류 메시지에 대한 자세한 설명, 오류의 원인 및 문제 해결을 위한 다음 단계는 일반적인 오류 코드 및 완화 방법을 참고하세요.

지원받기 및 의견 보내기