기술 의사 결정권자를 대상으로 하는 기여도 보고의 연결된 서비스에 대한 개략적인 개요입니다.
Attribution Reporting API를 사용하면 광고 기술과 광고주가 광고 클릭 또는 조회가 구매와 같은 전환으로 이어지는 경우 이 API는 클라이언트 측 통합과 서버 측 통합의 조합 살펴봤습니다
계속하기 전에 기여도 보고 개요 이를 통해 API의 목적과 다양한 출력 보고서의 흐름을 이해할 수 있습니다. (이벤트 수준 보고서 및 요약 보고서)를 제공합니다. 생소한 용어를 발견하면 개인 정보 보호 샌드박스 용어집.
이 도움말은 누구를 대상으로 하나요?
다음과 같은 경우 이 도움말을 읽어야 합니다.
- 광고 기술 또는 광고주의 기술 관련 의사 결정권자입니다. 당신은 일할 수 있습니다 운영, DevOps, 데이터 과학, IT, 마케팅 또는 기타 직무에서 기술적 구현과 관련된 결정을 내립니다. 이 API가 개인 정보 보호 측정에서 어떻게 작동하는지 궁금하시다면
- 기술 실무자 (개발자, 시스템 운영자, 시스템 설계자 또는 데이터 과학자)과 협력하여 API 및 집계 서비스 환경에 대해 살펴보겠습니다
이 도움말에서는 Attribution Reporting API에서 작동합니다. 기술 분야에 종사하는 경우 실무자의 경우 이 API를 사용해 제공합니다
개요
Attribution Reporting API는 많은 서비스로 구성되며, 여기에는 설정, 클라이언트 측 구성, 서버 배포가 포함됩니다. 무엇을 먼저 다음 단계를 따르세요.
- 디자인에 관한 결정을 내립니다. 수집할 정보를 정의하고, 특정 캠페인에서 예상되는 전환을 식별하고, 수집할 보고서 유형을 결정합니다. 최종 출력은 두 보고서 유형, 즉 이벤트 수준 보고서와 요약 보고서 중 하나 또는 둘 다입니다.
보고 지원에는 항상 두 가지 (때로는 세 가지) 구성요소가 있습니다.
- 웹사이트와 브라우저 간 통신. 포함
전환 및 광고 참여를 위한 정보는
사용자 또는 애널리틱스 서비스가
나중에 실행할 수 있습니다 이 API를 통해 브라우저는 전환을
광고 클릭수/조회수를 조정하여
분석 따라서 광고 렌더링 코드와 전환 추적은 다음 조건을 충족해야 합니다.
<ph type="x-smartling-placeholder">
- </ph>
- 어떤 전환에 어떤 광고가 기여한 것으로 간주되어야 하는지 브라우저에게 알림 알 수 있습니다.
- 최종 보고서에 포함할 다른 데이터에 신호를 보냅니다.
- 데이터 수집. 이를 위해서는 수집기 엔드포인트가 사용자 계정에서 생성된 보고서를 있습니다. 브라우저의 출력 가능한 두 가지 보고서, 즉 이벤트 수준 보고서와 집계 가능한 보고서 중 하나일 수 있습니다. 보고서 (암호화되어 요약 보고서를 생성하는 데 사용됨)
집계 가능한 보고서를 수집한 경우 세 번째 구성요소가 필요합니다.
- 요약 보고서 생성. 일괄 집계 가능한 보고서를 처리하고 집계 서비스를 사용해 보고서를 처리합니다. 요약 보고서를 생성합니다.
설계 결정
기여도 보고의 핵심 원칙은 초기 설계 결정입니다. 직접 결정 어떤 카테고리에서 어떤 데이터를 수집하고 얼마나 자주 그 데이터를 처리해야 하는지 데이터를 수집하는 데 사용됩니다 출력 보고서는 캠페인 또는 비즈니스에 대한 유용한 정보를 제공합니다.
출력 보고서는 다음과 같을 수 있습니다.
- 이벤트 수준 보고서는 광고 측의 특정 광고 클릭 또는 조회를 전환 측 데이터와 연결합니다. 사이트 전반에서 사용자 ID 결합을 제한하여 사용자 개인 정보를 보호하기 위해 전환 측 데이터가 매우 제한적이고 데이터에 노이즈가 많습니다 (일부의 경우 실제 보고서 대신 무작위 데이터가 전송됨).
- 요약 보고서는 광고 측의 특정 이벤트와 연결되지 않습니다. 이 보고서는 더 자세한 전환 데이터를 제공하고 클릭 및 조회 데이터와 전환 데이터를 결합할 수 있는 유연성을 제공합니다.
보고서 선택에 따라 수집해야 하는 데이터가 달라집니다.
또한 최종 출력은 데이터를 분석하는 데 사용하는 도구의 입력으로 생각할 수 있습니다. 결정할 수 있습니다. 예를 들어 데이터가 발생한 전환이 많은 경우 총비용으로 이어져 총지출을 늘리기 위해 다음 광고 캠페인에서 타겟팅할 대상을 정하세요.
측정할 항목을 결정했으면 클라이언트 측 Attribution Reporting API에 사용할 수 있습니다.
웹사이트 간 통신
<ph type="x-smartling-placeholder">기여 분석 이벤트 흐름
광고를 게재하는 게시자 사이트를 상상해 보세요. 모든 광고주 또는 광고 기술 제공업체는 광고와의 상호작용에 대해 알아보고 올바른 광고에 전환 기여도를 부여하려고 합니다. 보고서 (이벤트 수준 및 집계 가능 보고서)는 다음과 같이 생성됩니다.
게시자 사이트에서 광고 요소 (
<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시간 이내에 임의의 지연으로 전송되어야 하며 이벤트는 후원 예산이 있습니다. 이러한 선택사항을 통해 개인 정보를 보호하고 개별 사용자의 작업이 악용되는 것을 방지할 수 있습니다.
이벤트 수준 보고서에만 관심이 있는 경우 이 보고서가 배포할 수 있습니다 그러나 요약 보고서를 생성하려면 추가 서비스를 사용하여 집계 가능한 보고서를 처리해야 합니다.
요약 보고서 생성
요약 보고서를 생성하려면 집계 서비스 (애드테크에서 운영)를 사용하여 집계 가능한 보고서를 처리합니다. 집계 서비스에서 사용자 개인 정보를 보호하기 위해 노이즈를 추가하고 최종 요약 보고서를 반환합니다.
<ph type="x-smartling-placeholder">일괄 집계 가능한 보고서
집계 가능한 보고서는 일괄 처리해야 합니다. 배치 전략적으로 그룹화된 집계 가능한 보고서로 구성됩니다. 전략을 세울 때 특정 기간 (예: 매일 또는 매주)을 반영할 가능성이 높습니다. 이 보고 엔드포인트 역할을 하는 동일한 서버에서 실행될 수 있습니다.
신호 대 잡음비가 높아지도록 배치에 많은 보고서를 포함해야 합니다.
<ph type="x-smartling-placeholder">일괄 기간은 특정 이벤트를 포착할 수 있도록 언제든지 변경될 수 있습니다. 더 많은 트래픽이 예상되는 경우(예: 연간 세일) 일괄 처리 기간 기여 분석 소스나 트리거를 변경하지 않고도 변경할 수 있음
Aggregation Service
집계 서비스는 집계 가능한 보고서를 처리하여 요약 보고서를 생성합니다. 집계 가능한 보고서는 암호화되며 신뢰할 수 있는 실행 환경에서 실행되는 집계 서비스에 의해 판독됨 (TEE)를 사용합니다.
집계 서비스는 코디네이터에 복호화 키를 요청합니다. 데이터를 복호화하고 집계합니다. 복호화되고 집계되면 결과는 개인 정보를 보호하기 위해 노이즈가 적용되어 요약 보고서로 반환됩니다.
실무자는 집계 가능한 일반 텍스트 보고서를 생성하여 로컬에서 집계 서비스를 테스트합니다. 또는 Nitro Enclaves를 사용하여 AWS에서 암호화된 보고서로 테스트할 수 있습니다.
다음 단계
Google은 사용자와의 대화에 참여하여 이러한 요구사항을 충족하는 API를 빌드하고자 모두에게 도움이 됩니다.
API 토론
다른 개인 정보 보호 샌드박스 API와 마찬가지로 이 API는 문서화되어 있으며 공개적으로 논의되는 주제입니다.
API 실험
실험하고 참여할 수 있습니다. Attribution Reporting API에 관해 이야기해 보겠습니다