전환 기여 분석 측정에는 게시자, 광고주, 게재 광고 기술 (광고를 게재하는 주체), 측정 제공업체 등 여러 당사자가 관여할 수 있습니다. 이 문서에서는 일반적인 전환 측정 시나리오를 설명하지만, 일반적으로 Attribution Reporting API (ARA)에서 기여도 보고서를 받으려는 모든 당사자는 이 문서에 설명된 통합 단계를 따라야 합니다.
예를 들어 게시자는 광고 게재를 담당하는 광고 기술을 하나 이상 보유하는 것이 일반적입니다. 여기에는 광고 소재의 마크업을 제공할 책임이 있는 당사자, 광고 소재의 노출 또는 추적 픽셀을 제공하는 당사자, 게시자 페이지의 광고 슬롯에 SDK 또는 태그를 제공하는 당사자가 포함될 수 있습니다. 이러한 광고 기술은 ARA에서 기여도 보고서를 수신할 수도 있고 원하지 않을 수도 있지만 다운스트림 광고 기술이 기여도 보고서를 수신할 수 있도록 배치되어 있습니다.
또한 광고주가 교차 네트워크 기여 분석 및 기타 보고 기능을 위해 서드 파티 전환 측정 제공업체를 이용하고 있을 수도 있습니다. 광고주는 이 데이터를 사용하여 여러 고유한 게시자 및 채널의 광고 투자수익을 파악하므로 DSP 또는 광고 서버는 Attribution Reporting API를 사용 설정하여 이러한 사용 사례를 지원하는 방법을 이해하는 것이 중요합니다. 서드 파티를 이용하려는 광고주는 서드 파티 측정 제공업체를 이용하거나 API에서 보고서를 등록하고 수신하도록 내부 서버를 설정하여 서드 파티를 계속 이용할 수 있습니다.
Attribution Reporting API를 사용하면 여러 광고 기술에서 동일한 노출 또는 전환에 관한 기여 분석 소스 및 트리거를 등록하고 API에서 별도의 보고서를 수신할 수 있습니다. 예를 들어 DSP는 Attribution Reporting API에서 자체 기여도 보고서를 수신할 뿐만 아니라 광고주의 서드 파티 측정 제공업체에 대해 별도의 보고를 허용할 수 있습니다. 광고 기술은 API에서 보고서를 수신하려면 기여 분석 소스와 트리거를 모두 등록해야 하며 기여 분석은 광고 기술이 API에 개별적으로 등록한 기여 분석 소스 및 트리거 중에서 실행됩니다.
일반적인 전환 측정 시나리오
이 섹션에서는 전환 측정과 관련된 일반적인 두 가지 시나리오를 살펴보겠습니다.
시나리오 1: 게재 광고 기술 및 서드 파티 측정 제공업체가 모두 Attribution Reporting API에서 보고서를 수신해야 함
광고주가 서드 파티 측정 제공업체를 통해 광고 인벤토리의 전환 기여도를 부여하려고 하고, 광고 소재를 호스팅하는 광고 기술은 광고 인벤토리의 전환에 기여도를 부여하려고 합니다. 이러한 현상은 광고 소재에 마크업을 제공하고 자체 기여 보고서를 수행하며 제3자 측정 또는 분석 제공업체와 통합되는 광고주와 협력하는 DSP 또는 광고주 광고 서버 (서드 파티 광고 서버 — 3PAS)에서 일반적입니다.
이 경우 게재 광고 기술도 현재 설정에서 클릭 및 노출 이벤트를 실행할 책임이 있습니다. 게재 광고 기술은 새 attributionsrc를 적절한 위치에 설정하고 리디렉션이 올바르게 구성되도록 해야 합니다. 또한 게재 광고 기술과 서드 파티 측정 제공업체는 모두 등록되어 있고 서버가 Attribution Reporting API 요청을 수신하고 응답할 준비가 되어 있는지 확인해야 합니다.
일반적인 캠페인 설정은 다음과 같습니다.
광고주 광고 서버 (3PAS)가 광고 소재의 마크업을 DSP에 제공합니다. DSP에는 제3자 측정 제공업체의 노출 및 클릭 추적 픽셀이 포함되어 있습니다. 광고 서버에서는 광고 소재 마크업에
attributionsrc이(가) 포함되어 있는지 확인해야 합니다.DSP는 측정 노출 및 클릭 추적 픽셀을 추가하는 기능을 제공하므로
attributionsrc가 입찰하는 최종 광고 소재 마크업에 포함되어야 합니다.
시나리오 2: 서드 파티 측정 제공업체만 Attribution Reporting API에서 보고서를 수신해야 함
광고주가 서드 파티 측정 제공업체를 통해 광고 인벤토리의 전환 기여도를 분석하려고 하지만, 광고 소재를 호스팅하는 광고 기술에는 기여 분석 측정 요구사항이 없습니다. 이는 광고 소재를 호스팅하고 기여도 보고를 직접 사용할 계획이 없지만 DSP 파트너나 측정 태그 회사(예: 서드 파티 광고 서버, 측정 또는 분석 제공업체)를 위해 Attribution Reporting API를 사용 설정하려는 게시자, SSP 또는 게시자 광고 서버에서 일반적입니다.
이 경우 현재 설정에서 클릭 및 노출 이벤트를 실행해야 하는 당사자가 새 attributionsrc 속성을 광고 소재에 추가하고 리디렉션이 의도한 대로 작동하는지 확인해야 합니다. 이는 각 게시자의 통합에 따라 크게 달라지지만, 클릭 이벤트의 경우 SSP, 게재 광고 기술 또는 게시자 자체일 수 있습니다. 노출 이벤트의 경우 서드 파티 측정 업체를 이용하는 경우가 더 일반적입니다.
시나리오 1의 일반적인 캠페인 설정 예에서 게시자 광고 서버, SSP 또는 게시자는 DSP가 제공한 attributionsrc 속성이 게시자 페이지에 나타나는지 확인하기만 하면 됩니다.
구현 세부정보
다음 표에서는 Attribution Reporting API 구현 단계를 개략적으로 설명합니다.
| 단계 | 업무의 책임 | 예 |
|---|---|---|
| 1단계: 기존 광고 소재 및 측정 코드에 대한 기여 분석 소스 사용 설정 | 노출 이벤트를 실행하거나 클릭 이벤트를 처리하는 항목은 attributionsrc 속성을 추가합니다. |
클릭 이벤트의 경우 일반적으로 광고 소재를 렌더링하는 구매자 (DSP/광고주 광고 서버)가 속성을 추가합니다.
노출 이벤트의 경우 수요측 플랫폼 (DSP), 공급측 플랫폼 (SSP), 게시자, 광고 서버 또는 측정 제공업체가 이 속성을 추가하며 이는 게시자의 설정에 따라 다릅니다. VAST 형식을 사용하는 동영상 광고의 경우 게시자와 동영상 SDK가 속성을 추가합니다. |
| 2단계: 서드 파티 출처에 대한 Attribution Reporting 사용 설정 | 이 방법은 302 리디렉션이 포함된 기존 리디렉션 경로를 사용하는 경우 즉시 작동합니다. 302 리디렉션을 사용할 수 없는 경우 |
일반적으로 attributionsrc 속성이 광고 소재에 추가되어 있는 한 서드 파티 리디렉션은 Attribution Reporting API 호출을 수신해야 합니다. |
| 3단계: Attribution Reporting API 요청에 대한 응답 설정 | Attribution Reporting API에서 보고서를 수신하려는 모든 항목 | DSP 및 광고주가 사용하는 서드 파티 측정 공급업체 |
각 단계의 세부정보는 게시자 페이지에서 광고 소재가 렌더링되고 게재되는 방식과 Attribution Reporting API에서 보낸 보고서를 수신하는 광고 기술 항목에 따라 다릅니다.
1단계: 기존 광고 소재 및 측정 코드에 대한 기여 분석 소스 사용 설정
첫 번째 단계에서는 기여 분석 소스가 사용 설정됩니다.
attributionsrc 속성의 작동 방식
새 attributionsrc 속성은 Attribution Reporting API 요청이 전송될 위치를 지정합니다. 노출 및 클릭 이벤트 실행을 담당하는 항목은 attributionsrc 속성으로 광고 소재를 업데이트해야 합니다. attributionsrc는 기존 클릭 및 노출 이벤트에 추가되어야 하며, 비어 있거나 비어 있지 않을 수 있습니다.
리디렉션을 사용하는 클릭 이벤트의 경우 attributionsrc 속성을 탐색에 추가해야 합니다. 탐색 후 302 리디렉션에는 attributionsrc 속성을 추가할 필요가 없으며 초기 탐색에서 attributionsrc를 추가한 한 ARA를 사용할 수 있습니다.
attributionsrc가 비어 있으면 ARA 요청이 앵커 태그 (클릭률)의 href 속성에 정의된 URL로 전송됩니다. attributionsrc 속성이 정의되면 ARA 요청이 attributionsrc 속성에 정의된 URL로 전송됩니다. 클릭연결 URL도 소스를 등록할 수 있습니다.
일반적으로 클릭연결 URL을 호스팅하는 서버가 Attribution Reporting API 요청을 수신하고 응답할 수 있는 경우 빈 attributionsrc 속성을 사용합니다. Attribution Reporting API 요청이 다른 서버로 이동하게 하려면 자체 attributionsrc URL을 정의합니다.
빈 attributionsrc 속성의 예:
| 기존 설정 | ARA 통합 포함 |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
attributionsrc 속성이 비어 있으면 Attribution Reporting API 요청이 앵커 태그의 href 속성으로 정의된 URL로 전송됩니다.
비어 있지 않은 Attributionsrc 속성의 예:
| 기존 설정 | ARA 통합 포함 |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>
|
attributionsrc가 비어 있지 않으면 Attribution Reporting API 요청이 attributionsrc 태그로 정의된 URL로 전송됩니다. 클릭연결 URL도 소스를 등록할 수 있습니다.
클릭 및 노출 이벤트에 대한 attributionsrc 추가
- 클릭 이벤트:
attributionsrc추가를 담당하는 항목은 일반적으로 게재 광고 기술입니다.- 클릭 이벤트가 있는 앵커 태그에는
attributionsrc속성을 추가해야 합니다. window.open를 사용하는 클릭은window.open호출의windowFeatures인수를 사용하여 기여 분석 소스를 지정해야 합니다.
- 노출 이벤트:
attributionsrc추가를 담당하는 항목은 일반적으로 게재 광고 기술 및 측정 제공업체입니다.<img>태그 또는<script>태그에서 실행된 노출 이벤트에는attributionsrc속성이 포함되어야 합니다.- Fetch API를 사용하는 노출 이벤트는 가져오기 API 호출에 전달되는 options 인수에
attributionReporting객체를 포함해야 합니다.
클릭 및 노출 이벤트에 필요한 수정사항을 요약한 다음 표를 참고하세요.
| 이벤트 | 태그 | 기존 설정 | ARA 통합 후 |
|---|---|---|---|
| 클릭 | HTML |
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
| JavaScript | window.open("[CLICKTHROUGH_URL]", "_blank"); |
window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc"); |
|
| 노출 | HTML <img> 태그 |
<img src="[IMPRESSION_URL]">
|
<img src="[IMPRESSION_URL]" attributionsrc>
|
HTML <script> 태그 |
<script src="[IMPRESSION_URL]"></script>
|
<script src="[IMPRESSION_URL]" attributionsrc></script>
|
|
| JavaScript |
const options = {...} |
const options = { |
Protected Audience 입찰에서 기여 분석 소스 등록 사용 설정
Protected Audience 입찰에서 전환을 측정하려면 attributionsrc를 사용하는 대신 registerAdBeacon/registerAdMacro 및 setReportEventDataForAutomaticBeacons/reportEvent를 사용하여 기여 분석 소스 등록을 사용 설정할 수 있습니다.
Protected Audience 신호 보고의 경우 registerAdBeacon 함수는 보고 Worklet 내에서 사용할 수 있으며 registerAdMacro는 구매자의 낙찰 보고 Worklet 내에서 사용할 수 있습니다. 그러면 Fenced Frame Ads Reporting API의 reportEvent 및 setReportEventDataForAutomaticBeacons 함수를 사용하여 광고 프레임 내의 이벤트 데이터를 등록된 비콘 및 매크로에 추가할 수 있습니다. 이를 통해 Protected Audience 보고 워크렛과 광고 소재 프레임 이벤트 페이로드의 신호가 서로 연결될 수 있습니다.
비콘과 매크로가 프레임에서 reportEvent 호출을 통해 트리거되거나 브라우저에서 자동 비콘이 트리거될 때 Attribution-Reporting-Eligible HTTP 헤더가 요청에 추가됩니다. 비콘의 응답을 사용하여 기여 분석 소스를 등록할 수 있습니다. 비콘 요청은 서드 파티 측정을 허용하도록 리디렉션될 수 있습니다.
자세한 내용은 Fenced Frame Ad Reporting API 설명의 기여도 보고서 지원 섹션을 참고하세요.
VAST 형식에 대한 기여 분석 보고 사용 설정
VAST는 동영상 광고 인벤토리를 게재하고 측정하는 데 사용되는 일반적인 형식이며, 이 표준에 정의된 많은 이벤트는 Attribution Reporting API에 등록할 수 있는 잠재적인 소스 이벤트로 간주되어야 합니다. 기여도 보고 지원에 대한 VAST 부록에 이 내용이 자세히 설명되어 있습니다. 간단히 말해 모든 <Tracking>, <Impression>, <*ClickThrough>, <*ClickTracking> 이벤트는 잠재적인 기여 분석 소스 이벤트입니다. 모든 VAST 구현은 이러한 이벤트에 대한 등록 자격 요건을 제공해야 합니다.
VAST 부록에서는 기여 분석 등록을 위한 보조 URL을 설정할 수 있도록 이러한 요소에 새로운 속성을 정의합니다. 이벤트에 attributiontype="DOUBLE_PING" 및 attributionsrc="[URL]"가 포함된 경우 이 이벤트를 실행하는 코드는 Attribution Reporting API를 사용 설정할 때 [URL]를 attributionsrc 속성의 값으로 사용해야 합니다. VAST 부록에는 각 시나리오에 대한 예가 포함되어 있습니다.
적용 범위를 최대화하려면 이벤트 핑을 실행할 때 VAST 구현에서 기본적으로 등록된 모든 이벤트를 등록할 수 있게 해야 합니다. 예를 들어 <Impression> 이벤트 URL을 실행할 때 (비어 있는) attributionsrc 속성은 요청을 전송하는 데 사용되는 <img> 요소 (또는 가져오기 호출의 동등한 요소)에 사용되어야 합니다. 그래야 수신 당사자가 해당 이벤트를 Attribution Reporting API에 항상 등록할 수 있습니다.
2단계: 서드 파티 출처에 대한 Attribution Reporting 사용 설정
서드 파티가 Attribution Reporting API를 사용하도록 허용하려면 기존 리디렉션을 사용하거나 서드 파티 목록을 attributionsrc 속성에 추가하면 됩니다. 대부분의 경우 광고 기술마다 독립적인 노출 추적기가 있으므로 리디렉션이 클릭 추적 광고에 더 적합합니다.
기존 리디렉션 체인에서 서드 파티 출처 처리
일반적인 광고 클릭연결에서는 여러 클릭 추적 광고가 최종 방문 페이지로의 탐색의 일부로 이루어진 302 리디렉션 체인으로 존재할 수 있습니다. 원래 클릭 타겟이 attributionsrc로 주석 처리되었거나 Protected Audience API의 registerAdBeacon/registerAdMacro에 등록된 경우 리디렉션 체인의 모든 요청은 Attribution Reporting API에 등록할 수 있습니다. 리디렉션 체인의 광고 기술도 등록되어야 합니다.
초기 요청의 본문은 리디렉션 시 전송되지 않습니다. Protected Audience 입찰의 경우 reportEvent에 전달된 eventData 및 setReportEventDataForAutomaticBeacons를 리디렉션의 일부로 사용해야 하는 경우 리디렉션 URL의 일부로 명시적으로 전달해야 합니다.
다음 예에서는 게재 광고 기술 (serving-adtech.example)과 서드 파티 측정 제공업체 (3p-measurement.example)를 기여도 보고서를 생성하고 수신하려는 두 개의 개별 항목으로 사용합니다. 이 예의 게재 광고 기술은 게시자 사이트에서 광고 소재를 렌더링하고 자체 보고 제품이 있는 DSP일 수 있습니다. 서드 파티 측정 제공업체는 광고주가 전환 보고에 사용하는 법인일 수 있습니다.
소스 등록 시간에 다음 단계가 발생합니다.
serving-adtech.example는 광고 소재에attributionsrc속성을 설정합니다. 사용자가 게시자 페이지를 방문하면 브라우저가serving-adtech.example.에 요청을 보냅니다.serving-adtech.example는Attribution-Reporting-Register-Source헤더와Location헤더로 응답합니다.serving-adtech.example는Attribution-Reporting-Register-Source헤더를 사용하여 등록할 소스에 관한 메타데이터로 응답합니다.serving-adtech.example는Location헤더를 사용하여3p-measurement.example리디렉션을 포함합니다. 서드 파티로의302리디렉션을 지원하기 위해 기존 클릭 추적 흐름에서Location헤더가 이미 사용되고 있을 가능성이 높습니다.
- 브라우저가
serving-adtech.example에서 응답을 수신하고Attribution-Reporting-Register-Source헤더를 파싱합니다. 브라우저가serving-adtech.example를 보고 출처로 사용하여 소스 이벤트를 저장합니다. - 이 요청은 리디렉션이므로 브라우저도
3p-measurement.example에 새 요청을 합니다. 3p-measurement.example는Attribution-Reporting-Register-Source헤더가 포함된 응답으로 응답합니다.- 브라우저가
3p-measurement.example에서 이 응답을 수신하고Attribution-Reporting-Register-Source를 읽습니다. 브라우저가3p-measurement.example를 보고 출처로 사용하여 소스 이벤트를 저장합니다.
리디렉션 체인에 없는 서드 파티 출처에 attributionsrc 사용
여러 보고자 출처에서 탐색 이벤트에 소스를 등록하려고 하지만 어떤 이유로든 리디렉션 체인에 표시될 수 없는 경우 대체 솔루션으로 attributionsrc에서 여러 사이트를 기여 분석 소스로 나열할 수 있습니다.
| 기존 설정 | ARA 수정 후 |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>
|
이 예에서 Attribution Reporting API 요건을 충족하는 요청은 REPORTING_URL_1 및.REPORTING_URL_2로 전송됩니다. 클릭연결 URL로 전송된 탐색 요청도 기여 분석 소스를 등록할 수 있습니다.
3단계: Attribution Reporting API 요청에 대한 응답 설정
Attribution Reporting API 요청을 수신하는 모든 출처의 경우 서버가 적절한 Attribution-Reporting-Register-Source 헤더로 응답하는지 확인합니다. 응답 구성 방법을 알아보려면 소스 등록 가이드 및 설명서를 참고하세요.
여러 트리거 등록
전환 측에 여러 픽셀 요소 (트리거당 하나)를 추가하여 여러 기여 분석 트리거를 등록할 수 있습니다. attributionsrc 요소는 트리거 등록을 위한 선택사항입니다.
소스 등록과 동일한 방식으로 리디렉션 요청을 사용하거나 attributionsrc 요소에 여러 URL을 나열하여 단일 픽셀 요소에서 여러 트리거를 등록할 수도 있습니다. 동일한 출처에서 생성된 소스 이벤트 및 트리거 이벤트가 일치됩니다.