기술 의사 결정권자를 대상으로 하는 Attribution Reporting용 연결된 서비스에 관한 개략적인 개요입니다.
Attribution Reporting API를 사용하면 광고 기술 및 광고주가 광고 클릭 또는 조회가 구매와 같은 전환으로 이어지는 시점을 측정할 수 있습니다. 이 API는 비즈니스 요구사항에 따라 클라이언트 측 통합과 서버 측 통합의 조합을 사용합니다.
계속하기 전에 기여도 보고 개요를 읽어보세요. 이렇게 하면 API의 목적과 다양한 출력 보고서(이벤트 수준 보고서 및 요약 보고서)의 흐름을 이해하는 데 도움이 됩니다. 잘 모르는 용어가 있으면 개인 정보 보호 샌드박스 용어집을 참고하세요.
이 도움말의 대상은 누구인가요?
다음과 같은 경우 이 도움말을 읽어 보세요.
- 광고 기술 또는 광고주의 기술적 의사결정권자 운영, DevOps, 데이터 과학, IT, 마케팅 또는 기술 구현 결정을 내리는 다른 직무에서 근무할 수 있습니다. API가 개인 정보 보호 측정에 어떻게 작동하는지 궁금합니다.
- 기술 실무자 (예: 개발자, 시스템 운영자, 시스템 설계자 또는 데이터 과학자)로서 이 API 및 집계 서비스 환경에 대한 실험을 설정합니다.
이 도움말에서는 Attribution Reporting API에서 서비스가 작동하는 방식을 개략적으로 설명합니다. 기술 실무자라면 로컬에서 이 API로 실험해 볼 수 있습니다.
개요
Attribution Reporting API는 특정 설정, 클라이언트 측 구성, 서버 배포가 필요한 여러 서비스로 구성됩니다. 필요한 항목을 확인하려면 먼저 다음을 실행합니다.
- 디자인 결정: 수집할 정보를 정의하고, 캠페인에서 예상되는 전환을 식별하고, 수집할 보고서 유형을 결정할 수 있습니다. 최종 출력은 두 가지 보고서 유형, 즉 이벤트 수준 보고서와 요약 보고서 중 하나 또는 둘 다입니다.
항상 함께 작동하여 보고를 지원하는 구성요소는 2개 (때로는 3개)입니다.
- 웹사이트와 브라우저 간 통신. 쿠키 기반 시스템에서는 전환 및 광고 참여에 관한 정보가 식별자에 연결되어 개발자나 분석 서비스에서 나중에 이러한 이벤트를 조인할 수 있습니다. 이 API를 사용하면 브라우저에서
광고주의 안내에 따라 전환을 광고 클릭/조회와 연결한 후 분석을 위해
전송합니다. 따라서 광고 렌더링 코드와 전환 추적은 다음과 같아야 합니다.
- 어떤 광고 클릭 또는 노출에 기여해야 하는지 브라우저에 알립니다.
- 최종 보고서에 포함할 기타 데이터를 알립니다.
- 데이터 수집. 사용자의 브라우저에서 생성된 보고서를 수신하려면 수집기 엔드포인트가 필요합니다. 브라우저의 출력은 이벤트 수준 보고서와 집계 가능한 보고서 (암호화되어 요약 보고서를 생성하는 데 사용됨)라는 두 가지 보고서 중 하나일 수 있습니다.
집계 가능한 보고서를 수집한 경우 세 번째 구성요소가 필요합니다.
- 요약 보고서 생성. 집계 가능한 보고서를 일괄 처리하고 집계 서비스를 사용하여 보고서를 처리하여 요약 보고서를 생성합니다.
디자인 결정
기여도 보고의 핵심 원칙은 조기 설계 결정입니다. 어떤 카테고리에서 수집할 데이터와 해당 데이터를 처리할 빈도를 결정합니다. 출력 보고서는 캠페인 또는 비즈니스에 대한 통계를 제공합니다.
출력 보고서는 다음과 같습니다.
- 이벤트 수준 보고서는 광고 측의 특정 광고 클릭 또는 조회를 전환 측 데이터와 연결합니다. 사이트 간에 사용자 ID의 결합을 제한하여 사용자 개인 정보를 보호하기 위해 전환 측 데이터는 매우 제한되며 데이터에 노이즈가 있습니다 (즉, 일부 사례에서 실제 보고서 대신 임의 데이터가 전송됨).
- 요약 보고서는 광고 측의 특정 이벤트와 관련되어 있지 않습니다. 이러한 보고서는 더 자세한 전환 데이터를 제공하며 클릭과 조회 데이터를 전환 데이터와 결합할 수 있는 유연성을 제공합니다.
보고서 선택에 따라 수집해야 할 데이터가 달라집니다.
최종 출력을 의사결정에 사용하는 도구를 위한 입력으로 생각할 수도 있습니다. 예를 들어 요약 보고서를 생성하여 총 지출 가치로 이어진 전환수를 확인하는 경우 팀에서 더 높은 총 지출을 생성하기 위해 다음 광고 캠페인의 타겟을 결정하는 데 도움이 될 수 있습니다.
측정할 항목을 결정했다면 Attribution Reporting API용 클라이언트 측을 설정할 수 있습니다.
웹사이트-브라우저 간 통신
![게시자 웹사이트의 기여 분석 소스는 광고주 웹사이트의 트리거와 연결됩니다.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/attribution-sources-a-pu-b04d5ed143672.png?authuser=2&hl=ko)
기여 분석 이벤트 흐름
광고를 게재하는 게시자 사이트가 있다고 가정해 보겠습니다. 각 광고주 또는 광고 기술 제공업체는 광고와의 상호작용에 대해 알아보고 올바른 광고에 전환 기여도를 부여하기를 원합니다. 보고서 (이벤트 수준 및 집계 가능 보고서 모두)는 다음과 같이 생성됩니다.
게시자 사이트에서 광고 요소 (
<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 요소 대신 자바스크립트 호출을 사용할 수 있습니다.
다음은
window.open()
를 사용하는 JavaScript 예입니다. URL은 특수 문자 관련 문제를 방지하기 위해 URL 인코딩됩니다.const encodedUrl = encodeURIComponent( 'https://adtech.example/attribution_source?ad_id=...'); window.open( "https://shoes.example/landing", "_blank", attributionsrc=${encodedUrl});
- 사용자가 광고를 클릭하거나 조회하면 브라우저에서
GET
요청을attributionsrc
(일반적으로 광고주 또는 광고 기술 제공업체 엔드포인트)에 전송합니다. 이 요청을 수신하면 광고주 또는 광고 기술 제공업체는 나중에 이 광고에서 전환에 기여할 수 있도록, 광고와의 상호작용에 대한 소스 이벤트를 등록하도록 브라우저에 지시하기로 합니다. 이를 위해 광고주 또는 광고 기술 제공업체는 응답에 특수 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시간 이내에 임의의 지연으로 전송되며 이벤트는 참여 예산 내에 있어야 합니다. 이러한 선택을 통해 개인 정보를 보호하고 개별 사용자의 작업이 악용되지 않도록 방지할 수 있습니다.
이벤트 수준 보고서에만 관심이 있는 경우 필요한 마지막 인프라입니다. 하지만 요약 보고서를 생성하려면 추가 서비스를 사용하여 집계 가능한 보고서를 처리해야 합니다.
요약 보고서 생성
요약 보고서를 생성하려면 광고 기술에서 운영하는 집계 서비스를 사용하여 집계 가능한 보고서를 처리합니다. 집계 서비스는 노이즈를 추가하여 사용자 개인 정보를 보호하고 최종 요약 보고서를 반환합니다.
![집계 가능한 보고서는 수집, 일괄 처리된 후 광고 기술 환경으로 전송됩니다.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/aggregatable-reports-are-a0830fd543e6f.png?authuser=2&hl=ko)
수집된 집계 가능한 보고서를 일괄 처리한 후 집계 서비스에서 해당 배치를 처리합니다. 코디네이터는 집계 서비스의 증명된 버전에만 복호화 키를 제공합니다. 그런 다음 집계 서비스가 데이터를 복호화하고 집계하며 노이즈를 추가한 후 결과를 요약 보고서로 반환합니다.
일괄 집계 가능한 보고서
집계 가능한 보고서가 처리되기 전에 일괄 처리되어야 합니다. 배치는 전략적으로 그룹화된 집계 가능한 보고서로 구성됩니다. 전략은 특정 기간 (예: 매일 또는 매주)을 반영할 가능성이 높습니다. 이 프로세스는 보고 엔드포인트 역할을 하는 동일한 서버에서 발생할 수 있습니다.
배치에는 신호 대 노이즈 비율이 높게 유지되도록 많은 보고서를 포함해야 합니다.
![기간이 길수록 노이즈가 적은 결과를 얻을 수 있습니다.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/larger-periods-lead-les-4d4edffb3d2d6.png?authuser=2&hl=ko)
배치 기간은 연간 할인과 같이 더 많은 볼륨이 예상되는 특정 이벤트를 포착하기 위해 언제든지 변경될 수 있습니다. 일괄 처리 기간은 기여 분석 소스 또는 트리거를 변경하지 않고도 변경할 수 있습니다.
집계 서비스
집계 서비스는 집계 가능한 보고서를 처리하여 요약 보고서를 생성합니다. 집계 가능한 보고서는 암호화되며 신뢰할 수 있는 실행 환경(TEE)에서 실행되는 집계 서비스를 통해서만 읽을 수 있습니다.
집계 서비스는 데이터를 복호화하고 집계하기 위해 코디네이터에 복호화 키를 요청합니다. 복호화 및 집계 후에는 개인 정보 보호를 위해 결과에 노이즈가 제거되고 요약 보고서로 반환됩니다.
실무자는 집계 가능한 일반 텍스트 보고서를 생성하여 집계 서비스를 로컬에서 테스트할 수 있습니다. 또는 AWS에서 Nitro Enclaves를 사용하여 암호화된 보고서로 테스트할 수 있습니다.
다음 단계
Google은 누구나 사용할 수 있는 API를 빌드할 수 있도록 개발자들과 대화를 나누고자 합니다.
API 토론
다른 개인 정보 보호 샌드박스 API와 마찬가지로 이 API도 문서화되고 공개적으로 논의됩니다.
API 실험
Attribution Reporting API에 관한 대화에 실험하고 참여할 수 있습니다.