기술적 의사 결정권자를 대상으로 한 기여 분석 보고를 위한 연결된 서비스의 개요입니다.
Attribution Reporting API를 사용하면 광고 기술 및 광고주가 광고 클릭 또는 조회가 구매와 같은 전환으로 이어지는 시점을 측정할 수 있습니다. 이 API는 비즈니스 요구사항에 따라 클라이언트 측 통합과 서버 측 통합을 조합하여 사용합니다.
계속하기 전에 기여 분석 보고 개요를 읽어보세요. 이를 통해 API의 목적과 다양한 출력 보고서(이벤트 수준 보고서 및 요약 보고서)의 흐름을 이해할 수 있습니다. 익숙하지 않은 용어가 나오면 개인 정보 보호 샌드박스 용어집을 참고하세요.
이 도움말의 대상
다음과 같은 경우 이 도움말을 읽어보세요.
- 광고 기술 또는 광고주의 기술 의사 결정권자입니다. 운영, DevOps, 데이터 과학, IT, 마케팅 또는 기술 구현 결정을 내리는 다른 역할에서 근무할 수 있습니다. 개인 정보 보호 측정을 위해 API가 어떻게 작동하는지 궁금합니다.
- 이 API 및 집계 서비스 환경으로 실험을 설정할 기술적 실무자 (예: 개발자, 시스템 운영자, 시스템 설계자, 데이터 과학자)입니다.
이 도움말에서는 Attribution Reporting API에서 서비스가 작동하는 방식을 대략적으로 설명합니다. 기술 전문가는 로컬에서 이 API를 실험할 수 있습니다.
개요
Attribution Reporting API는 특정 설정, 클라이언트 측 구성, 서버 배포가 필요한 여러 서비스로 구성됩니다. 필요한 사항을 확인하려면 먼저 다음 단계를 따르세요.
- 디자인 결정 수집할 정보를 정의하고, 특정 캠페인에서 발생할 것으로 예상되는 전환을 파악하고, 수집할 보고서 유형을 결정합니다. 최종 출력은 이벤트 수준 보고서와 요약 보고서라는 두 가지 보고서 유형 중 하나 또는 둘 다입니다.
보고를 지원하기 위해 항상 두 개 (때로는 세 개)의 구성요소가 함께 작동합니다.
- 웹사이트와 브라우저 간의 통신 쿠키 기반 시스템에서는 전환 및 광고 참여에 대한 정보가 나 또는 분석 서비스가 나중에 이러한 이벤트에 참여할 수 있도록 하는 식별자에 연결됩니다. 이 API를 사용하면 브라우저가 분석을 위해 전송되기 전에 개발자의 안내에 따라 전환을 광고 클릭수/조회수와 연결합니다. 따라서 광고 렌더링 코드와 전환 추적은 다음을 충족해야 합니다.
- 어떤 광고 클릭수 또는 노출수에 어떤 전환 기여도를 부여해야 하는지 브라우저에 알려줍니다.
- 최종 보고서에 포함할 다른 데이터를 신호합니다.
- 데이터 수집 사용자의 브라우저에서 생성된 보고서를 수신하려면 수집기 엔드포인트가 필요합니다. 브라우저의 출력은 이벤트 수준 보고서와 집계 가능한 보고서 (요약 보고서를 생성하는 데 사용되며 암호화됨) 중 하나일 수 있습니다.
집계 가능한 보고서를 수집한 경우 세 번째 구성요소가 필요합니다.
- 요약 보고서 생성 집계 가능한 보고서를 일괄 처리하고 집계 서비스를 사용하여 보고서를 처리하여 요약 보고서를 생성합니다.
디자인 결정
기여 분석 보고의 핵심 원칙은 초기 설계 결정입니다. 어떤 카테고리에서 어떤 데이터를 수집하고 해당 데이터를 처리할 빈도를 결정합니다. 출력 보고서는 캠페인 또는 비즈니스에 대한 유용한 정보를 제공합니다.
출력 보고서는 다음과 같습니다.
- 이벤트 수준 보고서: 광고 측의 특정 광고 클릭 또는 조회를 전환 측의 데이터와 연결합니다. 사이트 간 사용자 ID 결합을 제한하여 사용자 개인 정보를 보호하기 위해 전환 측정 데이터는 매우 제한적이며 노이즈가 많습니다 (소수의 경우 실제 보고서 대신 무작위 데이터가 전송됨).
- 요약 보고서는 광고 측의 특정 이벤트와 연결되지 않습니다. 이러한 보고서는 더 자세한 전환 데이터를 제공하고 클릭 및 조회 데이터를 전환 데이터와 결합할 수 있는 유연성을 제공합니다.
보고서 선택에 따라 수집해야 할 데이터가 결정됩니다.
최종 출력을 결정을 내릴 때 사용하는 도구의 입력이라고 생각할 수도 있습니다. 예를 들어 요약 보고서를 생성하여 특정 총 지출 금액을 발생시킨 전환수를 확인하면 다음 광고 캠페인에서 더 높은 총 지출을 발생시키기 위해 타겟팅해야 할 항목을 결정하는 데 도움이 될 수 있습니다.
측정할 항목을 결정한 후 Attribution Reporting API의 클라이언트 측을 설정할 수 있습니다.
웹사이트와 브라우저 간 통신

기여 분석 이벤트 흐름
광고를 게재하는 게시자 사이트를 생각해 보세요. 각 광고주 또는 광고 기술 제공업체는 광고와의 상호작용에 대해 알아보고 올바른 광고에 전환 기여도를 부여하려고 합니다. 보고서 (이벤트 수준 및 집계 가능 보고서 모두)는 다음과 같이 생성됩니다.
게시자 사이트에서 광고 요소 (
<a>
또는<img>
태그)는 특수 속성attributionsrc
로 구성됩니다. 값은 URL입니다(예:https://adtech.example/register-source/ad_id=...
).다음은 클릭 시 소스를 등록하는 링크의 예입니다.
<a href="https://shoes.example/landing" attributionsrc="http://adtech.example/register-source?..." target="_blank"> Click me</a>
다음은 볼 때 소스가 등록되는 이미지의 예입니다.
<img href="https://advertiser.example/landing" attributionsrc="https://adtech.example/register-source?..."/>
또는 HTML 요소 대신 JavaScript 호출을 사용할 수 있습니다.
다음은
window.open()
를 사용하는 JavaScript 예입니다. 특수문자 관련 문제를 방지하기 위해 URL이 URL 인코딩됩니다.const encodedUrl = encodeURIComponent( 'https://adtech.example/attribution_source?ad_id=...'); window.open( "https://shoes.example/landing", "_blank", attributionsrc=${encodedUrl});
- 사용자가 광고를 클릭하거나 조회하면 브라우저는 일반적으로 광고주 또는 광고 기술 제공업체 엔드포인트인
attributionsrc
에GET
요청을 전송합니다. 이 요청을 수신하면 광고주 또는 광고 기술 제공업체는 나중에 이 광고로 인한 전환을 추적할 수 있도록 브라우저에 광고와의 상호작용에 대한 소스 이벤트를 등록하도록 지시합니다. 이를 위해 광고주 또는 광고 기술 제공업체는 응답에 특수 HTTP 헤더를 포함합니다. 소스 이벤트 (광고 클릭 또는 조회)에 관한 정보를 제공하는 맞춤 데이터를 이 헤더에 연결합니다. 이 광고에서 전환이 발생하면 이 맞춤 데이터가 기여 분석 보고서에 표시됩니다.
나중에 사용자가 광고주의 사이트를 방문합니다.
광고주 사이트의 각 관련 페이지(예: 구매 확인 페이지 또는 제품 페이지)에서 전환 픽셀(
<img>
요소) 또는 JavaScript 호출이https://adtech.example/conversion?param1=...¶m2=...
에 요청을 보냅니다.이 URL의 서비스(일반적으로 광고주 또는 광고 기술 제공업체)가 요청을 수신합니다. 이를 전환으로 분류하기로 결정했으므로 브라우저에 전환을 기록하도록 안내해야 합니다. 즉, 기여 분석을 트리거해야 합니다. 이를 위해 광고주 또는 광고 기술 제공업체는 픽셀 요청에 대한 응답에 전환에 관한 맞춤 데이터가 포함된 특수 HTTP 헤더를 포함합니다.
사용자의 로컬 기기에서 브라우저가 이 응답을 수신하고 전환 데이터를 원래 소스 이벤트 (광고 클릭 또는 조회)와 일치시킵니다. 소스를 트리거에 일치시키기에서 자세히 알아보기
브라우저는
attributionsrc
로 전송할 보고서를 예약합니다. 이 보고서에는 다음이 포함됩니다.- 광고 기술 제공업체 또는 광고주가 3단계에서 소스 이벤트에 연결한 맞춤 기여 분석 구성 데이터입니다.
- 6단계에서 설정한 맞춤 전환 데이터입니다.
나중에 브라우저는 지연과 노이즈가 있는 상태로
attributionsrc
에 정의된 엔드포인트로 보고서를 전송합니다. 집계 가능 보고서는 암호화되지만 이벤트 수준 보고서는 암호화되지 않습니다.
기여 분석 트리거 (광고주 웹사이트)
기여 분석 트리거는 브라우저에 전환을 캡처하도록 지시하는 이벤트입니다.
구매와 같이 광고주에게 가장 중요한 전환을 추적하는 것이 좋습니다. 요약 보고서에서 여러 전환 유형과 메타데이터를 캡처할 수 있습니다.
이렇게 하면 이러한 이벤트에 대한 집계 결과가 상세하고 정확합니다.
소스를 트리거에 일치시키기
브라우저가 기여 분석 트리거 응답을 수신하면 브라우저는 로컬 저장소에 액세스하여 기여 분석 트리거의 출처와 해당 페이지 URL의 eTLD+1이 모두 일치하는 소스를 찾습니다.
예를 들어 브라우저가 shoes.example/shoes123
의 adtech.example
에서 기여 분석 트리거를 수신하면 브라우저는 로컬 저장소에서 adtech.example
및 shoes.example
와 모두 일치하는 소스를 찾습니다.
트리거가 특정 소스와 일치하는 시점을 결정하도록 필터 (또는 맞춤 규칙)를 설정할 수 있습니다. 예를 들어 특정 제품 카테고리의 전환만 집계하고 다른 모든 카테고리는 무시하도록 필터를 설정할 수 있습니다. 필터 및 우선순위 모델을 사용하면 더 고급 기여 분석 보고가 가능합니다.
로컬 스토리지에서 기여 분석 소스가 여러 개 발견되면 브라우저는 가장 최근에 저장된 기여 분석 소스를 선택합니다. 기여 분석 소스에 우선순위가 할당된 경우 브라우저에서 우선순위가 가장 높은 소스를 선택합니다.
데이터 수집
이러한 기여 분석 트리거는 상응하는 소스와 일치하며 브라우저에서 광고 기술 소유 서버(수집 엔드포인트 또는 수집 서비스라고도 함)의 보고 엔드포인트로 보고서로 전송됩니다. 이러한 보고서는 이벤트 수준 보고서 또는 집계 가능한 보고서일 수 있습니다.
집계 가능한 보고서는 요약 보고서를 생성하는 데 사용됩니다. 집계 가능한 보고서는 게시자 사이트의 광고에서 수집된 데이터와 광고 기술에서 수집하기 전에 사용자 기기의 브라우저에서 생성 및 암호화된 광고주 사이트의 전환 데이터를 결합한 것입니다.
이벤트 수준 보고서는 2~30일 지연됩니다. 집계 가능한 보고서는 1시간 이내에 무작위 지연으로 전송되며 이벤트는 참여도 예산에 적합해야 합니다. 이러한 선택사항은 개인 정보를 보호하고 개별 사용자의 작업을 악용하는 것을 방지합니다.
이벤트 수준 보고서에만 관심이 있는 경우 이 인프라가 마지막으로 필요합니다. 하지만 요약 보고서를 생성하려면 추가 서비스로 집계 가능한 보고서를 처리해야 합니다.
요약 보고서 생성
요약 보고서를 생성하려면 집계 가능한 보고서를 처리하는 집계 서비스(광고 기술에서 운영)를 사용합니다. 집계 서비스는 사용자 개인 정보를 보호하기 위해 노이즈를 추가하고 최종 요약 보고서를 반환합니다.

수집된 집계 가능한 보고서를 일괄 처리한 후 집계 서비스에서 배치를 처리합니다. 조정자는 증명된 버전의 집계 서비스에만 복호화 키를 제공합니다. 그런 다음 집계 서비스는 데이터를 복호화하고 집계한 후 노이즈를 추가하여 결과를 요약 보고서로 반환합니다.
일괄 집계 가능한 보고서
집계 가능한 보고서를 처리하려면 먼저 일괄 처리해야 합니다. 일괄 처리는 전략적으로 그룹화된 집계 가능한 보고서로 구성됩니다. 전략은 특정 기간 (예: 일일 또는 주간)을 반영할 가능성이 큽니다. 이 프로세스는 보고 엔드포인트 역할을 하는 동일한 서버에서 실행될 수 있습니다.
신호 대 노이즈 비율을 높이려면 일괄 처리에 많은 보고서가 포함되어야 합니다.

연간 할인과 같이 볼륨이 더 많을 것으로 예상되는 특정 이벤트를 포착할 수 있도록 언제든지 일괄 처리 기간을 변경할 수 있습니다. 기여 분석 소스 또는 트리거를 변경하지 않고도 일괄 처리 기간을 변경할 수 있습니다.
Aggregation Service
집계 서비스는 집계 가능한 보고서를 처리하여 요약 보고서를 생성합니다. 집계 가능한 보고서는 암호화되며 신뢰할 수 있는 실행 환경(TEE)에서 실행되는 집계 서비스에서만 읽을 수 있습니다.
집계 서비스는 데이터를 복호화하고 집계하기 위해 코디네이터에게 복호화 키를 요청합니다. 복호화 및 집계된 결과는 개인 정보를 보호하기 위해 노이즈가 추가된 후 요약 보고서로 반환됩니다.
실무자는 집계 가능한 일반 텍스트 보고서를 생성하여 로컬에서 집계 서비스를 테스트할 수 있습니다. 또는 Nitro Enclaves를 사용하여 AWS에서 암호화된 보고서로 테스트할 수 있습니다.
다음 단계
Google은 모든 사용자에게 적합한 API를 빌드하기 위해 여러분과 대화를 나누고자 합니다.
API 토론
다른 개인 정보 보호 샌드박스 API와 마찬가지로 이 API는 문서화되고 공개적으로 논의됩니다.
API 실험
Attribution Reporting API에 관한 대화에 실험하고 참여할 수 있습니다.