일부 개인 정보 보호 샌드박스 기술이 단계적으로 폐지됩니다.

개인 정보 보호 샌드박스 기술 계획 관련 업데이트를 참고하세요.

개인 정보 보호 샌드박스 기능 상태에서는 개별 API 및 플랫폼 기능의 상태에 관한 자세한 정보를 제공합니다.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Attribution Reporting: 전체 시스템 개요

기술 의사 결정자를 대상으로 하는 기여 분석 보고의 연결된 서비스에 대한 개략적인 개요

Attribution Reporting API를 사용하면 광고 기술 및 광고주가 광고 클릭 또는 조회가 구매와 같은 전환으로 이어지는 시점을 측정할 수 있습니다. 이 API는 비즈니스 요구사항에 따라 클라이언트 측 통합과 서버 측 통합을 조합하여 사용합니다.

계속하기 전에 기여 분석 보고 개요를 읽어보세요. 이를 통해 API의 목적과 다양한 출력 보고서(이벤트 수준 보고서 및 요약 보고서)의 흐름을 이해할 수 있습니다. 낯선 용어가 나오면 개인 정보 보호 샌드박스 용어집을 참고하세요.

이 문서의 대상

다음의 경우 이 문서를 읽어야 합니다.

광고 기술 또는 광고주의 기술 의사 결정권자입니다. 운영, DevOps, 데이터 과학, IT, 마케팅 또는 기술 구현 결정을 내리는 기타 역할에서 일할 수 있습니다. 개인 정보 보호 측정에 API가 어떻게 작동하는지 궁금합니다.
이 API 및 집계 서비스 환경으로 실험을 설정하는 기술 실무자 (예: 개발자, 시스템 운영자, 시스템 설계자, 데이터 과학자)입니다.

이 문서에서는 Attribution Reporting API의 서비스 작동 방식에 관한 개괄적인 엔드 투 엔드 설명을 제공합니다. 기술 실무자는 로컬에서 이 API를 실험할 수 있습니다.

개요

Attribution Reporting API는 여러 서비스로 구성되어 있으며, 이러한 서비스에는 특정 설정, 클라이언트 측 구성, 서버 배포가 필요합니다. 필요한 것을 확인하려면 다음 단계를 따르세요.

디자인 결정. 수집할 정보를 정의하고, 특정 캠페인에서 예상되는 전환을 파악하고, 수집할 보고서 유형을 결정합니다. 최종 출력은 이벤트 수준 보고서와 요약 보고서라는 두 가지 보고서 유형 중 하나 또는 둘 다입니다.

보고를 지원하기 위해 함께 작동하는 구성요소는 항상 두 개 (때로는 세 개)입니다.

웹사이트와 브라우저 간 통신 쿠키 기반 시스템에서는 전환 및 광고 참여에 대한 정보가 식별자에 연결되어 나중에 사용자 또는 분석 서비스가 이러한 이벤트에 참여할 수 있습니다. 이 API를 사용하면 브라우저가 분석을 위해 전송되기 전에 광고 클릭/조회와 전환을 연결합니다. 따라서 광고 렌더링 코드와 전환 추적은 다음을 충족해야 합니다.
- 어떤 전환이 어떤 광고 클릭 또는 노출에 기여했는지 브라우저에 알려줍니다.
- 최종 보고서에 포함할 다른 데이터를 알립니다.
데이터 수집. 사용자 브라우저에서 생성된 보고서를 수신하려면 수집기 엔드포인트가 필요합니다. 브라우저의 출력은 이벤트 수준 보고서와 집계 가능 보고서 (암호화되어 요약 보고서를 생성하는 데 사용됨)라는 두 가지 가능한 보고서 중 하나일 수 있습니다.

집계 가능한 보고서를 수집한 경우 세 번째 구성요소가 필요합니다.

요약 보고서 생성 집계 가능한 보고서를 일괄 처리하고 집계 서비스를 사용하여 보고서를 처리하여 요약 보고서를 생성합니다.

설계 결정

Attribution Reporting의 핵심 원칙은 초기 설계 결정입니다. 어떤 카테고리에서 어떤 데이터를 수집하고 해당 데이터를 얼마나 자주 처리할지 결정합니다. 출력 보고서는 캠페인 또는 비즈니스에 대한 유용한 정보를 제공합니다.

출력 보고서는 다음 중 하나일 수 있습니다.

이벤트 수준 보고서는 특정 광고 클릭 또는 조회 (광고 측)를 전환 측의 데이터와 연결합니다. 사이트 간 사용자 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=...&param2=...에 요청을 보냅니다.
이 URL의 서비스(일반적으로 광고주 또는 광고 기술 제공업체)가 요청을 수신합니다. 이 경우 전환으로 분류되므로 브라우저에 전환을 기록하도록 지시해야 합니다. 즉, 기여 분석을 트리거해야 합니다. 이를 위해 광고주 또는 광고 기술 제공업체는 픽셀 요청에 대한 응답에 전환에 관한 맞춤 데이터를 포함하는 특수 HTTP 헤더를 포함합니다.
사용자의 로컬 기기에 있는 브라우저가 이 응답을 수신하고 전환 데이터를 원래 소스 이벤트 (광고 클릭 또는 조회)와 매칭합니다.
브라우저가 attributionsrc로 전송될 보고서를 예약합니다. 이 보고서에는 다음이 포함됩니다.
1. 광고 기술 제공업체 또는 광고주가 3단계에서 소스 이벤트에 연결한 맞춤 기여 분석 구성 데이터입니다.
2. 6단계의 맞춤 전환 데이터 세트
이 다이어그램은 Attribution Reporting의 요소가 이벤트 수준 보고서와 집계 가능한 보고서를 트리거하는 것을 보여줍니다.
나중에 브라우저는 약간의 지연과 노이즈를 포함하여 attributionsrc에 정의된 엔드포인트로 보고서를 전송합니다. 집계 가능 보고서는 암호화되지만 이벤트 수준 보고서는 암호화되지 않습니다.

기여 분석 트리거 (광고주 웹사이트)

기여 분석 트리거는 브라우저에 전환을 캡처하도록 지시하는 이벤트입니다.

구매와 같이 광고주에게 가장 중요한 전환을 포착하는 것이 좋습니다. 요약 보고서에서 여러 전환 유형과 메타데이터를 캡처할 수 있습니다.

이렇게 하면 이러한 이벤트에 대한 집계 결과가 상세하고 정확한지 확인할 수 있습니다.

소스와 트리거 매칭

브라우저가 기여 분석 트리거 응답을 수신하면 브라우저는 로컬 저장소에 액세스하여 기여 분석 트리거의 출처와 해당 페이지 URL의 eTLD+1이 모두 일치하는 소스를 찾습니다.

예를 들어 브라우저가 shoes.example/shoes123에서 adtech.example의 기여 분석 트리거를 수신하면 브라우저는 adtech.example 및 shoes.example와 모두 일치하는 소스를 로컬 저장소에서 찾습니다.

필터 (또는 맞춤 규칙)를 설정하여 트리거가 특정 소스와 일치하는 시점을 확인할 수 있습니다. 예를 들어 특정 제품 카테고리의 전환만 집계하고 다른 모든 카테고리는 무시하도록 필터를 설정합니다. 필터와 우선순위 지정 모델을 사용하면 더 고급 기여 분석 보고가 가능합니다.

로컬 스토리지에 기여 분석 소스가 여러 개 있는 경우 브라우저는 가장 최근에 저장된 소스를 선택합니다. 기여 분석 소스에 우선순위가 할당된 경우 브라우저는 우선순위가 가장 높은 소스를 선택합니다.

데이터 수집

기여 분석 트리거는 해당 소스와 일치하며, 브라우저에서 광고 기술 소유 서버의 보고 엔드포인트(수집 엔드포인트 또는 수집 서비스라고도 함)로 보고서로 전송됩니다. 이러한 보고서는 이벤트 수준 보고서 또는 집계 가능 보고서일 수 있습니다.

집계 가능한 보고서는 요약 보고서를 생성하는 데 사용됩니다. 집계 가능한 보고서는 광고 기술에서 수집하기 전에 사용자의 기기에서 브라우저에 의해 생성되고 암호화된 광고 (게시자 사이트)에서 수집된 데이터와 전환 데이터 (광고주 사이트)의 조합입니다.

이벤트 수준 보고서가 2~30일 지연됩니다. 집계 가능한 보고서는 1시간 이내에 무작위 지연과 함께 전송되며 이벤트는 기여 예산 내에 있어야 합니다. 이러한 선택은 개인 정보를 보호하고 개별 사용자의 행동이 악용되는 것을 방지합니다.

이벤트 수준 보고서에만 관심이 있다면 이것이 필요한 마지막 인프라입니다. 하지만 요약 보고서를 생성하려면 집계 가능한 보고서를 추가 서비스로 처리해야 합니다.

요약 보고서 생성

요약 보고서를 생성하려면 집계 서비스(광고 기술에서 운영)를 사용하여 집계 가능한 보고서를 처리합니다. 집계 서비스는 사용자 개인 정보를 보호하기 위해 노이즈를 추가하고 최종 요약 보고서를 반환합니다.

집계 가능한 보고서가 수집되고, 배치되고, 광고 기술 환경으로 전송됩니다. — 이 다이어그램은 수집 엔드포인트에서 시작하여 보고서를 일괄 처리하고 광고 기술 소유 집계 서비스에서 처리하는 데이터의 비동기 흐름을 나타냅니다.

수집된 집계 가능한 보고서를 배치한 후 집계 서비스에서 배치를 처리합니다. 코디네이터는 증명된 집계 서비스 버전에만 복호화 키를 제공합니다. 그런 다음 집계 서비스는 데이터를 복호화하고 집계하며 노이즈를 추가한 후 결과를 요약 보고서로 반환합니다.

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

집계 가능한 보고서는 처리되기 전에 일괄 처리되어야 합니다. 배치는 전략적으로 그룹화된 집계 가능한 보고서로 구성됩니다. 전략은 특정 기간 (예: 일별 또는 주별)을 반영할 가능성이 높습니다. 이 프로세스는 보고 엔드포인트 역할을 하는 동일한 서버에서 실행될 수 있습니다.

배치에는 신호 대 노이즈 비율이 높도록 많은 보고서가 포함되어야 합니다.

기간이 길수록 노이즈가 적은 결과를 얻을 수 있습니다. — 1일과 1주일을 기다리는 것을 비교합니다. 1시간 후에는 요약 값이 더 작아지고 노이즈가 더 많은 결과가 나올 수 있습니다. 하루가 지나면 요약 값이 커지므로 노이즈가 줄어들 가능성이 높습니다.

연간 할인과 같이 볼륨이 높을 것으로 예상되는 특정 이벤트를 포착할 수 있도록 일괄 처리 기간은 언제든지 변경할 수 있습니다. 배치 기간은 기여 분석 소스나 트리거를 변경하지 않고도 변경할 수 있습니다.

Aggregation Service

집계 서비스는 집계 가능한 보고서를 처리하여 요약 보고서를 생성합니다. 집계 가능한 보고서는 암호화되며 신뢰할 수 있는 실행 환경(TEE)에서 실행되는 집계 서비스에서만 읽을 수 있습니다.

집계 서비스는 코디네이터에 복호화 키를 요청하여 데이터를 복호화하고 집계합니다. 복호화되고 집계된 결과는 개인 정보를 보호하기 위해 노이즈가 추가되고 요약 보고서로 반환됩니다.

실무자는 집계 가능한 일반 텍스트 보고서를 생성하여 집계 서비스를 로컬에서 테스트할 수 있습니다. 또는 Nitro Enclaves를 사용하여 AWS에서 암호화된 보고서로 테스트할 수 있습니다.

다음 단계

Google은 모두에게 적합한 API를 빌드하기 위해 여러분과 대화하고 싶습니다.

API 토론

다른 개인 정보 보호 샌드박스 API와 마찬가지로 이 API는 문서화되어 있으며 공개적으로 논의됩니다.

API 실험

Attribution Reporting API에 관한 대화에 실험하고 참여할 수 있습니다.